‫Android XR: הנחיות איכות ומדיניות לאפליקציות שמספקות חוויות מציאות רבודה

מכשירי XR רלוונטיים

ההנחיות האלה יעזרו לכם ליצור חוויות למכשירי XR מהסוגים הבאים.

מידע ולמידה על סוגי מכשירי XR ←

משקפיים עם
תצוגה פנימית ואודיו

מידע ולמידה על סוגי מכשירי XR ←

ההנחיות בנוגע לאיכות האפליקציות למשקפיים חכמים מרחיבות את הסטנדרטים הבסיסיים של איכות האפליקציות לנייד.

המדיניות וההנחיות האלה לאיכות האפליקציות מתמקדות באינטראקציות מולטי-מודאליות חיוניות שייחודיות לפלטפורמת Android XR במשקפיים חכמים, כפי שמתואר בהגדרות של רמות התאימות, ברשימות המשימות ובמדיניות בנושא חוויות אודיו בלבד. כדאי לעיין בקטעים האלה כדי לוודא שהאפליקציה מספקת חוויית משתמש מעולה במשקפיים עם אודיו ומשקפיים עם תצוגה פנימית.

חוויות משופרות: הגדרות של רמות תאימות לאפליקציות לנייד

כדי להבין את רמת התמיכה שהאפליקציה מספקת לחוויות משופרות במשקפיים, כדאי לעיין בהגדרות הבאות של רמות התאימות.

תואם

אפליקציה תואמת לנייד מספקת חוויית שימוש משופרת במשקפיים, בלי שהמפתחים יצטרכו להשקיע מאמץ נוסף. האפליקציה הזו מייצגת אפליקציה קיימת ל-Android, כולל קישוריות Bluetooth, שלא הותאמה למשקפיים. פלטפורמת Android XR תומכת באופן אוטומטי באפליקציות מהסוג הזה, כל עוד הן לא מסתמכות על תכונות חומרה שלא נתמכות.

כדי להשיג את היכולת הזו, הפלטפורמה מרחיבה בצורה חלקה את ממשקי המערכת הרגילים של Android אל המשקפיים. לדוגמה, התראות מוצגות באופן אוטומטי בשדה הראייה של המשתמש או מוקראות בקול (במשקפיים עם ממשק קולי), כדי שהמשתמש יוכל לבצע משימות קריטיות ומהירות בלי להוציא את הטלפון.

מובחן

חוויית מציאות רבודה מובחנת מיועדת במיוחד למשקפיים, ומנצלת את כל היכולות של Jetpack XR SDK ואת החומרה הייחודית של המכשיר.

כדי ליצור את החוויות המשופרות האלה, אתם יכולים להשתמש בספריות הבאות:

• ‫Jetpack Compose Glimmer: ערכת כלים של ממשק משתמש ב-Compose ליצירת ממשקים מינימליים וקריאים, שמותאמים למסכים שקופים.
• ‫Jetpack Projected: ניהול משאבים וגישור חלק על הפונקציונליות בין הטלפון הנלווה (המארח) לבין המשקפיים (המכשיר המוקרן).
• ‫ARCore for Jetpack XR: גישה ליכולות תפיסה מתקדמות כמו מעקב אחרי מכשירים ו-Geospatial API, שמאפשרות לוקליזציה ותכונות שמותאמות להקשר, כמו ניווט רגלי.

חוויות משופרות: רשימת משימות לבדיקת איכות האפליקציה לנייד

כדי לוודא שהאפליקציה מספקת חוויית משתמש מעולה בחוויות מוגברות, כדאי לעיין ברשימות המשימות ובבדיקות התאימות הבאות.

רשימות המשימות והבדיקות האלה מגדירות קבוצה מקיפה של דרישות איכות לרוב סוגי האפליקציות ל-Android.

תואם

אפליקציות תואמות הן אפליקציות קיימות ל-Android שפועלות באופן אוטומטי במשקפיים באמצעות ממשקים רגילים של Android (לדוגמה, התראות רגילות והתראות בזמן אמת). לא נדרש קוד ספציפי למשקפיים ברמת התאימות הזו.

האפליקציה צריכה לעמוד בדרישות הבסיסיות הבאות:

