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

意圖

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

智慧型住宅意圖是簡單的訊息物件,用來說明要執行的動作 (例如開燈或將音訊投放至揚聲器)。

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

支援的智慧型住宅意圖如下:

同步處理

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

當使用者在 Google Home 應用程式中設定裝置時,他們也會驗證您的雲端基礎架構。接著,Google 助理會收到 OAuth2 權杖。這時,Google 助理會將 action.devices.SYNC 意圖傳送至執行要求,以便從您的雲端基礎架構擷取使用者裝置和功能的初始清單。

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

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

SYNC 意圖的流程圖
圖 2:Sync 意圖

設定本機執行要求時,本機主畫面平台會檢查智慧住宅動作的雲端出貨要求中的 SYNC 回應,如要進一步瞭解如何修改 SYNC 回應以支援本機執行要求,請參閱更新雲端執行中的 SYNC 回應

QUERY

action.devices.QUERY 意圖會用於查詢智慧住宅裝置的目前狀態。

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

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

為了提供最佳使用者體驗,請實作報表狀態,主動將使用者裝置目前的狀態直接回報至主畫面圖。舉例來說,這項功能可以讓 Google 助理瞭解使用者是否透過實體光源開關開啟智慧型燈具。

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

執行方式

action.devices.EXECUTE 意圖是用於提供在智慧住宅裝置上執行的指令。

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

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

DISCONNECT

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