Obsługa atrybutów interfejsu Automation API na Androidzie

Interfejs Automation API na Androida obsługuje większość cech, ale obsługa niektórych atrybutów, zdarzeń i poleceń w ramach cechy może być ograniczona.

Przede wszystkim:

• Wszystkie cechy i typy, których chcesz używać w aplikacji z interfejsem Automation API, muszą zostać zarejestrowane podczas inicjowania. Zobacz Tworzenie instancji Home.
• W poleceniach inicjujących i warunkach można używać dowolnych atrybutów.
• Urządzenia Cloud-to-cloud, które nie raportują swojego stanu, nie mogą być używane jako aktywatory w automatyzacjach utworzonych ręcznie lub przez wykrywanie.

• Nawet jeśli urządzenie obsługuje wymienione tutaj cechy, może zostać zablokowane i nie będzie można go używać jako elementu inicjującego lub działania w interfejsie Automation API ze względu na progi jakości stanu raportu:

  • Urządzenia, których wskaźnik sukcesu raportowania stanu jest niższy niż 90%, nie mogą być używane jako elementy inicjujące.
  • Urządzenia, których wskaźnik sukcesu wykonania polecenia jest niższy niż 95%, nie mogą być używane jako działania.

  Zapoznaj się z tą listą modeli urządzeń oraz konkretnymi elementami inicjującymi i działaniami, które obsługują w przypadku interfejsu Automations API.

• Poleceń można używać tylko jako działań.

• Niektóre cechy, takie jak AssistantBroadcast i Notification, są dostępne tylko w interfejsie Automation API.

• Polecenie okGoogle jest poleceniem na poziomie domu i można go używać do automatyzacji dowolnego urządzenia w domu. Aplikacja korzystająca z interfejsów Home API może jednak nie mieć dostępu do wszystkich urządzeń. Aby dowiedzieć się, jak uprawnienia są egzekwowane w różnych przypadkach, zapoznaj się z artykułem Uprawnienia OkGoogle.

• Niektóre cechy mają wymagania wstępne:

  • Aby używać elementów inicjujących opartych na czasie, takich jak Time.ScheduledTimeEvent, Time.RecurringClockTimeScheduledEvent lub Time.RecurringSolarTimeScheduledEvent, dom, w którym działa automatyzacja, musi mieć adres, aby można było określić lokalną strefę czasową i obliczyć położenie słońca. Adres można podać podczas tworzenia struktury lub ustawić w Google Home app (GHA). Zmienianie adresu domowego Google wyjaśnia, jak użytkownik może wpisać lub zaktualizować adres domu w GHA. Jeśli adres nie jest skonfigurowany, createAutomation() zapisuje i zwraca Automation, gdzie isValid == false, z problemem z weryfikacją UnsupportedEntityEvent zawierającym MissingStructureAddressSetup.
  • Aby domownicy mogli otrzymywać powiadomienia z Notification.sendNotifications, muszą mieć zainstalowaną aplikację GHA z włączonymi powiadomieniami. Powiadomienia są dostarczane członkom za pomocą GHA i nie można ich wysyłać bezpośrednio do aplikacji innych firm.
  • Aby korzystać z cech AreaPresenceState lub AreaAttendanceState, użytkownik musi skonfigurować wykrywanie obecności w aplikacji GHA.
  • Aby korzystać z cechy ObjectDetection, użytkownik musi mieć aktywną subskrypcję Google Home Premium.

W automatyzacjach można też używać uproszczonych wersji niektórych cech. Więcej informacji znajdziesz w artykule Uproszczone cechy na Androidzie.