• התראות: ודאו שכל ההתראות שדורשות פעולה ורגישות לזמן משתמשות בממשקי ה-API הרגילים של Android NotificationManager, כדי שהפלטפורמה תוכל להמיר אותן בצורה נכונה להקראות אודיו (מכשירי אודיו) או לשכבות-על חזותיות מינימליסטיות (מכשירי תצוגה).
• עדכונים בזמן אמת: אם באפליקציה יש פעילות מתמשכת (כמו משימות שקשורות להתקדמות), היא חייבת להשתמש במסגרת ההתראות הרגילה של עדכונים בזמן אמת כדי שהפלטפורמה תוכל להציג את המידע הזה בצורה שקל לראות בלי להשתמש בידיים.
• ‫Google Play: האפליקציה חייבת לעמוד בכל כללי המדיניות הרלוונטיים של Android ו-Google Play. התאימות נקבעת באופן אוטומטי על סמך הצהרות המניפסט ודרישות התכונות.

מובחן

אפליקציות מותאמות נוצרות במיוחד באמצעות Jetpack XR SDK (עם ספריות כמו Jetpack Compose Glimmer,‏ Jetpack Projected ו-ARCore for Jetpack XR) כדי לספק חוויית משתמש מותאמת מאוד ומודעת לסביבה, או כדי להשתמש ביכולות ייחודיות של מציאות רבודה. כדאי לעיין בדרישות שרלוונטיות לאפליקציה שלכם.

קטגוריה	אזור	הדרכה
פונקציונליות עיקרית	התחלת הפעילות במשקפיים	המשתמשים צריכים להיות מסוגלים להפעיל את החוויות ולשלוט בהן ישירות מהאפליקציה לנייד, במיוחד בהגדרה הראשונית או בניווט במידע צפוף לפני המעבר לאודיו ולמשקפיים עם תצוגה פנימית, שיש להם קבוצה קטנה יותר של יכולות UX.
	פקודה לפתיחת אפליקציה	צריך להגדיר את החוויות עם מצב הפעלה אפס במשקפיים עם Gemini, כך שכאשר משתמש נותן פרומפט עם הפקודה "Open [App]"‎, האפליקציה תעקוף את התפריטים הרגילים ותעבור מיד למצב של חוויית אודיו מוכנה לפעולה, כמו מצב רקע של אודיו בלבד, מצב האזנה בזמן אמת או אות קולי מיידי.
	הפעלת המצלמה	אפשר להפעיל את הגישה למצלמה מנקודת כניסה או מפעילות בנייד, או באמצעות קלט ישיר דרך תנועת הפעולה של המצלמה במכשיר. אם הגישה למצלמה מתחילה מהממשק בנייד, המשתמש אמור לשמוע ספירה לאחור לפני שהסטרימינג מהמצלמה מתחיל.
	בהירות ועקביות (תנועות)	צריך להטמיע תנועות (כמו קול, לחיצות או החלקות) בצורה ברורה ועקבית, בהתאם לציפיות של המשתמשים לגבי אינטראקציות נפוצות. המדיניות בנושא תנועות ליבה מפורטת בסעיפים הבאים.
ביצועים ויציבות	סוללה	בצעו אופטימיזציה של תהליכים ברקע בהתאם להגבלות של Android על משימות ברקע, וצמצמו את השימוש בחיישנים שצורכים הרבה אנרגיה (כמו פיד המצלמה) כשהם לא בשימוש פעיל.
	קצב הפריימים והרזולוציה של המצלמה	צריך להגדיר את הגישה לפיד המצלמה כך שתשתמש בהגדרות היעילות ביותר (קצב הפריימים והרזולוציה הנמוכים ביותר) לתרחיש שימוש נתון. במדריך למפתחים מפורט מידע נוסף על הגדרות מומלצות לכל תרחיש שימוש.
