Hướng dẫn về mạng nhà thông minh
action.devices.types.NETWORK
– Đại diện cho một nhóm các nút bộ định tuyến hoặc mạng lưới được kiểm soát dưới dạng một thực thể thay vì các thiết bị riêng lẻ. Thiết bị mạng có thể khởi động lại, cập nhật phần mềm và có các chế độ để xử lý các chế độ kiểm soát Chất lượng dịch vụ (QoS) cũng như các hạn chế của cha mẹ.
Thiết bị có thể thực hiện các thao tác như bật mạng khách và báo cáo thông tin cụ thể theo mạng, chẳng hạn như tốc độ thông lượng Internet hiện tại.
Loại này cho biết thiết bị sẽ nhận được biểu tượng Mạng cũng như một số từ đồng nghĩa và bí danh có liên quan.
Dung lượng của thiết bị
Tham khảo tài liệu về đặc điểm tương ứng để biết thông tin chi tiết về cách triển khai, chẳng hạn như các thuộc tính và trạng thái mà dịch vụ của bạn sẽ hỗ trợ, cũng như cách tạo phản hồi EXECUTE và QUERY.
Trait bắt buộc
Các đặc điểm và lệnh này là bắt buộc nếu phù hợp với thiết bị của bạn. Nếu thiết bị của bạn không hỗ trợ các đặc điểm này, hãy nhập mã lỗi functionNotSupported
vào phản hồi QUERY hoặc EXECUTE. Hãy xem phần Lỗi và ngoại lệ để biết thêm thông tin.
Trait được đề xuất
Bạn nên dùng các đặc điểm này (nếu phù hợp với thiết bị của mình). Tuy nhiên, bạn có thể kết hợp tất cả các đặc điểm có sẵn để đáp ứng tốt nhất chức năng sản phẩm hiện có.
Yêu cầu về chất lượng
- Độ trễ: phải nhỏ hơn hoặc bằng 300 mili giây.
- Độ tin cậy: phải lớn hơn hoặc bằng 97%.
Thiết bị ví dụ: Mạng đơn giản
Phần này trình bày các gói dữ liệu ý định mẫu đại diện cho một "Mạng" chung dựa trên loại thiết bị và đặc điểm ở trên. Nếu bạn thêm hoặc xoá đặc điểm trong quá trình triển khai, hãy sửa đổi các phản hồi của bạn cho phù hợp để phản ánh những thay đổi đó.
Phản hồi SYNC mẫu
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.NETWORK", "traits": [ "action.devices.traits.Reboot", "action.devices.traits.NetworkControl" ], "name": { "name": "Simple network" }, "willReportState": true, "attributes": { "supportsEnablingNetworkProfile": true, "supportsDisablingNetworkProfile": true, "supportsNetworkDownloadSpeedTest": true, "supportsNetworkUploadSpeedTest": true, "networkProfiles": [ "kids" ] }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Phản hồi QUERY mẫu
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" } } } } }
Lệnh EXECUTE mẫu
Khởi động lại
Để biết thêm thông tin chi tiết về các tham số lệnh, vui lòng xem tài liệu tham khảo
action.devices.traits.Reboot
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Reboot" } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true } } ] } }
EnableDisableNetworkProfile
Để biết thêm thông tin chi tiết về các tham số lệnh, vui lòng xem tài liệu tham khảo
action.devices.traits.NetworkControl
.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.EnableDisableNetworkProfile", "params": { "profile": "kids", "enable": false } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "networkEnabled": true, "networkSettings": { "ssid": "home-network-123" } } } ] } }
TestNetworkSpeed
Để biết thêm thông tin chi tiết về các tham số lệnh, vui lòng xem tài liệu tham khảo
action.devices.traits.NetworkControl
.
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TestNetworkSpeed", "params": { "testDownloadSpeed": true, "testUploadSpeed": true, "followUpToken": "123" } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true } } ] } }