הפעלת AR כדי להשתמש בתכונות של מציאות רבודה באפליקציה החדשה או הקיימת.
הגדרת האפליקציה כחובה או כאופציונלית ב-AR
כדי לחסוך מקום במכשירים ספציפיים, כל תכונות ה-AR נשמרות באפליקציה שנקראת Google Play Services למציאות רבודה ומתעדכנת בנפרד בחנות Play. אפליקציות ל-Android שמשתמשות בתכונות AR מתקשרות עם שירותי Google Play למציאות רבודה באמצעות ARCore SDK. ניתן להגדיר אפליקציה שתומכת בתכונות AR בשתי דרכים: חובה ב-AR ואופציונלי ל-AR. הסיווג הזה קובע את האינטראקציה של האפליקציה עם שירותי Google Play לאפליקציית AR.
אפליקציות שנדרשות AR לא יכולות לפעול ללא ARCore. לשם כך נדרש מכשיר שתומך ב-ARCore שמותקן בו שירותי Google Play למציאות רבודה.
- חנות Google Play תהפוך את האפליקציות שחובה לרכוש בהן AR רק במכשירים שתומכים ב-ARCore.
- כשמשתמשים מתקינים אפליקציה שחובה להכיר, חנות Google Play תתקין במכשיר שלהם באופן אוטומטי את שירותי Google Play למציאות רבודה. עם זאת, האפליקציה שלך עדיין צריכה לבצע בדיקות נוספות בזמן הריצה, למקרה ששירות Google Play Services למציאות רבודה לא מעודכן או שהוסר באופן ידני.
באפליקציית AR אופציונלי נעשה שימוש ב-ARCore כדי לשפר פונקציונליות קיימת. יש בו תכונות AR אופציונליות שמופעלות רק במכשירים שתומכים ב-ARCore שבהם הותקנו שירותי Google Play ל-AR.
- אפשר להתקין ולהפעיל אפליקציות AR אופציונליות במכשירים שלא תומכים ב-ARCore.
- כשמשתמשים מתקינים אפליקציה אופציונלית ל-AR, חנות Google Play לא תתקין באופן אוטומטי את שירותי Google Play למציאות רבודה במכשיר.
| נדרש AR | AR אופציונלי | |
|---|---|---|
| שימוש בתכונות AR | לאפליקציה שלך נדרשת ARCore לצורך פונקציונליות בסיסית. | ARCore מרחיב את הפונקציונליות של האפליקציה. האפליקציה שלך יכולה לפעול ללא תמיכה ב-ARCore. |
| חשיפה בחנות Play | האפליקציה שלך רשומה בחנות Play רק במכשירים שתומכים ב-ARCore. | האפליקציה פועלת בהתאם לנוהלי הרישום הרגילים. |
| שיטת ההתקנה של Google Play Services ל-AR | חנות Play מתקינה את Google Play Services למציאות רבודה לצד האפליקציה שלכם. | האפליקציה שלך משתמשת ב-ARSession.state כדי להוריד ולהתקין את ARCore. |
הדרישות ל-Android minSdkVersion |
Android 7.0 (רמת API 24) | Android 4.4 (API ברמה 19), אבל כדי להפעיל כל פונקציונליות AR נדרשת מערכת Android 7.0 (רמת API 24) לפחות |
צריך להשתמש ב-ARSession.state כדי לבדוק את התמיכה ב-ARCore ואת סטטוס ההתקנה |
הגדרת האפליקציה כחובה ב-AR
Android
נווט אל Edit > Project Settings > XR Plug-in Management > ARCore. כברירת מחדל, הערך של Requirement מוגדר ל-Required.
לחצו על Edit > Project Settings > Player ובחרו בכרטיסייה עם סמל Android.
בקטע Other Settings > Identification, צריך לציין ערך של Minimum API Level בגובה
24ומעלה.
iOS
נווט אל Edit > Project Settings > XR Plug-in Management > ARKit. כברירת מחדל, הערך של Requirement מוגדר ל-Required.
לוחצים על Edit > Project Settings > Player ובוחרים בכרטיסייה עם הסמל של iOS.
בקטע Other Settings > Configuration, מציינים את Target minimum iOS Version של האפליקציה.
הגדרת ה-AR של האפליקציה כאופציונלי
Android
נווט אל Edit > Project Settings > XR Plug-in Management > ARCore.
בתפריט הנפתח Requirement, בוחרים באפשרות Optional כדי להגדיר את האפליקציה כאופציונלי ל-AR.
לחצו על Edit > Project Settings > Player ובחרו בכרטיסייה עם סמל Android.
בקטע Other Settings > Identification, צריך לציין ערך של Minimum API Level בגובה
24ומעלה.
iOS
נווט אל Edit > Project Settings > XR Plug-in Management > ARKit.
בתפריט הנפתח Requirement בוחרים באפשרות Optional כדי להגדיר את האפליקציה כאופציונלי ל-AR.
לוחצים על Edit > Project Settings > Player ובוחרים בכרטיסייה עם הסמל של iOS.
בקטע Other Settings > Configuration, מציינים את Target minimum iOS Version של האפליקציה.
ביצוע בדיקות בזמן ריצה
איך לבדוק אם שירותי Google Play למציאות רבודה מותקנים
לפני שיוצרים סשן ARCore, גם אפליקציות שמחייבות AR וגם אפליקציות AR אופציונליות צריכות לבצע קריאה ל-ARSession.state כדי לבדוק אם מותקנת (עדיין) גרסה תואמת של שירותי Google Play ל-AR וכדי לוודא שכל הנתונים הנדרשים בפרופיל מכשיר ARCore הורדו.
במהלך זמן הריצה, אפליקציות שנדרשות ב-AR מבצעות בדיקות זמן ריצה באופן אוטומטי כדי לוודא שמכשיר היעד:
- תמיכה ב-ARCore
- האפליקציה Google Play Services for AR הותקנה – אם היא לא מותקנת (יכול להיות שהמשתמש הסיר אותה) או שהגרסה ישנה מדי, המשתמשים יתבקשו להתקין או לעדכן אותה באפליקציה.
- מכיל נתונים עדכניים של פרופיל מכשיר ARCore – אם הוא לא מעודכן, האפליקציה תוריד נתונים חדשים.
כדי להשבית את הבדיקות האלה כברירת מחדל, יש להגדיר את ARSession.attemptUpdate לערך false. האפליקציה שלכם עדיין אמורה לטפל בתנאים הבאים:
| תנאי | פעולה |
|---|---|
| המכשיר לא תומך ב-ARCore. | הסתרת פונקציונליות שקשורה ל-AR. |
| המכשיר תומך ב-ARCore, אבל Google Play Services for AR ו/או נתוני הפרופיל של מכשיר ARCore לא מותקנים או לא עדכניים. | מוצגת למשתמש בקשה להתקין או לעדכן את Google Play Services for AR ו/או
את נתוני הפרופיל של מכשיר ARCore באמצעות הקריאה
ARSession.Install(). |
| המכשיר תומך ב-ARCore וב-Google Play Services for AR, ונתוני פרופיל במכשיר ARCore מותקנים ומעודכנים. | יוצר ARCore Session ומתחיל להשתמש ב-ARCore. |
אפשר גם לבדוק ב-ARSession.state את מצבי ההתקנה והתמיכה.
ציות לדרישות בנושא פרטיות המשתמשים
כדי לפרסם את האפליקציה בחנות Play, צריך לוודא שהיא עומדת בדרישות של ARCore בנושא פרטיות המשתמשים.