הגדרת אפליקציית הטלפון להעברה של תצוגות שעון

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

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

הגדרת תצוגת שעון

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

1. התקנה: התקנת תצוגת השעון באמצעות Watch Face Push, שמופעל דרך MessageClient. השלב הזה פשוט, וניתן להשתמש ב-addWatchFace או ב-updateWatchFace, שמופעל באמצעות MessageClient מהטלפון לשעון.
2. הפעלה: מגדירים את תצוגת השעון שהותקנה כתצוגה הפעילה. בשלב הזה יש כמה דרכים אפשריות, בהתאם לסטטוס ההרשאה:
   • יכול להיות שלא תצטרכו לבצע שום פעולה. יכול להיות שזירת המסחר כבר שולטת בתצוגת השעון הפעילה.
   • יכול להיות שלא תהיה צורך בהתערבות של המשתמש. לאפליקציה יש את ההרשאות הנדרשות להגדרת תצוגת השעון הפעילה, והיא יכולה לעשות זאת ישירות באמצעות setWatchFaceAsActive().
   • יכול להיות שתצטרכו הנחיות, למשל איך לאשר בקשות הרשאה או איך להגדיר את תצוגת השעון באופן ידני באמצעות תנועת לחיצה ארוכה או דרך אפליקציה נלווית.

תגובת ההתקנה

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

• התוצאה של ניסיון ההתקנה
• התוצאה של isWatchFaceActive() – כדי לקבוע אם כבר יש באפליקציה את תצוגת השעון הפעילה.
• אם כבר התבצעה קריאה ל-setWatchFaceAsActive() בעבר – אפליקציית Wear OS אמורה לעקוב אחרי המידע הזה ולשמור אותו באופן מקומי. אפשר להשתמש בקריאה הזו ל-API רק פעם אחת.

Activation (הפעלה)

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

תרחיש 1: כל הניסיונות להגדיר את תצוגת השעון הפעילה נכשלו

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

תרחיש 2 – ניסיון להגדיר את תצוגת השעון הפעילה

הטלפון צריך להורות לשעון לבדוק אם יש לו את ההרשאה SET_PUSHED_WATCH_FACE_AS_ACTIVE הנדרשת:

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

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

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