הפעלת ARCore ל-Android

זהירות: הדף הזה מתעד את ה-ARCore SDK ל-Unity, שהוצא משימוש וכבר לא נתמך ב-Unity 2020 ואילך. צריך להשתמש ב-SDK הזה רק עבור מפתחים שעובדים על פרויקטים קיימים שלא ניתן לעבור ל-AR&

בדף הזה מוסבר איך להפעיל פונקציונליות של ARCore בפרויקטים ב-Unity שמטרגטים מכשירי Android. לשם כך:

1. ייבוא ה-SDK של ARCore ל-Unity
2. הגדרת האפליקציה כך ש-AR יהיה חובה או שהיא אופציונלית ל-AR
3. יש לוודא שהאפליקציה תואמת ל-ARCore's דרישות הפרטיות של המשתמשים

שירותי Google Play ל-AR

ערכות ARCore SDK מאפשרות גישה לתכונות ה-AR הזמינות במכשירים הנתמכים ב-ARCore שמותקנות Google Play Services ל-AR (ARCore) מותקנות.

Google Play Services למציאות רבודה מותקנים באופן אוטומטי ומתעדכנים ברוב המכשירים הנתמכים.

לפני התחלת סשן AR, האפליקציות חייבות:

1. מוודאים ש-ARCore נתמך. לשם כך, מתקשרים CheckApkAvailability.
2. מוודאים שאפליקציית Google Play Services למציאות רבודה מותקנת ומעודכנת, וש הורדת נתוני פרופיל המכשיר של ARCore באמצעות שיחה Session.RequestApkInstallation(bool userRequested).

ייבוא ARCore SDK ל-Unity

1. פותחים את Unity ויוצרים פרויקט 3D חדש.

   זהירות: ה-Universal Render Pipeline (לשעבר Lightweight Render Pipeline או LWRP) לא נתמך על ידי ARCore SDK ל-Unity.

2. התקנת חבילות ספציפיות לגרסה.

   שלישייה 2020

   בוחרים באפשרות Widow > Package Manager (מנהל חבילות) ומתקינים את החבילות הבאות:

   • ריבוי משתתפים ב-HLAPI (נדרש בדוגמת הענן של העוגנים)
   • ניהול הפלאגין של XR (נדרש על ידי התצוגה המקדימה המיידית, שמשתמש ב-TrackedPoseDriver)

   שלישייה 2019

   בוחרים באפשרות Widow > Package Manager (מנהל חבילות) ומתקינים את החבילות הבאות:

   • ריבוי משתתפים ב-HLAPI (נדרש בדוגמת הענן של העוגנים)
   • עוזרי קלט ישנים של XR (נדרש על ידי התצוגה המקדימה המיידית, שמשתמש ב- TrackedPoseDriver)

   שלישייה 2018

   אין צורך בחבילות נוספות. ממשיכים לשלב הבא.

   שלישייה 2017

   אין צורך בחבילות נוספות. ממשיכים לשלב הבא.

3. מייבאים את ה-ARCore SDK ל-Unity:

   1. בוחרים באפשרות PROPERTYs > Import Package > Custom Package (נכסים ו&ייבוא חבילה).

   2. בוחרים את arcore-unity-sdk-1.25.0.unitypackage שהורדתם.

   3. בתיבת הדו-שיח ייבוא חבילה, מוודאים שכל אפשרויות החבילה מסומנות ולוחצים על ייבוא.

בחלון Project של Unity' אתם אמורים לראות גם את קובצי ה-SDK וגם את האפליקציה שלוםAR בדוגמה שב-Assets/GoogleARCore/Examples/HelloAR/.

הגדרת האפליקציה כ-AR נדרשת או כ-AR אופציונלי

יש שתי דרכים להגדיר אפליקציה שתומכת בתכונות AR : AR נדרש ואופציונלי ב-AR. צריכים עזרה בבחירת האפליקציה? תוכלו להיעזר במאמר פרסום אפליקציות AR בחנות Google Play.

נדרש AR

כדי להשתמש בו, לאפליקציה חובה ל-AR מצריך מכשיר הנתמך על ידי ARCore הותקן בו שירותי Google Play ל-AR.

• אפליקציית חנות Google Play מאפשרת גישה לאפליקציות AR הנדרשות רק במכשירים שתומכים ב-ARCore.

• כשמשתמשים מתקינים אפליקציית AR נדרשת, חנות Google Play מתקין באופן אוטומטי את שירותי Google Play ל-AR. עם זאת, האפליקציה שלך עדיין תצטרך לבצע בדיקות זמן ריצה נוספות אם צריך לעדכן את שירותי Google Play ל-AR או להסיר את ההתקנה שלו באופן ידני, או שנתוני הפרופיל ב-ARCore לא מעודכנים.

למידע נוסף, כדאי לעיין בפרסום של אפליקציות AR בחנות Google Play.

כדי להגדיר AR לאפליקציה, יש לבצע את השלבים הבאים.

שלישייה 2020

1. פותחים את Edit > Project Settings (הגדרות > הגדרות פרויקט). בוחרים באפשרות Google ARCore ומוודאים שחובה להשתמש ב-ARCore.

2. מגדירים את רמת ה-API המינימלית בלחיצה על עריכה > פרויקט > נגן, ובחירה בכרטיסייה עם סמל Android. בקטע הגדרות אחרות > זיהוי, בוחרים רמת API מינימלית גבוהה מ-24.

שלישייה 2019

1. פותחים את Edit > Project Settings (הגדרות > הגדרות פרויקט). בוחרים באפשרות Google ARCore ומוודאים שחובה להשתמש ב-ARCore.

