支援裝置探索

如果 Google 與本機可控制的裝置相符，系統就會建立本機執行要求路徑來自 SYNC 中的退貨或 Cloud 執行要求回應

為了讓 Google 在區域網路上找到你的裝置，以及建立本機執行要求路徑，您必須在 Actions 主控台中新增探索資訊。您也需要從 Cloud 執行要求中更新 SYNC 回應，方便 Google 掌握可本機控制的裝置。

設定掃描設定資訊

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

在 Actions 主控台中開啟智慧型住宅專案。
在左側導覽面板中，按一下「動作」。
在「Configure local home SDK (optional)」下方 > 「Add deviceScan configuration」(新增裝置掃描設定)，按一下「NewScan config」(新增掃描設定)。
從下拉式選單中選取一項掃描比對通訊協定類型，然後輸入以下的值：。

下表說明您可以根據通訊協定新增的屬性您希望 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`

在 Cloud 執行要求中更新 SYNC 回應

SYNC 意圖回報的目標值如下： Google 助理：使用者控制的裝置及相關功能。

為支援本地執行要求，本地首頁平台會檢查 SYNC 回應模擬智慧型住宅動作的雲端執行要求，試著比對裝置將 otherDeviceIds 欄位中的 ID 設為 IDENTIFY 處理常式。不含「otherDeviceIds」欄位的裝置項目為從店面出貨中排除。

在 otherDeviceIds敬上回應SYNC回應中的欄位，您需要設定智慧型住宅的裝置 ID 可在本機控制的裝置。這個欄位會顯示在 device 層級回應。Google 可以在符合下列條件的裝置上建立本機執行要求路徑：指定的 ID

請使用 customData 欄位指定 Google 所需的任何其他資料連線到獨立裝置，或透過中樞裝置指定最終裝置 (例如通訊埠編號和其他通訊協定專屬資訊)。

範例

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

獨立/遊戲中心

{
  "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": "..."
      }
    }]
  }
}

總覽

導入本地出貨應用程式