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

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

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

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

การเปลี่ยนระหว่างพื้นที่หน้าหลักกับพื้นที่เต็ม

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

@Composable
private fun HomeSpaceFullSpaceToggleButton() {
    val xrSession = checkNotNull(LocalSession.current)

    val uiIsSpatialized = LocalSpatialCapabilities.current.isSpatialUiEnabled
    val toggleModes = if (uiIsSpatialized) {
        { xrSession.requestHomeSpaceMode() }
    } else {
        { xrSession.requestFullSpaceMode() }
    }

    IconButton(
        onClick = {
            toggleModes()
        }
    ) {
        Icon(
            painter = painterResource(id = drawable),
            contentDescription = stringResource(contentDescription)
        )
    }
}

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

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

หากต้องการเลือกว่าต้องการให้แอปเปิดในพื้นที่ทำงานของ Home หรือพื้นที่ทำงานแบบเต็ม ให้เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ 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" />

ดูเพิ่มเติม