בטיחות	בטיחות	החוויות צריכות להיות מתוכננות סביב פעולות שהמשתמשים יוזמים, ולמזער ככל האפשר את הסחות הדעת של המשתמשים מהסביבה המיידית שלהם, במיוחד בזמן תנועה או במרחבים ציבוריים.
פרטיות ואבטחה	הרשאות	האפליקציה צריכה לבקש הרשאות ספציפיות למשקפיים כדי לגשת לחומרה (כמו המצלמה או המיקרופון) באמצעות ה-API המוקרן לבקשת הרשאות, ולטפל בהפניה למכשיר המארח כדי לקבל את הסכמת המשתמש.
מדיניות כללית	נגישות	חשוב להביא בחשבון משתמשים עם צרכים שונים ולוודא ששיטות קלט חלופיות זמינות (לדוגמה, שימוש בפקודות קוליות כגיבוי לתנועות על לוח המגע) במקרים המתאימים.
	בדיקה	חשוב לבדוק ביסודיות את כל ההטמעות של התנועות והרכיבים החזותיים בתרחישים שונים של משתמשים, בתנאי תאורה שונים ובסביבות עמוסות, באמצעות האמולטור של Android XR ותצוגות מקדימות של רכיבים קומפוזביליים.
Google Play	מדיניות	לציית לכל כללי המדיניות של Google Play, כולל כללי המדיניות הספציפיים למשקפיים שמפורטים בסעיפים הבאים, שעוזרים להגן על הפרטיות והרווחה של המשתמשים.
חוויית האודיו	התראות קוליות	ההתראות הקוליות צריכות להיות תמציתיות ולספק רק את המידע הכי רלוונטי ושימושי. התראות קוליות על מצבי שגיאה אמורות לפעול גם בלי חיבור לאינטרנט. כדי להמשיך את השיחה או להעמיק בה, צריך להשתמש בסוכן באפליקציה או ב-Gemini.
	מיקוד אודיו	יש קשר הדוק בין הרשאת האודיו למיקוד הקלט. האפליקציות צריכות לבקש ולוותר על מיקוד האודיו בהתאם לצורך ובהתאם להנחיות של Android.
	כללי המדיניות בנושא אודיו	התנועות וההתנהגויות של נורות ה-LED צריכות לעמוד בכל כללי המדיניות בנושא חוויות אודיו בלבד.

המדיניות בנושא חוויות אודיו בלבד

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

בטיחות באפליקציות

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

חל איסור מוחלט על הפעילויות הבאות, ואסור לאפליקציות לאפשר או לקדם אותן:

• חשיפת מידע אישי ללא רשות (דוקסינג)
• זיהוי פנים או זיהוי ביומטרי
• מעקב
• יצירה או הפצה של תוכן ויזואלי אינטימי שנוצר או שותף ללא הסכמה (NCII)

כל האפליקציות צריכות לכלול את אמצעי ההגנה הבאים על עוברי אורח:

בטיחות המצלמה

אפליקציות שניגשות לחיישני מצלמה של מכשירים לבישים חייבות לכבד את הפרטיות של עוברי אורח ולעמוד בדרישות הבאות:

הגבלת סרטונים ותמונות

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

אינטראקציות אסורות	תיאור
סטרימינג בשידור חי ברשתות חברתיות ושידור ציבורי	אסור להשתמש בחיישני מצלמה של מכשירים לבישים באפליקציות לסטרימינג בשידור חי ברשתות חברתיות, כולל כל סטרימינג בשידור חי בזמן אמת, אחד לרבים, שידור ציבורי או העברה לפידים ציבוריים ולערוצים פתוחים.
זיהוי פנים בזמן אמת ודוקסינג	אסור לאפליקציות להשתמש בחיישני מצלמה כדי להפעיל זיהוי פנים במטרה לחשוף פרטים אישיים מזהים (PII) של עוברי אורח. לדוגמה: שמות, כתובות מגורים, מספרי טלפון או המעסיק שלהם.
יצירת תוכן ויזואלי אינטימי שנוצר או שותף ללא הסכמה (NCII) או תוכן לא חוקי	אסור להשתמש בחיישני המצלמה של האפליקציה כדי ליצור תוכן ויזואלי אינטימי שנוצר או שותף ללא הסכמה (NCII) או כל תוכן לא חוקי (לדוגמה, CSAM).

בטיחות האודיו

אפליקציות שמשתמשות במערך המיקרופונים צריכות לכבד את הפרטיות של עוברי אורח ולעמוד בדרישות הבאות:

