ขอขอบคุณที่เข้าร่วมงาน Android Dev Summit กับเรา ดูการบรรยายเกี่ยวกับ Android XR อีกครั้ง ลองใช้สิ่งต่างๆ และส่งความคิดเห็นถึงเรา

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

เริ่มต้นสร้างประสบการณ์สมจริง

อุปกรณ์ XR ที่รองรับ

คำแนะนำนี้จะช่วยคุณสร้างประสบการณ์การใช้งานสำหรับอุปกรณ์ XR ประเภทนี้

ดูข้อมูลเกี่ยวกับประเภทอุปกรณ์ XR →

ชุดหูฟัง XR

แว่นตา XR แบบใช้สาย

ดูข้อมูลเกี่ยวกับประเภทอุปกรณ์ XR →

หลังจากติดตั้งและกำหนดค่า Android Studio, สร้างโปรเจ็กต์ และตั้งค่า Jetpack XR SDK แล้ว คุณก็พร้อมที่จะเริ่มสร้างประสบการณ์ที่สมจริงสำหรับอุปกรณ์ต่างๆ เช่น ชุดหูฟัง XR และแว่นตา XR แบบมีสาย

ก่อนที่จะเริ่มสำรวจวิธีต่างๆ ในการสร้าง โปรดอ่านข้อมูลและทำงานในส่วนต่อไปนี้ให้เสร็จสมบูรณ์เพื่อให้แน่ใจว่าแอปของคุณได้รับการกำหนดค่าสำหรับการพัฒนา XR ที่สมจริง

กำหนดค่าไฟล์ Manifest ของแอป

เช่นเดียวกับโปรเจ็กต์แอป Android อื่นๆ แอป Android XR ต้องมีไฟล์ AndroidManifest.xml ที่มีการตั้งค่าไฟล์ Manifest ที่เฉพาะเจาะจง ไฟล์ Manifest อธิบายข้อมูลสำคัญเกี่ยวกับแอปของคุณให้เครื่องมือสร้าง Android, ระบบปฏิบัติการ Android และ Google Play ทราบ ดูข้อมูลเพิ่มเติมได้ที่คู่มือภาพรวมไฟล์ Manifest ของแอป

สำหรับแอปที่แตกต่างกันสำหรับ XR ไฟล์ Manifest ต้องมีองค์ประกอบและแอตทริบิวต์ต่อไปนี้

พร็อพเพอร์ตี้ PROPERTY_XR_ACTIVITY_START_MODE

พร็อพเพอร์ตี้ android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE" ช่วยให้ระบบทราบว่าควรเปิดกิจกรรมในโหมดที่เฉพาะเจาะจงเมื่อเริ่มกิจกรรม

พร็อพเพอร์ตี้นี้มีค่าต่อไปนี้

XR_ACTIVITY_START_MODE_HOME_SPACE (Jetpack XR SDK เท่านั้น)
XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED (Jetpack XR SDK เท่านั้น)

XR_ACTIVITY_START_MODE_HOME_SPACE

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

<manifest ... >

   <application ... >
       <property
           android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
           android:value="XR_ACTIVITY_START_MODE_HOME_SPACE" />
       <activity
           android:name="com.example.myapp.MainActivity" ... >

           <intent-filter>
               <action android:name="android.intent.action.MAIN" />

               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
       </activity>
   </application>
</manifest>

XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED

ใช้โหมดเริ่มต้นนี้เพื่อเปิดแอปใน Full Space ใน Full Space จะมีแอปทำงานเพียงแอปเดียวในแต่ละครั้ง โดยไม่มีขอบเขตพื้นที่ทำงาน และแอปอื่นๆ ทั้งหมดจะถูกซ่อนไว้


<manifest ... >

   <application ... >
       <property
           android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
           android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />
       <activity
           android:name="com.example.myapp.MainActivity" ... >

           <intent-filter>
               <action android:name="android.intent.action.MAIN" />

               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
       </activity>
   </application>
</manifest>

พร็อพเพอร์ตี้ PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

พร็อพเพอร์ตี้ android:name="android.window.PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED" บ่งชี้ว่าควรเปิดแอปพลิเคชันด้วยขอบเขตประเภทที่เฉพาะเจาะจง แอปของคุณต้องระบุ XR_BOUNDARY_TYPE_LARGE หากออกแบบมาเพื่อให้ผู้ใช้เคลื่อนที่ไปรอบๆ พื้นที่จริง การระบุ XR_BOUNDARY_TYPE_NO_RECOMMENDATION จะไม่ให้คำแนะนำสำหรับประเภทขอบเขตความปลอดภัย ดังนั้นระบบจะใช้ประเภทที่ใช้อยู่แล้ว

