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 chcesz używać w aplikacji z interfejsem Automation API, muszą być zarejestrowane podczas inicjowania. Zobacz Tworzenie instancji Home.
  • Każdego atrybutu można używać w poleceniach inicjujących lub warunkach.
  • Cloud-to-cloud urządzenia, które nie zgłaszają swojego stanu, nie mogą być używane jako wyzwalacze w automatyzacjach utworzonych ręcznie lub za pomocą wykrywania.
  • Nawet jeśli urządzenie obsługuje wymienione tu cechy, może zostać zablokowane w interfejsie Automation API jako polecenie inicjujące lub działanie ze względu na progi jakości zgłaszania stanu:

    • Urządzenia, których współczynnik powodzenia zgłaszania stanu jest niższy niż 90% , są blokowane jako polecenia inicjujące.
    • Urządzenia, których współczynnik powodzenia wykonywania poleceń jest niższy niż 95% , są blokowane jako działania.

    Na tej liście znajdziesz modele urządzeń oraz konkretne polecenia inicjujące i działania, które obsługują w interfejsie Automations API.

  • Polecenia mogą być używane tylko jako działania.

  • Niektóre cechy, np. AssistantBroadcast, 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 egzekwowane są uprawnienia w różnych przypadkach, znajdziesz w artykule Uprawnienia OkGoogle.

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

    • Aby używać Time.ScheduledTimeEvent, struktura, w której działa automatyzacja, musi mieć adres, który został skonfigurowany w Google Home app (GHA). W artykule Zmienianie adresu domowego w Google Home znajdziesz informacje o tym, jak użytkownik może wpisać adres struktury. Jeśli adres nie jest skonfigurowany w aplikacji GHA, nie można utworzyć automatyzacji i wyświetla się błąd z komunikatem „The ScheduledTimeEvent is not supported by the structure” (Cechy ScheduledTimeEvent nie obsługuje structure).
    • Aby używać cech AreaPresenceState lub AreaAttendanceState, użytkownik musi skonfigurować wykrywanie obecności w aplikacji GHA.
    • Aby używać cechy ObjectDetection, użytkownik musi mieć aktywną Nest Aware subskrypcję.

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