Material Design สำหรับ XR

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

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

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

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

ดึงดูด

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

Kotlin

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

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

ความคิดเห็น

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

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

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

เวอร์ชัน 1.0

เวอร์ชัน 1.0.0-alpha17

19 พฤษภาคม 2026

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

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

  • เปลี่ยน Orbiter ให้ใช้ OrbiterAnchorPoint + VolumeOffset หรือ OrbiterPoseProvider แทนตำแหน่ง ออฟเซ็ต ประเภทออฟเซ็ต การจัดแนว และระดับความสูง นอกจากนี้ยังนำพารามิเตอร์ shouldRenderInNonSpatial ออกด้วย หากนักพัฒนาซอฟต์แวร์ไม่ต้องการให้ Orbiter แสดงผลในแบบไม่ใช่เชิงพื้นที่ ก็ควรใส่ Orbiter ไว้ในคำสั่ง if และตรวจสอบ SpatialCapabilities (I9fbb3)
  • เพิ่มตัวปรับแต่งที่เคลื่อนย้ายได้ ปัจจุบันตัวปรับแต่งเหล่านี้ใช้ได้กับ SpatialPanels และ SpatialExternalSurface และจะรองรับ SpatialGltfModel ในอนาคต รวมถึง SubspaceComposables ทั้งหมดในที่สุด (I9a3cd)

เวอร์ชัน 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)
  • ลด minSdk ของ Material XR เป็น 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 ไม่ใช่@Composable อีกต่อไป (I61618)
  • LocalNavigationRailOrbiterProperties และ LocalNavigationBarOrbiterProperties ไม่ใช่ค่า Null อีกต่อไป (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 ใน NavigationBar และ NavigationRail ของ XR (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 ไม่รองรับแผงเชิงพื้นที่หลายแผง