Supporto dei tratti dell'API Automation su Android

L'API Automation per Android supporta la maggior parte dei tratti, ma il supporto per alcuni attributi, eventi e comandi di un tratto potrebbe essere limitato.

In generale:

• Tutti i tratti e i tipi che intendi utilizzare nella tua app con l'API Automation devono essere registrati durante l'inizializzazione. Consulta Crea un'istanza Home.
• Qualsiasi attributo può essere utilizzato nei comandi iniziali o nelle condizioni.
• I dispositivi Cloud-to-cloud che non segnalano il proprio stato non possono essere utilizzati come trigger nelle automazioni, create manualmente o tramite il rilevamento.

• Anche se un dispositivo supporta i tratti elencati qui, potrebbe essere bloccato per l'utilizzo come comando iniziale o azione nell'API Automation a causa delle soglie di qualità di Report State:

  • I dispositivi con un tasso di successo di Report State inferiore al 90% non possono essere utilizzati come comandi iniziali.
  • I dispositivi con un tasso di successo dell'esecuzione dei comandi inferiore al 95% non possono essere utilizzati come azioni.

  Consulta questo elenco di modelli di dispositivi e i comandi iniziali e le azioni specifici che supportano per l'API Automations.

• I comandi possono essere utilizzati solo come azioni.

• Alcuni tratti, come AssistantBroadcast e Notification, sono disponibili solo per l'utilizzo nell'API Automation.

• Il comando okGoogle è un comando a livello di struttura e può essere utilizzato per automatizzare qualsiasi dispositivo nella struttura. Tuttavia, un'app API Home potrebbe non avere accesso a tutti i dispositivi. Consulta Autorizzazioni OkGoogle per scoprire come vengono applicate le autorizzazioni in vari casi.

• Alcuni tratti hanno dei prerequisiti:

  • Per utilizzare i comandi iniziali basati sul tempo, come Time.ScheduledTimeEvent, Time.RecurringClockTimeScheduledEvent o Time.RecurringSolarTimeScheduledEvent, la struttura in cui viene eseguita l'automazione deve avere un indirizzo per determinare il fuso orario locale e i calcoli solari. L'indirizzo può essere fornito durante la creazione della struttura o impostato nell'Google Home app (GHA). Modifica l'indirizzo di casa Google spiega come un utente può inserire o aggiornare l'indirizzo della struttura nell'GHA. Se l'indirizzo non è configurato, createAutomation() salva e restituisce un Automation dove isValid == false, con un problema di convalida UnsupportedEntityEvent contenente MissingStructureAddressSetup.
  • Affinché i membri del nucleo familiare ricevano notifiche da Notification.sendNotifications, devono avere installato GHA con le notifiche attive. Le notifiche vengono inviate ai membri tramite l'GHA e non possono essere inviate direttamente ad app di terze parti.
  • Per utilizzare i tratti AreaPresenceState o AreaAttendanceState, l'utente deve configurare il monitoraggio della presenza di persone in GHA.
  • Per utilizzare il tratto ObjectDetection, l'utente deve avere un abbonamento Google Home Premium attivo.

Nelle automazioni sono disponibili anche versioni semplificate di alcuni tratti. Per saperne di più, consulta Tratti semplificati su Android.