รันไทม์ XR

เริ่มเซสชัน AR หรือ 3 มิติที่กําหนดเองด้วยรันไทม์แบบเนทีฟ
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า เวอร์ชันอัลฟ่า
7 พฤษภาคม 2025 - - - 1.0.0-alpha04

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มทรัพยากร Dependency ในรันไทม์ XR คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ใน ที่เก็บ Maven ของ Google

เพิ่มการอ้างอิงสำหรับอาร์ติแฟกต์ที่คุณต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล

ดึงดูดKotlin 
dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha04"

    // Use in environments that do not support OpenXR
    testImplementation "androidx.xr.runtime:runtime-testing:1.0.0-alpha04"
}
 
dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha04")

    // Use in environments that do not support OpenXR
    testImplementation("androidx.xr.runtime:runtime-testing:1.0.0-alpha04")
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพิงบิวด์

ความคิดเห็น

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

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของเครื่องมือติดตามปัญหา

รุ่น 1.0

เวอร์ชัน 1.0.0-alpha04

7 พฤษภาคม 2025

androidx.xr.runtime:runtime:1.0.0-alpha04, androidx.xr.runtime:runtime-openxr:1.0.0-alpha04 และ androidx.xr.runtime:runtime-testing:1.0.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha04 มีการคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้เซสชันใช้ androidx.lifecycle.LifecycleOwner เพื่อให้ทำงานร่วมกันกับรูปแบบวงจรชีวิตของ Android ที่มีอยู่ได้มากขึ้น
  • สตริงไฟล์ Manifest สำหรับ Android XR จะระบุและแสดงอยู่ในเอกสารประกอบที่นี่
  • เพิ่มเมธอดส่วนขยายการเรียกกลับการแสดงผลภาพในพื้นที่เพื่อตรวจสอบเมื่อเนื้อหาฉากเคลื่อนไหวภายในหรือนอกมุมมองของผู้ใช้
  • เพิ่มJxrPlatformAdapterเวอร์ชันสแต็บ (และคลาสที่เกี่ยวข้องทั้งหมด)
  • ระบบจะใช้เซสชันทั้งใน SceneCore และรันไทม์แทนเซสชันใน SceneCore
  • เพิ่ม ActivityPose.hitTest ซึ่งทำให้สามารถ hitTest เนื้อหาเสมือนจริงได้
  • ตอนนี้ระบบรองรับการระบุการใช้งานรันไทม์หลายรายการในเวลาคอมไพล์แล้ว ระบบจะโหลดเพียงรายการเดียวในเวลาที่ดำเนินการโดยอิงตามชุดฟีเจอร์ของอุปกรณ์ปัจจุบัน
  • เพิ่มประเภทคอมโพเนนต์ใหม่ SpatialPointerComponent ซึ่งช่วยให้ลูกค้าระบุไอคอนที่แสดงผลสำหรับเคอร์เซอร์หรือปิดใช้ไอคอนได้ ปัจจุบันคอมโพเนนต์นี้แนบกับอินสแตนซ์ PanelEntity รายการเท่านั้น

การเปลี่ยนแปลง API

  • เผยแพร่การใช้งาน Config (I95860)
  • เพิ่ม HandJointType และ TrackingState (I55880)
  • โปรเจ็กต์ที่เผยแพร่ด้วย Kotlin 2.0 ต้องใช้ KGP 2.0.0 ขึ้นไป (Idb6b5)
  • เปลี่ยน Hand.isActive (boolean) เป็น Hand.trackingState แล้ว เราได้แก้ไขการใช้งาน OpenXR ให้เป็นไปตามข้อกำหนดแล้ว
  • เปลี่ยนข้อกำหนดสิทธิ์ android.permission.SCENE_UNDERSTANDING ใน Session.configure เป็น android.permission.SCENE_UNDERSTANDING_COARSE แล้ว
  • LifecycleManager.configure ใช้งานได้แล้ว และตอนนี้จะส่งผ่านออบเจ็กต์ Config ซึ่งมีพร็อพเพอร์ตี้สําหรับฟีเจอร์รันไทม์ที่กําหนดค่าได้แต่ละรายการ
  • ตอนนี้คุณสามารถเรียกใช้ Session.configure ด้วย Config เพื่อกําหนดค่าฟีเจอร์รันไทม์ที่ใช้ได้
  • ตอนนี้ Session.create รองรับการส่ง CoroutineContext แทน CoroutineDispatcher แล้ว
  • Session.create รองรับการโหลด ARCore สำหรับ Jetpack XR และ/หรือ SceneCore โดยต้องระบุอย่างน้อย 1 รายการ (มีเวอร์ชันการทดสอบให้ใช้งาน)
  • FakePerceptionManager จะแสดง AnchorInvalidUuidException เมื่อมีการส่ง UUID ที่ไม่ถูกต้องไปยัง Anchor.load และ Anchor.unpersist
  • CoreState ไม่ใช่คลาสข้อมูลอีกต่อไป

