ผู้ใช้สามารถสัมผัสประสบการณ์การใช้งานแอปของคุณได้ 2 โหมด ได้แก่ Home Space หรือ Full Space ใน Home Space ผู้ใช้จะทำงานหลายอย่างพร้อมกันได้โดยให้แอปของคุณทำงานควบคู่ไปกับแอปอื่นๆ ใน Full Space แอปของคุณจะโดดเด่นเป็นจุดสนใจของประสบการณ์การใช้งานของผู้ใช้ โดยจะเข้าถึงความสามารถที่สมจริงของ Android XR ได้อย่างเต็มที่
แอปของคุณจะเปิดใน Home Space โดยค่าเริ่มต้น เว้นแต่คุณจะระบุไว้เป็นอย่างอื่นตามที่ อธิบายไว้ในส่วนประกาศโหมดเริ่มต้นสำหรับการเปิดแอป
ระบบรองรับการสร้างเสียงเชิงพื้นที่ใน Full Space เท่านั้น แอปของคุณสามารถเปลี่ยนไปใช้ Full Space เพื่อใช้ประโยชน์จากความสามารถเชิงพื้นที่และความสามารถ 3 มิติ เมื่อแอปของคุณได้รับโฟกัส คุณสามารถเปลี่ยนไปมาระหว่างโหมดเหล่านี้ได้โดยขอพื้นที่ที่เกี่ยวข้อง
ใช้ SpaceToggleButton เพื่อสลับไปมาระหว่าง Home Space กับ Full Space
หากต้องการเปลี่ยนไปมาระหว่าง Home Space กับ Full Space ให้ใช้
SpaceToggleButton คอมโพสได้จาก Material Design for XR
ไลบรารี
ปุ่มนี้เป็นคอมโพสได้ที่ปรับให้เข้ากับโหมดเชิงพื้นที่ปัจจุบันและสลับไปมาระหว่าง Full Space กับ Home Space
สร้างการเปลี่ยนภาพที่กำหนดเองระหว่าง Home Space กับ Full Space
หากคุณใช้ไลบรารี Jetpack Compose for XR ให้ขอ Home Space หรือ Full
Space โดยใช้ LocalSession คอมโพสได้
val session = LocalSession.current ?: return session.scene.requestHomeSpace() // or session.scene.requestFullSpace()
หากคุณใช้ไลบรารี Jetpack SceneCore คุณสามารถขอพื้นที่ที่เกี่ยวข้องจาก Session ได้ โปรดดูหัวข้อ การเข้าถึงเซสชันจาก Jetpack
SceneCore
xrSession.scene.requestHomeSpace()
ดูตัวอย่างวิธีใช้คำขอเหล่านี้เพื่อเปลี่ยนไปมาระหว่างโหมดต่างๆ โดย คลิกปุ่มได้ใน Codelab เรียนรู้พื้นฐาน Android XR: ตอนที่ 1 - โหมดและแผงเชิงพื้นที่ นอกจากนี้ เราขอแนะนำให้คุณอ่านคำแนะนำการออกแบบเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับ Home Space ไปยัง Full Space และวิธีเปลี่ยนไปมาระหว่าง 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" />