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ądzenia, które nie zgłaszają swojego stanu, nie mogą być używane jako wyzwalacze w automatyzacjach utworzonych ręcznie ani w ramach wykrywania.
  • Nawet jeśli urządzenie obsługuje wymienione tu cechy, może być zablokowane w użyciu jako polecenie inicjujące lub działanie w interfejsie Automation API z powodu progów jakości Report State:

    • Urządzenia, których odsetek zgłoszeń stanu zakończonych sukcesem 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 tą listą modeli urządzeń oraz konkretnych elementów początkowych i działań, które obsługują w przypadku interfejsu Automatyzacji.

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

  • 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, obiekt, 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 pojawi się błąd z komunikatem „The ScheduledTimeEvent is not supported by the GHA” (GHA nie obsługuje zdarzenia ScheduledTimeEvent).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.