ตั้งค่า Jetpack XR SDK

อุปกรณ์ XR ที่ใช้ได้
คำแนะนำนี้จะช่วยให้คุณสร้างประสบการณ์การใช้งานสำหรับอุปกรณ์ XR ประเภทต่างๆ เหล่านี้ได้
ชุดหูฟัง XR
แว่นตา XR แบบมีสาย
แว่นตา AI

คุณต้องตั้งค่า Jetpack XR SDK ก่อนจึงจะเริ่มสร้างได้ ทำตาม ขั้นตอนในแต่ละส่วนเพื่อตั้งค่าสภาพแวดล้อมการพัฒนาด้วย SDK

ตรวจสอบความเข้ากันได้ของ Android SDK

Jetpack XR SDK กำหนดให้แอปของคุณต้องใช้ Android minSdk 24 และ compileSdk 34 ขึ้นไป

เพิ่มการขึ้นต่อกันของไลบรารี

Dependency ที่แอปของคุณต้องการจะขึ้นอยู่กับประเภทประสบการณ์และ อุปกรณ์ XR ที่คุณสร้าง ดูข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มการอ้างอิงสำหรับแอปได้ในส่วนต่อไปนี้

เพิ่มทรัพยากร Dependency ของไลบรารีสำหรับประสบการณ์สมจริง (ชุดหูฟัง XR และแว่นตา XR)

ก่อนอื่น โปรดดูคู่มืออ้างอิงต่อไปนี้เพื่อทำความเข้าใจทรัพยากร Dependency ที่จำเป็นและปัญหาความเข้ากันได้สำหรับไลบรารีที่จำเป็นแต่ละรายการ

จากนั้นเพิ่มทรัพยากร Dependency ที่จำเป็นลงในไฟล์ build.gradle.kts ของแอป

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha09"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha10"
    implementation "androidx.xr.compose:compose:1.0.0-alpha09"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha13"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha09"

    // For compatibility with guava, use these dependencies:
    implementation "androidx.xr.arcore:arcore-guava:1.0.0-alpha09"
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha09"
    implementation "androidx.xr.scenecore:scenecore-guava:1.0.0-alpha10"

    // For compatibility with rxjava3, use these dependencies:
    implementation "androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha09"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha09"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha09")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha10")
    implementation("androidx.xr.compose:compose:1.0.0-alpha09")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha13")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha09")

    // For compatibility with guava, use these dependencies:
    implementation("androidx.xr.arcore:arcore-guava:1.0.0-alpha09")
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha09")
    implementation("androidx.xr.scenecore:scenecore-guava:1.0.0-alpha10")

    // For compatibility with rxjava3, use these dependencies:
    implementation("androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha09")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha09")
}

เปิดใช้การลดขนาดโค้ด (ไม่บังคับ)

หากต้องการเปิดใช้การลดขนาดโค้ดและการปรับโค้ดให้ยากต่อการอ่านโดยใช้ ProGuard สำหรับบิลด์ คุณต้องเพิ่มทรัพยากร Dependency ในไลบรารีส่วนขยาย Android สำหรับ XR ด้วย นี่เป็นข้อกำหนดสำหรับโปรเจ็กต์ที่ใช้ Jetpack XR alpha05 ขึ้นไป

เพิ่มทรัพยากร Dependency compileOnly ต่อไปนี้ลงในไฟล์ build.gradle.kts ของโมดูล

Groovy

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

Kotlin

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

เพิ่มการอ้างอิงไลบรารีสำหรับประสบการณ์การใช้งานแบบเพิ่มความเป็นจริง (แว่นตา AI)

ก่อนอื่น โปรดดูคู่มืออ้างอิงต่อไปนี้เพื่อทำความเข้าใจทรัพยากร Dependency ที่จำเป็นและปัญหาความเข้ากันได้สำหรับไลบรารีที่จำเป็นแต่ละรายการ

จากนั้นเพิ่มทรัพยากร Dependency ที่จำเป็นลงในไฟล์ build.gradle.kts ของแอป

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha09"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha02"
    implementation "androidx.xr.projected:projected:1.0.0-alpha03"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha09"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha09")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha02")
    implementation("androidx.xr.proejcted:projected:1.0.0-alpha03")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha09")
}