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

支援裝置探索

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

當 Google 將本機控制的裝置與雲端出貨 SYNC 回應中傳回的裝置進行比對時,就會建立本機出貨路徑。

如要讓 Google 在本機裝置上探索您的裝置並建立本機執行要求路徑,您必須在動作控制台中新增探索資訊。此外,您也必須更新雲端執行要求中的 SYNC 回應,讓 Google 知道本機控制的裝置。

設定掃描設定資訊

如要指定探索資訊,請按照下列步驟操作:

  1. 在動作控制台中開啟智慧型住宅專案。
  2. 在左側導覽面板中按一下 [動作]
  3. 在「Configure local home SDK (選填)」 >「Add device scan configuration」下方,按一下「New scan config」
  4. 從下拉式選單中選取要掃描的通訊協定類型,然後輸入要供 Google 掃描的值。

您可以根據要讓 Google 掃描裝置使用的通訊協定,查看下表中可新增的屬性:

mDNS
屬性 說明 範例值
服務名稱 必要,裝置發布的服務名稱,格式為 service.domain _http._tcp.local
名稱

必要,篩選格式為 instance.service.domain 的不重複服務執行個體。

平台會將這個值視為規則運算式,並傳回任何相符的裝置。
my-device-[0-9]{4}\._http\._tcp\.local
UPnP
屬性 說明 範例值
服務類型 必要,UPnP 服務的完整 ID,格式為 domain:service:type:version schemas-upnp-org:service:SwitchPower:1
OUI

選用,機構專屬 ID

識別裝置製造商的 24 位元值。 一般而言,裝置 MAC 位址的前三個八位元組。
1A:2B:3C
UDP
屬性 說明 範例值
廣播地址 必要,UDP 廣播的目的地 IP 位址。 255.255.255.255
廣播通訊埠 必要,UDP 廣播的目的地通訊埠。 5555
監聽通訊埠 必要,監聽 UDP 探索回應的通訊埠。 5556
探索封包

必要,要在 UDP 廣播中傳送的酬載。

採用十六進位編碼位元組格式。
48454C4C4F

更新雲端執行要求中的 SYNC 回應

SYNC 意圖會向 Google 助理回報使用者控制的裝置及其功能。

為支援本機執行要求,本機主畫面平台會檢查智慧住宅動作的雲端出貨要求中的 SYNC 回應,並嘗試比對 otherDeviceIds 欄位的裝置 ID 與 IDENTIFY 處理常式傳回的驗證 ID。不含 otherDeviceIds 欄位的裝置項目不會納入本機出貨要求。

SYNC 回應的 otherDeviceIds 欄位中,您必須設定本機控制的智慧住宅裝置裝置 ID。欄位會顯示在回應的 device 層級。Google 可以在具備指定 ID 的任何裝置上建立本機執行要求路徑。

使用 customData 欄位指定 Google 連線至獨立裝置時所需的任何其他資料,或是透過 Hub 指定終端裝置 (例如通訊埠編號和其他通訊協定專屬資訊)。

範例

下列程式碼片段說明如何建立 SYNC 處理常式。

獨立/Hub
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [{
      "id": "123",
      "type": "action.devices.types.OUTLET",
      "traits": [
        "action.devices.traits.OnOff"
      ],
      "name": {
        "name": "Night light"
      },
      "willReportState": false,
      "otherDeviceIds": [{
        "deviceId": "local-device-id"
      }],
      "customData": {
        "port": 5555,
        "authToken": "..."
      }
    }]
  }
}