ผู้ใช้สามารถใช้งานแอปของคุณได้ 2 โหมด ได้แก่ โหมดพื้นที่ทำงานหรือโหมดพื้นที่ทำงานแบบเต็ม ใน Home Space ผู้ใช้สามารถทำงานหลายอย่างพร้อมกันด้วยแอปของคุณที่ทำงานควบคู่ไปกับแอปอื่นๆ ในโหมดเต็มพื้นที่ แอปของคุณจะแสดงเป็นจุดศูนย์กลางของประสบการณ์ของผู้ใช้โดยเข้าถึงความสามารถของ Android XR แบบสมจริงได้อย่างเต็มที่
แอปจะเปิดในพื้นที่ทำงานโดยค่าเริ่มต้น เว้นแต่คุณจะระบุไว้เป็นอย่างอื่นตามที่อธิบายไว้ในส่วนประกาศโหมดเริ่มต้นสำหรับการเปิด
การจัดเสียงให้สมจริงใช้ได้เฉพาะในโหมดพื้นที่ทำงานแบบเต็มเท่านั้น แอปสามารถเปลี่ยนไปใช้โหมดพื้นที่ทำงานแบบเต็มเพื่อใช้ประโยชน์จากความสามารถเชิงมิติสัมพันธ์และ 3 มิติ เมื่อแอปมีโฟกัส คุณจะสลับระหว่างโหมดเหล่านี้ได้โดยขอพื้นที่ทำงานที่เกี่ยวข้อง
การเปลี่ยนระหว่างพื้นที่หน้าแรกกับพื้นที่เต็ม
หากคุณใช้ไลบรารี Jetpack Compose สำหรับ XR ให้ขอพื้นที่ในหน้าแรกหรือพื้นที่เต็มโดยใช้องค์ประกอบ LocalSpatialConfiguration
LocalSpatialConfiguration.current.requestHomeSpaceMode() // or LocalSpatialConfiguration.current.requestFullSpaceMode()
หากใช้ไลบรารี Jetpack SceneCore คุณสามารถขอพื้นที่ทำงานที่เกี่ยวข้องจาก Session ได้โดยดูที่เข้าถึงเซสชันจาก Jetpack SceneCore
xrSession.scene.spatialEnvironment.requestHomeSpaceMode()
ดูตัวอย่างวิธีใช้คําขอเหล่านี้เพื่อเปลี่ยนระหว่างโหมดต่างๆ โดยการคลิกปุ่มได้ที่เรียนรู้พื้นฐานเกี่ยวกับ Android XR: ส่วนที่ 1 - โหมดและแผงพื้นที่ใน Codelab นอกจากนี้ เราขอแนะนําให้อ่านคําแนะนําด้านการออกแบบเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับพื้นที่ในบ้านและพื้นที่เต็ม รวมถึงวิธีเปลี่ยนระหว่างพื้นที่ทั้งสองอย่างเหมาะสม
ประกาศโหมดเริ่มต้นสำหรับการเปิดใช้งาน
หรือจะเพิ่มบรรทัดต่อไปนี้ลงในไฟล์ 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" />