เข้าถึงเซสชันเพื่อสร้าง UI และเอนทิตีเชิงพื้นที่

อุปกรณ์ XR ที่ใช้ได้

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

ดูข้อมูลเกี่ยวกับประเภทอุปกรณ์ XR →

ชุดหูฟัง XR

แว่นตา XR แบบมีสาย

ดูข้อมูลเกี่ยวกับประเภทอุปกรณ์ XR →

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

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

เข้าถึงเซสชันจาก Jetpack Compose สำหรับ XR

เมื่อใช้ Jetpack Compose สำหรับ XR ระบบจะสร้างเซสชันให้คุณและเข้าถึงได้โดยใช้ LocalSession.current โปรดดูตัวอย่างต่อไปนี้

@Composable
fun ComposableUsingSession() {
    val session = LocalSession.current
}Session.kt

เข้าถึงเซสชันจาก Jetpack XR Runtime

หากคุณกำลังสร้างเอนทิตีเชิงพื้นที่จากไลบรารี SceneCore ของ Jetpack คุณจะต้องสร้างเซสชัน

หากต้องการสร้างเซสชัน ให้ส่งกิจกรรมไปยังเมธอด create() ดังที่แสดงในตัวอย่างต่อไปนี้

when (val result = Session.create(this)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}Session.kt

เมื่อกิจกรรมของเซสชันถูกทำลาย ระบบจะทำลาย UI เชิงพื้นที่และเนื้อหา 3 มิติทั้งหมดที่เชื่อมโยง กับเซสชันนั้น และเซสชันจะใช้ไม่ได้อีกต่อไป

เข้าถึงเซสชันจาก Jetpack Compose สำหรับ XR

เข้าถึงเซสชันจาก Jetpack XR Runtime

ดูเพิ่มเติม