本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用者引導設定以加入和操作裝置透過建立受管物件並將其連接到中樞，將您的裝置設定為加入受管整合中樞。本節說明使用使用者引導設定完成裝置加入程序的步驟。 ## 先決條件在嘗試加入裝置之前，請先完成以下步驟： + 將中樞裝置加入受管整合中樞。 + AWS CLI 從 [Managed Integrations AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/)安裝最新版本的 + 訂閱 [DEVICE\$1DISCOVERY-STATUS](managedintegrations-notifications.md#managedintegrations-notification-setup) 事件通知。 **Topics** + [先決條件](#managedintegrations-sdk-v2-cookbook-ugs-prereq) + [先決條件：在 Z Wave 裝置上啟用配對模式](#managedintegrations-sdk-v2-cookbook-pairing-mode) + [步驟 1：開始裝置探索](#managedintegrations-sdk-v2-cookbook-device-discovery) + [步驟 2：查詢探索任務 ID](#managedintegrations-sdk-v2-cookbook-query-discovery) + [步驟 3：為您的裝置建立受管物件](#managedintegrations-sdk-v2-cookbook-ugs-managed-thing) + [步驟 4：查詢受管物件](#managedintegrations-sdk-v2-cookbook-query-managed-thing) + [步驟 5：取得受管物件功能](#managedintegrations-sdk-v2-cookbook-check-device-capabilties) + [步驟 6：將命令傳送至受管物件](#managedintegrations-sdk-v2-cookbook-ugs-control-device) + [步驟 7：檢查受管物件狀態](#managedintegrations-sdk-v2-cookbook-ugs-device-state) + [步驟 8：從您的中樞移除受管物件](#managedintegrations-sdk-v2-cookbook-ugs-clean-up) ## 先決條件：在 Z Wave 裝置上啟用配對模式在 Z 波裝置上啟用配對模式。配對模式會因每個 Z-Wave 裝置而異，因此請參閱裝置的說明以正確設定配對模式。它通常是使用者必須按下的按鈕。 ## 步驟 1：開始裝置探索為您的中樞啟動裝置探索，以取得用於加入裝置的探索任務 ID。 **啟動裝置探索** + 使用 [start-device-discovery](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/start-device-discovery.html) 命令來取得探索任務 ID。 **start-device-discovery 範例** ``` #For Zigbee aws iot-managed-integrations start-device-discovery --discovery-type ZIGBEE \ --controller-identifier HUB_MANAGED_THING_ID #For Zwave aws iot-managed-integrations start-device-discovery --discovery-type ZWAVE \ --controller-identifier HUB_MANAGED_THING \ --authentication-material-type ZWAVE_INSTALL_CODE \ --authentication-material 13333 #For Cloud aws iot-managed-integrations start-device-discovery --discovery-type CLOUD \ --account-association-id C2C_ASSOCIATION_ID \ #For Custom aws iot-managed-thing start-device-discovery --discovery-type CUSTOM \ --controller-identifier HUB_MANAGED_THING_ID \ --custom-protocol-detail NAME : NON_EMPTY_STRING \ ``` **回應：** ``` { "Id": DISCOVERY_JOB_ID, "StartedAt": "2025-06-03T14:43:12.726000-07:00" } ``` **注意** Z-wave 和 Zigbee 裝置有不同的命令。如需詳細資訊，請參閱受管 integrations AWS CLI *Command Reference* 中的 [start-device-discovery](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/start-device-discovery.html) API。 ## 步驟 2：查詢探索任務 ID 使用 `list-discovered-devices`命令來取得裝置的身分驗證資料。 **查詢您的探索任務 ID** + 使用探索任務 ID 搭配 list-discovered-devices 命令，以取得裝置的身分驗證資料。 ``` aws iot-managed-integrations list-discovered-devices --identifier DISCOVERY_JOB_ID ``` **回應：** ``` "Items": [ { "DeviceTypes": [], "DiscoveredAt": "2025-06-03T14:43:37.619000-07:00", "AuthenticationMaterial": AUTHENTICATION_MATERIAL } ] ``` ## 步驟 3：為您的裝置建立受管物件使用 `create-managed-thing`命令為您的裝置建立受管物件。每個裝置都需要自己的受管物件。 **建立受管物件** + 使用 `create-managed-thing`命令為您的裝置建立受管物件。 **create-managed-thing 範例** ``` aws iot-managed-integrations create-managed-thing \ --role DEVICE --authentication-material-type DISCOVERED_DEVICE \ --authentication-material "AUTHENTICATION_MATERIAL" ``` **回應：** ``` { "Id": "DEVICE_MANAGED_THING_ID" "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/DEVICE_MANAGED_THING_ID" "CreatedAt": "2025-06-09T13:58:52.977000+08:00" } ``` 如需詳細資訊，請參閱受管整合命令參考中的 [create-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-managed-thing.html) AWS CLI 命令。 ** ## 步驟 4：查詢受管物件您可以使用 `get-managed-thing`命令來檢查受管物件是否已啟用。 **查詢受管物件** + 使用 `get-managed-thing`命令來檢查受管物件的佈建狀態是否設定為 `ACTIVATED`。如需佈建狀態的詳細資訊，請參閱 [裝置佈建](https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html)。 **get-managed-thing 範例** ``` aws iot-managed-integrations get-managed-thing \ --identifier "DEVICE_MANAGED_THING_ID" ``` **回應：** ``` { "Id": "DEVICE_MANAGED_THING_ID", "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/DEVICE_MANAGED_THING_ID, "Role": "DEVICE", "ProvisioningStatus": "ACTIVATED", "MacAddress": "MAC_ADDRESS", "ParentControllerId": "PARENT_CONTROLLER_ID", "CreatedAt": "2025-06-03T14:46:35.149000-07:00", "UpdatedAt": "2025-06-03T14:46:37.500000-07:00", "Tags": {} } ``` 如需詳細資訊，請參閱受管整合命令參考中的 [get-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing.html) AWS CLI 命令。 ** ## 步驟 5：取得受管物件功能您可以使用檢視受管物件的可用動作清單`get-managed-thing-capabiltiies`。 **取得裝置的功能** + 使用 `get-managed-thing-capabilities`命令來取得端點 ID。另請注意可能的動作清單。 **get-managed-thing-capabilities 範例** ``` aws iot-managed-integrations get-managed-thing-capabilities \ --identifier "DEVICE_MANAGED_THING_ID" ``` **回應：** ``` { "ManagedThingId": "DEVICE_MANAGED_THING_ID", "CapabilityReport": { "version": "1.0.0", "nodeId": "zb.539D+4A1D", "endpoints": [ { "id": "1", "deviceTypes": [ "Unknown Device" ], "capabilities": [ { "id": "matter.OnOff@1.4", "name": "On/Off", "version": "6", "properties": [ "OnOff", "OnOff", "OnTime", "OffWaitTime" ], "actions": [ "Off", "On", "Toggle", "OffWithEffect", "OnWithRecallGlobalScene", "OnWithTimedOff" ], ... } ``` 如需詳細資訊，請參閱受管整合命令參考中的 [get-managed-thing-capabilities](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing-capabilities.html) 命令。 AWS CLI** ## 步驟 6：將命令傳送至受管物件您可以使用 send-managed-thing-command 命令，將切換動作命令傳送至受管物件。 **使用切換動作將命令傳送至受管物件。** + 使用 `send-managed-thing-command`命令來傳送切換動作命令。 **send-managed-thing-command 範例** ``` json=$(jq -cr '.|@json') < 檢查受管物件的狀態，以驗證切換動作是否成功。 **檢查受管物件的裝置狀態** + 使用 `get-managed-thing-state`命令來驗證切換動作是否成功。 **get-managed-thing-state 範例** ``` aws iot-managed-integrations get-managed-thing-state --managed-thing-id DEVICE_MANAGED_THING_ID ``` **回應：** ``` { "Endpoints": [ { "endpointId": "1", "capabilities": [ { "id": "matter.OnOff@1.4", "name": "On/Off", "version": "1.4", "properties": [ { "name": "OnOff", "value": { "propertyValue": true, "lastChangedAt": "2025-06-03T21:50:39.886Z" } } ] } ] } ] } ``` 如需詳細資訊，請參閱受管整合命令參考中的 [get-managed-thing-state](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing-state.html) 命令。 AWS CLI* * ## 步驟 8：從您的中樞移除受管物件移除受管物件以清除您的中樞。 **刪除受管物件** + 使用 [delete-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/delete-managed-thing.html) 命令移除受管物件。 **delete-managed-thing 範例** ``` aws iot-managed-integrations delete-managed-thing \ --identifier MANAGED_THING_ID ``` 如需詳細資訊，請參閱受管整合命令參考中的 [delete-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/delete-managed-thing.html) AWS CLI 命令。 ** **注意** 如果裝置卡在 `DELETE_IN_PROGRESS` 狀態，請將 `--force`旗標附加至 `delete-managed-thing`命令。 **注意** 對於 Z-wave 裝置，您需要在執行命令之後，讓裝置進入配對模式。