Akıllı ev amaçları, smart home ışığı açmak veya hoparlöre ses yayınlamak gibi ne yapacağını açıklayan basit mesajlaşma nesneleridir.
Tüm smart home amaçları action.devices ad alanında yer alır ve bunlar için istek karşılamanız gerekir. Google Assistant, istek karşılamaya her intent gönderdiğinde 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ğlandığı ve kullanıma hazır olduğu 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ızın kimliği de doğrulanı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.
Bir kullanıcı hesabının bağlantısının kaldırılmasını ve yeniden bağlanmasını önlemek için Assistant adresine senkronizasyon isteği gönderebilirsiniz. Bu işlem, cihaz ve özellik listesini senkronize etmek için action.devices.SYNC amacını karşılamanıza gönderir. Daha fazla bilgi için Senkronizasyon İsteğini Uygulama bölümüne bakın.
Yerel sipariş karşılama kurulumu sırasında Yerel Ev platformu, smart home İşleminizin bulut karşılama hizmetinden gelen SYNC yanıtını kontrol eder. SYNC yanıtınızı yerel sipariş karşılamayı destekleyecek şekilde değiştirme hakkında daha fazla bilgi edinmek için Bulut 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 yanıyor? gibi bir soruyu yanıtlamak için:
Assistant, karşılamanıza action.devices.QUERY intent gönderir.
En iyi kullanıcı deneyimi için bir kullanıcının cihazlarının mevcut durumunu proaktif olarak doğrudan Google Home Graph kullanıcısına bildirmek amacıyla Rapor Durumu'nu uygulamanız gerekir. Örneğin, Assistant, kullanıcınızın fiziksel ışık anahtarıyla akıllı ışığı açıp açmadığını bilebilir.
UYGULAMA
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şılama işleminiz için işlemi ve yapılacak cihazları açıklayan action.devices.EXECUTE niyeti alır. Kullanıcılar, Ok Google, salonumun ışıklarını aç gibi bir komutla cihazda işlem gerçekleştirebilir.
DISCONNECT
action.devices.DISCONNECT niyeti, bir kullanıcı uygulama hesabının Assistant ile bağlantısını kaldırdığında size bilgi vermek için tetiklenir.
action.devices.DISCONNECT intent'i aldıktan sonra, bu kullanıcının cihazları için durumu bildirmemelisiniz.