ARCore สำหรับ Jetpack XR

นำเนื้อหาดิจิทัลมาสู่โลกแห่งความเป็นจริงด้วยความสามารถในการรับรู้
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
21 ตุลาคม 2569 1.0.0 - - 1.1.0-alpha01

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

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

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

ดึงดูด

dependencies {
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}

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

ความคิดเห็น

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

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

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Issue Tracker

เวอร์ชัน 1.1

เวอร์ชัน 1.1.0-alpha01

21 ตุลาคม 2569

androidx.xr.arcore:arcore-*:1.1.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.1.0-alpha01 มีคอมมิตเหล่านี้

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

  • เปิดตัว SpatialAnnotation API สำหรับติดตามเรขาคณิตและวัตถุทางกายภาพแบบ 3 มิติ เพิ่ม SpatialAnnotationTrackingOptions และรูปแบบ Builder ที่เกี่ยวข้องเพื่อกำหนดค่าการติดตามเชิงพื้นที่ผ่านบัฟเฟอร์รูปภาพจากกล้อง (I918ce)
  • เปิดตัว SpatialAnnotation และ SpatialAnnotationTrackingMode ใน Jetpack XR ARCore ซึ่งช่วยให้นักพัฒนาแอปกำหนดค่าและติดตามเรขาคณิตรูปสี่เหลี่ยม 3 มิติที่มีขอบเขตตามต้องการ (Quad) ซึ่งกำหนดเป้าหมายไปยังสภาพแวดล้อมเชิงพื้นที่ในโลกจริง (I880e4)
  • เพิ่ม TestSpatialAnnotation เพื่ออนุญาตการจำลองคำอธิบายประกอบเชิงพื้นที่แบบเป็นโปรแกรมในการทดสอบอัตโนมัติ (If2335)
  • เพิ่ม geospatialPose, horizontalAccuracy, verticalAccuracy และ orientationYawAccuracy เป็น API ใหม่เพื่อให้ข้อมูลเพิ่มเติมในสถานะเชิงพื้นที่ (If28f8)

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

  • อัปเดตทรัพยากร Dependency androidx.lifecycle:lifecycle-runtime เป็น 2.10.0 แล้ว ต้องใช้เวอร์ชันนี้เพื่อให้การตรวจสอบ Lint ของรันไทม์วงจรที่รวมมาทำงานร่วมกับ AGP เวอร์ชัน 9.5.0-alpha04 ขึ้นไปได้ (I99bfd, b/556807521)
  • ตรวจสอบจำนวนรูปภาพสูงสุดเป็น 0 เมื่อกำหนดค่า AugmentedImage โดยแสดง UnsupportedOperationException แทนที่จะดำเนินการไม่สำเร็จโดยไม่คาดคิด I6ce439
  • แก้ไขปัญหาหน่วยความจำรั่วไหลและปัญหาการเกิดขึ้นพร้อมกันใน AugmentedImageRenderer โดยการติดตามและยกเลิกงานการแสดงผล การกำจัดเอนทิตี และการแก้ไขคอลเล็กชันรูปภาพอย่างปลอดภัย Ie70760

รุ่น 1.0

เวอร์ชัน 1.0.0

21 ตุลาคม 2569

androidx.xr.arcore:arcore-*:1.0.0 เผยแพร่แล้ว เวอร์ชัน 1.0.0 มีคอมมิตเหล่านี้

ฟีเจอร์หลักของ 1.0.0:

  • ARCore สำหรับ Jetpack XR พร้อมให้ใช้งานอย่างเสถียรแล้ว ไลบรารี ARCore สำหรับ Jetpack XR มีความสามารถในการผสมผสานเนื้อหาดิจิทัลเข้ากับโลกจริง ไลบรารีนี้ประกอบด้วยการติดตามการเคลื่อนไหว, Anchor แบบถาวร, การทดสอบตัวชี้, การระบุระนาบด้วยการติดป้ายกำกับเชิงความหมาย (เช่น พื้น ผนัง และโต๊ะ) และท่าทางเชิงภูมิสารสนเทศโดยใช้ระบบระบุตำแหน่งด้วยภาพของ Google
  • ดูข้อมูลเพิ่มเติมได้ที่คู่มือนักพัฒนาซอฟต์แวร์และเอกสารอ้างอิง API

