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 cechach może być ograniczona.

Przede wszystkim:

• Wszystkie cechy i typy, których zamierzasz 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.
• Cloud-to-cloud urządzeń, które nie zgłaszają swojego stanu, nie można używać jako wyzwalaczy w automatyzacjach utworzonych ręcznie ani w ramach wykrywania.

• Nawet jeśli urządzenie obsługuje wymienione tu cechy, może być zablokowane i nie można go używać jako polecenia inicjującego lub działania w interfejsie Automation API ze względu na progi jakości Report State:

  • Urządzenia, w przypadku których wskaźnik sukcesu zgłoszeń stanu jest niższy niż 90%, są blokowane i nie mogą być używane jako urządzenia startowe.
  • Urządzenia, w przypadku których wskaźnik sukcesu wykonania poleceń jest niższy niż 95%, nie mogą być używane jako działania.

  Zapoznaj się z tą listą modeli urządzeń oraz konkretnymi starterami i działaniami, które obsługują w przypadku interfejsu Automatyzacji.

• Polecenia 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 struktury i może służyć do automatyzacji dowolnego urządzenia w strukturze. Aplikacja korzystająca z interfejsów Home API może jednak nie mieć dostępu do wszystkich urządzeń. Więcej informacji o tym, jak uprawnienia są egzekwowane w różnych przypadkach, znajdziesz w sekcji Uprawnienia „OK Google”.

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

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

Uproszczone wersje niektórych cech są też dostępne do użycia w automatyzacjach. Więcej informacji znajdziesz w artykule Uproszczone cechy na Androidzie.