การแก้ไขข้อบกพร่อง

  • แก้ไขการกำหนดค่า ProGuard รันไทม์

เวอร์ชัน 1.0.0-alpha03

26 กุมภาพันธ์ 2025

androidx.xr.runtime:runtime:1.0.0-alpha03, androidx.xr.runtime:runtime-openxr:1.0.0-alpha03 และ androidx.xr.runtime:runtime-testing:1.0.0-alpha03 เผยแพร่โดยไม่มีการเปลี่ยนแปลงที่โดดเด่นนับตั้งแต่รุ่นอัลฟ่าล่าสุด เวอร์ชัน 1.0.0-alpha03 มีการคอมมิตเหล่านี้

เวอร์ชัน 1.0.0-alpha02

12 กุมภาพันธ์ 2025

androidx.xr.runtime:runtime:1.0.0-alpha02, androidx.xr.runtime:runtime-openxr:1.0.0-alpha02 และ androidx.xr.runtime:runtime-testing:1.0.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีการคอมมิตเหล่านี้

การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและการเปลี่ยนแปลงด้านลักษณะการทำงาน

  • ตอนนี้OpenXRฟังก์ชันรันไทม์ที่แสดงผล Anchor จะแสดง AnchorResourcesExhaustedException หากพบรหัสข้อผิดพลาดที่แจ้งว่าถึงขีดจํากัดของทรัพยากร OpenXR แล้ว
  • ตอนนี้ Session.create และ Session.resume ต้องใช้สิทธิ์ android.permission.HAND_TRACKING

ฟีเจอร์ใหม่

  • เพิ่มการรองรับการติดตามการเคลื่อนไหวของมือ

แก้ไขข้อบกพร่อง

  • การสร้างจุดยึดมีความเสถียรมากขึ้นเมื่อทำงานบนโปรแกรมจำลอง

เวอร์ชัน 1.0.0-alpha01

12 ธันวาคม 2024

androidx.xr.runtime:runtime-* 1.0.0-alpha01 ได้รับการปล่อยแล้ว

ฟีเจอร์ของรุ่นแรก

การเปิดตัวรันไทม์ Jetpack XR ครั้งแรก ไลบรารีนี้มีฟังก์ชันพื้นฐานสําหรับชุดไลบรารี Jetpack XR ซึ่งรวมถึงการค้นพบความสามารถ การจัดการวงจร การกำหนดค่า และอื่นๆ ไลบรารีรันไทม์มีรูปแบบที่แตกต่างกัน (เช่น runtime-openxr หรือ runtime-testing) โดยขึ้นอยู่กับแพลตฟอร์มการเรียกใช้ นอกจากนี้ ไลบรารีนี้ยังมีการแยกความคิดทางคณิตศาสตร์พื้นฐาน เช่น Vector3 และ Matrix4 ซึ่งใช้ในแพลตฟอร์ม Jetpack XR API ทั้งหมด

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

  • Pose: ตําแหน่งในระบบพิกัดที่กำหนดเองซึ่งมีตําแหน่งและการวางแนวที่เชื่อมโยงอยู่ คุณจะใช้คลาสนี้เพื่อสื่อสารตำแหน่งของวัตถุด้วย ARCore สำหรับ Jetpack XR และ Jetpack SceneCore

ปัญหาที่ทราบ

  • ขณะนี้ configure ยังไม่มีผล เวอร์ชันในอนาคตจะเพิ่มการตั้งค่าใหม่ที่คุณสามารถใช้เพื่อควบคุมลักษณะการทำงานของ Session