2. מגדירים את רמת ה-API המינימלית בלחיצה על עריכה > פרויקט > נגן, ובחירה בכרטיסייה עם סמל Android. בקטע הגדרות אחרות > זיהוי, בוחרים רמת API מינימלית גבוהה מ-24.

שלישייה 2018

1. פותחים את Edit > Project Settings (הגדרות > הגדרות פרויקט). בוחרים באפשרות Google ARCore ומוודאים שחובה להשתמש ב-ARCore.

2. מגדירים את רמת ה-API המינימלית בלחיצה על עריכה > פרויקט > נגן, ובחירה בכרטיסייה עם סמל Android. בקטע הגדרות אחרות > זיהוי, בוחרים רמת API מינימלית גבוהה מ-24.

שלישייה 2017

1. פותחים את Edit > Project Settings > Google ARCore ומוודאים שהאפשרות ARCorerequired מסומנת.

2. מגדירים את רמת ה-API המינימלית בלחיצה על עריכה > פרויקט > נגן, ובחירה בכרטיסייה עם סמל Android. בקטע הגדרות אחרות > זיהוי, בוחרים רמת API מינימלית גבוהה מ-24.

האפליקציה שלך תבצע בדיקות בזמן ריצה באופן אוטומטי כדי לוודא שהמכשיר תומך ב-ARCore וששירותי Google Play Services ל-AR מותקנים ושנתוני הפרופיל ב-ARCore מעודכנים. אם שירותי Google Play ל-AR לא מותקנים (אולי כי הם הוסרו על ידי המשתמשים) או שהגרסה ישנה מדי, האפליקציה תבקש מהמשתמש להתקין או לעדכן אותה. אם נתוני הפרופיל של מכשיר ARCore לא מעודכנים, האפליקציה תוריד ותעדכן אותם. אם ההתקנה או העדכון ייכשלו (אולי בעקבות כשל ברשת), Session.Status יחזיר שגיאה והאפליקציה שלך אמורה לטפל בשגיאה ולצאת ממנה.

AR אופציונלי

לאפליקציה אופציונלית של AR יש תכונות אופציונליות של AR, המופעלות רק במכשירים שמותקנים בהם שירותי Google Play ל-AR.

• ניתן להתקין אפליקציות AR אופציונליות ולהפעיל אותן במכשירים שלא תומכים ב-ARCore.

• כשמשתמשים מתקינים אפליקציה אופציונלית ב-AR, חנות Google Play לא תתקין אוטומטית את שירותי Google Play ל-AR באמצעות האפליקציה.

כדי להפוך אפליקציה ל-AR אופציונלית, יש לבצע את השלבים הבאים.

שלישייה 2020

1. פותחים את Edit > Project Settings (הגדרות > הגדרות פרויקט). בוחרים באפשרות Google ARCore ומבטלים את הסימון של ARCore required.

2. מגדירים את רמת ה-API המינימלית בלחיצה על עריכה > פרויקט > נגן, ובחירה בכרטיסייה עם סמל Android. בקטע הגדרות אחרות > זיהוי, בוחרים רמת API מינימלית גבוהה מ-18.

שלישייה 2019

1. פותחים את Edit > Project Settings (הגדרות > הגדרות פרויקט). בוחרים באפשרות Google ARCore ומבטלים את הסימון של ARCore required.

2. מגדירים את רמת ה-API המינימלית בלחיצה על עריכה > פרויקט > נגן, ובחירה בכרטיסייה עם סמל Android. בקטע הגדרות אחרות > זיהוי, בוחרים רמת API מינימלית גבוהה מ-18.

שלישייה 2018

1. פותחים את Edit > Project Settings (הגדרות > הגדרות פרויקט). בוחרים באפשרות Google ARCore ומבטלים את הסימון של ARCore required.

2. מגדירים את רמת ה-API המינימלית בלחיצה על עריכה > פרויקט > נגן, ובחירה בכרטיסייה עם סמל Android. בקטע הגדרות אחרות > זיהוי, בוחרים רמת API מינימלית גבוהה מ-18.

שלישייה 2017

1. פותחים את Edit > Project Settings > Google ARCore ומבטלים את הסימון של ARCore required.

2. מגדירים את רמת ה-API המינימלית בלחיצה על עריכה > פרויקט > נגן, ובחירה בכרטיסייה עם סמל Android. בקטע הגדרות אחרות > זיהוי, בוחרים רמת API מינימלית גבוהה מ-18.

בדיקות ריצה

כשהיא מופעלת, האפליקציה צריכה להתקשר אל Session.CheckApkAvailability() כדי לבדוק אם המכשיר תומך ב-ARCore, ואם כן, אם Google Play Services מקבלת נתונים לגבי פרופיל המכשיר AR ו-ARCore.

האפליקציה צריכה לטפל בתנאים הבאים:

תנאי	פעולה
המכשיר לא תומך ב-ARCore.	מסתירה פונקציונליות הקשורה ל-AR.
המכשיר תומך ב-ARCore, אבל שירותי Google Play ל-AR ו/או לנתוני פרופיל המכשיר ב-ARCore לא מותקנים או לא מעודכנים.	שליחת בקשה למשתמש להתקין או לעדכן את שירותי Google Play עבור נתוני AR ו/או נתוני מכשיר של ARCore באמצעות התקשרות Session.RequestApkInstallation().
המכשיר תומך ב-ARCore וב-Google Play Services עבור AR ונתוני פרופיל במכשיר ARCore מותקן ועדכני.	המערכת תיצור ARCore Session ותתחיל להשתמש ב-ARCore.

דרישות בנושא פרטיות המשתמשים

מוודאים שהאפליקציה עומדת בדרישות של ARCore&#39.לדרישות הפרטיות.

השלבים הבאים

יש לקרוא את הקוד באפליקציה לדוגמה ול-ARCore לקבלת מידע על Unity API.