เวอร์ชัน 1.0.0-rc02

7 ตุลาคม 2026

androidx.xr.arcore:arcore-*:1.0.0-rc02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-rc02 มี คอมมิตเหล่านี้

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

  • แก้ไขปัญหาที่ OpenXrRuntime กำหนดค่าเซสชันไม่สำเร็จเมื่อระบบไม่รองรับการติดตามรูปภาพที่ได้รับการเสริมประสิทธิภาพ (I8b9759)
  • แก้ไขปัญหาหลายอย่าง ซึ่งรวมถึงการปรับปรุงการจัดการหน่วยความจำใน XrInstanceManager โดยใช้ applicationContext, แก้ไขปัญหาที่อาจเกิดขึ้นเกี่ยวกับวงจรด้วยการลดความซับซ้อนของกลไกการแคช Session และ Scene และปรับปรุง ReferenceCleaner เพื่อให้มั่นใจว่ามีการลงทะเบียนการล้างข้อมูลที่ปลอดภัยต่อเธรดและการกำจัดที่ชัดเจน (Id0b76c)

เวอร์ชัน 1.0.0-rc01

9 กันยายน 2026

androidx.xr.arcore:arcore-*:1.0.0-rc01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-rc01 มีคอมมิตเหล่านี้

เวอร์ชัน 1.0.0-beta02

12 สิงหาคม 2569

androidx.xr.arcore:arcore-*:1.0.0-beta02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-beta02 มีคอมมิตเหล่านี้

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

  • แก้ไขปัญหาการเกิดขึ้นพร้อมกันในความคงอยู่ของ Anchor OpenXR (I15c8b)
  • ใช้ toString() ในคลาสเพิ่มเติมเพื่อแก้ไขข้อบกพร่อง (I587e8)

เวอร์ชัน 1.0.0-beta01

15 กรกฎาคม 2569

androidx.xr.arcore:arcore-*:1.0.0-beta01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-beta01 มีคอมมิตเหล่านี้

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

  • อัปเดตตัวแก้ไขที่ปรับขนาดได้ให้ใช้ ResizePolicy แทนตัวแก้ไข 2 ตัว (I7fb0f, b/496257436, b/519672992)
  • เพิ่มโอเวอร์โหลดที่เคลื่อนย้ายได้ด้วยพารามิเตอร์ movePolicy และเลิกใช้งาน transformingMovable และ movable (Ic88c1, b/481781189)
  • นำ TrackingState.TRACKING_DEGRADED ออกจากแพลตฟอร์ม API สาธารณะ และแมปสถานะรันไทม์ที่ลดลงเป็น PAUSED แทน อัปเดต TrackingState เพื่อใช้ enum แทนค่า int สำหรับการแปลงสตริงและการแปลงรันไทม์ (I3eb5b, b/524326338)
  • แปลง Session.create เป็นฟังก์ชันระงับ (I5d27f)
  • เลิกใช้งาน ProjectedPermissionsResultContract (I141d5, b/515699436)
  • อัปเดต AnchorEntity ให้เรียกว่า AnchorSpace (Ifa95e, b/513619219)

เวอร์ชัน 1.0.0-alpha15

17 มิถุนายน 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha15 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha15 มีคอมมิตเหล่านี้

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

  • นำ HitResult.createAnchor ออกแล้ว นักพัฒนาแอปสามารถสร้าง Anchor ที่แสดง HitResult หากผลลัพธ์ที่ติดตามได้คือ Anchorable โดยระบุตำแหน่งการแตะให้กับฟังก์ชัน createAnchor ของ Anchorable (Ia851e)
  • นำ AnchorUnsupportedObject ออกแล้ว รันไทม์ JXR ARCore จะไม่แสดงข้อผิดพลาดนี้อีกต่อไป (Ia851e)
  • androidx.xr.arcore.Anchor และ androidx.xr.arcore.ArDevice ใช้ androidx.xr.arcore.Trackable แล้ว (I57b65)
  • Depth.left, Depth.right และ Depth.mono เป็นค่าที่เว้นว่างไม่ได้แล้ว (I1fc5e)
  • Face.getUserFace เป็นค่าที่เว้นว่างไม่ได้แล้ว (I0eac1)
  • RenderViewpoint.left, RenderViewpoint.right, RenderViewpoint.mono เป็นค่าที่เว้นว่างไม่ได้แล้ว (Icf7fa)
  • Hand.left และ Hand.right ต้องไม่เป็นค่า Null (Icef37)
  • เพิ่ม QrCode API (Ia0bbe)

