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