Etkinlikler

Akıllı ev amaçları, bire bir konuşurken smart home hangi işlemi yapacaklarını (ör. ışığı açma veya hoparlöre yayınlayabilirsiniz.

smart home amaçlarının tümü action.devices ad alanıdır ve bunlar için karşılamanız gerekir. Her zaman Google Assistant, istek karşılamaya bir intent gönderir. Yetkilendirme üstbilgisinde üçüncü taraf OAuth 2 erişim jetonu iletildi.

Desteklenen smart home amaçları şunlardır:

SENKRONİZE ET

action.devices.SYNC intent, aşağıdakilerin listesini istemek için kullanılır: Kullanıcının bağlı olduğu ve şu olduğu smart home cihaz: kullanılabilir.

Kullanıcı cihazlarını Google Home app (GHA) ile kurduğunda kimliğinizin doğrulanmasını sağlar. Ardından, Assistant, bir OAuth2 jetonu alır. Bu noktada Assistant, şuraya action.devices.SYNC intent'i gönderir: kullanıcı cihazlarının ve özelliklerinin ilk listesini alma en iyi uygulamaları görelim.

Bu şekilde, Google altyapısı ile web sitesi arasındaki etkileşim
    ve iş ortağı altyapısı. Google altyapısında,
    Asistan istemci uygulamasında kullanılabilen iş ortaklarının listesini
    OAuth kimlik doğrulamasını tamamlamak için iş ortağı altyapısına aktarılır. OAuth
    iş ortağı tarafında kimlik doğrulama, iş ortağı kurulumu web görünümü, OAuth web görünümü,
    isteğe bağlı ayarlar, şartlar ve iş ortağı bulut hizmetleri. İş ortağı altyapısı,
    ve ardından OAuth kimlik bilgilerini Asistan istemci uygulamasına döndürür. İş ortağı
    bulut hizmetleri, kullanılabilir cihazları ve özellikleri Asistan hizmetlerine gönderir,
    Bu da bilgileri Ana Sayfa Grafiği'nde depolar.
Şekil 1: Google ile İş Ortağı arasındaki etkileşim altyapı

Bir kullanıcı hesabının bağlantısının kaldırılmasını ve yeniden bağlanmasını önlemek için senkronizasyon isteği gönderebilirsiniz Assistant numaralı telefona. Bu, action.devices.SYNC niyetini gönderir cihaz ve özellik listesini senkronize etmek için sipariş karşılamaya ekleyin. Görüntüleyin Daha fazlası için Senkronizasyon İsteğini uygulayın ekleyebilirsiniz.

SYNC amacının akış diyagramı
Şekil 2: SENKRONİZASYON Amacı

Yerel sipariş karşılama kurulumu sırasında Yerel Ev platformu, sizden gelen SYNC yanıtını kontrol eder smart home İşlemin buluttaki karşılaması. Google Cloud'un SYNC yanıtınızı yerel sipariş karşılamayı destekleyecek şekilde değiştirmek için Buluttaki istek karşılamada SYNC yanıtını güncelleyin.

QUERY

action.devices.QUERY amacı, mevcut durumu sorgulamak için kullanılır smart home cihazdan

Kullanıcılar cihaz durumunu sorgularken, Ok Google, mutfakta hangi ışıklar açık?, Assistant, şuraya action.devices.QUERY intent'i gönderir: istek karşılamayı da kapsar.

QUERY amacının akış diyagramı
Şekil 3: QUERY amacı

En iyi kullanıcı deneyimi için Proaktif olarak bildirmek için bildirme durumu kullanıcının cihazlarının mevcut durumunu doğrudan Google Home Graph. Örneğin bu, Assistant, kullanıcınızın bir akıllı ışığı açıp açmadığını öğrenebilir fiziksel ışık anahtarı.

Rapor Durumunu kullanarak cihaz durumunu raporlama
Şekil 4: Cihaz durumunu raporlama

UYGULAMA

action.devices.EXECUTE intent, komut sağlamak için kullanılır smart home cihazda çalıştırılmasına izin veriliyor.

Kullanıcılar Assistant ile cihazlara komut gönderdiğinde, sipariş karşılama, sipariş karşılamaya yönelik action.devices.EXECUTE intent alır: işlemi ve işlem yapılacak cihazları tanımlar. Kullanıcı işlem gerçekleştirebilir Ok Google, salonumun ışıklarını aç gibi bir komutla cihazda.

EXECUTE amacının akış diyagramı
Şekil 5: Niyeti UYGULAMA

DISCONNECT

action.devices.DISCONNECT intent, sizi bilgilendirmek için tetiklenir. Kullanıcı, uygulama hesabının Assistant ile bağlantısını kaldırdığında. action.devices.DISCONNECT intent'i aldıktan sonra bunu bildirmemelisiniz. durumu belirtin.