פעולה במכשיר
מחפשים יכולים לבקש מהספק לבצע פעולה. אם הספק תומך בפעולה, צריך לאשר אותה ולבצע אותה, אחרת יש להתעלם ממנה.
שם קבוצת ההודעות | ערך |
---|---|
אירוע פעולה במכשיר | 0x04 |
שם קוד הפעולה של המכשיר | ערך |
---|---|
צלצול | 0x01 |
צלצול במכשיר
אחד מהתרחישים לדוגמה הוא המשתמש שמבקש שיצלצל לספק, למשל אם המשתמש איבד את המכשיר ועליו לאתר אותו. כשמתקבלת פעולת הצלצול, הספק צריך להתחיל להפעיל קובץ צליל נטען מראש בעוצמת קול גבוהה מספיק כדי שהמשתמש יוכל לאתר אותו. מומלץ להעביר את הצליל מעוצמת קול נמוכה לעוצמת קול מקסימלית לאורך זמן. הצלצול אמור להימשך עד שמתקבלת פעולה נוספת שמפנה לעצירה, או לאחר שהזמן הקצוב לתפוגה חלף.
ההודעה תכלול נתונים נוספים שיציינו אם יש להפעיל או להפסיק את הצלצול, מה שאפשר להרחיב כדי לתמוך בספקים עם מספר רכיבים (אוזניה שמאלית וימנית). בבייט הראשון, הביטים יוגדרו ל-1 כדי לבקש צלצול שיפעיל, או 0 כדי לבקש צלצול שיפסיק.
לדוגמה, אם הבייט הראשון של הנתונים הנוספים מוגדר ל:
- 0x00 (0b00000000): כל הרכיבים אמורים להפסיק לצלצל
- 0x01 (0b00000001): השמעת צלצול בצד ימין, הפסקת צלצול שמאלה
- 0x02 (0b00000010): השמעת צלצול בצד שמאל, הפסקת הצלצול ימינה
- 0x03 (0b00000011): השמעת צלצולים שמאלה וימינה
במקרה של ספקים שלא תומכים בצלצולים בודדים, צריך להביא בחשבון רק קטע אחד:
- 0x00 (0b00000000): הפסקת הצלצול
- 0x01 (0b00000001): התחלת הצלצול
הבייט השני בנתונים הנוספים, אם קיים, מייצג את הזמן הקצוב לתפוגה בשניות. הספק צריך להשתמש בערך הזה כדי לקבוע למשך כמה זמן הוא צריך לצלצל לפני שהוא משתיק את עצמו. על סמך הדוגמה הקודמת של צלצול מימין וזמן קצוב לתפוגה של 60 שניות, 0x013C
יועברו כנתונים הנוספים.
מתבצע סנכרון של סטטוס הצלצול חזרה למחפשים
יכול להיות שספקים ירצו להודיע למחפש כשהוא משנה את סטטוס הצלצול, לדוגמה, אם תנועה גורמת להפסקת הצלצול. לאחר מכן, מי שרצה יכול לקבל את ההודעה ולעדכן את ממשק המשתמש אם צריך.
הספק צריך להיות בפורמט זהה לזה של ההודעה, כפי שמתואר בדוגמה שלמעלה. אפליקציית Looker תהקשיב להודעה ותאשר את קבלתה.
אישור פעולה
כשמתקבלת פעולה, היא צריכה להיות מאושרת כדי שהמחפש ידע אם הפעולה בוצעה או לא. אם התודה לא מתקבלת תוך שנייה אחת משליחת פעולה (או שמתקבל אישור שלילי), הצד המבקש יישער שהפעולה אינה נתמכת כרגע.