Akıllı ev amaçları, smart home işlemi için gerçekleştirilecek işlemi (ör. ışığı yakma veya hoparlöre ses yayınlama) açıklayan basit mesaj nesneleridir.
smart home amaçlarının tümü action.devices ad alanında yer alır ve bunlar için istek karşılama yapmanız gerekir. Google Assistant, istek karşılama isteği 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.
Cihazlarını Google Home app (GHA) ile ayarlayan kullanıcılar, bulut altyapınıza yönelik olarak da doğrulanır. Ardından Assistant bir OAuth2 jetonu alır. Bu noktada Assistant, bulut altyapınızdan kullanıcı cihazları ve özelliklerinin ilk listesini almak için karşılamanıza bir action.devices.SYNC niyeti gönderir.
Bir kullanıcının hesabının bağlantısını kaldırmayı ve yeniden bağlantı oluşturmayı önlemek için Assistant ile senkronizasyon isteği gönderebilirsiniz. Bu işlem, cihaz ve özellikler listesini senkronize etmek için action.devices.SYNC niyetini karşılama isteğinize gönderir. Daha fazla bilgi için İstek Senkronizasyonunu Uygulama bölümüne bakın.
Yerel istek karşılama kurulumu sırasında Yerel Ev platformu, smart home İşleminizin bulut istek karşılamasından alınan SYNC yanıtını kontrol eder. SYNC yanıtınızı yerel istek karşılamayı destekleyecek şekilde değiştirme hakkında daha fazla bilgi edinmek için Bulut istek karşılamada SENKRONİZASYON 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 var? gibi bir soruya yanıt vermek için
Assistant, karşılamanıza action.devices.QUERY amacı gönderir.
En iyi kullanıcı deneyimi için bir kullanıcının cihazlarının mevcut durumunu doğrudan Google Home Graph adlı müşteriye proaktif olarak bildirmek üzere Rapor Durumu'nu uygulamanız gerekir. Örneğin bu, Assistant adlı kullanıcının kullanıcınızın fiziksel ışık anahtarı olan akıllı ışığı açıp açmadığını bilmesini sağlar.
Yürüt
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şılamanıza, işlemi ve hangi cihazlarda işlem yapılacakı açıklayan, sipariş karşılama işleminiz için action.devices.EXECUTE amacı gönderilir. Kullanıcılar, Ok Google, salonumun ışıklarını aç gibi bir komutla cihazda işlem gerçekleştirebilir.
DISCONNECT
action.devices.DISCONNECT amacı, bir kullanıcı uygulama hesabının Assistant 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 durum bildirmemelisiniz.