אינטראקציות אסורות	תיאור
האזנה מתמשכת	אסור לאפליקציות להפעיל הקלטת אודיו או תמלול ברקע באופן קבוע, כשהמשתמש לא מבצע באופן פעיל משימה באפליקציה.
זיהוי דיבור	אסור לאפליקציות להשתמש במערך המיקרופונים כדי לזהות קולות של אנשים שלא מרכיבים את המשקפיים או של עוברי אורח.
הסתרה או שינוי של תוכן באופן פרוגרמטי	אסור לאפליקציות לשנות או להשבית את מסנני הרעשים באודיו שמערכת ההפעלה אוכפת. בנוסף, אסור לעודד או להנחות את המשתמשים לשנות או להשבית את מסנני הרעשים באודיו.

תנועות וקלט

המדיניות הזו מפרטת את הדרישות להטמעת אירועי תנועה במשקפיים במהלך חוויות של אודיו בלבד. כדי לספק חוויית משתמש עקבית ואינטואיטיבית באפליקציות שונות ובמכשירי Android XR, חשוב לפעול לפי ההנחיות האלה. כל הקלט אמור לפעול אם האפליקציה נמצאת במיקוד האודיו, בלי קשר למצב שלה בחזית.

1. תנועת הקשה

תנועת הלחיצה היא נגיעה מהירה אחת באזור הקלט של לוח המגע. הקשה היא הדרך שבה המשתמש מבצע פעולה במשקפיים. הפעולה הזו יכולה להפעיל השמעה של אודיו, למשל כדי לספק מידע על סמך המצב של המשתמש או כדי לחזור על ההודעה הקולית האחרונה. אם מושמע אודיו, לחיצה יכולה להשהות או להפסיק את פלט האודיו.

דוגמאות

אינטראקציות מותרות	תיאור
השמעת הנחיה רלוונטית	מספקים למשתמש מידע רלוונטי, כמו: הצגת בקשה להרשאות משתמש. מידע שמבוסס על המצב הנוכחי של המשתמש. לדוגמה, "מימינך נמצא גשר שער הזהב". חזרה על ההודעה הקולית האחרונה שהושמעה למשתמש. לחיצה בזמן שהאודיו מופעל תפסיק את האודיו.
השתקה או ביטול ההשתקה של המיקרופון	המשתמשים יכולים להשתיק או לבטל את ההשתקה של המיקרופון באמצעות תנועת נגיעה כשהם משתמשים באפליקציה שמשתמשת בקלט מהמיקרופון. צריך להשמיע צליל כשמשתיקים את המיקרופון או מבטלים את ההשתקה שלו.

אינטראקציות אסורות	תיאור
מידע או מודעות לא רלוונטיים	אל תשתמשו בתנועת ההקשה כדי להציג מודעות או לספק מידע שלא רלוונטי למצב הפיזי או להקשר הנוכחי של המשתמש.
קלט של משחקים ופעולות רציפות מהירות	תנועת ההקשה מיועדת לפעולות מהירות בנגיעה אחת. אסור להשתמש בו כבקר רציף למשחקים אינטראקטיביים או למשימות קלט בתדירות גבוהה שמשבשות את פקדי המערכת הרגילים.
עידוד פשע, אלימות או פגיעה עצמית	תנועת ההקשה לא יכולה להפעיל הוראות שניתן לבצע כדי לעודד פעולות לא חוקיות או מזיקות, כמו גיוס פעילים קיצוניים, יצירת כלי נשק או פגיעה עצמית.

2. תנועת פעולה במצלמה

תנועת הפעולה של המצלמה כוללת לחיצה על כפתור המצלמה פעמיים ברצף. אפליקציות שניגשות למצלמה צריכות להתייחס לאירוע הזה כפעולת מצלמה שמספקת נתוני חיישנים ישירות לאפליקציה.

דוגמאות

אינטראקציות מותרות

תיאור

הפעלת המצלמה באפליקציה

להפעיל את הסטרימינג מהמצלמה באפליקציה. זה כולל הפעלה של הסטרימינג מהמצלמה כדי לצלם תמונות או סרטונים, או כדי לאפשר עיבוד של הסביבה באמצעות פיד המצלמה. השימוש בסטרימינג מהמצלמה חייב לעמוד בכל כללי המדיניות של Android שקשורים לצילום במצלמה ולהקלטה במיקרופון, ובמדיניות בנושא נתוני משתמשים במרכז המדיניות למפתחים של Play. בנוסף, המדיניות בנושא בריונות והטרדה אוסרת על אפליקציות שחושפות מידע אישי או מנצלות אחרים באופן פומבי.

