Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenebileceğiniz yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem derlemeye devam edersiniz.

Etkinlikler

Akıllı ev intent'leri, ışığı etkinleştirme veya hoparlöre ses yayınlama gibi smart home işleminin gerçekleştirilmesi gerektiğini açıklayan basit mesajlaşma nesneleridir.

Tüm smart home niyet action.devices ad alanında bulunur ve bu niyetlerin karşılanması gerekir. Google Assistant, istek karşılama amacıyla her istek gönderdiğinde, bir kullanıcının üçüncü taraf OAuth 2 erişim jetonu Yetkilendirme üst bilgisinde iletilir.

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

SENKRONİZE ET

action.devices.SYNC amacı, kullanıcının bağladığı ve kullanabileceği smart home cihazın listesini istemek için kullanılır.

Bir kullanıcı, 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 niyeti gönderir.

Bu şekil, Google altyapısı ile iş ortağı altyapısı arasındaki etkileşimi göstermektedir. Google altyapısında, Asistan istemci uygulaması tarafından kullanılabilen iş ortaklarının bir listesi vardır. Bu liste daha sonra OAuth kimlik doğrulamasını tamamlamak için iş ortağı altyapısına gider. İş ortağı tarafında OAuth kimlik doğrulaması; iş ortağı kurulumu web görünümü, OAuth web görünümü, isteğe bağlı ayar 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 ve ardından bu bilgileri Home Graph'te depolar.
Şekil 1: Google ile İş Ortağı altyapısı arasındaki etkileşim

Bir kullanıcının hesabının bağlantısını kaldırıp yeniden bağlamaktan kaçınmak için Assistant hizmetine bir istek senkronizasyonu gönderebilirsiniz. Bu işlem, cihaz ve özellik listesini senkronize etmek için action.devices.SYNC niyeti karşılamanıza gönderir. Daha fazla bilgi için Sync Sync İsteğini Uygulama bölümüne bakın.

SYNC niyetinin akış şeması
Şekil 2: Niyeti senkronize etme

Yerel sipariş karşılama kurulumu sırasında Yerel Ev platformu, smart home İşleminizin buluttaki yerine getirilmesinden alınan SYNC yanıtını kontrol eder. SYNC yanıtınızı yerel isteği destekleyecek şekilde değiştirme hakkında daha fazla bilgi edinmek için Bulutta sipariş karşılamada SYNC yanıtını güncelleme bölümüne bakın.

QUERY

action.devices.QUERY amacı, smart home cihazı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, istek karşılamanıza action.devices.QUERY amacı gönderir.

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

En iyi kullanıcı deneyimi için bir kullanıcının cihazlarının durumunu doğrudan Google Home Graph adresine proaktif bir şekilde bildirmek üzere Rapor Durumu'nu uygulamanız gerekir. Örneğin, Assistant kullanıcınızın fiziksel ışık anahtarıyla akıllı ışık açıp açmadığını bildirir.

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

Yürüt

action.devices.EXECUTE amacı, smart home cihazlarda çalıştırmak üzere komutlar sağlamak için kullanılır.

Kullanıcılar Assistant kullanarak cihazlara komut gönderdiğinde sipariş karşılama işleminiz, işlemi ve işlem yapılacak cihazları açıklayan action.devices.EXECUTE amacına ulaşır. Kullanıcılar, Ok Google, salon ışıklarımı aç gibi bir komutla bir cihazda işlem gerçekleştirebilir.

Yürütme amacının akış şeması
Şekil 5: Yürütme amacı

DISCONNECT

action.devices.DISCONNECT amacı, bir kullanıcı uygulama hesabının Assistant ile olan bağlantısını kaldırdığında sizi bilgilendirmek için tetiklenir. Bir action.devices.DISCONNECT amacı aldıktan sonra, bu kullanıcının cihazları için durumu bildirmemelisiniz.