Jetpack SceneCore

สร้างและจัดการกราฟฉาก Android XR ด้วยเนื้อหา 3 มิติ
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
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) เป็นแบบสาธารณะ/เสถียร โดยยังคงให้เมธอด setter GltfAnimation.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 เป็นแบบสาธารณะ ตอนนี้นักพัฒนาแอปสามารถระบุรัศมีมุมเมื่อสร้างรูปทรงสี่เหลี่ยมเพื่อแสดงผล Canvas SurfaceEntity ที่มีมุมโค้งมน และค้นหารัศมีของสี่เหลี่ยมที่มีอยู่ได้ (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)
  • VertexLayout API ได้รับการอัปเดตให้ใช้รายการ 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)
  • ย้ายข้อมูลค่าคงที่ PlaneSemanticType PlaneOrientation ของ SceneCore จาก Int เป็นประเภทที่กำหนดเองแล้ว ระบบจะนำค่าคงที่ ANY ออก ไคลเอ็นต์ควรแจกแจงค่าคงที่ที่ต้องการทั้งหมดอย่างชัดเจนแทน หรือใช้ค่าคงที่ Set แบบเปลี่ยนแปลงไม่ได้ .ALL ใหม่ ตอนนี้เมธอดแฟกทอรี AnchorEntity จะยอมรับชุดประเภทเหล่านี้แทนค่าเดียว (Ib1033)
  • เพิ่มการรองรับภาพเคลื่อนไหวแบบโครงกระดูก (สกินนิง) ลงใน Custom Mesh API เวอร์ชันทดลอง ตอนนี้นักพัฒนาแอปสามารถสร้างภาพเคลื่อนไหวของเมชที่กำหนดเองได้โดยระบุ boneCount เมื่อสร้าง MeshEntity และอัปเดตภาพเคลื่อนไหวแบบเรียลไทม์โดยใช้ MeshEntity.setBoneTransforms() (Id8ba2, b/496692490)
  • เปิดตัว CustomMesh API เวอร์ชันทดลอง ตอนนี้นักพัฒนาแอปสามารถสร้างและแสดงผลเรขาคณิต 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 ในเมธอด Factory ActivityPanelEntity, 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)
  • เพิ่ม GltfAnimation API สำหรับควบคุมภาพเคลื่อนไหว 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 เนื่องจากตอนนี้ getPerceivedResolution API อาศัย RenderViewpoint API ของ ARCore แทน CameraViewScenePose ชื่อนี้สะท้อนถึงการใช้งานใหม่ได้ดียิ่งขึ้น (I8c967, b/446989745, b/419311998)
  • ตอนนี้เมธอด PanelEntity/SurfaceEntity.getPerceivedResolution จะใช้ RenderViewpoint ที่นักพัฒนาแอปให้มาเป็นอาร์กิวเมนต์ ก่อนหน้านี้ รันไทม์จะเลือก RenderViewpoint ที่ใช้ในการคำนวณความละเอียดที่รับรู้โดยพลการ (I8c967, b/446989745, b/419311998)
  • นำ SpatialUser, ScenePose.Head และ ScenePose.CameraView ออกแล้ว ฟังก์ชันการทำงานของ API เหล่านี้ครอบคลุมโดย API ArDevice และ 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 เป็น Null HitTestResult.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)
  • ตอนนี้ Scenecore Fakes อยู่ในโมดูล xr:scenecore:scenecore-testing แล้ว (Idd951)
  • เปลี่ยนชื่อ shouldAutoHideContent เป็น isAutoHideContentWhileResizingEnabled และ shouldAlwaysShowOverlay เป็น isAlwaysShowOverlayEnabled (I97c36, b/432335421)
  • อัปเดตค่าคงที่ SceneCore TextureSampler เพื่อให้อ่านง่ายขึ้น เช่น ตอนนี้ 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)
  • ตอนนี้ GroupEntity factory จะแสดงผลประเภท 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.shouldAutoHideContent ResizableComponent.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.setFullSpaceMode
    • import 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.getEntitiesOfType
    • import 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 โดยการตั้งค่า CanvasShape
  • StereoSurfaceEntity มีสมาชิก 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 ได้ที่คู่มือนี้