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

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

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

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

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

ใช้ SpaceToggleButton เพื่อสลับระหว่างพื้นที่หน้าแรกกับพื้นที่เต็ม

หากต้องการเปลี่ยนจาก Home Space เป็น Full Space ให้ใช้ Composable SpaceToggleButton จากไลบรารี Material Design สำหรับ XR

นี่คือปุ่มที่ประกอบได้ซึ่งปรับให้เข้ากับโหมดเชิงพื้นที่ปัจจุบันและสลับ ระหว่าง Full Space กับ Home Space

สร้างการเปลี่ยนฉากที่กำหนดเองระหว่างพื้นที่หน้าแรกกับพื้นที่เต็ม

หากใช้ไลบรารี Jetpack Compose สำหรับ XR ให้ขอ Home Space หรือ Full Space โดยใช้ LocalSpatialConfiguration องค์ประกอบภายใน

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

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

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

ดูตัวอย่างวิธีใช้คำขอเหล่านี้เพื่อเปลี่ยนโหมดโดยการคลิกปุ่มได้ใน Codelab Learn Android XR Fundamentals: Part 1 - Modes and Spatial Panels นอกจากนี้ เราขอแนะนำให้คุณอ่านคำแนะนำด้านการออกแบบเพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับ Home Space ไปยัง Full Space และวิธีเปลี่ยนจาก Home Space ไปยัง Full Space ได้อย่างราบรื่น

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

หรือคุณจะเพิ่มบรรทัดต่อไปนี้ลงในไฟล์ 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" />

ดูเพิ่มเติม