เวอร์ชัน 1.0.0-alpha14

19 พฤษภาคม 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha14 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha14 มีคอมมิตเหล่านี้

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

  • เลิกใช้งาน GeospatialMode.VPS_AND_GPS เพื่อใช้ GeospatialMode.SPATIAL และเปิดตัวโหมดการติดตามที่ใช้พลังงานต่ำแบบใหม่ GeospatialMode.INERTIAL ซึ่งใช้เฉพาะ IMU และ GPS (I1e6cd)
  • คลาสข้อยกเว้น Anchor ที่กำหนดเอง: AnchorInvalidUuidException, AnchorNotAuthorizedException, AnchorUnsupportedLocationException, AnchorRuntimeFailureException และ AnchorUnsupportedObjectException เป็น อินสแตนซ์ RuntimeException แล้ว ซึ่งไม่ได้มีไว้เพื่อตรวจสอบ (I9356e)
  • เพิ่ม API ArCoreTestRule ซึ่งรวมถึง TestArDevice, TestAugmentableObject, TestDepthMap, TestEye, TestFace, TestGeospatial, TestHand, TestPlane, TestRenderViewpoint และ TestTrackable (I0ad3c)
  • นำ AnchorLoadInvalidUuid, AnchorCreateUnsupportedObject, AnchorCreateUnsupportedLocation และ AnchorCreateNotAuthorized ออก ข้อผิดพลาดทั้งหมดนี้เป็นข้อยกเว้นในรันไทม์แล้ว นำ AnchorCreateIllegalState ออก ในกรณีส่วนใหญ่ รายการนี้ถูกแทนที่ด้วย AnchorCreateTrackingUnavailable เพิ่ม AnchorException และคลาสที่ได้มา AnchorInvalidUuidException, AnchorNotAuthorizedException, AnchorUnsupportedLocationException, AnchorRuntimeFailureException และ AnchorUnsupportedObjectException (I4c4dd)

การมีส่วนร่วมจากภายนอก

  • เพิ่ม AugmentedImage API สำหรับการติดตามเครื่องหมายที่กำหนดเอง (I0cf09)

เวอร์ชัน 1.0.0-alpha13

