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
- เปิดตัว
SpatialAnnotationAPI สำหรับติดตามเรขาคณิตและวัตถุทางกายภาพแบบ 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)- เพิ่ม
QrCodeAPI (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)
การมีส่วนร่วมจากภายนอก
- เพิ่ม
AugmentedImageAPI สำหรับการติดตามเครื่องหมายที่กำหนดเอง (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.stateFlow เพื่อตรวจสอบ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) - การทำให้
TiltGestureAPI เป็นเวอร์ชันทดลองเนื่องจากอาจมีการเปลี่ยนแปลงหรือนำออกในอนาคต หากต้องการใช้ 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 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เปิดตัว
TiltGestureAPI ซึ่งมี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 ที่รองรับได้นำเสนอการโต้ตอบของผู้ใช้ที่เป็นธรรมชาติโดยใช้
hitTesthitTest ใช้Rayเพื่อระบุเนื้อหาที่ตัดกันและสร้างAnchorจากตำแหน่งนั้น ลองทำการทดสอบ HitTest จากInputEvent
ปัญหาที่ทราบ
อาจมีความล่าช้าระหว่างการเรียก
unpersistและการนำ UUID ออกจากผลลัพธ์ที่แสดงโดยgetPersistedAnchorUuidscreateจะไม่ตรวจสอบว่าระบบมีทรัพยากรเพียงพอที่จะแสดง Anchor ใหม่หรือไม่ การสร้าง Anchor มากเกินไปอาจทำให้แอปขัดข้องขณะนี้ระบบยังไม่รองรับการคงอยู่ของ Anchor ที่เคยคงอยู่และไม่คงอยู่ก่อนหน้านี้
ระบบรองรับการใช้งานในโปรแกรมจำลอง แต่ลักษณะการทำงานอาจไม่เสถียรเท่ากับการทำงานในอุปกรณ์จริง โดยเฉพาะอย่างยิ่ง การเรียกใช้
createอาจไม่สำเร็จเนื่องจากข้อผิดพลาดของโค้ดแบบเนทีฟและสิ้นสุดกิจกรรมทันทีในบางกรณี ระบบอาจแสดง
RuntimeExceptionอย่างไม่ถูกต้องเมื่อเรียกใช้persistพร้อมข้อความ "Anchor was not persisted" ในกรณีดังกล่าว ฟังก์ชันจะยังคงทำงานได้สำเร็จและระบบจะคง Anchor ไว้ เราขอแนะนำให้รวมการเรียกใช้persistด้วยบล็อกtryเป็นวิธีแก้ปัญหาชั่วคราว