Niyetler

Akıllı ev intent'leri, Cloud-to-cloud entegrasyonunun ne yapacağını (ör. ışığı açma veya bir hoparlöre ses yayınlama) açıklayan basit mesajlaşma nesneleridir.

Tüm smart home intent'leri action.devices ad alanında bulunur ve bunlar için karşılama sağlamanız gerekir. Google Assistant, yerine getirmeye yönelik bir intent gönderdiğinde kullanıcının üçüncü taraf OAuth 2 erişim jetonu, Yetkilendirme başlığında iletilir.

Desteklenen smart home intent'leri şunlardır:

SENKRONİZE ET

action.devices.SYNC intent'i, kullanıcının bağladığı ve kullanılabilen smart home cihazların listesini istemek için kullanılır.

Kullanıcılar cihazlarını Google Home app (GHA) ile kurarken bulut altyapınızda kimlik doğrulaması da yapar. Ardından Assistant bir OAuth2 jetonu alır. Bu noktada Assistant, kullanıcı cihazlarının ve özelliklerinin ilk listesini bulut altyapınızdan almak için sipariş işleme hizmetinize bir action.devices.SYNC isteği gönderir.

Bu şekilde, Google altyapısı ile iş ortağı altyapısı arasındaki etkileşim gösterilmektedir. Google altyapısında, Asistan istemci uygulamasının kullanabileceği bir iş ortağı listesi vardır. Bu liste, OAuth kimlik doğrulamasını tamamlamak için iş ortağı altyapısına aktarılır. İş ortağı tarafındaki OAuth kimlik doğrulaması; iş ortağı kurulumu web görünümü, OAuth web görünümü, isteğe bağlı ayarlar ve şartlar ve iş ortağı bulut hizmetleridir. İş ortağı altyapısı, OAuth kimlik bilgilerini Asistan istemci uygulamasına döndürür. İş ortağı bulut hizmetleri, mevcut cihazları ve özellikleri Asistan hizmetlerine gönderir. Asistan hizmetleri de bilgileri Home Graph'da depolar.
Şekil 1: Google ile iş ortağı altyapısı arasındaki etkileşim

Kullanıcının hesabının bağlantısının kaldırılmasını ve yeniden bağlanmasını önlemek için Assistant adresine bir senkronizasyon isteği gönderebilirsiniz. Bu işlem, cihaz ve özellik listesini senkronize etmek için action.devices.SYNC intent'ini yerine getirme hizmetinize gönderir. Daha fazla bilgi için İstek Senkronizasyonu'nu uygulama başlıklı makaleyi inceleyin.

SYNC intent'inin akış diyagramı
Şekil 2: SYNC intent

Yerel sipariş tamamlama kurulumu sırasında Yerel Ana Sayfa platformu, smart home İşleminizin bulut sipariş tamamlama özelliğinden gelen SYNC yanıtını kontrol eder. Yerel sipariş tamamlamayı desteklemek için SYNC yanıtınızı nasıl değiştireceğiniz hakkında daha fazla bilgi edinmek istiyorsanız Bulut sipariş tamamlamada SYNC yanıtını güncelleme başlıklı makaleyi inceleyin.

QUERY

action.devices.QUERY intent'i, smart home cihazlarının mevcut durumunu sorgulamak için kullanılır.

Kullanıcılar cihaz durumunu sorgularken Hey Google, mutfakta hangi ışıklar açık? gibi bir soruyu yanıtlamak için Assistant, sipariş tamamlama hizmetinize bir action.devices.QUERY intent'i gönderir.

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

En iyi kullanıcı deneyimi için, kullanıcının cihazlarının mevcut durumunu doğrudan Google Home Graph'e proaktif olarak bildirmek üzere Durum Bildir özelliğini uygulamanız gerekir. Örneğin, bu özellik sayesinde Assistant, kullanıcınızın akıllı bir lambayı fiziksel bir ışık anahtarıyla açıp açmadığını öğrenebilir.

"Durum Raporu"nu kullanarak cihaz durumunu bildirme
Şekil 4: Cihaz durumunu raporlama

YÜRÜTME

action.devices.EXECUTE intent'i, smart home cihazlarda çalıştırılacak komutlar sağlamak için kullanılır.

Kullanıcılar Assistant ile cihazlara komut gönderdiğinde, sipariş tamamlama işleminiz, işlemi ve işlem yapılacak cihazları açıklayan bir action.devices.EXECUTE intent'i alır. Kullanıcılar, Ok Google, oturma odamın ışıklarını aç gibi bir komutla cihazlarda işlem yapabilir.

EXECUTE intent'inin akış diyagramı
Şekil 5: EXECUTE intent

DISCONNECT

action.devices.DISCONNECT intent'i, bir kullanıcının uygulama hesabının Assistant ile bağlantısını kaldırdığında sizi bilgilendirmek için tetiklenir. action.devices.DISCONNECT intent'i aldıktan sonra bu kullanıcının cihazlarının durumunu bildirmemeniz gerekir.

Önceki
Cihaz türleri ve özellikler
Sonraki
Sipariş karşılama