設定 Jetpack XR SDK

適用的 XR 裝置
本指南可協助您為這類 XR 裝置打造體驗。
瞭解 XR 裝置類型 →
XR 頭戴式裝置
有線 XR 眼鏡
音訊和
顯示型眼鏡
瞭解 XR 裝置類型 →

開始建構前，您需要設定 Jetpack XR SDK。請按照各節中的步驟，使用 SDK 設定開發環境。

檢查 Android SDK 相容性

Jetpack XR SDK 要求應用程式使用 24 的 Android minSdk，以及 34 以上的 compileSdk。

新增程式庫依附元件

應用程式所需的依附元件，取決於您要建構的體驗類型和 XR 裝置。如要進一步瞭解如何為應用程式新增依附元件，請參閱下列各節。

新增沉浸式體驗 (XR 頭戴式裝置和 XR 眼鏡) 的程式庫依附元件

首先，請參閱下列參考指南，瞭解各個必要程式庫的必要依附元件和相容性問題：

接著，在應用程式的 build.gradle.kts 檔案中新增必要依附元件：

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha02"
    implementation "androidx.xr.scenecore:scenecore:1.1.0-alpha01"
    implementation "androidx.xr.compose:compose:1.0.0-beta02"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha17"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
    implementation("androidx.xr.compose:compose:1.0.0-beta02")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}

啟用程式碼壓縮功能 (選用)

如要使用 ProGuard 啟用建構作業的程式碼壓縮和模糊化功能，也必須新增 Android Extensions for XR 程式庫的依附元件。如果專案使用 Jetpack XR alpha05 以上版本，就必須執行這項操作。

在模組的 build.gradle.kts 檔案中新增下列 compileOnly 依附元件：

Groovy

dependencies {
    // ... other dependencies
    compileOnly "com.android.extensions.xr:extensions-xr:1.4.0"
}

Kotlin

dependencies {
    // ... other dependencies
    compileOnly("com.android.extensions.xr:extensions-xr:1.4.0")
}

新增擴增體驗 (音訊和顯示型眼鏡) 的程式庫依附元件

首先，請參閱下列參考指南，瞭解各個必要程式庫的必要依附元件和相容性問題：

接著，在應用程式的 build.gradle.kts 檔案中新增必要依附元件：

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.1.0-alpha02"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha18"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha18"
    implementation "androidx.xr.projected:projected:1.0.0-alpha13"
    implementation "androidx.xr.arcore:arcore:1.0.0-beta02"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha18")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha18")
    implementation("androidx.xr.projected:projected:1.0.0-alpha13")
    implementation("androidx.xr.arcore:arcore:1.0.0-beta02")
}
上一頁
建立 Android XR 專案