歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。

意圖

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

智慧型住宅意圖是簡單的訊息物件,用於說明smart home要執行的動作 (例如開燈或將音訊投放到喇叭)。

所有 smart home 意圖都包含在 action.devices 命名空間中,而您必須為這些意圖提供執行要求。每當 Google Assistant 將意圖傳送至執行要求時,使用者的第三方 OAuth 2 存取憑證就會傳送至 Authorization 標頭。

以下是支援的 smart home 意圖:

同步處理

action.devices.SYNC 意圖用於要求使用者已連線且可供使用的 smart home 裝置清單。

當使用者用 Google Home app (GHA) 設定裝置時,他們也會通過雲端基礎架構驗證。接著,Assistant 會收到 OAuth2 憑證。此時,Assistant 會將 action.devices.SYNC 意圖傳送至執行要求,以從您的雲端基礎架構擷取使用者裝置和功能的初始清單。

下圖顯示 Google 基礎架構與合作夥伴基礎架構之間的互動。在 Google 基礎架構中,Google 助理用戶端應用程式可以使用合作夥伴清單,然後由合作夥伴提供給合作夥伴基礎架構完成 OAuth 驗證。合作夥伴端的 OAuth 驗證包括合作夥伴設定 WebView、OAuth 網頁畫面、選用設定和條款,以及合作夥伴雲端服務。接著,合作夥伴基礎架構會將 OAuth 憑證傳回至 Google 助理用戶端應用程式。合作夥伴雲端服務會將可用裝置和功能傳送至 Google 助理服務,然後將資訊儲存至 Home Graph 中。
圖 1:Google 與合作夥伴基礎架構之間的互動

為避免取消連結及重新連結使用者帳戶,您可以將要求同步處理傳送至 Assistant。這項操作會將 action.devices.SYNC 意圖傳送至執行要求,以同步處理裝置和功能清單。詳情請參閱實作 要求同步處理

SYNC 意圖的流程圖
圖 2:同步意圖

本機執行要求設定期間,本機首頁平台會檢查 smart home 動作雲端執行要求中的 SYNC 回應。如要進一步瞭解如何修改 SYNC 回應以支援本機執行要求,請參閱更新雲端執行中的 SYNC 回應

QUERY

action.devices.QUERY 意圖用於查詢 smart home 裝置的目前狀態。

當使用者查詢裝置狀態時,要回答以下問題,例如:「Ok Google,廚房的燈是什麼?」Assistant 會將 action.devices.QUERY 意圖傳送至執行要求。

QUERY 意圖的流程圖
圖 3:QUERY 意圖

為了提供最佳的使用者體驗,您應實作報告狀態,主動將使用者裝置目前的狀態主動回報至 Google Home Graph。例如,此設定會讓 Assistant 知道使用者是否以實體光源開關開啟智慧型燈具。

使用報告狀態回報裝置狀態
圖 4:回報裝置狀態

執行

action.devices.EXECUTE 意圖可用來提供在 smart home 裝置上執行的指令。

當使用者傳送指令至 Assistant 的裝置時,執行要求會收到您的 action.devices.EXECUTE 意圖,用於說明動作和要執行的動作。使用者可以透過裝置 (例如「Ok Google,打開客廳的燈」) 對裝置執行動作。

EXECUTE 意圖的流程圖
圖 5:執行意圖

取消連結

action.devices.DISCONNECT 意圖會在使用者取消連結應用程式帳戶與 Assistant 時通知您。收到 action.devices.DISCONNECT 意圖後,請不要回報這位使用者的裝置狀態。