Amaçlar

Akıllı ev intent'leri, hangi Cloud-to-cloud entegrasyonunun gerçekleştirileceğini (ör. ışığı açma veya hoparlöre ses yayınlama) açıklayan basit mesajlaşma nesneleridir.

smart home amaçlarının tümü action.devices ad alanında yer alır ve bunlar için karşılama sağlamanız gerekir. Google Assistant, yerine getirme işlemine bir intent gönderdiğinde kullanıcının üçüncü taraf OAuth 2 erişim jetonu, Authorization 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ıma hazır olan smart home cihazlarının listesini istemek için kullanılır.

Kullanıcılar cihazlarını Google Home app (GHA) ile kurduğunda bulut altyapınızda da kimlik doğrulaması yapılır. Ardından Assistant, bir OAuth2 jetonu alır. Bu noktada Assistant, bulut altyapınızdan kullanıcı cihazlarının ve özelliklerinin ilk listesini almak için karşılamanıza bir action.devices.SYNC intent'i gönderir.

Bu şekilde, Google altyapısı ile iş ortağı altyapısı arasındaki etkileşim gösterilmektedir. Google altyapısından, Asistan istemci uygulaması tarafından kullanılabilen bir iş ortağı listesi vardır. Bu liste, OAuth kimlik doğrulamasını tamamlamak için iş ortağı altyapısına gönderilir. İş 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 ile iş ortağı bulut hizmetlerinden oluşur. İş 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 bu bilgileri Home Graph'te depolar.
Şekil 1: Google ve iş ortağı altyapısı arasındaki etkileşim

Kullanıcı hesabının bağlantısını kaldırıp yeniden bağlamamak için Assistant adresine senkronizasyon isteği gönderebilirsiniz. Bu işlem, cihazların ve özelliklerin listesini senkronize etmek için action.devices.SYNC intent'ini karşılama hizmetinize gönderir. Daha fazla bilgi için Senkronizasyon isteğini uygulama başlıklı makaleyi inceleyin.

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

Yerel karşılama kurulumu sırasında Yerel Ev platformu, smart home İşleminizin bulut karşılamasından gelen SYNC yanıtını kontrol eder. Yerel karşılamayı desteklemek için SYNC yanıtınızı nasıl değiştireceğiniz hakkında daha fazla bilgi edinmek istiyorsanız Bulut karşılamada SYNC yanıtını güncelleme başlıklı makaleyi inceleyin.

QUERY

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

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

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

En iyi kullanıcı deneyimi için Report State'i uygulayarak kullanıcının cihazlarının mevcut durumunu doğrudan Google Home Graph platformuna proaktif olarak bildirmelisiniz. Örneğin, bu sayede Assistant, kullanıcınızın fiziksel bir ışık anahtarıyla akıllı ışığı açıp açmadığını öğrenebilir.

Report State'i kullanarak cihaz durumunu bildirme
Şekil 4: Cihaz durumunu bildirme

EXECUTE

action.devices.EXECUTE intent'i, smart home cihazlarda yürütülecek komutları sağlamak için kullanılır.

Kullanıcılar Assistant ile cihazlara komut gönderdiğinde, yerine getirme işleminiz, işlemi ve üzerinde işlem yapılacak cihazları açıklayan bir action.devices.EXECUTE intent alır. Kullanıcı, Ok Google, oturma odamın ışıklarını aç gibi bir komutla cihazda işlem gerçekleştirebilir.

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

DISCONNECT

action.devices.DISCONNECT intent'i, bir kullanıcı 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ı için durum bildirmemeniz gerekir.

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