Supporto dei tratti dell'API Automation su Android

L'API Automation per Android supporta la maggior parte delle caratteristiche, ma il supporto di alcuni attributi, eventi e comandi in una caratteristica potrebbe essere limitato.

In generale:

• Tutti i tratti e i tipi che intendi utilizzare nella tua app con l'API Automation devono essere registrati all'inizializzazione. Vedi Crea un'istanza di 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 rilevamento.

• Anche se un dispositivo supporta le caratteristiche elencate qui, il suo utilizzo come comando iniziale o azione nell'API Automation potrebbe essere bloccato 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 starter.
  • 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 Automazioni.

• 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 Ok Google per scoprire come vengono applicate le autorizzazioni in vari casi.

• Alcuni tratti hanno dei prerequisiti:

  • Per utilizzare i comandi iniziali basati sul tempo, ad esempio 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 in Google Home app (GHA). Modificare l'indirizzo di casa di Google spiega come un utente può inserire o aggiornare l'indirizzo della struttura in GHA. Se l'indirizzo non è configurato, createAutomation() salva e restituisce un Automation in cui isValid == false, con un problema di convalida UnsupportedEntityEvent contenente MissingStructureAddressSetup.
  • Affinché i membri del nucleo familiare ricevano notifiche da Notification.sendNotifications, devono aver installato GHA con le notifiche attivate. Le notifiche vengono inviate ai membri tramite 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 l'attributo ObjectDetection, l'utente deve avere un abbonamento Google Home Premium attivo.

Sono disponibili anche versioni semplificate di alcuni tratti da utilizzare nelle automazioni. Per saperne di più, consulta Caratteristiche semplificate su Android.