ผู้ใช้สามารถใช้งานแอปของคุณได้ 2 โหมด ได้แก่ โหมดพื้นที่ทำงานหรือโหมดพื้นที่ทำงานแบบเต็ม ใน Home Space ผู้ใช้สามารถทำงานหลายอย่างพร้อมกันด้วยแอปของคุณที่ทำงานควบคู่ไปกับแอปอื่นๆ ในโหมดเต็มพื้นที่ แอปของคุณจะเป็นจุดสนใจของประสบการณ์ของผู้ใช้โดยสามารถเข้าถึงความสามารถของ Android XR ได้อย่างเต็มรูปแบบ
แอปจะเปิดในพื้นที่ทำงานโดยค่าเริ่มต้น เว้นแต่คุณจะระบุไว้เป็นอย่างอื่นตามที่อธิบายไว้ในส่วนประกาศโหมดเริ่มต้นสำหรับการเปิด
การจัดวางเสียงตามตำแหน่งใช้ได้เฉพาะในโหมดพื้นที่ทำงานแบบเต็มเท่านั้น แอปสามารถเปลี่ยนไปใช้พื้นที่ทำงานแบบเต็มเพื่อใช้ประโยชน์จากความสามารถเชิงมิติสัมพันธ์และ 3 มิติ เมื่อแอปของคุณมีโฟกัส คุณจะสลับระหว่างโหมดเหล่านี้ได้โดยขอพื้นที่ทำงานที่เกี่ยวข้อง
การเปลี่ยนระหว่างพื้นที่หน้าหลักกับพื้นที่เต็ม
หากคุณใช้ไลบรารี Jetpack Compose สำหรับ XR ให้ขอพื้นที่ในบ้านหรือพื้นที่เต็มโดยใช้ LocalSpatialConfiguration
composition local
LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
หากใช้ไลบรารี Jetpack SceneCore คุณสามารถขอพื้นที่ทำงานที่เกี่ยวข้องจาก Session
val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()
ดูตัวอย่างวิธีใช้คำขอเหล่านี้เพื่อสลับระหว่างโหมดต่างๆ โดยการคลิกปุ่มได้ที่เรียนรู้พื้นฐานเกี่ยวกับ Android XR: ส่วนที่ 1 - โหมดและแผงพื้นที่ใน Codelab นอกจากนี้ เราขอแนะนําให้อ่านคําแนะนําด้านการออกแบบเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับพื้นที่ในหน้าแรกและพื้นที่แบบเต็ม รวมถึงวิธีเปลี่ยนระหว่างพื้นที่ทั้ง 2 แบบให้ดีที่สุด
ประกาศโหมดเริ่มต้นสำหรับการเปิดใช้งาน
หรือจะเพิ่มบรรทัดต่อไปนี้ลงในไฟล์ Manifest ของ Android เพื่อเลือกพื้นที่ทำงานที่แอปควรเปิดก็ได้
<!-- Launch in Full Space. -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />
<!-- Or, launch in Home Space. -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_HOME_SPACE_MANAGED" />