הגענו לגרסה Developer Preview 3 של Android XR SDK, ואנחנו רוצים לקבל מכם משוב! אתם יכולים לנסות את האפשרויות השונות ולפנות אלינו דרך דף התמיכה.

דף זה תורגם על ידי Cloud Translation API.

איך מתחילים ליצור חוויות סוחפות

מכשירי XR רלוונטיים

ההנחיות האלה יעזרו לכם ליצור חוויות למכשירי XR מהסוגים האלה.

מידע על סוגי מכשירי XR →

משקפי XR

משקפי AR חוטיים

מידע על סוגי מכשירי XR →

אחרי ההתקנה וההגדרה של Android Studio, יצירת פרויקט וההגדרה של Jetpack XR SDK, אפשר להתחיל ליצור חוויות אימרסיביות.

לפני שמתחילים לבדוק את כל הדרכים שבהן אפשר לפתח, כדאי לעיין במידע ולבצע את כל המשימות שבקטעים הבאים כדי לוודא שהאפליקציה מוגדרת לפיתוח XR אימרסיבי.

הגדרת קובץ המניפסט של האפליקציה

כמו בפרויקטים אחרים של אפליקציות ל-Android, גם לאפליקציית Android XR צריך להיות קובץ AndroidManifest.xml עם הגדרות מניפסט ספציפיות. קובץ המניפסט מתאר מידע חיוני על האפליקציה שלכם לכלי הבנייה של Android, למערכת ההפעלה Android ול-Google Play. מידע נוסף זמין במדריך בנושא סקירה כללית של מניפסט האפליקציה.

באפליקציות עם תכונות ייחודיות ל-XR, קובץ המניפסט צריך לכלול את הרכיבים והמאפיינים הבאים:

המאפיין 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

משתמשים במצב ההתחלה הזה כדי להפעיל את האפליקציה ב'מרחב הבית'. במרחב הבית, אפשר להפעיל כמה אפליקציות זו לצד זו, כך שהמשתמשים יכולים לבצע כמה משימות בו-זמנית. כל אפליקציית Android לנייד או למסך גדול יכולה לפעול במרחב הבית, וגם אפליקציות 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

משתמשים במצב ההפעלה הזה כדי להפעיל את האפליקציה במצב מסך מלא. במסך מלא, רק אפליקציה אחת פועלת בכל פעם, בלי גבולות בין האפליקציות, וכל שאר האפליקציות מוסתרות.


<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, אפשר לציין במניפסט של האפליקציה תכונות חומרה או תוכנה שנדרשות להפעלה שלה. האלמנט uses-feature מאפשר לחנות Play לסנן בצורה מתאימה את האפליקציות שמוצגות למשתמשים.

התכונות הבאות ספציפיות לאפליקציות עם הבדלים בין פלטפורמות XR.

android.software.xr.api.spatial

אפליקציות שמבוססות על Jetpack XR SDK חייבות לכלול את התכונה הזו במניפסט האפליקציה. הערך שאתם מגדירים למאפיין android:required תלוי במסלול ההפצה של האפליקציה.

אם חבילות ה-App Bundle שלכם כוללות תכונות או תוכן שמותאמים ל-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

התכונה הזו מציינת שהאפליקציה דורשת קלט מבקר תנועה בעל דיוק גבוה עם 6 דרגות חופש (6DoF) כדי לפעול בצורה תקינה. אם האפליקציה תומכת בבקרי משחק ולא יכולה לפעול בלעדיהם, צריך להגדיר את הערך true. אם האפליקציה תומכת בבקרי משחק אבל אפשר להשתמש בה גם בלי בקרים, צריך להגדיר אותה לfalse.

<!-- 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" />

שיקולים לגבי תאימות של מניפסט האפליקציה לאפליקציות לנייד ולאפליקציות למסך גדול

כמו שמתואר בקטע תכונות של PackageManager לאפליקציות XR, אפליקציות מצהירות על שימוש בתכונה מסוימת על ידי הצהרה עליה ברכיב <uses-feature> בקובץ המניפסט של האפליקציה. יכול להיות שחלק מהתכונות, כמו טלפוניה או GPS, לא יהיו תואמות לכל המכשירים.

כדי לראות רשימה של התכונות שמופעלות במכשיר, מריצים את הפקודה adb shell pm list features.

תכונות שאינן נתמכות

מסנני חנות Google Play מסננים את האפליקציות שזמינות להתקנה במכשיר באמצעות ההצהרות הבאות של תכונות Android.

השלבים הבאים

אחרי שסיימתם להגדיר את המניפסט של האפליקציה ולבדוק מידע חשוב, הגיע הזמן לבדוק איך אפשר ליצור חוויות סוחפות:

איך מתחילים ליצור חוויות סוחפות קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

הגדרת קובץ המניפסט של האפליקציה

המאפיין 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

שיקולים לגבי תאימות של מניפסט האפליקציה לאפליקציות לנייד ולאפליקציות למסך גדול

תכונות שאינן נתמכות

חומרה של מצלמה

קישוריות

תצורת המכשיר

הגדרת גורם צורה

קלט

מיקום

תקשורת מטווח קצר

תצורת אבטחה וחומרה

חיישנים

הגדרת תוכנה

טלפוניה

מציאות מדומה (גרסה קודמת)

ווידג'טים

השלבים הבאים

איך מתחילים ליצור חוויות סוחפות