Удаление устройства подразумевает его вывод из эксплуатации в структуре. Пользователь может сделать это в Google Home app (GHA), а приложение – программно вывести устройство умного дома из эксплуатации. Существуют ограничения на удаление устройств. Кроме того, удаление устройства может повлиять на структуру и удобство использования приложения.
Что можно удалить
Вы можете программно удалить следующие устройства с помощью Home API:
- Matter устройств, на которых у приложения есть разрешения.
- Matter мостов, если у приложения есть доступ ко всем устройствам, подключенным через мост. Если вы удалите мост, все подключенные к нему устройства Matter также будут удалены.
- Поддерживаемые камеры и дверные звонки, в том числе камеры и дверные звонки Google Nest с поддержкой Matter, а также совместимые камеры партнеров. Подробнее о поддерживаемых и неподдерживаемых моделях…
Что нельзя удалить
Следующие устройства нельзя удалить программно с помощью Home API:
- Matter устройств, на которых у приложения нет разрешений пользователя.
- Отдельные устройства, подключенные через мост Matter.
- Связано устройств: Cloud-to-cloud.
- Устройства с двумя путями, не являющиеся камерами (устройства, на которых реализованы и Matter, и Cloud-to-cloud, кроме поддерживаемых камер и дверных звонков).
- Неподдерживаемые камеры и дверные звонки, в том числе умные дисплеи со встроенными камерами и устаревшие камеры, которые не поддерживают Matter (см. раздел Камеры и дверные звонки).
Важные примечания, касающиеся удаления устройств
Когда ваше приложение удаляет устройство, оно удаляется из всей структуры, что влияет на всех пользователей и все приложения, включая GHA. В зависимости от типа устройства могут быть дополнительные побочные эффекты вывода устройства из эксплуатации:
- Если устройство выполняет несколько функций, например умный светильник также является контроллером, то при его удалении будут удалены и все связанные с ним устройства. Если затронуто несколько функций устройства, приложение должно сообщить об этом пользователю.
- Если вы удалите камеру или дверной звонок, то непрерывная видеозапись, видеозапись событий, записанные клипы и данные библиотеки знакомых лиц, связанные с этим устройством, будут навсегда удалены из дома.
- При выводе камеры из эксплуатации активные подписки, например Google Home Premium или партнерские сервисы мониторинга, не отменяются. Подписка действует до тех пор, пока пользователь не отменит ее.
- При выводе камеры или дверного звонка из эксплуатации платформа Home API показывает пользователю экран подтверждения, управляемый Google, с объяснением, что архив видеозаписей будет удален без возможности восстановления. Пользователь должен подтвердить запрос, прежде чем устройство будет удалено.
- Будьте осторожны при удалении устройств с общих поверхностей, так как это может привести к непредвиденным последствиям для других пользователей.
- Удалять устройства можно только на аутентифицированных платформах, например на мобильных телефонах, но не на неаутентифицированных устройствах, таких как телевизоры. Это нарушает правила для разработчиков продуктов для Google Home.
Как удалить устройство
Проверка того, можно ли удалить устройство, требует много ресурсов, поэтому ее следует выполнять только при необходимости. Чтобы проверить, можно ли удалить устройство, используйте следующую команду:
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.") }
Устройства Matter
Вы можете удалить устройство Matter программно, если оно не подключено через мост Matter.
Чтобы удалить устройство Matter, вызовите на нем decommissionDevice():
val decommissionedDeviceIds = device.decommissionDevice()
Если вызов не выдает ошибку, значит он выполнен успешно.
Вы можете проверить, есть ли идентификатор устройства среди возвращенных decommissionDevice():
if (decommissionedDeviceIds.contains(deviceId)) { println("Decommission successful!") } else { println("Decommission failed!") }
Камеры и дверные звонки
Вы можете программно удалить поддерживаемые камеры и дверные звонки с помощью decommissionDevice().
Поддерживаемые модели:
- 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. На этом экране пользователь видит, что при удалении камеры будут навсегда удалены все данные непрерывной видеозаписи, история событий, клипы и библиотека знакомых лиц, связанные с устройством во всем доме.
Если пользователь закрывает или отменяет экран подтверждения,decommissionDevice() выдает ошибку HomeException.
При выводе камеры из эксплуатации активные подписки на нее (например, Google Home Premium) не отменяются. Пользователям нужно отменять подписки отдельно через поставщика.
try {
val decommissionedDeviceIds = device.decommissionDevice()
if (decommissionedDeviceIds.contains(device.id)) {
// Camera was successfully decommissioned
}
} catch (e: HomeException) {
// Handle cancellation or decommission error
}
Устройства, не поддерживающие Matter
Устройства, не относящиеся к Matter (кроме поддерживаемых камер и дверных звонков), нельзя удалить программно. Чтобы удалить другие устройства, не относящиеся к Matter, вы можете отправить запрос на синхронизацию (см. раздел Запрос на синхронизацию) или удалить интеграцию Cloud-to-cloud (см. раздел Как удалить запущенную интеграцию типа "облако – облако").
Если вы вызовете decommissionDevice() на неподдерживаемом устройстве, не относящемся к Matter, будет выдана ошибка HomeException.
После удаления устройства, не относящегося к Matter, проверьте, действительно ли оно было удалено:
var removedDevice: HomeDevice? = null runBlockingCustom { try { removedDevice = homeManager.devices().get(deviceId) } catch (exception: Exception) { println("removal successful!") } } if (removedDevice != null) { println("removal failed!") }