אפשר להפעיל AR כדי להשתמש בתכונות של מציאות רבודה באפליקציה החדשה או הקיימת.
הגדרת האפליקציה כחובה או כ-AR אופציונלית
כדי לחסוך במקום במכשירים ספציפיים, כל תכונות ה-AR מאוחסנות באפליקציה בשם Google Play Services למציאות רבודה שמתעדכנת בנפרד על ידי חנות Play. אפליקציות ל-Android שמשתמשות בתכונות AR מתקשרות עם Google Play Services למציאות רבודה באמצעות ARCore SDK. אפשר להגדיר אפליקציות שתומכות בתכונות AR בשתי דרכים: חובה ב-AR ואופציונלי ל-AR. הסיווג הזה קובע את האינטראקציה של האפליקציה עם אפליקציית Google Play Services למציאות רבודה.
אפליקציה נדרש AR לא יכולה לפעול בלי ARCore. כדי לעשות זאת, נדרש מכשיר שנתמך ב-ARCore, שהותקן בו שירותי Google Play למציאות רבודה.
- בחנות Google Play, אפליקציות חובה ב-AR יהיו זמינות רק במכשירים שתומכים ב-ARCore.
- כשמשתמשים מתקינים אפליקציה שנדרשת ל-AR, חנות Google Play תתקין במכשיר שלהם באופן אוטומטי את שירותי Google Play למציאות רבודה. עם זאת, האפליקציה עדיין צריכה לבצע בדיקות נוספות של סביבת זמן הריצה למקרה ש-'Google Play Services למציאות רבודה' לא עדכני או שהוא הוסר באופן ידני.
אפליקציה AR אופציונלית משתמשת ב-ARCore כדי לשפר את הפונקציונליות הקיימת. הוא כולל תכונות AR אופציונליות שמופעלות רק במכשירים שנתמכים ב-ARCore שהותקנו בהם שירותי Google Play למציאות רבודה.
- אפשר להתקין ולהפעיל אפליקציות אופציונליות ב-AR במכשירים שלא תומכים ב-ARCore.
- כשמשתמשים מתקינים אפליקציה אופציונלית ל-AR, חנות Google Play לא תתקין במכשיר באופן אוטומטי את שירותי Google Play למציאות רבודה.
| נדרש AR | AR אופציונלי | |
|---|---|---|
| שימוש בתכונות AR | לאפליקציה שלך נדרש ARCore לפונקציונליות בסיסית. | בעזרת ARCore אפשר לשפר את הפונקציונליות של האפליקציה. האפליקציה יכולה לפעול בלי תמיכה ב-ARCore. |
| הרשאות הגישה לחנות Play | האפליקציה שלך מופיעה בחנות Play רק במכשירים שתומכים ב-ARCore. | האפליקציה פועלת לפי ההליכים הרגילים של כרטיסי מוצר. |
| שיטת ההתקנה של Google Play Services למציאות רבודה | חנות Play מתקינה את Google Play Services למציאות רבודה לצד האפליקציה שלכם. | האפליקציה שלך משתמשת
קורוטין ARSession.Install()
כדי להוריד ולהתקין את ARCore. |
דרישות עבור Android minSdkVersion |
Android 7.0 (רמת API 24) | Android 4.4 (רמת API 19), אם כי הפעלה של פונקציונליות AR נדרשת לפחות Android 7.0 (רמת API 24) |
חובה להשתמש ב-ARSession.state כדי לבדוק את התמיכה ב-ARCore ואת סטטוס ההתקנה
|
||
חובה להשתמש
קורוטין ARSession.Install()
כדי להתקין את Google Play Services למציאות רבודה |
הגדרת האפליקציה כחובה ב-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 Services למציאות רבודה מותקנת
חובה להשתמש גם באפליקציות AR נדרשות וגם באפליקציות AR אופציונליות
קורוטין ARSession.Install()
לפני שיוצרים סשן ARCore כדי לבדוק אם מותקנת גרסה תואמת של Google Play Services למציאות רבודה (עדיין) ולוודא שכל נתוני הפרופיל הנדרשים של מכשיר 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 דרישות בנושא פרטיות המשתמשים.