Usunięcie urządzenia wiąże się z wycofaniem go z domu. Użytkownik może to zrobić za pomocą Google Home app (GHA), a aplikacja może automatycznie wycofać inteligentne urządzenie domowe. Istnieją ograniczenia dotyczące tego, które urządzenia można usunąć. Usunięcie urządzenia może też wpłynąć na strukturę i wrażenia użytkowników aplikacji.
Co możesz usunąć
Za pomocą interfejsów API Google Home możesz automatycznie usuwać te urządzenia:
- Matter urządzenia, do których Twoja aplikacja ma uprawnienia.
- mostki Matter, pod warunkiem że aplikacja ma dostęp do wszystkich urządzeń połączonych przez mostek. Usunięcie mostka spowoduje usunięcie wszystkich połączonych z nim urządzeń Matter.
- Obsługiwane kamery i dzwonki, w tym kamery i dzwonki Google Nest obsługujące standard Matter oraz zgodne kamery innych firm. Szczegółowe informacje o obsługiwanych i nieobsługiwanych modelach znajdziesz w artykule Kamery i dzwonki.
Czego nie możesz usunąć
Tych urządzeń nie można usunąć automatycznie za pomocą interfejsów API Google Home:
- Matter urządzenia, na których Twoja aplikacja nie ma zgody użytkownika.
- Poszczególne urządzenia połączone za mostem Matter.
- Liczba połączonych urządzeń: Cloud-to-cloud.
- Urządzenia bez kamery, które obsługują 2 ścieżki (urządzenia, które implementują zarówno Matter, jak i Cloud-to-cloud, inne niż obsługiwane kamery i dzwonki).
- Nieobsługiwane kamery i dzwonki, w tym inteligentne ekrany z wbudowanymi kamerami i starsze kamery, które nie obsługują Matter (patrz Kamery i dzwonki).
Ważne kwestie, które należy wziąć pod uwagę przed usunięciem urządzenia
Gdy aplikacja usunie urządzenie, zostanie ono usunięte z całej struktury, co wpłynie na wszystkich użytkowników i wszystkie aplikacje, w tym GHA. W zależności od typu urządzenia wycofanie go może mieć dodatkowe skutki uboczne:
- Jeśli urządzenie ma kilka funkcji, np. inteligentne oświetlenie, które działa też jako hub, usunięcie go spowoduje również usunięcie wszystkich powiązanych urządzeń. Aplikacja powinna poinformować użytkownika, jeśli dotyczy to wielu funkcji urządzenia.
- Usunięcie kamery lub dzwonka spowoduje trwałe usunięcie całej historii całodobowych nagrań wideo, historii nagrań zdarzeń, nagranych klipów i danych z biblioteki znajomych twarzy powiązanych z tym urządzeniem w całym domu.
- Wycofanie kamery nie powoduje anulowania aktywnych subskrypcji, takich jak Google Home Premium czy usługi monitorowania partnera. Subskrypcje są aktywne, dopóki użytkownik ich nie anuluje.
- Podczas wycofywania kamery lub dzwonka platforma interfejsów API Google Home wyświetla użytkownikowi ekran potwierdzenia zarządzany przez Google, na którym wyjaśnia, że historia nagrań wideo zostanie trwale usunięta. Użytkownik musi potwierdzić tę prośbę, zanim urządzenie zostanie usunięte.
- Zachowaj ostrożność podczas usuwania urządzeń we wspólnych miejscach, ponieważ może to mieć niezamierzone konsekwencje dla innych osób.
- Urządzenia można usuwać tylko na uwierzytelnionych platformach, takich jak telefon komórkowy, a nie na nieuwierzytelnionych urządzeniach, takich jak telewizory. Jest to naruszenie zasad dla deweloperów Google Home.
Usuwanie urządzenia
Sprawdzanie, czy urządzenie można usunąć, jest kosztowne i powinno być wykonywane tylko wtedy, gdy jest to konieczne. Aby sprawdzić, czy urządzenie można usunąć, użyj tego polecenia:
val eligibility = device.checkDecommissionEligibility() if (eligibility is DecommissionEligibility.Ineligible) { println("The device cannot be decommissioned.") } else if (eligibility is DecommissionEligibility.EligibleWithSideEffects) { println("The device can be decommissioned but there will be side effects on other devices.") } else if (eligibility is DecommissionEligibility.Eligible) { println("The device can be decommissioned.") }
Urządzenia Matter
Urządzenie Matter możesz usunąć automatycznie, jeśli nie znajduje się ono za mostem Matter.
Aby usunąć urządzenie Matter, wywołaj na nim polecenie decommissionDevice():
val decommissionedDeviceIds = device.decommissionDevice()
Jeśli wywołanie nie zwróci błędu, oznacza to, że zakończyło się powodzeniem.
Możesz sprawdzić, czy identyfikator urządzenia znajduje się wśród tych zwróconych przez decommissionDevice():
if (decommissionedDeviceIds.contains(deviceId)) { println("Decommission successful!") } else { println("Decommission failed!") }
Kamery i dzwonki
Obsługiwane kamery i dzwonki możesz usunąć automatycznie za pomocą decommissionDevice().
Obsługiwane modele:
- 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)
- zgodne kamery i dzwonki partnerów (np. Walmart onn.).
Tych kamer i dzwonków nie można wycofać automatycznie:
- inteligentne ekrany z wbudowanymi kamerami, takie jak Google Nest Hub Max;
- Starsze kamery i dzwonki Nest, które nie obsługują Matter i łączą się tylko przez usługi w chmurze, takie jak kamera wewnętrzna Nest Cam Indoor (1 generacji), kamera zewnętrzna Nest Cam Outdoor (1 generacji), Nest Cam IQ i urządzenie Nest Doorbell (zasilane z sieci, 1 generacji).
- Kamery i dzwonki innych firm połączone z aplikacją Cloud-to-cloud.
Gdy aplikacja rozpocznie wycofywanie kamery lub dzwonka, platforma wyświetli użytkownikowi ekran potwierdzenia zarządzany przez Google. Ten ekran informuje użytkownika, że usunięcie kamery spowoduje trwałe usunięcie całej historii całodobowych nagrań wideo, historii zdarzeń, klipów i danych z biblioteki znajomych twarzy powiązanych z urządzeniem w całym domu.
Jeśli użytkownik zamknie lub anuluje ekran potwierdzenia,decommissionDevice() zgłasza błąd HomeException.
Wycofanie kamery nie powoduje anulowania aktywnych subskrypcji (takich jak Google Home Premium). Użytkownicy muszą anulować subskrypcje osobno u dostawcy subskrypcji.
try {
val decommissionedDeviceIds = device.decommissionDevice()
if (decommissionedDeviceIds.contains(device.id)) {
// Camera was successfully decommissioned
}
} catch (e: HomeException) {
// Handle cancellation or decommission error
}
Urządzenia inne niż Matter
Urządzeń innych niż Matter (z wyjątkiem obsługiwanych kamer i dzwonków) nie można usunąć programowo. Aby usunąć inne urządzenia, które nie są urządzeniami Matter, możesz wysłać żądanie synchronizacji (patrz Żądanie synchronizacji) lub usunąć integrację Cloud-to-cloud (patrz Usuwanie uruchomionej integracji Cloud-to-cloud).
Jeśli wywołasz metodę decommissionDevice() na nieobsługiwanym urządzeniu innym niż Matter, zostanie wygenerowany błąd HomeException.
Po usunięciu urządzenia innego niż Matter sprawdź, czy zostało ono usunięte:
var removedDevice: HomeDevice? = null runBlockingCustom { try { removedDevice = homeManager.devices().get(deviceId) } catch (exception: Exception) { println("removal successful!") } } if (removedDevice != null) { println("removal failed!") }