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 zamierzasz używać w aplikacji z interfejsem Automation API, muszą być 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 jako urządzenie początkowe lub działanie w interfejsie Automation API z powodu progów jakości Report State:

    • Urządzenia, których odsetek udanych zgłoszeń stanu jest niższy niż 90%, są blokowane i nie można ich używać jako urządzeń początkowych.
    • Urządzenia, w przypadku których odsetek udanych wykonań poleceń jest niższy niż 95%, nie mogą być używane jako działania.

    Zapoznaj się z listą modeli urządzeń oraz konkretnych elementów początkowych i działań, które obsługują w przypadku interfejsu Automatyzacji.

  • 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ń. W sekcji Uprawnienia Ok Google znajdziesz informacje o tym, jak są one egzekwowane w różnych przypadkach.

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

    • Aby korzystać z Time.ScheduledTimeEvent, budynek, w którym działa automatyzacja, musi mieć adres pocztowy skonfigurowany w Google Home app (GHA). Zmiana adresu domowego w Google zawiera informacje o tym, jak użytkownik może wpisać adres budynku. Jeśli adres nie jest skonfigurowany w GHA, automatyzacja nie zostanie utworzona i zostanie wyświetlony błąd z komunikatem „The ScheduledTimeEvent is not supported by the GHA” (Zdarzenie ScheduledTimeEvent nie jest obsługiwane przez GHA).structure
    • 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ę Nest Aware.

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