הפעלת AR כדי להשתמש בתכונות של מציאות רבודה באפליקציה החדשה או הקיימת.
הגדרת האפליקציה כחובה ב-AR או כאופציונלי ב-AR
כדי לחסוך במקום במכשירים ספציפיים, כל תכונות ה-AR מאוחסנות באפליקציה בשם Google Play Services למציאות רבודה שמתעדכנת בנפרד בחנות Play. אפליקציות ל-Android שמשתמשות בתכונות AR מתקשרות עם Google Play Services למציאות רבודה באמצעות ARCore SDK. יש שתי דרכים להגדיר אפליקציה שתומכת בתכונות AR: חובה ב-AR ואופציונלי ב-AR. הסיווג הזה קובע את האינטראקציה בין האפליקציה לבין שירותי Google Play למציאות רבודה.
אפליקציות שנדרשות AR לא יכולות לפעול ללא ARCore. כדי לעשות זאת, נדרש מכשיר שתומך ב-ARCore שבו מותקן Google Play Services למציאות רבודה.
- אפליקציות שנדרשות ב-AR יהיו זמינות בחנות Google Play רק במכשירים שתומכים ב-ARCore.
- כשמשתמשים מתקינים אפליקציה נדרשת ל-AR, בחנות Google Play יותקנו באופן אוטומטי שירותי Google Play למציאות רבודה במכשיר שלהם. עם זאת, האפליקציה עדיין חייבת לבצע בדיקות נוספות בזמן הריצה למקרה ששירות Google Play Services למציאות רבודה לא עדכני או אם האפליקציה הוסרה באופן ידני.
באפליקציית AR אופציונלי נעשה שימוש ב-ARCore כדי לשפר פונקציונליות קיימת. יש בה תכונות AR אופציונליות שפועלות רק במכשירים שתומכים ב-ARCore שהתקינו את Google Play Services ל-AR.
- אפשר להתקין ולהפעיל אפליקציות אופציונליות של AR במכשירים שלא תומכים ב-ARCore.
- כשמשתמשים מתקינים אפליקציה ל-AR, חנות Google Play לא תתקין במכשיר באופן אוטומטי את Google Play Services למציאות רבודה.
| נדרש AR | AR אופציונלי | |
|---|---|---|
| שימוש בתכונות AR | לאפליקציה שלך נדרשת ARCore לפונקציונליות בסיסית. | ARCore מרחיב את הפונקציונליות של האפליקציה. האפליקציה יכולה לפעול בלי תמיכה ב-ARCore. |
| חשיפה בחנות Play | האפליקציה שלך רשומה בחנות Play רק במכשירים שתומכים ב-ARCore. | האפליקציה פועלת בהתאם לנוהלי הרישום הרגילים. |
| שיטת ההתקנה של Google Play Services ל-AR | חנות 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 Optional.
לוחצים על Edit > Project Settings > Player ובוחרים בכרטיסייה עם סמל ה-iOS.
בקטע Other Settings > Configuration ציינו את Target minimum iOS Version של האפליקציה.
ביצוע בדיקות בזמן ריצה
איך לבדוק אם שירותי Google Play למציאות רבודה מותקנים
לפני שיוצרים סשן ARCore, גם האפליקציות שמחייבות AR וגם אפליקציות ל-AR אופציונליות חייבות להשתמש בקורוטין ARSession.Install()
כדי לבדוק אם מותקנת גרסה תואמת של Google Play Services ל-AR (עדיין), ולוודא שבוצעה הורדה של כל נתוני הפרופיל הנדרשים של מכשיר ARCore.
בזמן הריצה, אפליקציות שנדרשות ב-AR יבצעו באופן אוטומטי בדיקות בזמן הריצה כדי לוודא שמכשיר היעד:
- תמיכה ב-ARCore
- הותקנה האפליקציה Google Play Services for AR – אם היא לא מותקנת (ככל הנראה כי המשתמש הסיר אותה) או אם הגרסה ישנה מדי, המשתמשים יתבקשו להתקין או לעדכן אותה.
- כולל נתונים עדכניים של פרופיל מכשיר ARCore, ואם הוא לא עדכני, האפליקציה תוריד נתונים חדשים.
כדי להשבית את בדיקות ברירת המחדל האלה, יש להגדיר את ARSession.attemptUpdate לערך false. האפליקציה שלכם עדיין אמורה לטפל בתנאים הבאים:
| תנאי | פעולה |
|---|---|
| המכשיר לא תומך ב-ARCore. | הסתרת פונקציונליות שקשורה ל-AR. |
| המכשיר תומך ב-ARCore, אבל נתוני הפרופיל במכשיר ARCore או Google Play Services for AR לא מותקנים או לא מעודכנים. | מוצגת למשתמש בקשה להתקין או לעדכן את נתוני הפרופיל של מכשיר Google Play Services for AR ו/או
ARCore באמצעות קריאה ל-ARSession.Install(). |
| המכשיר תומך ב-ARCore וב-Google Play Services for AR, ונתוני פרופיל במכשיר ARCore מותקנים ועדכניים. | יצירת ARCore Session והתחלת השימוש ב-ARCore. |
אפשר גם לבדוק את מצבי ההתקנה והתמיכה ב-ARSession.state.
ציות לדרישות בנושא פרטיות המשתמשים
כדי לפרסם את האפליקציה בחנות Play, צריך לוודא שהיא עומדת בדרישות של ARCore בנושא פרטיות המשתמשים.
מה השלב הבא?
- מידע נוסף על הגדרה של סשן ARCore