支援裝置探索

當 Google 將本機可控制的裝置與雲端執行結果傳回的裝置相符時,就會建立本機執行路徑。SYNC

如要讓 Google 在本機網路上偵測裝置並建立本機執行路徑,您必須在 Actions 主控台中新增偵測資訊。您也需要更新雲端執行服務的 SYNC 回應,讓 Google 瞭解可透過本機控制的裝置。

設定掃描設定資訊

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

  1. 前往 Google Home Developer Console 中的 Cloud-to-cloud 整合:

    前往開發人員控制台

  2. 前往畫面左側的「Project」>「Cloud-to-cloud」,然後選取要整合的「Edit」。在「設定和配置」頁面中,捲動至「本機訂單履行」,然後將設定切換為開啟。在每個測試網址欄位中輸入下列網址,插入專案 ID,然後按一下「儲存」

    https://<project-id>.web.app/local-home/index.html

  3. 按一下「裝置偵測」下方的「+ 新增掃描設定」,新增掃描設定。

  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
Discovery 封包

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

以十六進位編碼的位元組字串格式呈現。
48454C4C4F

在雲端執行服務時更新 SYNC 回應

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

為支援本機執行,Local Home 平台會檢查智慧型住宅動作指令的雲端執行結果所傳回的 SYNC 回應,並嘗試將 otherDeviceIds 欄位中的裝置 ID 與 IDENTIFY 處理常式傳回的驗證 ID 比對。沒有 otherDeviceIds 欄位的裝置項目會從本機服務中排除。

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

使用 customData 欄位指定 Google 需要連線至獨立裝置,或使用中樞指定終端裝置的任何其他資料 (例如連接埠號碼和其他特定通訊協定資訊)。

範例

下列程式碼片段說明如何建立 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": "..."
      }
    }]
  }
}