הסרת מכשיר כוללת את הוצאתו משימוש במבנה. המשתמש יכול לעשות את זה באמצעות Google Home app (GHA), ואפליקציה יכולה להוציא משימוש מכשיר לבית חכם באופן פרוגרמטי. יש מגבלות על המכשירים שאפשר להסיר. בנוסף, הסרת מכשיר יכולה להשפיע על המבנה ועל חוויית המשתמש באפליקציה.
מה אפשר להסיר
אתם יכולים להסיר את המכשירים הבאים באופן פרוגרמטי באמצעות ממשקי ה-API של Home:
- Matter מכשירים שלאפליקציה יש הרשאות אליהם.
- Matter גשרים, בתנאי שלאפליקציה יש גישה לכל המכשירים שמחוברים דרך הגשר. הסרת הגשר תסיר את כל מכשירי Matter שמחוברים אליו.
- מצלמות ופעמוני דלת נתמכים, כולל מצלמות ופעמוני דלת של Google Nest שתומכים ב-Matter, וגם מצלמות תואמות של שותפים. לפרטים על דגמים נתמכים ולא נתמכים, ראו מצלמות ופעמוני דלת.
מה אי אפשר להסיר
אי אפשר להסיר את המכשירים הבאים באופן פרוגרמטי דרך ממשקי ה-API של Home:
- Matter מכשירים שבהם לאפליקציה אין הרשאות משתמש.
- מכשירים פרטיים שמחוברים מאחורי גשר Matter.
- Cloud-to-cloud מכשירים מקושרים.
- מכשירים עם שני נתיבים שהם לא מצלמות (מכשירים שמטמיעים גם את Matter וגם את Cloud-to-cloud, מלבד מצלמות ופעמוני דלת נתמכים).
- מצלמות ופעמוני דלת שלא נתמכים, כולל מסכים חכמים עם מצלמות מובנות ומצלמות מדור קודם שלא תומכות ב-Matter (ראו מצלמות ופעמוני דלת).
נקודות חשובות שכדאי לשים לב אליהן לפני שמסירים מכשיר
כשהאפליקציה מסירה מכשיר, הוא מוסר מכל המבנה, וזה משפיע על כל המשתמשים וכל האפליקציות, כולל GHA. בהתאם לסוג המכשיר, יכולות להיות השפעות נוספות להוצאה משימוש של מכשיר:
- אם למכשיר יש כמה פונקציות, כמו נורה חכמה שפועלת גם כרכזת, הסרה שלו תסיר גם את כל המכשירים המשויכים. האפליקציה צריכה להודיע למשתמש אם כמה פונקציות במכשיר מושפעות.
- כשמסירים מצלמה או פעמון דלת, כל היסטוריית הווידאו המלאה, היסטוריית הווידאו של האירועים, הקליפים המוקלטים והנתונים בספריית הפנים המוכרות שמשויכים למצלמה הזו נמחקים באופן סופי בכל הבית הווירטואלי.
- הוצאת מצלמה משימוש לא מבטלת מינויים פעילים, כמו Google Home Premium או שירותי מעקב של שותפים. המינויים נמשכים עד שהמשתמש מבטל אותם.
- כשמוציאים משימוש מצלמה או פעמון דלת, פלטפורמת Home APIs מציגה למשתמש מסך אישור בניהול Google, שבו מוסבר שהיסטוריית הסרטונים תימחק באופן סופי. המשתמש צריך לאשר את ההודעה הזו לפני שהמכשיר יוסר.
- חשוב להפעיל שיקול דעת כשמוחקים מכשירים באזורי עבודה משותפים, כי לפעולה כזו עלולות להיות השלכות לא רצויות על משתמשים אחרים.
- אפשר להסיר מכשירים רק בפלטפורמות מאומתות, כמו טלפון נייד, ולא במכשירים לא מאומתים כמו טלוויזיות. פעולה כזו מפרה את המדיניות למפתחים של Google Home.
הסרת מכשיר
בדיקה אם אפשר להסיר מכשיר היא פעולה יקרה, וצריך לבצע אותה רק כשצריך. כדי לבדוק אם אפשר להסיר מכשיר, משתמשים בפקודה הבאה:
let eligibility = try await device.decommissionEligibility
מכשירים בתקן Matter
אפשר להסיר מכשיר Matter באופן פרוגרמטי אם המכשיר לא נמצא מאחורי גשר Matter.
כדי להסיר מכשיר Matter, מפעילים בו את הפקודה decommission():
let decommissionedDeviceIDs = try await device.decommission()
אם הקריאה לא מקפיצה הודעת שגיאה, סימן שהיא הצליחה.
כדי לבדוק אם מזהה המכשיר נמצא בין המזהים שמוחזרים על ידי decommission():
do {
let decommissionedDeviceIDs = try await device.decommission()
print("The following devices were decommissioned: \(decommissionedDeviceIDs)")
} catch {
print("An error occurred: \(error)")
}
מצלמות ופעמוני דלת
אפשר להסיר מצלמות ופעמוני דלת נתמכים באופן פרוגרמטי באמצעות decommission().
המודלים הנתמכים כוללים:
- Google Nest Cam (indoor, wired)
- Google Nest Cam (outdoor or indoor, battery)
- Google Nest Cam with floodlight
- Google Nest Doorbell (battery)
- Google Nest Doorbell (wired)
- מצלמות ופעמוני דלת תואמים של שותפים (כמו Walmart onn.)
אי אפשר להוציא משימוש את המצלמות ופעמוני הדלת הבאים באופן פרוגרמטי:
- מסכים חכמים עם מצלמות מובנות, כמו Google Nest Hub Max.
- מצלמות ופעמוני דלת מדור קודם של Nest שלא תומכים ב-Matter ומתחברים רק דרך שירותי ענן, כמו Nest Cam Indoor (דור ראשון), Nest Cam Outdoor (דור ראשון), Nest Cam IQ ו-Nest Doorbell (עם כבל, דור ראשון).
- מצלמות ופעמוני דלת של צד שלישי שמקושרים ל-Cloud-to-cloud.
כשהאפליקציה מתחילה את תהליך ההוצאה משימוש של מצלמה או פעמון דלת, הפלטפורמה מציגה למשתמש מסך אישור שמנוהל על ידי Google. במסך הזה מוסבר למשתמש שהסרת המצלמה תמחק באופן סופי את כל הנתונים שמשויכים למכשיר בכל המבנה: היסטוריית וידאו מלאה, היסטוריית האירועים, הקליפים וספריית הפנים המוכרות.
אם המשתמש סוגר או מבטל את מסך האישור,decommission() מחזיר HomeError.
הוצאת מצלמה משימוש לא מבטלת מינויים פעילים למצלמה (כמו Google Home Premium). המשתמשים צריכים לבטל את המינויים בנפרד דרך ספק המינוי.
do {
let decommissionedDeviceIDs = try await device.decommission()
if decommissionedDeviceIDs.contains(device.id) {
// Camera was successfully decommissioned
}
} catch {
// Handle cancellation or decommission error
}
מכשירים שלא תומכים בתקן Matter
אי אפשר להסיר מכשירים שהם לא של Matter (חוץ ממצלמות ופעמוני דלת נתמכים) באמצעות קוד. כדי להסיר מכשירים אחרים שאינם של Matter, אפשר לשלוח בקשת סנכרון (ראו בקשת סנכרון) או למחוק את השילוב של Cloud-to-cloud (ראו מחיקת שילוב שהופעל בין שירותי ענן).
אם קוראים ל-decommission() במכשיר שלא נתמך ולא פועל עם Matter, נזרקת השגיאה HomeError.
אחרי שמסירים מכשיר שאינו Matter, בודקים אם המכשיר עדיין קיים כדי לוודא שהוא הוסר:
guard try await !self.context.devices().list().contains(where: { $0.id == deviceID })
else {
// The device still exists in Home APIs
}