本頁面由 Cloud Translation API 翻譯而成。

延展實境專用 Material Design

使用可自動調整的 Material 元件和版面配置，打造 XR 應用程式

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2025 年 10 月 22 日	-	-	-	1.0.0-alpha12

宣告依附元件

如要新增 XR Compose Material3 核心的依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

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

Kotlin

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

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

1.0 版本

1.0.0-alpha12 版

2025 年 10 月 22 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha12。1.0.0-alpha12 版包含這些修訂項目。

新功能

新增 SpaceModeToggleButton，可在 HomeSpace 和 FullSpace 之間切換 (Ic6865)

修正錯誤

改善 XR 工具列 (Ied1f5)

1.0.0-alpha11 版本

2025 年 8 月 27 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha11。1.0.0-alpha11 版包含這些修訂項目。

修正錯誤

修正 XR NavRail 中的 FAB 行為 (Ibe20b)

1.0.0-alpha10 版本

2025 年 7 月 30 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha10。1.0.0-alpha10 版包含這些修訂項目。

新功能

建立 XR 實作項目，並為水平和垂直工具列建立 ComponentOverride (0e9496c、dcfef96)

修正錯誤

修正 XR 對話方塊未顯示部分內容的問題 (c82e61b)

1.0.0-alpha08 版本

2025 年 5 月 20 日

發布 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 版本

2025 年 5 月 7 日

發布 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 版本

2025 年 3 月 26 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha06。1.0.0-alpha06 版包含這些修訂項目。

1.0.0-alpha05 版本

2025 年 3 月 12 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha05。1.0.0-alpha05 版包含這些修訂項目。

新功能

使用 EnableXrComponentOverrides 時，TopAppBar 預設會空間化為 Orbiter。
使用 EnableXrComponentOverrides 時，Material AlertDialog 預設會空間化為 SpatialPanel。

API 變更

將 ComponentOverride 類型重新命名為 Override，並將 ComponentOverrideContext 類型重新命名為 OverrideScope (Id973c)

修正錯誤

修正空間化 NavigationRail 和 NavigationBar 的鋸齒狀問題和錯誤的半透明效果。(I9db52)

1.0.0-alpha04 版本

2025 年 2 月 26 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha04。1.0.0-alpha04 版包含這些修訂項目。

新功能

使用 EnableXrComponentOverrides 時，ListDetailPaneScaffold 和 SupportingPaneScaffold 預設會使用 SpatialPanels (I166b0)

API 變更

DefaultNavigationRailOrbiterProperties 和 DefaultNavigationBarOrbiterProperties getter 不再是 @Composable (I61618)
LocalNavigationRailOrbiterProperties 和 LocalNavigationBarOrbiterProperties 不再可為空值 (I61618)

1.0.0-alpha03 版本

2025 年 2 月 12 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha03，該版本與上一個 Alpha 版沒有差別。1.0.0-alpha03 版包含這些修訂項目。

1.0.0-alpha02 版

2025 年 1 月 29 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha02。1.0.0-alpha02 版包含這些修訂項目。

新功能

在 XR NavigationBar 和 NavigationRail 上啟用 Orbiter 屬性自訂功能。(Ic300f)

API 變更

建立在 XR 上覆寫 ThreePaneScaffold 的功能 (Ib66f1)
為 XR 實作非動畫窗格覆寫 (I7f620)
新增及使用新的實驗性註解 ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

修正錯誤

將 Material3 XR 的依附元件固定在 XR Compose。(Ia02cc)

1.0.0-alpha01 版

2024 年 12 月 12 日

發布 androidx.xr.compose.material3:material3:1.0.0-alpha01。

初始版本的功能

這是 Material Design for XR 的初始開發人員版本。使用現有的 Material 3 程式庫，透過空間 UI 行為強化元件和自動調整式版面配置。您可以直接使用 M3 XR 元件建構，也可以新增 EnableXrComponentOverrides 包裝函式，調整目前的實作項目。詳情請參閱這份開發人員指南。

支援的延展實境改編內容：

任何 Compose 版面配置中的導覽軌 (包括 NavigationSuiteScaffold) 都會自動調整為 XR Orbiter。詳情請參閱「Material Design 指南」。
任何 Compose 版面配置中的導覽列 (包括 NavigationSuiteScaffold) 都會自動調整為 XR Orbiter。詳情請參閱「Material Design 指南」。

已知問題

ListDetailPaneScaffold 和 SupportingPaneScaffold 目前不支援多個空間面板