6 พฤษภาคม 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha13 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha13 มี คอมมิตเหล่านี้

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

  • TrackingState และ VpsAvailabilityResult ได้ย้ายไปที่ androidx.xr.arcore package แล้ว และประเภทใน androidx.xr.runtime เลิกใช้งานแล้ว (Ic7930, b/480462213)
  • เปลี่ยนชื่อ Plane.Type เป็น PlaneType แล้ว (I8c90c, b/482675376)
  • เปลี่ยนชื่อ Hand.HandSide เป็น HandSide แล้ว (Ica562, b/482675376)
  • เปลี่ยนชื่อ Plane.Label เป็น PlaneLabel แล้ว (Ic6b67, b/482675376)
  • เปลี่ยนชื่อ Geospatial.Surface เป็น GeospatialSurface แล้ว (I1a8be, b/482675376)
  • เปลี่ยนชื่อ Geospatial.State เป็น GeospatialState แล้ว (I203fa, b/482675376)
  • ย้าย API NativeData ไปยังไลบรารี xr:runtime:runtime แล้ว (I87954, b/494251500)
  • ตอนนี้ Session.create และ Session.configure ไม่ครอบคลุมทั้งหมดและต้องมีส่วนคำสั่ง else ในคำสั่ง when (I9885e, b/495805998, b/495805998)
  • androidx.xr.runtime.FieldOfView เลิกใช้งานแล้ว โปรดใช้ androidx.xr.runtime.math.FieldOfView แทน (Ia01a0, b/480233045)
  • เปลี่ยน Orbiter ให้ใช้ OrbiterAnchorPoint + VolumeOffset หรือ OrbiterPoseProvider แทน position, offset, offsetType, alignment และ elevation นอกจากนี้ยังนำพารามิเตอร์ shouldRenderInNonSpatial ออกด้วย หากนักพัฒนาแอปไม่ต้องการให้ Orbiter แสดงผลในโหมดที่ไม่ใช่เชิงพื้นที่ ก็ควรใส่ Orbiter ไว้ในคำสั่ง if และเลือก SpatialCapabilities (I9fbb3, b/462428503)
  • เพิ่มตัวปรับแต่งที่เคลื่อนย้ายได้ ตัวแก้ไขเหล่านี้ทำงานได้ดีในขณะนี้สำหรับ SpatialPanels และ SpatialExternalSurface และจะรองรับ SpatialGltfModels ในเร็วๆ นี้ด้วย อย่างไรก็ตาม เราตั้งใจที่จะรองรับฟีเจอร์เหล่านี้อย่างเต็มที่สำหรับ SubspaceComposables ทั้งหมด (I9a3cd, b/479530787, b/478935063, b/478935063)
  • นักพัฒนาแอปควรสังเกต ArDevice.state Flow เพื่อตรวจสอบ State.trackingState และปรับการแสดงผลหรือคำเตือนของแอปพลิเคชันตามความแม่นยำในการติดตาม (Ic00f0, b/445466590)
  • เปลี่ยนชื่อค่า enum HandJointType รายการแล้ว (Ifbc83, b/482670596)
  • เปลี่ยนชื่อค่าคงที่ FaceConfidenceRegion รายการแล้ว (Ia62d5, b/482670596)
  • เปลี่ยนชื่อค่าคงที่ FaceBlendShapeType รายการแล้ว (I33b8b, b/482670596)
  • เพิ่ม CreatePoseFromGeospatialPoseErrorInternal และ CreateGeospatialPoseFromPoseErrorInternal แล้ว (I4bcf1, b/482666615)
  • เปลี่ยนชื่อ DeviceTrackingMode.LAST_KNOWN เป็น SPATIAL_LAST_KNOWN (พร้อมการสำรองที่เลิกใช้งานแล้ว) เพิ่ม INERTIAL_LAST_KNOWN สำหรับการติดตาม 3DoF และเพิ่ม TRACKING_DEGRADED ไปยัง TrackingState (Ie661c, b/445466590)
  • เลิกใช้งาน GroupEntity แล้ว หากต้องการให้ Entity มีเฉพาะฟังก์ชันการทำงานของ Entity พื้นฐาน ให้เรียกใช้ Entity.create ซึ่งจะแสดงผลและอินเทอร์เฟซ Entity (I4c450, b/473867483)
  • เพิ่ม API ของ XrLog แล้ว ตั้งค่า XrLog.isEnabled เป็น true เพื่อเปิดใช้การบันทึกใน JetpackXR และใช้ XrLog.Level เพื่อตั้งค่าระดับการบันทึก (I76a1f, b/463460895, b/487378441)

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

  • เพิ่มการรองรับสถานะการติดตามอุปกรณ์ไปยังอุปกรณ์ OpenXR (I91485, b/445466590)

เวอร์ชัน 1.0.0-alpha12

25 มีนาคม 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha12 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha12 มี คอมมิตเหล่านี้

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

  • เปลี่ยน Config.augmentedObjectCategories จากรายการเป็นชุดแล้ว (I25a64, b/487376359)
  • ประเภท androidx.xr.arcore.Eye และ androidx.xr.arcore.Hand (I42438, b/449032900)
  • เพิ่มโอเวอร์โหลด Session.create เพื่ออนุญาตให้ส่งบริบท Android สำหรับการกำหนดขอบเขตทรัพยากร (I7d3fe, b/415805990, b/477386334)
  • เปลี่ยน FakeRuntimeAnchor.ANCHOR_RESOURCE_LIMIT เป็น FakeRuntimeAnchor.anchorResourceLimit (I90841, b/431992235)
  • การทำให้ TiltGesture API เป็นเวอร์ชันทดลองเนื่องจากอาจมีการเปลี่ยนแปลงหรือนำออกในอนาคต หากต้องการใช้ API นี้ ให้เลือกใช้ @ExperimentalGesturesApi (Ic9858)
  • เพิ่มความสามารถในการตั้งค่าหมวดหมู่สำหรับการติดตาม AugmentedObject ในการกำหนดค่า (I1f6e4, b/480220930)

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

  • แก้ไขบิลด์ของ Chrome โดยอัปเดตไฟล์ META-INF/services/ ด้วยตำแหน่งจริงของ PerceptionRuntimeFactory (I7a801, b/481288291)

