Material Design สำหรับ XR

สร้างด้วยคอมโพเนนต์และเลย์เอาต์ของ Material ที่ปรับให้เหมาะกับ XR
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
25 มีนาคม 2026 - - - 1.0.0-alpha16

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

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

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

ดึงดูด

dependencies {
    // Use to implement XR Compose Material3
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha16"
}

Kotlin

dependencies {
    // Use to implement XR Compose Material3
   implementation("androidx.xr.compose.material3:material3:1.0.0-alpha16")
}

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

ความคิดเห็น

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

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

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

รุ่น 1.0

เวอร์ชัน 1.0.0-alpha16

25 มีนาคม 2026

androidx.xr.compose.material3:material3:1.0.0-alpha16 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha16 มีการเปลี่ยนแปลงเหล่านี้

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

  • เปลี่ยน Orbiter ให้ใช้ OrbiterAnchorPoint + VolumeOffset หรือ OrbiterPoseProvider แทน position, offset, offsetType, alignment และระดับความสูง นอกจากนี้ยังนำพารามิเตอร์ shouldRenderInNonSpatial ออกด้วย หากนักพัฒนาซอฟต์แวร์ไม่ต้องการให้ Orbiter แสดงผลในโหมดที่ไม่ใช่เชิงพื้นที่ นักพัฒนาซอฟต์แวร์ควรห่อ Orbiter ในคำสั่ง if และตรวจสอบ SpatialCapabilities (I9fbb3, b/462428503)

เวอร์ชัน 1.0.0-alpha15

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

androidx.xr.compose.material3:material3:1.0.0-alpha15 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha15 มีการคอมมิตเหล่านี้

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

  • การเปลี่ยนแปลงระยะขอบของตัวปรับแต่ง Subspace เพื่อให้ทราบทิศทางของเลย์เอาต์ (I53e25, b/475290780, b/474410590)

เวอร์ชัน 1.0.0-alpha14

28 มกราคม 2026

androidx.xr.compose.material3:material3:1.0.0-alpha14 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha14 มีการเปลี่ยนแปลงเหล่านี้

เวอร์ชัน 1.0.0-alpha13

3 ธันวาคม 2025

androidx.xr.compose.material3:material3:1.0.0-alpha13 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha13 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

  • สร้างการติดตั้งใช้งาน XR และ ComponentOverride สำหรับ WideNavigationRail และ ModalWideNavigationRail (I1e86d, b/407769444)
  • NavigationSuiteScaffold, ListDetailPaneScaffold และ SupportingPaneScaffold ตอนนี้ใช้ recommendedContentBoxInFullSpace เพื่อตั้งค่าขนาดเริ่มต้น (Ic54f1, b/388111668, b/394913962, b/394913962)

เวอร์ชัน 1.0.0-alpha12

22 ตุลาคม 2025

androidx.xr.compose.material3:material3:1.0.0-alpha12 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha12 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่ม SpaceModeToggleButton สำหรับการสลับระหว่าง HomeSpace กับ FullSpace (Ic6865)

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

  • ปรับปรุงแถบเครื่องมือ XR (Ied1f5)

เวอร์ชัน 1.0.0-alpha11

27 สิงหาคม 2025

androidx.xr.compose.material3:material3:1.0.0-alpha11 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha11 มีการเปลี่ยนแปลงเหล่านี้

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

  • แก้ไขลักษณะการทำงานของ FAB ใน XR NavRail (Ibe20b)

เวอร์ชัน 1.0.0-alpha10

30 กรกฎาคม 2025

androidx.xr.compose.material3:material3:1.0.0-alpha10 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha10 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

  • สร้างการติดตั้งใช้งาน XR และ ComponentOverride สำหรับแถบเครื่องมือแนวนอนและแนวตั้ง (0e9496c, dcfef96)

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

  • แก้ไขกล่องโต้ตอบ XR ที่ไม่แสดงเนื้อหาบางอย่าง (c82e61b)

เวอร์ชัน 1.0.0-alpha08

20 พฤษภาคม 2025

androidx.xr.compose.material3:material3:1.0.0-alpha08 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha08 มีการเปลี่ยนแปลงเหล่านี้

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

  • แก้ไขข้อขัดข้องเมื่อ ListDetailPaneScaffold หรือ SupportingPaneScaffold ไม่มีรายการย่อย (46df990)
  • ลด Material XR minSdk เป็น 24 (6064706)