אינטראקציות אסורות	תיאור
קלט בהתאמה אישית ומיפוי מחדש	תנועת הלחיצה הכפולה על המצלמה חייבת לשמש רק להפעלת הסטרימינג מהמצלמה ולספק נתוני חיישנים ישירות לאפליקציה. אסור למפות מחדש את תנועת החומרה הזו לפונקציות שלא קשורות למצלמה, לקיצורי דרך בהתאמה אישית או לחוויות שימוש חלופיות באפליקציה.
שימוש בחיישן מנותק או בחיישן דמה	אפליקציות שמיירטות את תנועת הלחיצה הכפולה על המצלמה חייבות להתייחס אליה כבקשה אמיתית לנתונים מחיישן חזותי. אסור לרשום את אירוע הלחיצה הכפולה כדי להשתלט על הכפתור הפיזי תוך התעלמות, ביטול או השתקה מכוונים של פיד המצלמה.
חוסר גילוי נאות או שימוש מטעה	כשמשתמשים בתנועת הלחיצה הכפולה על המצלמה כדי להפעיל את המצלמה, צריך להסביר למשתמש באופן מפורש מה בדיוק השימוש במצלמה לפני כן בתהליך של האפליקציה לנייד, במהלך מתן ההרשאה הראשוני או הגדרת האפליקציה. לדוגמה, תרחישי שימוש תקינים יכולים להיות סטרימינג בשידור חי, צילום תמונה או עיבוד באמצעות AI. אסור להשתמש בסטרימינג מהמצלמה לפונקציה שהמשתמש לא הסכים לה באופן מפורש.

3. תנועת החלקה אחורה באצבע אחת

תנועת החלקה אחורה באצבע אחת כוללת תנועה רציפה אחורה באזור הקלט של לוח המגע. המערכת תומכת בתנועה הזו גם במהלך חוויות אודיו בלבד, באמצעות קריאה ל-onBack(). האפליקציה צריכה לטפל באירוע הזה על ידי יציאה מהממשק הנוכחי או החזרת המשתמש למצב הקודם של האפליקציה.

אינטראקציות אסורות	תיאור
חטיפת פקודת היציאה	תנועת ההחלקה אחורה חייבת תמיד להפעיל את onBack() כדי לצאת מהחוויה או להחזיר את המשתמש למצב הקודם של האפליקציה. אסור למפות אותו לפעולות בהתאמה אישית, להשקות של מדיה חדשה או למודעות.
יציאות מזויפות (האזנה סמויה)	האפליקציות חייבות לצאת או להשעות את השימוש בחיישן הראשי שלהן כשהתנועה הזו מופעלת. אסור לדמות יציאה מהאפליקציה תוך שמירה חשאית על חיישנים פעילים ברקע למטרות מעקב.

התנהגויות של נורות ה-LED

אסור שהאפליקציה תשנה את ההתנהגות של נורית ה-LED של המערכת על סמך הגישה למיקרופון ולמצלמה.

אינטראקציות אסורות	תיאור
הסתרה או שינוי של תוכן באופן פרוגרמטי	אסור לאפליקציות לשנות, לעמעם או להשבית את ההתנהגות של נורות ה-LED שפונות לעולם וגלויות למשתמשים, שנאכפת על ידי המערכת, על סמך הגישה למיקרופון ולמצלמה. בנוסף, אסור לעודד או להנחות את המשתמשים לשנות, לעמעם או להשבית את פעולת נורות ה-LED.
עקיפת מנגנוני זיהוי של סיכול ושיבוש	אסור לאפליקציות לעקוף את האלגוריתמים של המכשיר לזיהוי חסימות, או להפריע להם, או לעודד או להנחות משתמשים לעשות זאת. האלגוריתמים האלה נועדו להפסיק את ההקלטה באופן פרוגרמטי אם נורית ה-LED שפונה לעולם מכוסה או פגומה פיזית.