<manifest ... >

   <application ... >
       <property
           android:name="android.window.PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED"
           android:value="XR_BOUNDARY_TYPE_LARGE" />
   </application>
</manifest>

ฟีเจอร์ PackageManager สำหรับแอป XR

เมื่อคุณจัดจำหน่ายแอปผ่าน Google Play Store คุณสามารถระบุฟีเจอร์ฮาร์ดแวร์หรือซอฟต์แวร์ที่จำเป็นในไฟล์ Manifest ของแอปได้ องค์ประกอบ uses-feature ช่วยให้ Play Store กรองแอปที่แสดงต่อผู้ใช้ได้อย่างเหมาะสม

ฟีเจอร์ต่อไปนี้มีไว้สำหรับแอปที่สร้างความแตกต่างด้วย XR โดยเฉพาะ

android.software.xr.api.spatial

แอปที่สร้างโดยใช้ Jetpack XR SDK ต้องมีฟีเจอร์นี้ในไฟล์ Manifest ของแอป ค่าที่คุณตั้งค่าสำหรับแอตทริบิวต์ android:required จะขึ้นอยู่กับแทร็กการเผยแพร่ของแอป

หากแอปของคุณรวมฟีเจอร์หรือเนื้อหาที่แตกต่างกันสำหรับ XR ไว้ใน APK บนอุปกรณ์เคลื่อนที่ที่มีอยู่และเผยแพร่ในแทร็กการเผยแพร่บนอุปกรณ์เคลื่อนที่ ให้ตั้งค่าแอตทริบิวต์ android:required เป็น false ดังนี้

<!-- If you are publishing an existing mobile APK using the mobile release track, set android:required to false.-->
<uses-feature android:name="android.software.xr.api.spatial" android:required="false" />

หากแอปของคุณสร้างขึ้นสำหรับอุปกรณ์ที่เปิดใช้ XR โดยเฉพาะและเผยแพร่ไปยังแทร็กการเผยแพร่สำหรับ Android XR โดยเฉพาะ ให้ตั้งค่าแอตทริบิวต์ android:required เป็น true ดังนี้

<!-- If you are publishing a separate APK for XR using the dedicated Android XR release track, set android:required to true.-->
<uses-feature android:name="android.software.xr.api.spatial" android:required="true" />

android.hardware.xr.input.controller

ฟีเจอร์นี้ระบุว่าแอปต้องใช้อินพุตจากตัวควบคุมการเคลื่อนไหว 6DoF (ระดับความอิสระ) ที่มีความแม่นยำสูงเพื่อให้ทำงานได้อย่างถูกต้อง หากแอปของคุณรองรับตัวควบคุมและทำงานไม่ได้หากไม่มีตัวควบคุม ให้ตั้งค่าเป็น true หากแอปของคุณรองรับคอนโทรลเลอร์แต่ทำงานได้โดยไม่ต้องใช้คอนโทรลเลอร์ ให้ตั้งค่าเป็น false

หมายเหตุ: ตัวควบคุมการเคลื่อนไหว 6DoF คือตัวควบคุมฮาร์ดแวร์ 1 คู่ โดยมีตัวควบคุมสำหรับมือแต่ละข้าง ระบบจะติดตามตัวควบคุมแต่ละตัวแยกกันในพื้นที่ผ่านระดับความอิสระ 6 ระดับ ทั้งการเคลื่อนไหวเชิงเส้นและการหมุน โดยทั่วไปแล้วตัวควบคุมเหล่านี้จะมีปุ่มกดหลายปุ่ม รวมถึงทริกเกอร์และการตอบสนองแบบรู้สึกได้

<!-- Sets android:required to true, indicating that your app can't function on devices without controllers. -->
<uses-feature android:name="android.hardware.xr.input.controller" android:required="true" />

android.hardware.xr.input.hand_tracking

แฟล็กนี้ระบุว่าแอปต้องใช้การติดตามการเคลื่อนไหวของมือที่มีความแม่นยำสูงเพื่อให้ทำงานได้อย่างถูกต้อง ซึ่งรวมถึงตำแหน่ง การวางแนว และความเร็วของข้อต่อในมือของผู้ใช้ หากแอปรองรับการติดตามการเคลื่อนไหวของมือและทำงานไม่ได้หากไม่มีฟีเจอร์นี้ ให้ตั้งค่าเป็น true หากแอปของคุณรองรับการติดตามการเคลื่อนไหวของมือ แต่สามารถทำงานได้โดยไม่ต้องใช้ ให้ตั้งค่าเป็น false

