การเปลี่ยนจากพื้นที่หน้าหลักเป็นพื้นที่เต็ม

ผู้ใช้จะใช้งานแอปของคุณได้ 2 โหมด ได้แก่ พื้นที่หน้าแรกหรือพื้นที่เต็ม ใน Home Space ผู้ใช้จะทำงานหลายอย่างพร้อมกันได้โดยให้แอปของคุณทำงานควบคู่ไปกับแอปอื่นๆ ในพื้นที่เต็ม แอปของคุณจะกลายเป็นจุดศูนย์กลางของประสบการณ์การใช้งานของผู้ใช้ โดยมีสิทธิ์เข้าถึงความสามารถในการดื่มด่ำของ Android XR อย่างเต็มรูปแบบ

แอปจะเปิดในพื้นที่บ้านโดยค่าเริ่มต้น เว้นแต่คุณจะระบุเป็นอย่างอื่นตามที่อธิบายไว้ในส่วนประกาศโหมดเริ่มต้นสำหรับการเปิดตัว

การปรับเสียงตามตำแหน่งรองรับเฉพาะในพื้นที่เต็มเท่านั้น แอปของคุณสามารถเปลี่ยนไปใช้ พื้นที่เต็มเพื่อใช้ประโยชน์จากความสามารถเชิงพื้นที่และ 3 มิติ เมื่อแอปมีโฟกัส คุณจะเปลี่ยนโหมดเหล่านี้ได้โดยขอพื้นที่ที่เกี่ยวข้อง

เปลี่ยนจากพื้นที่หน้าแรกเป็นพื้นที่เต็ม

หากใช้ไลบรารี Jetpack Compose สำหรับ XR ให้ขอพื้นที่บ้านหรือพื้นที่เต็มโดยใช้ LocalSpatialConfiguration องค์ประกอบในเครื่อง

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()

หากใช้ไลบรารี SceneCore ของ Jetpack คุณสามารถขอพื้นที่ที่เกี่ยวข้องจาก Session ได้ ดูเข้าถึงเซสชันจาก SceneCore ของ Jetpack

xrSession.scene.requestHomeSpaceMode()

ดูตัวอย่างวิธีใช้คำขอเหล่านี้เพื่อเปลี่ยนโหมดโดยการคลิกปุ่มได้ในโค้ดแล็บดูข้อมูลพื้นฐานเกี่ยวกับ Android XR: ตอนที่ 1 - โหมดและแผงเชิงพื้นที่ นอกจากนี้ เราขอแนะนำให้คุณอ่านคำแนะนำด้านการออกแบบเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับ การเปลี่ยนจากพื้นที่หน้าแรกเป็นพื้นที่เต็ม และวิธีเปลี่ยนระหว่างพื้นที่ทั้ง 2 อย่างมีประสิทธิภาพสูงสุด

ประกาศโหมดเริ่มต้นสำหรับการเปิดตัว

หรือคุณจะเพิ่มบรรทัดต่อไปนี้ลงในไฟล์ Android Manifest เพื่อ เลือกพื้นที่ที่แอปควรเปิดก็ได้

<!-- 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" />

ดูเพิ่มเติม