เวอร์ชัน 1.0.0-alpha11

25 กุมภาพันธ์ 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha11 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha11 มีคอมมิตเหล่านี้

เวอร์ชัน 1.0.0-alpha10

28 มกราคม 2026

androidx.xr.arcore:arcore-*:1.0.0-alpha10 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha10 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เปิดตัว TiltGesture API ซึ่งมี Flow แบบรีแอ็กทีฟสำหรับการตรวจจับสถานะการเอียงอุปกรณ์ (ขึ้น/ลง) ที่เสถียรพร้อมความคืบหน้าของการเปลี่ยนสถานะ (Ic269f, b/448152779)
  • ตอนนี้ ARCore สำหรับ Jetpack XR ใช้กลไกการบันทึก XR Runtime แล้ว ดูข้อมูลเพิ่มเติมที่ androidx.xr.runtime.Log (l52735, b/448697662)

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

  • ตอนนี้ Geospatial.createPoseFromGeospatialPose ใช้งานได้บนอุปกรณ์ที่เปิดใช้ OpenXR แล้ว (l362c6)

เวอร์ชัน 1.0.0-alpha09

3 ธันวาคม 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha09 มีคอมมิตเหล่านี้

เวอร์ชัน 1.0.0-alpha08

19 พฤศจิกายน 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha08 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • ตอนนี้ ARCore สำหรับ Jetpack XR รองรับอุปกรณ์ที่ใช้บริการ Google Play สำหรับ AR ได้แล้ว
  • เพิ่ม Geospatial API สำหรับความพร้อมใช้งานของ VPS และการแปลงท่าทาง (I144dc)

เวอร์ชัน 1.0.0-alpha07

22 ตุลาคม 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha07 มี คอมมิตเหล่านี้

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

  • :xr:arcore:arcore-openxr เพิ่มเป็นทรัพยากร Dependency ของการติดตั้งใช้งานใน :xr:arcore:arcore (I47315, b/446999229)

เวอร์ชัน 1.0.0-alpha06

24 กันยายน 2025

androidx.xr.arcore:arcore-*:1.0.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha06 มีคอมมิตเหล่านี้

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

  • การรองรับการทดสอบสำหรับ ARCore ได้ย้ายข้อมูลไปยังโมดูล xr:arcore:arcore-testing แล้ว (I25469)
  • การเพิ่ม ArDevice และ RenderViewpoint เพื่ออนุญาตให้แอปพลิเคชันดึงข้อมูลท่าทางและการกำหนดค่าการแสดงผลของอุปกรณ์เพื่อวัตถุประสงค์ในการแสดงผล (Ib7e3f)
  • เปลี่ยนชื่อ enum HandJointType ด้วยคำนำหน้า HAND_JOINT_TYPE_ (I3f7cd)
  • ย้าย HandJointType จาก xr:runtime:runtime ไปยัง xr:arcore:arcore แล้ว (Iadb9c, b/409058039)
  • ตอนนี้ Hand.State จะแสดง java.nio.FloatBuffer พร้อมท่าทางของข้อต่อในรูปแบบที่ช่วยให้เข้าถึงแอปพลิเคชันที่เน้นประสิทธิภาพได้ง่าย (I55e27)

เวอร์ชัน 1.0.0-alpha05

30 กรกฎาคม 2025

