Amaçlar

Akıllı ev amaçları, Cloud-to-cloud entegrasyonunun ne gibi işlemler yapacağını (ör. ışığı açma veya hoparlöre ses aktarma) açıklayan basit mesajlaşma nesneleridir.

Tüm smart home amaçları action.devices ad alanında yer alır ve bunlar için karşılama sağlamanız gerekir. Google Assistant, her ne zaman bir niyet gönderirse kullanıcının üçüncü taraf OAuth 2 erişim jetonu Yetkilendirme başlığında iletilir.

Desteklenen smart home amaçlar şunlardır:

SENKRONİZE ET

action.devices.SYNC amacı, kullanıcının bağladığı ve kullanıma hazır olan smart home cihazları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ının cihazlarının ve özelliklerinin ilk listesini almak için karşılamanıza bir action.devices.SYNC amacı 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ı tarafından kullanılabilen bir iş ortağı listesi bulunur. 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 ile iş ortağı bulut hizmetleridir. İş ortağı altyapısı, OAuth kimlik bilgilerini Asistan istemci uygulamasına döndürür. İş ortağı bulut hizmetleri, kullanılabilir cihazları ve özellikleri Asistan hizmetlerine gönderir. Asistan hizmetleri de bu bilgileri Ev Grafiği'nde saklar.
Şekil 1: Google ve İş Ortağı altyapısı arasındaki etkileşim

Kullanıcı hesabının bağlantısını kaldırmayı ve yeniden bağlamayı ö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 amacını karşılama işlevinize gönderir. Daha fazla bilgi için İstek Senkronizasyonunu Uygulama başlıklı makaleyi inceleyin.

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

Yerel karşılama kurulumu sırasında Local Home platformu, smart home İşleminizin bulut karşılama özelliğinden gelen SYNC yanıtını kontrol eder. Yerel karşılama özelliğini desteklemek için SYNC yanıtınızı nasıl değiştireceğiniz hakkında daha fazla bilgi edinmek için Bulut karşılama özelliğinde SYNC yanıtını güncelleme başlıklı makaleyi inceleyin.

QUERY

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

Kullanıcılar cihaz durumunu sorguladığında (ör. Hey Google, mutfakta hangi ışıklar açık? sorusunu yanıtlamak için) Assistant, karşılamanıza bir action.devices.QUERY intent'i gönderir.

QUERY amacının akış diyagramı
Şekil 3: SORGULAMA 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'e proaktif olarak bildirmeniz gerekir. Örneğin, bu özellik Assistant uygulamasının, kullanıcınızın fiziksel bir ışık anahtarıyla akıllı ışığı açıp açmadığını bilmesini sağlar.

Durum raporu kullanılarak cihaz durumunu raporlama
Şekil 4: Cihaz durumunu raporlama

YÜRÜTME

action.devices.EXECUTE amacı, 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, karşılanma isteğinizde işlemi ve üzerinde işlem yapılacak cihazları açıklayan bir action.devices.EXECUTE amacı yer alır. Kullanıcılar, Ok Google, oturma odamın ışıklarını aç gibi bir komutla cihazda işlem yapabilir.

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

DISCONNECT

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

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