เวอร์ชัน 1.0.0-alpha07

7 พฤษภาคม 2025

androidx.xr.compose.material3:material3:1.0.0-alpha07 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha07 มีคอมมิตเหล่านี้

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

  • โปรเจ็กต์ที่เผยแพร่ด้วย Kotlin 2.0 ต้องใช้ KGP 2.0.0 ขึ้นไป (Idb6b5)

เวอร์ชัน 1.0.0-alpha06

26 มีนาคม 2025

androidx.xr.compose.material3:material3:1.0.0-alpha06 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha06 มีการเปลี่ยนแปลงเหล่านี้

เวอร์ชัน 1.0.0-alpha05

12 มีนาคม 2025

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

ฟีเจอร์ใหม่

  • TopAppBar จะได้รับการปรับให้เป็นเสียงรอบทิศทางใน Orbiter โดยค่าเริ่มต้นเมื่อใช้ EnableXrComponentOverrides
  • โดยค่าเริ่มต้น ระบบจะแปลง AlertDialog ของ Material เป็น SpatialPanel เมื่อใช้ EnableXrComponentOverrides

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

  • เปลี่ยนชื่อประเภท ComponentOverride เป็น Override และประเภท ComponentOverrideContext เป็น OverrideScope (Id973c)

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

  • แก้ไขการลบเหลี่ยมและการปิดบังที่ไม่ถูกต้องใน NavigationRail และ NavigationBar ที่ปรับให้เหมาะกับเสียงตามตำแหน่ง (I9db52)

เวอร์ชัน 1.0.0-alpha04

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

androidx.xr.compose.material3:material3:1.0.0-alpha04 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha04 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

  • ListDetailPaneScaffold และ SupportingPaneScaffold จะใช้ SpatialPanels โดยค่าเริ่มต้นเมื่อใช้ EnableXrComponentOverrides (I166b0)

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

  • DefaultNavigationRailOrbiterProperties และ DefaultNavigationBarOrbiterProperties getters จะ@Composableไม่ทำงานอีกต่อไป (I61618)
  • LocalNavigationRailOrbiterProperties และ LocalNavigationBarOrbiterProperties จะไม่เป็นค่าว่างอีกต่อไป (I61618)

เวอร์ชัน 1.0.0-alpha03

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

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

เวอร์ชัน 1.0.0-alpha02

29 มกราคม 2025

androidx.xr.compose.material3:material3:1.0.0-alpha02 ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีการเปลี่ยนแปลงเหล่านี้

ฟีเจอร์ใหม่

  • เปิดใช้การปรับแต่งพร็อพเพอร์ตี้ Orbiter ใน XR NavigationBar และ NavigationRail (Ic300f)

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

  • สร้างความสามารถในการลบล้าง ThreePaneScaffold ใน XR (Ib66f1)
  • ใช้การลบล้างแผงแบบไม่อนิเมชันสำหรับ XR (I7f620)
  • เพิ่มและใช้คำอธิบายประกอบเวอร์ชันทดลองใหม่ ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

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

  • ปักหมุดทรัพยากร Dependency ของ Material3 XR ใน XR Compose (Ia02cc)

เวอร์ชัน 1.0.0-alpha01

12 ธันวาคม 2024

androidx.xr.compose.material3:material3:1.0.0-alpha01 ได้รับการเผยแพร่แล้ว

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

การเปิดตัว Material Design สำหรับ XR เวอร์ชันนักพัฒนาครั้งแรก เมื่อใช้ไลบรารี Material 3 ที่มีอยู่ คอมโพเนนต์และเลย์เอาต์แบบปรับอัตโนมัติจะได้รับการปรับปรุงด้วยลักษณะการทำงานของ UI เชิงพื้นที่ คุณสร้างด้วยคอมโพเนนต์ M3 XR ได้โดยตรง หรือปรับใช้การใช้งานปัจจุบันโดยเพิ่ม Wrapper EnableXrComponentOverrides ดูข้อมูลเพิ่มเติมได้ในคู่มือนักพัฒนาซอฟต์แวร์นี้

การดัดแปลง XR ที่รองรับ

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

  • ขณะนี้ ListDetailPaneScaffold และ SupportingPaneScaffold ยังไม่รองรับแผงเชิงพื้นที่หลายแผง