<!-- Sets android:required to true, indicating that your app can't function on devices without hand tracking. -->
<uses-feature android:name="android.hardware.xr.input.hand_tracking" android:required="true" />

android.hardware.xr.input.eye_tracking

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

<!-- Sets android:required to true, indicating that your app can't function on devices without eye tracking. -->
<uses-feature android:name="android.hardware.xr.input.eye_tracking" android:required="true" />

android.hardware.xr.input.face_tracking

Flag นี้ระบุว่าแอปต้องใช้ฮาร์ดแวร์การติดตามใบหน้าจึงจะทำงานได้อย่างถูกต้อง หากแอปรองรับการติดตามใบหน้าและทำงานไม่ได้หากไม่มีฟีเจอร์นี้ ให้ตั้งค่าเป็น true หากแอปของคุณรองรับการติดตามใบหน้า แต่สามารถทำงานได้โดยไม่ต้องใช้ฟีเจอร์นี้ ให้ตั้งค่าเป็น false

<!-- Sets android:required to true, indicating that your app can't function on devices without face tracking. -->
<uses-feature android:name="android.hardware.xr.input.face_tracking" android:required="true" />

หมายเหตุ: การติดตามการเคลื่อนไหวของมือ การติดตามดวงตา การติดตามใบหน้า การติดตามร่างกาย การทำความเข้าใจฉาก และตำแหน่งเป็นความสามารถที่ละเอียดอ่อนด้านความเป็นส่วนตัว และกำหนดให้แอปต้องขอสิทธิ์รันไทม์ ดูข้อมูลเพิ่มเติมเกี่ยวกับการประกาศและการขอสิทธิ์ได้ที่ทำความเข้าใจสิทธิ์สำหรับ XR

ข้อควรพิจารณาเกี่ยวกับความเข้ากันได้ของไฟล์ Manifest ของแอปสำหรับแอปบนอุปกรณ์เคลื่อนที่และแอปบนหน้าจอขนาดใหญ่

ตามที่อธิบายไว้ในส่วนฟีเจอร์ PackageManager สำหรับแอป XR แอปจะประกาศว่าใช้ฟีเจอร์โดยประกาศในองค์ประกอบ <uses-feature> ในไฟล์ Manifest ของแอป ฟีเจอร์บางอย่าง เช่น โทรศัพท์หรือ GPS อาจใช้งานร่วมกับอุปกรณ์บางรุ่นไม่ได้

หากต้องการดูรายการฟีเจอร์ที่เปิดใช้สำหรับอุปกรณ์ ให้เรียกใช้ adb shell pm list features

ฟีเจอร์ที่ไม่รองรับ

Google Play Store จะกรองแอปพลิเคชันที่พร้อมให้ติดตั้งในอุปกรณ์โดยใช้การประกาศฟีเจอร์ Android ต่อไปนี้

ขั้นตอนถัดไป

เมื่อกำหนดค่าไฟล์ Manifest ของแอปและตรวจสอบข้อมูลสำคัญเสร็จแล้ว ให้สำรวจวิธีสร้างประสบการณ์ที่สมจริงดังนี้

แสดงแอป Android เป็น 3 มิติด้วย XR

กำหนดค่าไฟล์ Manifest ของแอป

พร็อพเพอร์ตี้ PROPERTY_XR_ACTIVITY_START_MODE

XR_ACTIVITY_START_MODE_HOME_SPACE

XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED

พร็อพเพอร์ตี้ PROPERTY_XR_BOUNDARY_TYPE_RECOMMENDED

ฟีเจอร์ PackageManager สำหรับแอป XR

android.software.xr.api.spatial

android.hardware.xr.input.controller

android.hardware.xr.input.hand_tracking

android.hardware.xr.input.eye_tracking

android.hardware.xr.input.face_tracking

ฟีเจอร์ที่ไม่รองรับ

ฮาร์ดแวร์กล้อง

การเชื่อมต่อ

การกำหนดค่าอุปกรณ์

การกำหนดค่ารูปแบบของอุปกรณ์

อินพุต

ตำแหน่ง

Near Field Communication

การกำหนดค่าการรักษาความปลอดภัยและฮาร์ดแวร์

เซ็นเซอร์

การกำหนดค่าซอฟต์แวร์

โทรศัพท์

เทคโนโลยีความจริงเสมือน (เดิม)

วิดเจ็ต

ขั้นตอนถัดไป