Jetpack SceneCore
| อัปเดตล่าสุด | รุ่นที่เสถียร | รุ่นที่อาจได้รับการเผยแพร่ | รุ่นเบต้า | รุ่นอัลฟ่า |
|---|---|---|---|---|
| 21 ตุลาคม 2569 | 1.0.0 | - | - | 1.1.0-alpha01 |
การประกาศทรัพยากร Dependency
หากต้องการเพิ่มทรัพยากร Dependency ใน XR SceneCore คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google
เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล ดังนี้
ดึงดูด
dependencies { implementation "androidx.xr.scenecore:scenecore:1.1.0-alpha01" // Use to write unit tests testImplementation "androidx.xr.scenecore:scenecore-testing:1.1.0-alpha01" }
Kotlin
dependencies { implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01") // Use to write unit tests testImplementation("androidx.xr.scenecore:scenecore-testing:1.1.0-alpha01") }
ดูข้อมูลเพิ่มเติมเกี่ยวกับการขึ้นต่อกันได้ที่เพิ่มการขึ้นต่อกันของบิลด์
ความคิดเห็น
ความคิดเห็นของคุณช่วยเราปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากคุณพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว
ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Issue Tracker
เวอร์ชัน 1.1
เวอร์ชัน 1.1.0-alpha01
21 ตุลาคม 2569
androidx.xr.scenecore:scenecore-*:1.1.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.1.0-alpha01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่ม API การอัปเดต Mesh แบบไดนามิก (
MeshBuffer.createDynamic,MeshBuffer.updateVertexData,MeshBuffer.updateIndexDataและตัวสร้างCustomMesh.BuilderFromMeshDataแบบไดนามิก) เพื่อรองรับการอัปเดตข้อมูลจุดยอดและดัชนีที่รันไทม์ (Ia1ecb) - เพิ่มเมธอดตัวช่วย
VertexLayout.getBufferIndexเพื่อดึงข้อมูลดัชนีบัฟเฟอร์สำหรับVertexAttributeหรือVertexBufferLayoutที่ระบุได้อย่างง่ายดาย (I1a9e3) - ทำให้
CustomMesh.boundsเป็นตัวแปรเพื่อให้สามารถอัปเดตกรอบล้อมรอบแบบไดนามิกที่รันไทม์ (Ib0397) - เลื่อนระดับ API ภาพเคลื่อนไหว
glTF(GltfAnimation,GltfModelEntity.getAnimationsและGltfModelEntity.stopAllAnimations) เป็นแบบสาธารณะ/เสถียร โดยยังคงให้เมธอด setterGltfAnimation.loop เป็นแบบทดลอง และGltfAnimationStartOptionsและ start(options) เป็นแบบทดลองและเลิกใช้งานแล้ว (Iacdae) - เพิ่ม
stopAllAnimations()ลงในGltfModelEntity, ทำให้GltfAnimation.start()ไม่มีพารามิเตอร์, เพิ่มพร็อพเพอร์ตี้loopและspeedลงในGltfAnimationและเลิกใช้งานGltfAnimationStartOptions,start(options)และseekTo(Duration)(I53105) - อัปเดต API
GltfModelEntityเพื่อบันทึกIllegalStateException(โดยเฉพาะEntity.DisposedException) เมื่อเรียกใช้เอนทิตีที่ถูกกำจัด I65a76f
แก้ไขข้อบกพร่อง
- อัปเดตทรัพยากร Dependency
androidx.lifecycle:lifecycle-runtimeเป็น 2.10.0 แล้ว ต้องใช้เวอร์ชันนี้เพื่อให้การตรวจสอบ Lint ของรันไทม์วงจรที่รวมมาทำงานร่วมกับ AGP เวอร์ชัน 9.5.0-alpha04 ขึ้นไปได้ (I99bfd, b/556807521) - ปรับปรุง kdocs ที่เกี่ยวข้องกับ
AudioOutputProviderเพื่อไฮไลต์ว่าไม่ควรนำมาใช้ซ้ำกับอินสแตนซ์ExoPlayerหลายรายการ (I6b18e) - นำทรัพยากร Dependency ที่ไม่จำเป็นใน
impressออกจากโมดูล XR ต่างๆ I84636c
รุ่น 1.0
เวอร์ชัน 1.0.0
21 ตุลาคม 2569
androidx.xr.scenecore:scenecore-*:1.0.0 เผยแพร่แล้ว เวอร์ชัน 1.0.0 มีคอมมิตเหล่านี้
ฟีเจอร์หลักของ 1.0.0:
- Jetpack XR SceneCore พร้อมให้ใช้งานอย่างเสถียรแล้ว SceneCore ช่วยให้คุณวางและจัดเรียงเนื้อหา 3 มิติ ซึ่งกำหนดโดยเอนทิตี โดยสัมพันธ์กันและสัมพันธ์กับสภาพแวดล้อมของคุณ SceneCore ช่วยให้คุณสร้าง วาง และจัดการแผง 2 มิติและโมเดล 3 มิติในฉากเสมือนจริงและฉากเทคโนโลยีความจริงแบบผสม (MR) ระบุสภาพแวดล้อมเชิงพื้นที่และแหล่งที่มาของเสียงรอบทิศทาง รวมถึงตรึงเนื้อหาเสมือนจริงไว้กับโลกจริงได้
- ดูข้อมูลเพิ่มเติมได้ที่หน้าภาพรวมและเอกสารอ้างอิง API
เวอร์ชัน 1.0.0-rc02
7 ตุลาคม 2026
androidx.xr.scenecore:scenecore-*:1.0.0-rc02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-rc02 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาหน่วยความจำรั่วไหลที่อาจเกิดขึ้นโดยนำ
perceptionRuntimeCacheในSessionExtออก และเปลี่ยนโครงสร้างภายในโค้ดเพื่อดึงข้อมูลPerceptionRuntimeจากอินสแตนซ์Sessionโดยตรง (Ie35b1) - แก้ไขการรั่วไหลของบริบทที่อาจเกิดขึ้นโดยใช้
applicationContextสำหรับแฮนเดิลเนทีฟOpenXRเพื่อให้รันไทม์เนทีฟไม่เก็บการอ้างอิงไปยังบริบทActivity(Ie35b1) - แก้ไขภาวะแข่งขันใน
XrInstanceManagerโดยใช้การซิงค์และการล็อกการเริ่มต้นที่เหมาะสม (Ie35b1) - แก้ไข
ReferenceCleanerเพื่อรองรับการยกเลิกการลงทะเบียนการดำเนินการล้างข้อมูล และตรวจสอบว่าการดำเนินการล้างข้อมูลEntityทำงานอย่างชัดเจนในระหว่างdispose()เพื่อป้องกันการดำเนินการซ้ำเมื่อมีการรวบรวมขยะ (Ie35b1) - แก้ไขหน่วยความจำรั่วไหลใน
SceneโดยนำsceneCacheในSessionExtออก และเปลี่ยนโครงสร้างภายในโค้ดSceneเพื่อดึงอินสแตนซ์จากsessionConnectorsโดยตรง (Ie35b1)
เวอร์ชัน 1.0.0-rc01
9 กันยายน 2026
androidx.xr.scenecore:scenecore-*:1.0.0-rc01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-rc01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่ม
xr:scenecore:scenecore-openxrลงในคลังแล้ว (Ic49f2) - นำ API ที่เลิกใช้งานแล้วหลายรายการออกก่อนการเปิดตัวเวอร์ชันเสถียร 1.0.0
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องของหน่วยความจำรั่วไหลซึ่งระบบอาจเก็บข้อมูลอ้างอิงกิจกรรมไว้เมื่อกิจกรรมถูกทำลาย (I6dcd7)
การเปลี่ยนแปลงพฤติกรรม
- นำเอาต์พุต logcat ออกจาก SceneCore (I10c3c)
เวอร์ชัน 1.0.0-beta02
12 สิงหาคม 2569
androidx.xr.scenecore:scenecore-*:1.0.0-beta02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-beta02 มีคอมมิตเหล่านี้
การแก้ไขข้อบกพร่อง
toMoveEvent()จะแสดงผลnullหากเอนทิตีหลักได้รับการเก็บขยะแล้ว (Ia7a1b)
เวอร์ชัน 1.0.0-beta01
15 กรกฎาคม 2569
androidx.xr.scenecore:scenecore-*:1.0.0-beta01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- API
GltfAnimationและSpatialGltfModelAnimationได้รับการทำเครื่องหมายว่าอยู่ระหว่างการทดสอบ พร็อพเพอร์ตี้บางรายการเปลี่ยนเป็น Getter (I8d689, b/524771027) - นำเมธอด Factory
MovableComponent.createTrackingMovableสาธารณะออกแล้ว (I00912, b/477169015) - แปลง Session.create เป็นฟังก์ชันระงับ (I5d27f)
- ตอนนี้
ActivitySpaceและAnchorSpaceขยายคลาสSpaceEntityทั่วไปซึ่งมีลักษณะการทำงานทั่วไปสำหรับเอนทิตีที่ระบบควบคุมตำแหน่ง (I506ec, b/513619219) - อัปเดต
AnchorEntityให้เรียกว่าAnchorSpace(Ifa95e, b/513619219) - มี API ทดสอบสาธารณะ
SoundEffectPoolComponentTester(I87df7, b/498104417) - เพิ่มพารามิเตอร์
cornerRadiusที่ไม่บังคับลงในคอนสตรักเตอร์SurfaceEntity.Shape.Quadและทำให้พร็อพเพอร์ตี้cornerRadiusเป็นแบบสาธารณะ ตอนนี้นักพัฒนาแอปสามารถระบุรัศมีมุมเมื่อสร้างรูปทรงสี่เหลี่ยมเพื่อแสดงผล CanvasSurfaceEntityที่มีมุมโค้งมน และค้นหารัศมีของสี่เหลี่ยมที่มีอยู่ได้ (Ia7809, b/474681085) - มี API ทดสอบสาธารณะ
SpatialAudioTrackBuilderTester,SpatialAudioTrackTesterและSceneCoreTestRule.getTesterโอเวอร์โหลด (I378c6, b/496333938) - เพิ่มการลบล้างเฉพาะทางของ
toString()สำหรับประเภท ARCore จำนวนหนึ่ง ประเภทเหล่านี้มีไว้เพื่อให้ข้อมูลเพิ่มเติมแก่นักพัฒนาซอฟต์แวร์เพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่อง และไม่ได้มีไว้เพื่อใช้ในเวอร์ชันที่ใช้งานจริงหรือแอปพลิเคชันที่จัดส่ง
เวอร์ชัน 1.0.0-alpha16
17 มิถุนายน 2026
androidx.xr.scenecore:scenecore-*:1.0.0-alpha16 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha16 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่มโอเวอร์โหลดสำหรับ
addVertexData,setIndexDataและaddSubsetไปยังCustomMesh.BuilderFromMeshDataและCustomMesh.BuilderFromMeshBufferโอเวอร์โหลดเหล่านี้ช่วยให้นักพัฒนาแอปส่งข้อมูลดิบและพารามิเตอร์ได้โดยตรง (เช่นByteBuffer,offset,size,topology,indexOffset,indexCount) โดยไม่ต้องรวมไว้ในออบเจ็กต์สื่อกลาง เช่นByteBufferRegionหรือMeshSubset(I84d5c) Scene.requestFullSpaceMode()และScene.requestHomeSpaceMode()เปลี่ยนชื่อเป็นrequestFullSpace()และrequestHomeSpace()ตามลำดับ เมธอดและเอกสารประกอบอื่นๆ ที่อ้างอิงถึง "Home Space Mode" และ "Full Space Mode" ได้รับการอัปเดตในลักษณะเดียวกัน (I45751)- มี API ทดสอบสาธารณะ
PanelEntityTesterและMainPanelEntityTester(I961e4) - กำลังเพิ่มพร็อพเพอร์ตี้
pointSourceParamsไปยังSoundEffectPoolComponent(I4a750) - มี API ทดสอบสาธารณะ
MovableComponentTester(I0c972) - มี API ทดสอบสาธารณะ
PointerCaptureComponentTester(Ic0d4f) - มี API ทดสอบสาธารณะ
ActivityPanelEntityTester(I837c4) - มี API ทดสอบสาธารณะ
ResizableComponentTester(I0a3a4) - มี API ทดสอบสาธารณะ
BoundsComponentTester.(Iefd53) - มี API ทดสอบสาธารณะ
SpatialMediaPlayerTester(Ia3e09) - มี API ทดสอบสาธารณะ
SpatialEnvironmentTester(Icf60f) - มี API ทดสอบสาธารณะ
GltfModelTesterและSceneCoreTestRule.getGltfModelTester(I33fcb) - มี API ทดสอบสาธารณะ
InteractableComponentTester(Ia7096) - มี API ทดสอบสาธารณะ
SurfaceEntityTester(Ic0740) - มี API ทดสอบสาธารณะ
GltfModelEntityTester,TestGltfModelNodeและTestGltfAnimation(I72c4d) - มี API ทดสอบสาธารณะ
SceneTesterและSceneCoreTestRule.sceneTester(Ib4ec5) - มี API ทดสอบสาธารณะ
PerceptionSpaceTesterและSceneCoreTestRule.perceptionSpaceTester(Icf739) - มี API ทดสอบสาธารณะ
MeshEntityTester(I63801) - ให้ API ทดสอบสาธารณะ
ImageBasedLightingAssetTesterและSceneCoreTestRule.getTesterโอเวอร์โหลด (I57ec4) - มี API ทดสอบสาธารณะ
TextureTester(Ia865b) - มี API ทดสอบสาธารณะ
PositionalAudioComponentTester(Icd96e) - มี API ทดสอบสาธารณะ
SpatialSoundPoolTester(Ia3531) - มี API ทดสอบสาธารณะ
SoundEffectPoolTester(If349a) - มี API ทดสอบสาธารณะ
ActivitySpaceTesterและSceneCoreTestRule.activitySpaceTester(I2d5c2) - มี API ทดสอบสาธารณะ
SpatialWindowTester(I41837) - มี API ทดสอบสาธารณะ
AnchorEntityTester(I68404) - มีอินเทอร์เฟซ API ทดสอบสาธารณะ
SceneCoreTestRule(Ic72d3) - เพิ่มคลาส
PixelDensityและแสดงผ่านScene#virtualPixelDensityเพื่อให้อัตราส่วนพิกเซลต่อเมตรตามฮาร์ดแวร์สำหรับการแมปมิติทางกายภาพที่แม่นยำในActivitySpace(I0e3ac) - เพิ่ม API สาธารณะสำหรับการสร้างและแสดงผลเมชที่กำหนดเอง (I7ad2f)
VertexLayoutAPI ได้รับการอัปเดตให้ใช้รายการVertexBufferLayoutโดยที่VertexBufferLayoutแต่ละรายการจะอธิบายแอตทริบิวต์ภายในบัฟเฟอร์จุดยอดเดียว ซึ่งช่วยให้จัดเรียงข้อมูล Vertex ได้ยืดหยุ่นมากขึ้น รวมถึงแอตทริบิวต์ที่สลับกันซึ่งมีระยะก้าวและออฟเซ็ตที่กำหนดเอง (Ic426b)- ให้
MovableComponent.createTrackingMovableเพื่อเปลี่ยน ARCore Trackable เป็นท่าทางที่สัมพันธ์กับพื้นที่กิจกรรม (I12249) - อัปเดตค่าเริ่มต้นสำหรับผู้ปกครองใน
Entity.createเป็น Null แล้ว (Ic3145) Entityได้รับการอัปเดตให้เป็นคลาสแทนอินเทอร์เฟซ และตอนนี้เป็นคลาสพื้นฐานสำหรับประเภทเอนทิตีทั้งหมด ระบบนำBaseEntityออกแล้วเนื่องจากการเปลี่ยนแปลงนี้ (I7fbc9)- ตอนนี้
GltfModel,ExrImageและImageBasedLightingAssetจะใช้AutoCloseableเพื่ออนุญาตให้จัดการทรัพยากรตามสำนวนโดยใช้บล็อกuseของ Kotlin (I1ac79) - เปิดตัวคลาส
ImageBasedLightingAssetเพื่อแทนที่ExrImageสำหรับการกำหนดแสงสภาพแวดล้อมเชิงพื้นที่ExrImageเลิกใช้งานแล้วและนำออกจาก API สาธารณะแล้วSpatialEnvironmentPreferenceได้รับการอัปเดตให้ใช้ImageBasedLightingAssetแล้ว (I6c92a) - เปลี่ยนชื่อพารามิเตอร์
skyboxในSpatialEnvironmentเป็นimageBasedLightingAssetเพื่อให้สอดคล้องกับวัตถุประสงค์มากขึ้น และชี้แจงว่าควรใส่พื้นผิว Skybox ที่มองเห็นได้ในพารามิเตอร์เรขาคณิต (I24d4a) - ตอนนี้เอนทิตีเชิงพื้นที่จะใช้ความหนาแน่นของอุปกรณ์ที่เสถียรสำหรับการคำนวณพิกเซลต่อเมตรใน Spatial API ระดับ 1 และ 2 เพื่อให้มั่นใจว่าขนาดจะสอดคล้องกันไม่ว่าความหนาแน่นของการแสดงผลของระบบจะเปลี่ยนแปลงไปอย่างไร (I37051)
เวอร์ชัน 1.0.0-alpha15
19 พฤษภาคม 2026
androidx.xr.scenecore:scenecore-*:1.0.0-alpha15 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha15 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้เราได้นำ
Entity.dispose()ออกจาก API สาธารณะแล้ว แทนที่จะเรียกใช้dispose()ในอินสแตนซ์ Entity แอปสามารถทำให้อินสแตนซ์ล้างได้โดยตั้งค่าparentเป็นnullและล้างการอ้างอิงที่เข้มงวดไปยังอินสแตนซ์เหล่านั้น (I396c9) - ลบวิธีการ
set/clearOnLoadCompleteListenerของSoundEffectPoolแล้ว โปรดใช้add/removeLoadCompleteListenerแทน (Iae78d) set/clearSpatialVisibilityChangedListenerของฉากถูกแทนที่ด้วยadd/removeSpatialVisibilityChangedListener(I67dff)- เมธอด SceneCore
add/removeOnFooListenerทั้งหมดเปลี่ยนชื่อเป็นadd/removeFooListenerโดยนำOnออกจากชื่อ (Ibe50b) - ระบบได้แทนที่เมธอด
AnchorEntity.setOnOriginChangedListenerและAnchorEntity.setOnStateChangedListenerด้วยเมธอดadd/removeFooListenerเพื่อรองรับ Listener หลายรายการพร้อมกัน (I13749) - เปลี่ยนชื่อ
AnchorEntity.State.TIMEDOUTเป็นState.TIMED_OUTแล้ว (Id2b8d) - Component API ได้รับการเปลี่ยนโครงสร้างภายในโค้ดเพื่อเพิ่มความปลอดภัยและความสามารถในการขยาย ตอนนี้
Componentเป็นคลาส Abstract แล้ว ตอนนี้เมธอดonAttach()และonDetach()เป็นprotectedเพื่อป้องกันการเรียกโดยตรง โปรดใช้Entity.addComponent()และEntity.removeComponent()เพื่อจัดการวงจรของคอมโพเนนต์ (Id04e8) - ย้ายข้อมูลค่าคงที่
PlaneSemanticTypePlaneOrientationของ SceneCore จาก Int เป็นประเภทที่กำหนดเองแล้ว ระบบจะนำค่าคงที่ANYออก ไคลเอ็นต์ควรแจกแจงค่าคงที่ที่ต้องการทั้งหมดอย่างชัดเจนแทน หรือใช้ค่าคงที่ Set แบบเปลี่ยนแปลงไม่ได้.ALLใหม่ ตอนนี้เมธอดแฟกทอรีAnchorEntityจะยอมรับชุดประเภทเหล่านี้แทนค่าเดียว (Ib1033) - เพิ่มการรองรับภาพเคลื่อนไหวแบบโครงกระดูก (สกินนิง) ลงใน Custom Mesh API เวอร์ชันทดลอง ตอนนี้นักพัฒนาแอปสามารถสร้างภาพเคลื่อนไหวของเมชที่กำหนดเองได้โดยระบุ
boneCountเมื่อสร้างMeshEntityและอัปเดตภาพเคลื่อนไหวแบบเรียลไทม์โดยใช้MeshEntity.setBoneTransforms()(Id8ba2, b/496692490) - เปิดตัว
CustomMeshAPI เวอร์ชันทดลอง ตอนนี้นักพัฒนาแอปสามารถสร้างและแสดงผลเรขาคณิต 3 มิติในฉากแบบเป็นโปรแกรมได้โดยใช้CustomMesh,MeshBufferและMeshEntity(I94617) - นำ
androidx.xr.scenecore.SpatializerConstants.SourceType.SOURCE_TYPE_SOUND_FIELDออกแล้ว โปรดใช้SourceType.SOUND_FIELDแทน (Ia68b9) - การเพิ่มคอมโพเนนต์เสียงรอบทิศทาง:
PositionalAudioComponent,SoundEffectPoolComponentและSoundFieldAudioComponent(Ieda89) AnchorEntity.getAnchorถูกแทนที่ด้วยAnchorEntity.anchorและตอนนี้จะแสดงผลAnchorเมื่อสร้างAnchorEntityจากAnchorของ ARCore (I5c7c8)- ค่าเริ่มต้นของพารามิเตอร์
parentในเมธอด FactoryActivityPanelEntity,GltfModelEntity,GroupEntity,PanelEntityและSurfaceEntityเปลี่ยนจากActivitySpaceเป็นnullหากต้องการแนบเอนทิตีกับกราฟฉากและแสดงผลให้มองเห็นได้ ตอนนี้นักพัฒนาแอปต้องตั้งค่าระดับบนอย่างชัดเจนระหว่างการสร้างอินสแตนซ์หรือผ่านEntity.parent = ...(Ie7cc1)
แก้ไขข้อบกพร่อง
- ตอนนี้
SceneCoreจะเรียกคืนอินสแตนซ์Entityโดยอัตโนมัติเมื่ออินสแตนซ์เหล่านั้นเข้าถึงได้แบบ Phantom ซึ่งช่วยให้นักพัฒนาแอปไม่ต้องเรียกใช้dispose()อย่างชัดแจ้งเพื่อเพิ่มพื้นที่ว่างในทรัพยากร นักพัฒนาแอปควรทำดังนี้เพื่อให้แน่ใจว่าอินสแตนซ์ [Entity] ได้รับการเรียกคืนอย่างถูกต้อง- แยกออกจากกราฟฉากโดยตั้งค่า
parentเป็นnull - สละการอ้างอิงที่ชัดเจนทั้งหมดไปยังอินสแตนซ์ในโค้ด
- หมายเหตุเกี่ยวกับประเภทเอนทิตีพิเศษ: สำหรับเอนทิตีที่ไม่มีระดับบนสุด (เช่น
AnchorEntity) นักพัฒนาแอปต้องรักษาการอ้างอิงที่รัดกุมขณะที่อินสแตนซ์มีการใช้งานอยู่ หากมีการปล่อยการอ้างอิงทั้งหมด อินสแตนซ์เหล่านี้จะกลายเป็น Phantom ที่เข้าถึงได้และจะได้รับการเรียกคืนโดยอัตโนมัติ (I83fe4)
- แยกออกจากกราฟฉากโดยตั้งค่า
- จำกัดกฎการเก็บรักษา Proguard สำหรับไลบรารี
SceneCoreทั้งหมด (I98447)
ปัญหาที่ทราบ
- การแนบ
PositionalAudioComponentกับEntityที่มีอินสแตนซ์ExoPlayerที่ไม่ได้ใช้งานจะทำให้เกิดข้อขัดข้อง อย่าเรียกใช้setPointSourceParamsหรือแนบ/ถอดคอมโพเนนต์เสียงรอบทิศทางขณะที่ ExoPlayer หยุดทำงาน ปัญหานี้จะได้รับการแก้ไขในรุ่นถัดไป
เวอร์ชัน 1.0.0-alpha14
6 พฤษภาคม 2026
androidx.xr.scenecore:scenecore-*:1.0.0-alpha14 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha14 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
TrackingStateและVpsAvailabilityResultได้ย้ายไปที่androidx.xr.arcore packageแล้ว และประเภทในandroidx.xr.runtimeเลิกใช้งานแล้ว (Ic7930, b/480462213)- เปลี่ยนชื่อ
Plane.Typeเป็นPlaneTypeแล้ว (I8c90c, b/482675376) - เปลี่ยนชื่อ
Plane.Labelเป็นPlaneLabelแล้ว (Ic6b67, b/482675376) androidx.xr.runtime.FieldOfViewเลิกใช้งานแล้ว โปรดใช้androidx.xr.runtime.math.FieldOfViewแทน (Ia01a0, b/480233045)Matrix4.poseเปลี่ยนชื่อเป็นMatrix4.toPose()แล้ว เลิกใช้งานพร็อพเพอร์ตี้ท่าทางแล้ว (I329b4, b/493383490)- เปลี่ยนชื่อค่า enum
HandJointTypeรายการแล้ว (Ifbc83, b/482670596) - แสดง
Component.onAttachและonDetachเป็น API สาธารณะเพื่อให้ใช้Componentที่กำหนดเองได้ (I0ca1f) - การเพิ่มคอมโพเนนต์เสียงรอบทิศทาง (I39ddd, b/489421980, b/436642086, b/436642499)
- นำเอนทิตีออกจาก
PointSourceParamsแต่จะใช้ Entity โดยตรงกับSpatialAudioTrack,SpatialSoundPoolและSpatialMediaPlayerแทน (Ib3685, b/489421980, b/436634048) - เปลี่ยนชื่อ
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)
แก้ไขข้อบกพร่อง
- ตอนนี้
Scene.keyEntityจะใช้mainPanelEntityเป็นค่าเริ่มต้น (I6a3ef)
เวอร์ชัน 1.0.0-alpha13
25 มีนาคม 2026
androidx.xr.scenecore:scenecore-*:1.0.0-alpha13 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha13 มี คอมมิตเหล่านี้
การเปลี่ยนแปลง API
- นำแฟล็ก
unscaledGravityAlignedActivitySpaceออกจากSession.createแล้ว ตอนนี้ActivitySpaceจะไม่มีการปรับขนาดและจัดแนวตามแรงโน้มถ่วงเสมอ (If6f11, b/458173423) - นำฟังก์ชัน
setMaterialOverrideและclearMaterialOverrideที่เลิกใช้งานแล้วออกจากGltfModelEntityซึ่งตอนนี้จะเรียกใช้ในGltfModelNodeแต่ละรายการ (I2e5d2) - เพิ่ม
transformPixelCoordinatesToLocalPositionและtransformNormalizedCoordinatesToLocalPositionลงในPanelEntityและนำเมธอดทดลองที่เทียบเท่าซึ่งเคยแสดงผลท่าทางแทนตำแหน่งVector3ออก (Ib6960, b/460123106, b/458333591) - เพิ่ม
GltfAnimationAPI สำหรับควบคุมภาพเคลื่อนไหว glTF ในSceneCore(I2c172, b/466065486, b/465819070, b/465818617) - เปลี่ยนชื่อ
ScenePose.activitySpacePoseเป็นScenePose.poseInActivitySpace(I8f175, b/427822261) - เพิ่มการติดตั้งใช้งานรันไทม์ที่คาดการณ์ไว้ของ Scenecore (I9c4ab, b/476440158)
- เมื่อปรับขนาดเอนทิตีแผงหลัก เอนทิตีอาจเปลี่ยนตำแหน่งไปที่จุดเริ่มต้น
ActivitySpaceไม่มีวิธีแก้ปัญหาอื่นนอกจากการเปลี่ยนตำแหน่งแผงกลับไปยังตำแหน่งเดิมด้วยตนเองหรือโดยใช้โปรแกรม เราจะแก้ไขข้อบกพร่องนี้ในรุ่นต่อๆ ไป (b/489427007) - ในบางกรณี ความสามารถในการจ่ายสำหรับ
MovableComponentอาจไม่ปรากฏสำหรับSurfaceEntityและประเภทเอนทิตีอื่นๆ ที่ไม่ใช่แผง การตั้งค่าMovableComponent.sizeอย่างชัดเจนจะทำให้ความสามารถในการดำเนินการปรากฏขึ้น ข้อบกพร่องนี้จะได้รับการแก้ไขในรุ่นต่อๆ ไป (b/490983469)
เวอร์ชัน 1.0.0-alpha12
25 กุมภาพันธ์ 2026
androidx.xr.scenecore:scenecore-*:1.0.0-alpha12 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha12 มี คอมมิตเหล่านี้
ปัญหาที่ทราบ
- เอนทิตีที่ตรึงไว้อาจดีดตัวจากตำแหน่งที่ตรึงไว้ไปยังจุดเริ่มต้นของพื้นที่กิจกรรมหลังจากผ่านไปหลายวินาที
- แอปอาจขัดข้องเมื่อสร้างอินสแตนซ์
SurfaceEntityรายการ ปัญหานี้ได้รับการแก้ไขแล้วในandroidx.xr.scenecore:scenecore-*:1.0.0-alpha13และรุ่นต่อๆ ไป แอปที่ได้รับผลกระทบควรอัปเดตเป็นเวอร์ชันล่าสุด
การเปลี่ยนแปลง API
ActivitySpace.addOnSpaceUpdatedListenerและActivitySpace.removeOnSpaceUpdatedListenerเปลี่ยนชื่อเป็นaddOnOriginChangedListenerและremoveOnOriginChangedListenerแล้วAnchorEntity.setOnSpaceUpdatedListenerเปลี่ยนชื่อเป็นsetOnOriginChangedListenerแล้ว (I5d8fb)- เพิ่มพร็อพเพอร์ตี้ชื่อสาธารณะลงใน
FakeEntityและทำให้มุมมองเป็นสาธารณะในFakePanelEntity(Ifa1f9)
แก้ไขข้อบกพร่อง
- แก้ไขการคำนวณความหนาแน่นของพิกเซลในอิมเมจระบบที่ใหม่กว่า (I57d04)
เวอร์ชัน 1.0.0-alpha11
28 มกราคม 2026
androidx.xr.scenecore:scenecore-*:1.0.0-alpha11 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha11 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เปลี่ยนชื่อ
PerceivedResolutionResult.InvalidCameraViewเป็นPerceivedResolutionResult.InvalidRenderViewpointเนื่องจากตอนนี้getPerceivedResolutionAPI อาศัยRenderViewpointAPI ของ ARCore แทนCameraViewScenePoseชื่อนี้สะท้อนถึงการใช้งานใหม่ได้ดียิ่งขึ้น (I8c967, b/446989745, b/419311998) - ตอนนี้เมธอด
PanelEntity/SurfaceEntity.getPerceivedResolutionจะใช้RenderViewpointที่นักพัฒนาแอปให้มาเป็นอาร์กิวเมนต์ ก่อนหน้านี้ รันไทม์จะเลือกRenderViewpointที่ใช้ในการคำนวณความละเอียดที่รับรู้โดยพลการ (I8c967, b/446989745, b/419311998) - นำ
SpatialUser,ScenePose.HeadและScenePose.CameraViewออกแล้ว ฟังก์ชันการทำงานของ API เหล่านี้ครอบคลุมโดย APIArDeviceและRenderViewpointภายใน ARCore สำหรับ Jetpack XR หากต้องการรับScenePoseที่สอดคล้องกับศีรษะหรือตาซ้ายหรือตาขวาของผู้ใช้ นักพัฒนาแอปสามารถใช้PerceptionSpace.getScenePoseFromPerceptionPoseกับท่าทางที่เหมาะสมซึ่งได้มาโดยใช้ ARCore API (I2f69c, b/446989745)
เวอร์ชัน 1.0.0-alpha10
3 ธันวาคม 2025
androidx.xr.scenecore:scenecore-*:1.0.0-alpha10 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha10 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่ม
transformPixelCoordinatesToPoseและtransformNormalizedCoordinatesToPoseไปยังPanelEntity(I462b3) แล้ว - เพิ่มคลาสตัวช่วย Utils ลงในรันไทม์
SceneCoreโดยอิงตามตรรกะในSceneCore(I570b9)
แก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องที่อาจเกิดขึ้นเมื่อเซสชันถูกทำลายและได้รับ
SpatialModeChangeEvent(If44e8) - แก้ไขข้อบกพร่องที่อาจทำให้เกิด
IllegalStateExceptionเมื่อออกจากหรือกลับเข้าสู่กิจกรรม (Ibff1c)
เวอร์ชัน 1.0.0-alpha09
19 พฤศจิกายน 2025
androidx.xr.scenecore:scenecore-*:1.0.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha09 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่ม API สำหรับดึงข้อมูล
ScenePoseซึ่งแสดงถึงองค์ประกอบของท่าทางต้นทางของพื้นที่การรับรู้และท่าทางที่เกี่ยวข้องกับต้นทางของพื้นที่การรับรู้ (I5b50a) - เพิ่มฟังก์ชัน
getGravityAlignedPoseแล้ว ท่าทางที่สอดคล้องกับแรงโน้มถ่วงจะไม่สนใจการหมุนแบบพิตช์และโรล (I5ae21) - ประเภทค่าคงที่
AnchorEntity.Stateรายการเปลี่ยนจาก Ints เป็นประเภทย่อยของ State (Ib0c49) - เพิ่ม
getChildren()ไปยังอินเทอร์เฟซเอนทิตีแล้ว อัปเดตวงจรMainPanelEntityแล้ว (Ia69d6)
การเปลี่ยนแปลง API
- เปลี่ยนประเภทค่าคงที่
PointerCaptureComponent.PointerCaptureStateรายการจาก Ints เป็นประเภทย่อยPointerCaptureState(Ic888a) - ตอนนี้
Scene.spatialCapabilitiesเป็นประเภทSet<SpatialCapability>แทนที่จะเป็นช่อง Int เปลี่ยนชื่อค่าคงที่SpatialCapabilityแล้ว (I9c109) - ประเภทค่าคงที่
SurfaceEntityได้รับการเปลี่ยนชื่อและเปลี่ยนจาก Int เป็นประเภทย่อยSurfaceEntity(I419ed) - ประเภทค่าคงที่
SpatializerConstantได้รับการเปลี่ยนชื่อและเปลี่ยนจาก Int เป็นประเภทย่อยSpatializerConstant(Ia0e18) - ประเภทค่าคงที่
TextureSamplerได้รับการเปลี่ยนชื่อและเปลี่ยนจาก Int เป็นประเภทย่อยTextureSampler(I44078) - เปลี่ยนประเภทค่าคงที่
SpatialVisibilityรายการจาก Int เป็นประเภทย่อยSpatialVisibilityแล้ว (I70739) - ประเภทค่าคงที่
ResizeEvent.ResizeStateได้รับการเปลี่ยนชื่อและเปลี่ยนจาก Ints เป็นประเภทย่อยResizeState(I384d5) - ประเภทค่าคงที่
InputEventได้รับการเปลี่ยนชื่อและเปลี่ยนจาก Ints เป็นค่าที่รับค่ามาจากประเภทที่ล้อมรอบที่เกี่ยวข้อง (I82817) - เปลี่ยนประเภทค่าคงที่
GltfModelEntity.AnimationStateรายการจาก Ints เป็นประเภทย่อยAnimationState(I24f4e) - ประเภทค่าคงที่
AlphaModeได้รับการเปลี่ยนชื่อและเปลี่ยนจาก Int เป็นประเภทย่อยAlphaMode(I27b56) - เปลี่ยนประเภทค่าคงที่
Spaceจาก Int เป็นประเภทย่อยของ Space แล้ว (I9255b) - ตอนนี้
ScenePose.hitTestและเมธอดที่เกี่ยวข้องจะแสดงผลnullหากไม่พบจุดตัด แทนที่จะเป็นHitTestResultที่มีhitPositionเป็น NullHitTestResult.hitPositionไม่สามารถเป็นค่า Null ได้อีกต่อไป (I1400a) - เปลี่ยนการอ้างอิง
ActivityPoseเป็นScenePose(I7fe43)
เวอร์ชัน 1.0.0-alpha08
22 ตุลาคม 2025
androidx.xr.scenecore:scenecore-*:1.0.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha08 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เปลี่ยนชื่อ
ActivityPanelEntity.moveActivityเป็นtransferActivity(I273c5, b/430332856)
แก้ไขข้อบกพร่อง
- เพิ่ม
:xr:scenecore:scenecore-spatial-renderingและ:xr:scenecore:scenecore-spatial-coreเป็นทรัพยากร Dependency ของการติดตั้งใช้งาน:xr:scenecore:scenecore(I6ab65, b/447000520) - ระบบจะแสดงข้อยกเว้นหากมีการเข้าถึง
session.sceneหลังจากทำลายเซสชัน (I77e6f)
เวอร์ชัน 1.0.0-alpha07
24 กันยายน 2025
androidx.xr.scenecore:scenecore:1.0.0-alpha07, androidx.xr.scenecore:scenecore-guava:1.0.0-alpha07 และ androidx.xr.scenecore:scenecore-testing:1.0.0-alpha07 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha07 มี คอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เปลี่ยนชื่อ
fixedAspectRatioเป็นisFixedAspectRatioEnabledและทำให้เป็นพร็อพเพอร์ตี้บูลีน (I5c4e8, b/440588971) - ตอนนี้
ScenecoreFakes อยู่ในโมดูลxr:scenecore:scenecore-testingแล้ว (Idd951) - เปลี่ยนชื่อ
shouldAutoHideContentเป็นisAutoHideContentWhileResizingEnabledและshouldAlwaysShowOverlayเป็นisAlwaysShowOverlayEnabled(I97c36, b/432335421) - อัปเดตค่าคงที่
SceneCoreTextureSamplerเพื่อให้อ่านง่ายขึ้น เช่น ตอนนี้TextureSampler.MinFilter.LINEARเป็นTextureSampler.MIN_FILTER_LINEAR(Ib159c) - ระบบได้ผสานตัวตั้งค่า
setKeyEntityของฉากเข้ากับตัวแปรkeyEntityแล้ว การตั้งค่าkeyEntityเป็นเอนทิตีที่เคลื่อนย้ายไม่ได้ เช่นAnchorEntityจะแสดงIllegalArgumentExceptionแทนที่จะแสดงบูลีนเป็นเท็จ (I62080, b/428721695, b/422215745) - ตัวแปร
SpatialModeChangeListenerของฉากถูกแทนที่ด้วยsetSpatialModeChangedListenerโดยจะใช้Consumer<SpatialModeChangeEvent>แทนSpatialModeChangedListenerตอนนี้setSpatialModeChangedListenerสามารถรับ Executor ได้ (ไม่บังคับ) (I62080, b/428721695, b/422215745) - นำพารามิเตอร์
bundleออกจากActivityPanelEntity.startActivity(I64344, b/430332856, b/430333040) - เปลี่ยนชื่อ
SpatializerConstants.SOURCE_TYPE_BYPASSเป็นSpatializerConstants.SOURCE_TYPE_DEFAULTแล้ว (Ifc7fe, b/422215565) - เพิ่มค่าคงที่
SpatialSoundPool.PLAY_FAILEDแล้ว (Ifc7fe, b/422215565) - เพิ่มอาร์กิวเมนต์เริ่มต้นลงในเมธอด
SpatialSoundPool.playรายการแล้ว (Ifc7fe, b/422215565) - นำค่าที่แสดงผลของ Setter ใน
SpatialAudioTrackBuilderออกแล้ว (Ifc7fe, b/422215565) - การเปลี่ยนแปลง SurfaceEntity
SurfaceEntity.CanvasShapeเปลี่ยนชื่อShapeแล้วSurfaceEntity.CanvasShape.Vr180Hemisphereเปลี่ยนชื่อHemisphereแล้วSurfaceEntity.CanvasShape.Vr360Sphereเปลี่ยนชื่อSphereแล้วSurfaceEntity.EdgeFeatheringParams.SmoothFeatherเปลี่ยนชื่อRectangleFeatherแล้วSurfaceEntity.EdgeFeathingParams.SolidEdgeเปลี่ยนชื่อNoFeatheringแล้วSurfaceEntity.ContentSecurityLevelเปลี่ยนชื่อSurfaceProtectionแล้วSurfaceEntity.ContentSecurityLevel.{values}เพิ่มคำนำหน้าSURFACE_PROTECTION_แล้วSurfaceEntity.SuperSampling.{$values}เพิ่มคำนำหน้าSUPER_SAMPLING_แล้วSurfaceEntity.StereoMode.{values}เพิ่มคำนำหน้าSTEREO_MODE_แล้วSurfaceEntity.ContentColorMetadata.maxCLLเปลี่ยนชื่อmaxContentLightLevel(I7eb5f, b/422216050, b/427529950)
- เปลี่ยนชื่อ
launchActivityเป็นstartActivity(I7db90, b/430332856) - นำ
Scene.activitySpaceRootออกแล้ว โปรดใช้Scene.activitySpaceแทน (I05ee8, b/378706624, b/422215745) - เปลี่ยนชื่อ
configureBundleForFullSpaceModeLaunchและconfigureBundleForFullSpaceModeLaunchWithEnvironmentInheritedเป็นcreateBundleForFullSpaceModeLaunchและcreateBundleForFullSpaceModeLaunchWithEnvironmentInheritedตามลำดับ และย้ายไปยังไฟล์ LaunchUtils.kt เป็นเมธอดระดับบนสุดและใช้ Session เป็นพารามิเตอร์แรก (I64a2c, b/437186050) - ตอนนี้
GroupEntityfactory จะแสดงผลประเภทGroupEntityแทน Entity (I66042)
แก้ไขข้อบกพร่อง
- แสดง
IllegalStateExceptionเมื่อมีการใช้อินสแตนซ์เอนทิตีหลังจากทิ้ง (I90990, b/427314036, b/432063442)
เวอร์ชัน 1.0.0-alpha06
13 สิงหาคม 2025
androidx.xr.scenecore:scenecore:1.0.0-alpha06, androidx.xr.scenecore:scenecore-guava:1.0.0-alpha06 และ androidx.xr.scenecore:scenecore-testing:1.0.0-alpha06 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha06 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ยกเลิกการจำกัด API
BaseEntityและBaseScenePoseของSceneCore(88c0ff6)
เวอร์ชัน 1.0.0-alpha05
30 กรกฎาคม 2025
androidx.xr.scenecore:scenecore-guava:1.0.0-alpha05, androidx.xr.scenecore:scenecore-testing:1.0.0-alpha05 และ androidx.xr.scenecore:scenecore:1.0.0-alpha05 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha05 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่ม Perceived Resolution API ลงในเอนทิตีแผงและ
SurfaceEntitiesแล้ว (I118f6) - เพิ่มเมธอด Callback
PerceivedResolutionรายการลงใน Scene.kt เพื่อตรวจสอบความละเอียดที่รับรู้ของแผงหลักของกิจกรรมใน HSM (I58084) SurfaceEntity- เพิ่มการรองรับแอปพลิเคชันเพื่อขอการสุ่มตัวอย่างขั้นสูงในเวลาที่สร้าง ซึ่งจะช่วยให้แอปพลิเคชันใช้ตัวกรองการสุ่มตัวอย่างแบบซูเปอร์เพื่อลดรอยหยักได้ (I06913)- เพิ่มพร็อพเพอร์ตี้
recommendedContentBoxInFullSpaceไปยังActivitySpaceแล้ว โดยจะแสดงกล่องที่แนะนำสำหรับวางเนื้อหาเมื่ออยู่ในโหมด Full Space (I4cd6f) - ระบุตัวสร้างที่โอเวอร์โหลดสำหรับตัวแก้ไขที่เคลื่อนย้ายได้ซึ่งอนุญาตให้ทำการยึดตำแหน่ง (Ic0c70)
การเปลี่ยนแปลง API
มีการเปลี่ยนแปลง API อย่างครอบคลุมใน SceneCore สำหรับรุ่นนี้ มีการเปลี่ยนชื่อและ/หรือย้ายคลาสหลายคลาสไปยังโมดูลต่างๆ และเมธอด Getter/Setter ส่วนใหญ่ถูกแทนที่ด้วยพร็อพเพอร์ตี้ Kotlin แม้ว่าเราคาดว่าจะมีการเปลี่ยนแปลง API ที่ส่งผลกระทบในอนาคตจนกว่าจะมีการเปิดตัวเวอร์ชันเบต้าครั้งแรก แต่การเปลี่ยนแปลงดังกล่าวจะไม่ส่งผลกระทบหรือมีจำนวนมากนัก
- เปลี่ยนชื่อและ/หรือย้ายคลาสและอินเทอร์เฟซต่อไปนี้
androidx.xr.scenecore.PixelDimensionsไปยังandroidx.xr.runtime.math.IntSize2d,androidx.xr.scenecore.Dimensionsไปยังandroidx.xr.runtime.math.FloatSize3d,androidx.xr.scenecore.ActivityPoseไปยังScenePose,androidx.xr.scenecore.ContentlessEntityไปยังGroupEntity,androidx.xr.scenecore.PlaneTypeไปยังPlaneOrientation,androidx.xr.scenecore.PlaneSemanticไปยังPlaneSemanticType(Ifd405)(I3b622) (If534d) - เมธอด Setter จำนวนหนึ่งสำหรับพร็อพเพอร์ตี้ของ
Sceneได้รับการกำหนดให้เป็นแบบส่วนตัว เนื่องจากไม่ได้มีไว้เพื่อให้ไคลเอ็นต์SceneCoreเปลี่ยนแปลงค่า ซึ่งได้แก่activitySpace,activitySpaceRoot,mainPanelEntity,perceptionSpace,spatialCapabilities,spatialEnvironmentและspatialUser(I2f506) - ใน Entity: เปลี่ยนพร็อพเพอร์ตี้ต่อไปนี้:
get/setParent(),setContentDescriptionเลิกใช้งานEntity.is/setHidden()แล้ว ให้ใช้Entity.is/setEnabledแทน (Ibc4c6) - นำคลาส
androidx.xr.scenecore.BasePanelEntityออกแล้ว ให้ใช้PanelEntityโดยตรงแทน แทนที่ Getter และ Setter สำหรับPanelEntityด้วยพร็อพเพอร์ตี้ เปลี่ยนพร็อพเพอร์ตี้PanelEntity.sizeจากFloat3dSizeเป็นFloat2dSizeแล้ว นำเมธอดandroidx.xr.scenecore.PanelEntity.getPixelDimensionsที่เลิกใช้งานแล้วออก ให้ใช้getSizeInPixelsแทน (Icc174) - แทนที่
androidx.xr.scenecore.OnSpaceUpdatedListenerด้วยRunnableแล้ว (I19308) - แทนที่
SpatialUser.getCameraViews()ด้วยพร็อพเพอร์ตี้แล้ว (Ib0cc5) สำหรับExrImageและGltfModel:ได้เปลี่ยนเมธอดcreateให้เป็นฟังก์ชันระงับ แก้ไขพารามิเตอร์การสร้างให้ยอมรับUriหรือPathแทนString(Id8883) (I0d247), (I25706) - ย้าย
SpatialEnvironment.requestFullSpaceModeและSpatialEnvironment.requestHomeSpaceModeไปยัง Scene แล้ว เช่น ใช้session.scene.requestFullSpaceMode()แทนsession.scene.spatialEnvironment.requestFullSpaceMode()ตอนนี้addOnPassthroughOpacityChangedListenerและaddOnSpatialEnvironmentChangedListenerมีการลบล้างที่ยอมรับ Executor ที่ไม่บังคับ (I12fe0) (I6b21e) - นำเมธอด
SpatialEnvironmentที่เลิกใช้งานแล้วต่อไปนี้ออก:togglePassthrough,setPassthrough,setPassthroughOpacity,getPassthroughMode,getPassthroughOpacity,setSkyboxและsetGeometryนอกจากนี้ยังนำคลาสSpatialEnvironment.PassthroughModeที่เลิกใช้งานแล้วออกด้วย (I927bd) (I927bd) (I927bd) - แทนที่เมธอด Getter และ Setter ของ
SpatialEnvironmentต่อไปนี้ด้วยพร็อพเพอร์ตี้ Kotlin:getCurrentPassthroughOpacity(),get/setPassthroughOpacityPreference(),get/setSpatialEnvironmentPreference(),isSpatialEnvironmentPreferenceActive()(I33a7b) (Ie06e2) (Ie06e2) - เปลี่ยนประเภท
SpatialEnvironmentPreference.preferredPassthroughOpacityจากFloat?เป็นFloatแล้ว ระบบไม่ยอมรับค่า Null อีกต่อไป แต่จะใช้SpatialEnvironment.NO_PASSTHROUGH_OPACITY_PREFERENCEเพื่อส่งสัญญาณว่าไม่มีค่ากำหนดความทึบแสง (I40107) - อัปเดตพารามิเตอร์
windowBoundsPxเป็นpixelDimensionsและประเภทจาก Rect เป็นIntSize2dในเมธอด create (I1926e) - ตอนนี้คอนสตรัคเตอร์
SpatialEnvironmentเป็นแบบภายในแล้ว (I75a51) - แทนที่คลาส
SpatialPointerIconNoneและคลาสSpatialPointerIconCircleด้วยออบเจ็กต์ที่ใช้ร่วมกันSpatialPointerIcon.NONEและSpatialPointerIcon.CIRCLE(I416d2) SpatialPointerIconในSpatialPointerComponentจะเป็นค่า Null ไม่ได้อีกต่อไป ใช้SpatialPointerIcon.DEFAULTแทนค่า Null เพื่อระบุว่าควรใช้ไอคอนเคอร์เซอร์ค่าเริ่มต้นของระบบ (I416d2)- แทนที่
androidx.xr.scenecore.AnchorEntity.getState()ด้วยพร็อพเพอร์ตี้แบบอ่านอย่างเดียว เปลี่ยนชื่อพารามิเตอร์ในเมธอดAnchorEntity.create()เพื่อความชัดเจน ในเมธอดของAnchorEntityสำหรับการตั้งค่าและการเพิ่ม Listener ระบบได้ย้าย Listener ไปยังอาร์กิวเมนต์สุดท้ายเพื่อเปิดใช้ Lambda ต่อท้าย แทนที่androidx.xr.scenecore.OnStateChangedListenerสำหรับAnchorEntityด้วยConsumer<AnchorEntity.State>แล้ว (I472e0) GltfModelEntity.getAnimationState()เป็นพร็อพเพอร์ตี้แล้ว (I10b29)- แทนที่
ActivitySpace.getBounds()ด้วยพร็อพเพอร์ตี้แล้ว เปลี่ยนชื่อActivitySpace.addBoundsChangedListenerเป็นActivitySpace.addOnBoundsChangedListenerแล้ว แทนที่ActivitySpace.setOnSpaceUpdatedListenerด้วยเมธอด add/remove (I4c956) AnchorPlacement: planeTypeFilterเปลี่ยนชื่อเป็นanchorablePlaneOrientationsและplaneSemanticFilterเปลี่ยนชื่อเป็นanchorablePlaneSemanticTypesการเพิ่มMovableComponentลงในAnchorEntityหรือActivitySpaceจะแสดงผลเป็นเท็จ มีการเปลี่ยนชื่อMoveListenerเป็นEntityMoveListener shouldDisposeParentAnchorมีการเปลี่ยนชื่อเป็นdisposeParentOnReAnchor systemMovableมีการนำออกจากฟังก์ชันcreateเพื่อใช้creeateCustomMovable,createSystemMovableและcreateAnchorable(If11c4)- นำ
SurfaceEntity.featherRadiusX/Yออกและเพิ่มแนวคิดคลาสEdgeFeatheringParams(Ic78fc) - แทนที่เมธอด
PanelEntity.enablePanelDepthTest()ด้วยพร็อพเพอร์ตี้panelClippingConfigตั้งค่าScene.panelClippingConfig = PanelClippingConfig(isDepthTestEnabled = true)เพื่อเปิดใช้การทดสอบความลึก หรือตั้งค่าเป็นPanelClippingConfig(isDepthTestEnabled = false)เพื่อปิดใช้ (I0cbe0) - ตอนนี้
Scene.mainPanelEntityเป็นประเภทMainPanelEntityแทนPanelEntity(I7125a) - เปลี่ยนชื่อเมธอด
setFullSpaceModeของ Scene เป็นconfigureBundleForFullSpaceModeLaunchและเมธอดsetFullSpaceModeWithEnvironmentInheritedเป็นconfigureBundleForFullSpaceModeLaunchWithEnvironmentInherited(I0cbe0) (I0cbe0) - เปลี่ยนชื่อค่า UNKNOWN, OUTSIDE_FOV, PARTIALLY_WITHIN_FOV และ WITHIN_FOV ของ
SpatialVisibilityเป็น SPATIAL_VISIBILITY_UNKNOWN, SPATIAL_VISIBILITY_OUTSIDE_FIELD_OF_VIEW, SPATIAL_VISIBILITY_PARTIALLY_WITHIN_FIELD_OF_VIEW และ SPATIAL_VISIBILITY_WITHIN_FIELD_OF_VIEW ตามลำดับ (Ie7e8c) - แทนที่คลาส
SpatialVisibilityด้วยออบเจ็กต์สาธารณะที่มีค่า Int แบบคงที่ ตอนนี้setSpatialVisibilityChangedListenerยอมรับConsumer<Int>แทนConsumer<SpatialVisibility>(Ie7e8c) - เปลี่ยนชื่อค่าคงที่
PointerCaptureComponentรายการและย้ายไปยังออบเจ็กต์PointerCaptureComponent.PointerCaptureState(I9c7ac) - แทนที่
PointerCaptureComponents' StateListenerด้วยConsumer<Int>แล้ว (I9c7ac) - แทนที่
InputEventListenerด้วยConsumer<InputEvent>(I9c7ac) setPreferredAspectRatioย้ายจากคลาส Scene ไปยังออบเจ็กต์SpatialWindowและใช้ Session เป็นพารามิเตอร์แรก (I7b717)Entity.setHidden()ถูกแทนที่ด้วยEntity.setEnabled()และEntity.isHidden()ถูกแทนที่ด้วยEntity.isEnabled()setHidden(false)เท่ากับsetEnabled(true)และisHidden() == !isEnabled()(Icf0de)- ประเภท
Entity.contentDescriptionเปลี่ยนจากสตริงเป็นCharSequence(Ie59be) - ตอนนี้
Session.createและSession.configureจะแสดงSecurityExceptionเมื่อไม่ได้รับสิทธิ์ที่เพียงพอ แทนที่จะแสดงSessionCreatePermissionsNotGrantedหรือSessionConfigurePermissionsNotGranted(I7c488) ResizableComponent.createตอนนี้ต้องใช้Consumer<ResizeEvent> ResizeEventListenerแทนที่ด้วยConsumer<ResizeEvent> ResizableComponent.sizeเปลี่ยนชื่อเป็นResizableComponent.affordanceSize ResizableComponent.minimumSizeเปลี่ยนชื่อเป็นResizableComponent.minimumEntitySize ResizableComponent.maximumSizeเปลี่ยนชื่อเป็นResizableComponent.maximumEntitySize,ResizableComponent.autoHideContentเปลี่ยนชื่อเป็นResizableComponent.shouldAutoHideContentResizableComponent.forceShowResizeOverlayเปลี่ยนชื่อเป็นResizableComponent.shouldAlwaysShowOverlay(I97a2d)- ลด
minSDKเป็น 24 สำหรับandroidx.xr.scenecoreและandroidx.xr.composeแพ็กเกจ XR ยังคงต้องใช้ API 34 ที่รันไทม์ (I17224) - นำข้อจำกัด
RequiresApi(34)ออกจากแพ็กเกจ Jetpack XR ทั้งหมด ข้อจำกัดนี้ซ้ำซ้อนเนื่องจากปัจจุบัน Jetpack XR พร้อมใช้งานในอุปกรณ์ที่มีระดับ API 34 ขึ้นไปเท่านั้น (Iae0f8) - อาร์ติแฟกต์
SceneCoreหลัก (xr:scenecore:scenecore) จะมีเฉพาะ API แบบไม่พร้อมกันสไตล์ Kotlin เท่านั้น นักพัฒนาซอฟต์แวร์ Java สามารถใช้ไลบรารีxr:scenecore:scenecore-guavaเพื่อเข้าถึง API ที่เข้ากันได้ (If221b) - โปรเจ็กต์ที่เผยแพร่ด้วย Kotlin 2.0 ต้องใช้ KGP 2.0.0 ขึ้นไป (Idb6b5)
- ตอนนี้ไลบรารีนี้ใช้คำอธิบายประกอบ Nullness ของ JSpecify ซึ่งเป็นการใช้ประเภท นักพัฒนา Kotlin ควรใช้อาร์กิวเมนต์คอมไพเลอร์ต่อไปนี้เพื่อบังคับใช้การใช้งานที่ถูกต้อง:
-Xjspecify-annotations=strict(นี่เป็นค่าเริ่มต้นที่เริ่มตั้งแต่เวอร์ชัน 2.1.0 ของคอมไพเลอร์ Kotlin) (Ia8420) - เมธอดแบบไม่พร้อมกันทั้งหมดที่แสดงผล
ListenableFutureถูกแทนที่ด้วยฟังก์ชันระงับของ Kotlin ตอนนี้นักพัฒนาซอฟต์แวร์ Java ที่ต้องการใช้เมธอดแบบไม่พร้อมกันที่อิงตามListenableFutureแทนฟังก์ชัน Suspend ของ Kotlin ต้องใช้ฟังก์ชันส่วนขยายใน:xr:scenecore-scenecore-guavaตัวอย่างเช่นGuavaExrImageมีฟังก์ชัน ExrImage แบบไม่พร้อมกันที่เทียบเท่า Guava,GuavaScenePoseมีฟังก์ชันScenePoseแบบไม่พร้อมกันที่เทียบเท่า Guava,GuavaGltfModelมีฟังก์ชันGuava-equivalent GltfModelแบบไม่พร้อมกัน เป็นต้น (If7283) (I0af60) (If7283) (Ia8515) (I4efdf) (I54bbf) (I3467a) (I82a33)
แก้ไขข้อบกพร่อง
- อัปเดตกฎ Jetpack XR Scenecore
ProGuardเพื่อป้องกันAbstractMethodErrorสำหรับไคลเอ็นต์ที่ลดขนาด (I91a01) - การแก้ไขเพิ่มเติมเพื่อรองรับการลดขนาด Proguard สำหรับ Jetpack XR
SceneCore(I4f47e) - แก้ไขข้อบกพร่องที่
InteractableComponentอาจทำให้เกิดข้อขัดข้องหากhitPositionใน HitInfo ของInputEventอาจทำให้เกิดข้อขัดข้องหากhitPositionที่แสดงผลจากระบบเป็นค่า Null (I7a695) - เปลี่ยนชื่อค่า *Mode ของการกำหนดค่าเพื่อแสดงลักษณะการทำงาน (I6d247)
- แก้ไขปัญหาเกี่ยวกับ FOV และ
HitTestใน TestApp ของSceneCore(I2c51e) - แก้ไขข้อบกพร่องใน
SpatialCapabilities.hasCapability()ซึ่งจะแสดงผลเป็น "จริง" หากความสามารถใดๆ ที่ส่งผ่านด้วย OR ระดับบิตเป็น "จริง" แทนที่จะแสดงผลเป็น "จริง" เฉพาะในกรณีที่ความสามารถทั้งหมดเป็น "จริง" (I2cd40) SurfaceEntity.StereoMode.TOP_BOTTOMอัปเดตให้มีแผนที่ด้านบนสำหรับตาซ้ายและแผนที่ด้านล่างสำหรับตาขวา (I4ae68)
เวอร์ชัน 1.0.0-alpha04
7 พฤษภาคม 2025
androidx.xr.scenecore:scenecore:1.0.0-alpha04 และ androidx.xr.scenecore:scenecore-testing:1.0.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้การจัดการปุ่มย้อนกลับจะทำงานในเอนทิตีแผงที่ไม่มีกิจกรรมแบบฝัง เพื่อให้การจัดการปุ่มย้อนกลับทำงานได้ คุณต้องระบุ
android:enableOnBackInvokedCallback= "true"ในไฟล์ Manifest ของ Android - ตอนนี้
StereoSurfaceEntityรองรับการเล่น MV-HEVC ผ่านค่าStereoModeใหม่ 2 ค่า ได้แก่ MULTIVIEW_LEFT_PRIMARY และ MULTIVIEW_RIGHT_PRIMARY - ตอนนี้
PanelEntity.setSizeและPanelEntity.getSizeจะแสดงผลขนาดในพื้นที่ทำงานหลัก Entity.setPose,Entity.getPose,Entity.setScale,Entity.getScale,Entity.setAlphaและEntity.getAlphaจะใช้พารามิเตอร์ใหม่relativeToซึ่งช่วยให้รับ/ตั้งค่าที่เกี่ยวข้องกับพื้นที่ทำงานต่างๆ ได้ ค่าที่รองรับ ได้แก่ Parent, Activity และ Real World spaces และค่าเริ่มต้นของพารามิเตอร์นี้คือ Parent- เพิ่มเมธอดส่วนขยาย Spatial Visibility Callback ลงใน
SessionExt.ktเพื่อตรวจสอบเมื่อเนื้อหาฉากเคลื่อนที่เข้าหรือออกจากขอบเขตการมองเห็นของผู้ใช้ - เพิ่ม
setPointSourceParamsลงในSpatialAudioTrackแล้ว ซึ่งช่วยให้อัปเดตพารามิเตอร์ได้หลังจากสร้างแทร็กแล้ว - เพิ่มคลาสใหม่ Scene พร้อมข้อมูลอ้างอิงไปยัง API ของ
Scenecoreฉากจะเข้าถึงได้ในฐานะพร็อพเพอร์ตี้ส่วนขยายของเซสชัน ฟังก์ชันภายในSessionExtได้ย้ายไปยัง Scene แล้ว ดังนั้นจึงต้องปรับการนำเข้า เช่นSessionExt.getScene(session)addSpatialCapababilitiesChangedListenerพบกับSessionExt.addSpatialCapabilitiesChangedListener - เพิ่ม
ActivityPose.hitTestAsyncแล้ว ซึ่งจะเปิดใช้hitTestกับเนื้อหาเสมือน - เพิ่มประเภทคอมโพเนนต์ใหม่
SpatialPointerComponentซึ่งช่วยให้ไคลเอ็นต์ระบุไอคอนที่แสดงผลสำหรับเคอร์เซอร์หรือปิดใช้ไอคอนได้ ปัจจุบันคอมโพเนนต์นี้แนบกับอินสแตนซ์PanelEntityได้เท่านั้น - ขอแนะนําโรงงาน
PanelEntityใหม่ ซึ่งใช้ขนาดแผงเป็นเมตรหรือพิกเซล นำโรงงานPanelEntityรุ่นเก่าที่ใช้พารามิเตอร์ประเภท Dimension 2 รายการสำหรับแผงออกแล้ว
การเปลี่ยนแปลง API
- นำข้อจำกัด
RequiresApi(34)ออกจากแพ็กเกจ Jetpack XR ทั้งหมด ข้อจำกัดนี้ซ้ำซ้อนเนื่องจากปัจจุบัน Jetpack XR พร้อมใช้งานในอุปกรณ์ที่มีระดับ API 34 ขึ้นไปเท่านั้น (Iae0f8) - โปรเจ็กต์ที่เผยแพร่ด้วย Kotlin 2.0 ต้องใช้ KGP 2.0.0 ขึ้นไป (Idb6b5)
- นำชั้นเรียน
PermissionHelperออกแล้ว PanelEntity.getPixelDensityเลิกใช้งานแล้ว- ระบบจะนำ
PanelEntity.setPixelDimensionsและPanelEntity.getPixelDimensionออก แล้วแทนที่ด้วยsetSizeInPixelsและgetSizeInPixels - นำ
Entity.getActivitySpaceAlphaออกแล้ว แทนที่ด้วยEntity.getAlpha(Space.Activity)ได้ - นำ
Entity.getWorldSpaceScaleออกแล้ว แทนที่ด้วยEntity.getScale(Space.REAL\_WORLD)ได้ - คลาส Session ใน
SceneCoreถูกลบออกเพื่อใช้ Session ในรันไทม์ XR แทน StereoSurfaceEntityเปลี่ยนชื่อเป็นSurfaceEntityแล้ว- ระบบจะนำ
Entity.setSizeและEntity.getSizeออก และเพิ่มเมธอดเดียวกันลงในPanelEntity PointSourceAttributesเปลี่ยนชื่อเป็นPointSourceParamsแล้วSpatializerConstants.SOURCE\_TYPE\_BYPASSเปลี่ยนชื่อเป็นSpatializerConstants.SOURCE\_TYPE\_DEFAULTแล้ว- มีการแก้ไขเอนทิตี
PointSourceParamsจากการเข้าถึงแบบสาธารณะเป็นการเข้าถึงภายใน - ตอนนี้
AnchorEntity.createกำหนดให้ต้องกำหนดค่าPlaneTrackingModeในSession.configure() - ตอนนี้ API ของ
SpatialUserต้องมีการกำหนดค่าHeadTrackingModeในSession.configure() - เมื่อไม่ได้แนบ
ResizableComponentระบบจะแสดงบันทึกระดับ INFO แทนบันทึกระดับ ERROR - ตอนนี้คลาส Fov เป็นคลาส Kotlin ปกติแล้ว
- แยก
Entity.ktเพื่อวางเอนทิตีแต่ละประเภทที่เฉพาะเจาะจงลงในไฟล์ของตัวเอง - เมื่อสร้าง
PanelEntityใหม่ มุมมองส่วนใหญ่จะได้รับการกำหนดระดับบนสุดใหม่เป็นFrameLayoutซึ่งจะช่วยให้ใช้LayoutInspectorกับแผงเชิงพื้นที่ได้ง่ายขึ้น - ตอนนี้อินสแตนซ์
XrExtensionsที่ใช้อยู่ได้รับการลงทะเบียนกับแพลตฟอร์มแล้ว โดยพยายามอย่างเต็มที่เพื่อช่วยในการแก้ไขข้อบกพร่องของแอป
แก้ไขข้อบกพร่อง
- เพิ่มการแก้ไขเพื่อป้องกันข้อขัดข้องที่อาจเกิดขึ้นเมื่อมีการย้าย
PanelEntityที่มีMovableComponentและAnchorPlacement - แก้ไขปัญหาที่
ResizableComponentระบุขนาดที่ล้าสมัยใน Callback ของonResizeStart - แก้ไขข้อขัดข้องเมื่อมีการเรียกใช้
dispose()ของJxrPlatformAdapterAxrหลายครั้ง
เวอร์ชัน 1.0.0-alpha03
26 กุมภาพันธ์ 2025
androidx.xr.scenecore:scenecore:1.0.0-alpha03 และ androidx.xr.scenecore:scenecore-testing:1.0.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha03 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ระบบรองรับการลดขนาด Proguard สำหรับโค้ด Jetpack XR แล้ว
แก้ไขข้อบกพร่อง
- การแก้ไขเพิ่มเติมเพื่อรองรับการลดขนาด Proguard สำหรับ Jetpack XR SceneCore (I4f47e)
- อัปเดตกฎ Jetpack XR Scenecore
ProGuardเพื่อป้องกันAbstractMethodErrorสำหรับไคลเอ็นต์ที่ลดขนาด (I91a01)
เวอร์ชัน 1.0.0-alpha02
12 กุมภาพันธ์ 2025
androidx.xr.scenecore:scenecore:1.0.0-alpha02 และ androidx.xr.scenecore:scenecore-testing:1.0.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบที่กำลังจะเกิดขึ้นซึ่งส่งผลต่อแอปที่สร้างก่อน 1.0.0-alpha02
- เมธอด Factory ได้ย้ายจากคลาส
Sessionไปยังเมธอด Companion ในแต่ละประเภทที่เกี่ยวข้อง ดังนี้- ระบบลบ
Session.createActivityPanelEntity(Dimensions, String, Activity, Pose)และแทนที่ด้วยActivityPanelEntity.create(Session, Dimensions, String, Pose)แล้ว - ระบบลบ
Session.createAnchorEntity(Anchor)และแทนที่ด้วยAnchorEntity.create(Session, Anchor)แล้ว - ระบบลบ
Session.createAnchorEntity(Dimensions, Int, Int, Duration)และแทนที่ด้วยAnchorEntity.create(Session, Dimensions, Int, Int, Duration)แล้ว - ระบบลบ
Session.createEntity(String, Pose)และแทนที่ด้วยContentlessEntity.create(Session, String, Pose)แล้ว - ระบบลบ
Session.createExrImageResource(String)และแทนที่ด้วยExrImage.create(Session, String)แล้ว - ระบบลบ
Session.createGltfEntity(GltfModel, Pose)และแทนที่ด้วยGltfModelEntity.create(Session, GltfModel, Pose)แล้ว - ระบบลบ
Session.createGltfModelResource(String)และแทนที่ด้วยGltfModel.create(Session, String)แล้ว - ระบบลบ
Session.createInteractableComponent(Executor, InputEventListener)และแทนที่ด้วยInteractableComponent.create(Session, Executor, InputEventListener)แล้ว - ระบบลบ
Session.createMovableComponent(Boolean, Boolean, Set<AnchorPlacement>, Boolean)และแทนที่ด้วยMovableComponent.create(Session, Boolean, Boolean, Set<AnchorPlacement>, Boolean)แล้ว - ระบบลบ
Session.createPanelEntity(View, Dimensions, Dimensions, String, Pose)และแทนที่ด้วยPanelEntity.create(Session, View, Dimensions, Dimensions, String, Pose)แล้ว - ระบบลบ
Session.createResizableComponent(Dimensions, Dimensions)และแทนที่ด้วยResizableComponent.create(Session, Dimensions, Dimensions)แล้ว - ระบบลบ
Session.createStereoSurfaceEntity(Int, Dimensions, Pose)และแทนที่ด้วยStereoSurface.create(Session, Int, Dimensions, Pose)แล้ว
- ระบบลบ
- ระบบได้นำเมธอดที่เลิกใช้งานต่อไปนี้ออกแล้ว
- ลบ
Session.canEmbedActivityPanel(Activity)แล้ว โปรดใช้getSpatialCapabilities.hasCapabilility(SPATIAL_CAPABILITY_EMBED_ACTIVITY)แทน - ลบ
Session.hasSpatialCapability(Int)แล้ว เราได้แทนที่ด้วยการใช้getSpatialCapabilities().hasCapability()เป็นวิธีที่แยกส่วนมากขึ้นในการตรวจสอบความสามารถเชิงพื้นที่ เนื่องจากgetSpatialCapabilities()แสดงผลออบเจ็กต์SpatialCapabilities - ระบบลบ
Session.requestFullSpaceMode()และแทนที่ด้วยSpatialEnvironment.requestFullSpaceMode()แล้ว - ระบบลบ
Session.requestHomeSpaceMode()และแทนที่ด้วยSpatialEnvironment.requestHomeSpaceMode()แล้ว
- ลบ
Session.setFullSpaceMode(Bundle)และSession.setFullSpaceModeWithEnvironmentInherited(Bundle)ได้ย้ายไปยังฟังก์ชันส่วนขยายแล้ว ไฟล์ของนักพัฒนาแอปจะต้องเพิ่มการนำเข้าใหม่สำหรับการเข้าถึง ดังนี้import androidx.xr.scenecore.setFullSpaceModeimport androidx.xr.scenecore.setFullSpaceModeWithEnvironmentInherited
Session.setPreferredAspectRatio(Activity, Float)ได้ย้ายไปเป็นฟังก์ชันส่วนขยายแล้ว ไฟล์ของนักพัฒนาแอปจะต้องเพิ่มการนำเข้าใหม่เพื่อเข้าถึง ดังนี้import androidx.xr.scenecore.setPreferredAspectRatio
Session.getEntitiesOfType(Class<out T>)และSession.getEntityForRtEntity(RtEntity)ได้ย้ายไปยังฟังก์ชันส่วนขยายแล้ว ไฟล์ของนักพัฒนาแอปจะต้องเพิ่มการนำเข้าใหม่สำหรับการเข้าถึง ดังนี้import androidx.xr.scenecore.getEntitiesOfTypeimport androidx.xr.scenecore.getEntityForRtEntity
- ลบ
Session.unpersistAnchor(Anchor)แล้ว - ลบ
Session.createPersistedAnchorEntity(UUID)แล้ว
ปัญหาที่ทราบ
PanelEntity.setCornerRadius()และActivityPanelEntity.setCornerRadius()อาจไม่มีผลจนกว่าจะมีการย้ายแผงในครั้งถัดไป ซึ่งสามารถลดผลกระทบได้โดยการย้ายแผงไปยังตำแหน่งปัจจุบัน- เมื่อมีการเรียก
BoundsChangedในActivitySpaceระบบอาจอัปเดตActivityPoseบางรายการไม่ถูกต้อง โดยจะอัปเดตในการโทรOnSpaceUpdatedครั้งถัดไปในวันที่ActivitySpace
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและการเปลี่ยนแปลงด้านลักษณะการทำงาน
PanelEntityและActivityPanelEntityจะมีรัศมีมุมเริ่มต้นที่ 32dp หรือเล็กกว่าหากแผงมีความกว้างหรือความสูงน้อยกว่า 32dp
API และความสามารถใหม่ๆ
- เปิดตัว
StereoSurface.CanvasShapeซึ่งช่วยให้สร้าง Canvas แบบSphericalและHemisphericalเพื่อแสดงผลสื่อที่สมจริงได้ - ตอนนี้
StereoSurfaceEntity.create()ยอมรับพารามิเตอร์CanvasShapeแล้ว (ปัจจุบันระบบจะละเว้นพารามิเตอร์นี้ แต่จะใช้ในรุ่นต่อๆ ไป) StereoSurfaceEntity.create()ไม่ใช้พารามิเตอร์Dimensionsอีกต่อไป แอปพลิเคชันควรควบคุมขนาดของ Canvas โดยการตั้งค่าCanvasShapeStereoSurfaceEntityมีสมาชิกCanvasShapeซึ่งตั้งค่าแบบไดนามิกได้- ตอนนี้
StereoSurfaceEntity.dimensionsเป็นพร็อพเพอร์ตี้แบบอ่านอย่างเดียว แอปพลิเคชันควรตั้งค่าCanvasShapeเพื่อเปลี่ยนมิติข้อมูล - ตอนนี้
StereoSurfaceEntityอนุญาตให้รีเซ็ตStereoModeได้หลังจากสร้างเสร็จแล้ว
การเปลี่ยนแปลงอื่นๆ
- ลด minSDK เวลาคอมไพล์เป็น 24 Jetpack XR API ทั้งหมดยังคงต้องใช้ API 34 ที่รันไทม์
- โรงงานเซสชันของ
SceneCore(Session.create) จะไม่เปิด Intent เพื่อรับสิทธิ์SCENE_UNDERSTANDINGอีกต่อไป แต่แอปพลิเคชันไคลเอ็นต์ต้องขอสิทธิ์จากผู้ใช้อย่างชัดเจนก่อนที่จะพยายามสร้าง Anchor การสร้าง Anchor จะไม่สำเร็จหากผู้ใช้ไม่ให้สิทธิ์
การแก้ไขข้อบกพร่อง
getActivitySpacePose()ได้รับการแก้ไขให้พิจารณามาตราส่วนActivitySpaceโดยแสดงผลค่าการแปลเป็นเมตรที่ปรับขนาดแล้ว แทนที่จะแสดงผลเป็นเมตรที่ไม่ได้ปรับขนาดเสมอ ตอนนี้transformPoseToยังใช้หน่วยที่ถูกต้องในการคำนวณการเปลี่ยนแปลงพิกัดเมื่อActivitySpaceเกี่ยวข้องกับต้นทางหรือปลายทางด้วย- ตอนนี้ระบบจะตั้งค่า Skybox เป็น Skybox สีดำทั้งหมดเมื่อมีการส่งค่ากำหนด Skybox เป็น Null โดยใช้
setSpatialEnvironmentPreference(new SpatialEnvironmentPreference(null, geom))หากต้องการเปลี่ยนกลับไปใช้สกายบ็อกซ์และเรขาคณิตค่าเริ่มต้นของระบบ ให้ใช้setSpatialEnvironmentPreference(null).
เวอร์ชัน 1.0.0-alpha01
12 ธันวาคม 2024
androidx.xr.scenecore:scenecore-* 1.0.0-alpha01 เผยแพร่แล้ว
ฟีเจอร์ของเวอร์ชันแรก เวอร์ชันแรกสำหรับนักพัฒนาของ Jetpack SceneCore ซึ่งเป็นไลบรารีกราฟฉาก 3 มิติสำหรับการสร้างและจัดการฉากและสภาพแวดล้อมที่สมจริง ไลบรารีนี้ช่วยให้คุณวางและจัดเรียงโมเดล 3 มิติและแผงเนื้อหาให้สัมพันธ์กันและสัมพันธ์กับสภาพแวดล้อมเสมือนจริงหรือสภาพแวดล้อมในโลกจริงได้
- SpatialEnvironment: สร้างประสบการณ์ที่สมจริงอย่างเต็มรูปแบบด้วยรูปภาพ Skybox และ/หรือเรขาคณิตโมเดล 3 มิติเป็นฉากหลังสำหรับฉาก XR ของสภาพแวดล้อม หรือเปิดใช้ฟีเจอร์ส่งผ่านเพื่อให้ฉากเสมือนจริงผสานรวมกับสภาพแวดล้อมในชีวิตจริงของผู้ใช้ได้
- PanelEntity: เพิ่มเนื้อหา 2 มิติลงในฉาก 3 มิติโดยฝังเลย์เอาต์และกิจกรรม Android มาตรฐานลงในแผงเชิงพื้นที่ที่ลอยหรือยึดกับพื้นผิวในโลกจริงได้
- GltfModelEntity: วาง สร้างภาพเคลื่อนไหว และโต้ตอบกับโมเดล 3 มิติในฉาก SceneCore รองรับรูปแบบไฟล์ glTF เพื่อให้ผสานรวมกับโมเดลที่มีอยู่ได้ง่าย
- SpatialAudio: เพิ่มแหล่งที่มาของเสียงรอบข้างและเสียงแบบจุดลงในฉาก 3 มิติเพื่อให้ได้เสียงรอบทิศทางที่สมจริงอย่างเต็มรูปแบบ
- StereoSurfaceEntity: SceneCore รองรับการกำหนดเส้นทางตาซ้าย/ขวาของเนื้อหาที่แสดงผลบน Android Surface ซึ่งสามารถใช้เพื่อแสดงผลเนื้อหาสามมิติในรูปแบบเคียงข้างกันหรือบนล่าง เช่น รูปภาพสเตอริโอ วิดีโอ 3 มิติ หรือ UI อื่นๆ ที่แสดงผลแบบไดนามิก แอปพลิเคชันควรใช้ MediaPlayer หรือ ExoPlayer สำหรับการถอดรหัสวิดีโอ
- ระบบคอมโพเนนต์: SceneCore มีระบบคอมโพเนนต์ที่เสถียรและยืดหยุ่นสำหรับการเพิ่มความสามารถให้กับเนื้อหา XR รวมถึงความสามารถในการเคลื่อนย้าย ปรับขนาด และโต้ตอบกับโมเดลและแผงต่างๆ สำหรับผู้ใช้
- Anchor: เมื่อเปิดใช้ฟีเจอร์ส่งผ่าน คุณจะแนบแผงและโมเดลกับพื้นผิวจริงได้ ซึ่งช่วยให้ผู้ใช้ผสานรวมเนื้อหาเสมือนจริงเข้ากับสภาพแวดล้อมในชีวิตจริงได้อย่างราบรื่น
- ท่าทางของผู้ใช้: เข้าถึงตำแหน่งของผู้ใช้ในฉากเสมือนจริงเพื่อปรับทิศทางเนื้อหาตามตำแหน่งของผู้ใช้
- SpatialCapabilities: สร้างแอปที่ปรับเปลี่ยนตามอุปกรณ์ได้อย่างเต็มรูปแบบซึ่งใช้ประโยชน์จากความสามารถเชิงพื้นที่เมื่อพร้อมใช้งาน เช่น การจัดตำแหน่ง 3 มิติของเนื้อหา UI นอกจากนี้ แอปยังสามารถตรวจสอบการเปลี่ยนแปลงความสามารถขณะที่แอปกำลังทำงาน เพื่อปรับเปลี่ยนประสบการณ์การใช้งานตามวิธีที่ผู้ใช้ใช้อุปกรณ์ Android XR
ปัญหาที่ทราบ
- ปัจจุบันต้องใช้ minSDK เวอร์ชัน 30 เพื่อใช้ Jetpack SceneCore วิธีแก้ปัญหาชั่วคราวคือเพิ่มรายการไฟล์ Manifest
<uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/>ต่อไปนี้เพื่อให้สามารถสร้างและเรียกใช้ด้วย minSDK เวอร์ชัน 23 ได้ - เซสชันอาจไม่ถูกต้องในสถานการณ์ต่างๆ ที่สร้างกิจกรรมขึ้นมาใหม่โดยอัตโนมัติ ซึ่งรวมถึงการปรับขนาดแผงหลัก การเชื่อมต่ออุปกรณ์ต่อพ่วง และการเปลี่ยนระหว่างโหมดสว่างและโหมดมืด หากพบปัญหาเซสชันไม่ถูกต้อง วิธีแก้ปัญหาชั่วคราว ได้แก่ การทำให้แผงหลักปรับขนาดไม่ได้ การใช้เอนทิตีแผงแบบไดนามิก การปิดใช้การสร้างกิจกรรมใหม่สำหรับการเปลี่ยนแปลงการกำหนดค่าที่เฉพาะเจาะจง หรือการปิดใช้การเปลี่ยนแปลงธีมโหมดสว่าง/โหมดมืด
- GltfEntity ไม่รองรับคอมโพเนนต์ที่เคลื่อนย้ายได้และปรับขนาดได้
- GltfEntity ไม่รองรับ Entity.getSize()
- แอป Jetpack XR ต้องขอสิทธิ์
android.permission.SCENE_UNDERSTANDINGใน AndroidManifest - การสร้างเซสชันรองรับเฉพาะในอุปกรณ์ Android XR เท่านั้น ในตอนนี้ หากคุณสร้างเซสชันและพยายามใช้เซสชันนั้นในอุปกรณ์ Android XR ที่ไม่ใช่ Android คุณจะได้รับ RuntimeException
- การตั้งค่า Skybox เป็น Null ผ่าน `SpatialEnvironment.setSpatialEnvironmentPreference() ไม่ได้ส่งผลให้เกิด Skybox สีดำทึบตามที่ระบุไว้ในเอกสาร ซึ่งอาจส่งผลให้เกิด Skybox ค่าเริ่มต้นของระบบหรือไม่มีการเปลี่ยนแปลง Skybox ปัจจุบัน
- ไคลเอ็นต์ SceneCore ควรเพิ่ม
implementation(“com.google.guava:listenablefuture-1.0”)ลงในการกำหนดค่า Gradle สำหรับทรัพยากร Dependency ของแอป ในรุ่นต่อๆ ไป scenecore จะรวมไลบรารีนี้เป็นทรัพยากร Dependency ของapiเพื่อให้ไคลเอ็นต์ไม่จำเป็นต้องประกาศอย่างชัดแจ้ง - SceneCore รวม
com.google.guava:guava-31.1-androidและcom.google.protobuf:protobuf-javaliteเป็นทรัพยากร Dependency แบบสกรรมกริยาอย่างไม่ถูกต้อง หากการดำเนินการนี้ส่งผลให้เกิดข้อผิดพลาดคลาสซ้ำในบิลด์ คุณสามารถยกเว้นทรัพยากร Dependency ทั้ง 2 รายการนี้ได้อย่างปลอดภัย - หากแอปใช้ SceneCore และเปิดใช้ ProGuard แอปจะขัดข้องเมื่อคุณสร้างเซสชัน วิธีแก้ปัญหาชั่วคราวคือปิดใช้ ProGuard ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีเปิดใช้ ProGuard ได้ที่คู่มือนี้