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

อุปกรณ์ XR ที่รองรับ
คำแนะนำนี้จะช่วยคุณสร้างประสบการณ์การใช้งานสำหรับอุปกรณ์ XR ประเภทนี้
ชุดหูฟัง XR
แว่นตา XR แบบใช้สาย

ผู้ใช้สามารถใช้งานแอปของคุณได้ 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 สำหรับ XR

ปุ่มนี้เป็นปุ่ม Composable ที่ปรับตามโหมดเชิงพื้นที่ปัจจุบันและสลับระหว่าง Full Space กับ Home Space

สร้างการเปลี่ยนที่กำหนดเองระหว่าง Home Space กับ Full Space

หากใช้ไลบรารี Jetpack Compose สำหรับ XR ให้ขอ Home Space หรือ Full Space โดยใช้ LocalSession Composition Local

val session = LocalSession.current ?: return
session.scene.requestHomeSpace()
// or
session.scene.requestFullSpace()

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

xrSession.scene.requestHomeSpace()

อ่านคำแนะนำด้านการออกแบบเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับ 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" />

ดูเพิ่มเติม