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.
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.
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 için 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.
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.
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.
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.
Bir action.devices.DISCONNECT intent'i aldıktan sonra, bu kullanıcının cihazlarının durumunu bildirmemeniz gerekir.