androidx.xr.arcore:arcore:1.0.0-alpha05, androidx.xr.arcore:arcore-guava:1.0.0-alpha05 และ androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha05 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha05 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่ม getPrimaryHandSide เพื่อให้นักพัฒนาแอปได้รับข้อมูลด้านข้าง (I270bd)
  • เพิ่ม API ตรวจสอบความพร้อมใช้งานของ VPS สำหรับข้อมูลเชิงพื้นที่ (I58573)
  • เพิ่ม ARCore API สำหรับ checkVpsAvailability (Idbded)
  • เพิ่มฟังก์ชันส่วนขยาย stateFlowable ลงใน :xr:arcore:arcore-rxjava3 เพื่อให้นักพัฒนา Java ใช้งาน (I083aa, b/427247794)

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

  • เปลี่ยนชื่อค่า *Mode ของการกำหนดค่าเพื่อให้สอดคล้องกับลักษณะการทำงาน (I6d247, b/414648065)
  • อาร์ติแฟกต์ ARCore หลัก (xr:arcore:arcore) จะมีเฉพาะ API แบบไม่พร้อมกันสไตล์ Kotlin เท่านั้น นักพัฒนาซอฟต์แวร์ Java สามารถใช้ไลบรารี xr:arcore:arcore-rxjava3 เพื่อเข้าถึง API ที่เข้ากันได้ (Ia525e, b/422794329)
  • อาร์ติแฟกต์ ARCore หลัก (xr:scenecore:scenecore) จะมีเฉพาะ API แบบไม่พร้อมกันสไตล์ Kotlin เท่านั้น นักพัฒนาซอฟต์แวร์ Java สามารถใช้ไลบรารี xr:arcore:arcore-guava เพื่อเข้าถึง API ที่เข้ากันได้ (Iffcb4, b/422773524)
  • เพิ่ม Anchor.persistAsync() ลงใน AnchorGuava เพื่อให้นักพัฒนาซอฟต์แวร์ Java ใช้งาน (I4af1c, b/425984631)
  • เพิ่ม Earth.createAnchorOnSurfaceAsync(Session, Double, Double, Double, Quaternion, Surface) ลงใน EarthGuava เพื่อให้นักพัฒนาซอฟต์แวร์ Java ใช้งาน (I66357, b/425992992)
  • นักพัฒนาแอป Java จะใช้ฟังก์ชันส่วนขยายสำหรับ GltfModel.createAsync ใน GltfModel.kt ระบบจะลบฟังก์ชัน Async ใน GltfModel (I0af60)
  • ตอนนี้ไลบรารีนี้ใช้คำอธิบายประกอบ Nullness ของ JSpecify ซึ่งเป็นการใช้ประเภท นักพัฒนา Kotlin ควรใช้อาร์กิวเมนต์คอมไพเลอร์ต่อไปนี้เพื่อบังคับใช้การใช้งานที่ถูกต้อง: -Xjspecify-annotations=strict (นี่เป็นค่าเริ่มต้นที่เริ่มตั้งแต่เวอร์ชัน 2.1.0 ของคอมไพเลอร์ Kotlin) (Ia8420, b/326456246)
  • เพิ่มฟังก์ชันส่วนขยาย subscribeAsFlowable ลงใน :xr:arcore:arcore-rxjava3 เพื่อให้นักพัฒนา Java ใช้งาน (Id3e49, b/427277298)

เวอร์ชัน 1.0.0-alpha04

7 พฤษภาคม 2025

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

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

  • โปรเจ็กต์ที่เผยแพร่ด้วย Kotlin 2.0 ต้องใช้ KGP 2.0.0 ขึ้นไปจึงจะใช้งานได้ (Idb6b5)
  • ย้าย TrackingState และ HandJointType จาก ARCore ไปยังรันไทม์แล้ว
  • Hand.State.isActive (boolean) เปลี่ยนเป็น Hand.State.trackingState (androidx.xr.runtime.TrackingState) แล้ว
  • Anchor.load จะแสดงผล Anchor.AnchorLoadInvalidUuid หาก UUID ไม่ถูกต้อง

เวอร์ชัน 1.0.0-alpha03

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

androidx.xr.arcore:arcore:1.0.0-alpha03 เปิดตัวโดยไม่มีการเปลี่ยนแปลงที่สำคัญนับตั้งแต่เวอร์ชันอัลฟาล่าสุด เวอร์ชัน 1.0.0-alpha03 มีคอมมิตเหล่านี้

เวอร์ชัน 1.0.0-alpha02

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

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

ฟีเจอร์ใหม่

  • เพิ่มการรองรับการติดตามการเคลื่อนไหวของมือ ใช้ Hand.left และ Hand.right เพื่อเข้าถึงข้อมูลการติดตาม
  • ตอนนี้ API ที่สร้าง Anchor (Anchor.create, Anchor.load, Plane.createAnchor) จะแสดงผล AnchorCreateResult และใช้ AnchorCreateResourcesExhausted อย่างถูกต้อง

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

  • Anchor.detach ไม่ทำให้เกิดข้อขัดข้องร้ายแรงเนื่องจากภาวะแข่งขันกับเทรดการอัปเดตเซสชันอีกต่อไป
  • Anchor.create มีความเสถียรมากกว่าเมื่อทำงานในโปรแกรมจำลอง

เวอร์ชัน 1.0.0-alpha01

12 ธันวาคม 2024

androidx.xr.arcore:arcore-* 1.0.0-alpha01 เผยแพร่แล้ว

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

ไลบรารี ARCore สำหรับ Jetpack XR ได้รับแรงบันดาลใจจากไลบรารี ARCore ที่มีอยู่ โดยมีความสามารถในการผสมผสานเนื้อหาดิจิทัลเข้ากับโลกจริง ไลบรารีนี้ประกอบด้วยการติดตามการเคลื่อนไหว, Anchor แบบถาวร, การทดสอบตัวชี้ และการระบุระนาบด้วยการติดป้ายกำกับเชิงความหมาย (เช่น พื้น ผนัง และโต๊ะ) ดูคู่มือนักพัฒนาซอฟต์แวร์เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการทำงานกับ ARCore สำหรับ Jetpack XR

  • Session: ARCore สำหรับ Jetpack XR ใช้ Jetpack XR Runtime เบื้องหลังเพื่อขับเคลื่อนฟังก์ชันการทำงาน คุณจะใช้เซสชันเพื่อโต้ตอบกับ API ส่วนใหญ่ของ ARCore สำหรับ Jetpack XR ดังนั้นโปรดดูเอกสารประกอบของเซสชัน

  • Plane: ใช้ระนาบเพื่อทำความเข้าใจโลกรอบตัวคุณ เครื่องบินแต่ละลำมี Label ที่อธิบายความหมายของเครื่องบิน คุณสามารถใช้ subscribe เพื่อรับการแจ้งเตือนเกี่ยวกับเครื่องบินที่ตรวจพบล่าสุด หรือใช้ state เพื่อรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงของเครื่องบินที่เฉพาะเจาะจง

  • Anchor: ลิงก์ระหว่างวัตถุเสมือนกับสถานที่ในโลกจริง คุณสามารถแนบ Anchor กับตำแหน่งที่เฉพาะเจาะจงในพื้นที่ (โดยใช้ create) หรือ Trackable (โดยใช้ createAnchor)

    • คุณสามารถใช้ Anchor ซ้ำในเซสชันต่างๆ ได้ คุณสามารถใช้ persist เพื่อจัดเก็บ getPersistedAnchorUuids เพื่อแจกแจง และ load เพื่อดึงข้อมูล อย่าลืมunpersistเมื่อไม่ได้ใช้งานแล้ว

    • Anchor ทำงานร่วมกันได้ระหว่าง ARCore สำหรับ Jetpack XR และ Jetpack SceneCore คุณสามารถสร้าง AnchorEntity โดยใช้ Anchor หรือหากมี AnchorEntity อยู่แล้ว ก็สามารถใช้ getAnchor เพื่อดึงข้อมูล Anchor ที่รองรับได้

    • นำเสนอการโต้ตอบของผู้ใช้ที่เป็นธรรมชาติโดยใช้ hitTest hitTest ใช้ Ray เพื่อระบุเนื้อหาที่ตัดกันและสร้าง Anchor จากตำแหน่งนั้น ลองทำการทดสอบ HitTest จาก InputEvent

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

  • อาจมีความล่าช้าระหว่างการเรียก unpersist และการนำ UUID ออกจากผลลัพธ์ที่แสดงโดย getPersistedAnchorUuids

  • create จะไม่ตรวจสอบว่าระบบมีทรัพยากรเพียงพอที่จะแสดง Anchor ใหม่หรือไม่ การสร้าง Anchor มากเกินไปอาจทำให้แอปขัดข้อง

  • ขณะนี้ระบบยังไม่รองรับการคงอยู่ของ Anchor ที่เคยคงอยู่และไม่คงอยู่ก่อนหน้านี้

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

  • ในบางกรณี ระบบอาจแสดง RuntimeException อย่างไม่ถูกต้องเมื่อเรียกใช้ persist พร้อมข้อความ "Anchor was not persisted" ในกรณีดังกล่าว ฟังก์ชันจะยังคงทำงานได้สำเร็จและระบบจะคง Anchor ไว้ เราขอแนะนำให้รวมการเรียกใช้ persist ด้วยบล็อก try เป็นวิธีแก้ปัญหาชั่วคราว