Hướng dẫn sử dụng khăn cho nhà thông minh

action.devices.types.BLANKET – Các hoạt động tương tác với chăn thông minh có thể bao gồm bật và tắt, điều chỉnh nhiệt độ và/hoặc đặt nhiều chế độ và công tắc bật/tắt.

Loại này cho biết thiết bị nhận được biểu tượng Blanket và một số từ đồng nghĩa và bí danh.

Khả năng của thiết bị

Tham khảo tài liệu về đặc điểm tương ứng cho thông tin chi tiết về việc 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 các phản hồi EXECUTE và QUERY.

Bạn nên dùng những đặ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ể thoải mái kết hợp tất cả các đặc điểm có sẵn để phù hợp nhất với hiện tại của mình chức năng của sản phẩm.

Yêu cầu về chất lượng

  • Độ trễ: phải nhỏ hơn hoặc bằng 2500 mili giây.
  • Độ tin cậy: phải lớn hơn hoặc bằng 97%.

Thiết bị ví dụ: Chăn

Phần này chứa các tải trọng ý định mẫu đại diện cho một "Khoảng không quảng cáo" chung dựa trên loại thiết bị và đặc điểm nêu trên. Nếu bạn thêm hoặc xoá các đặc điểm trong quá trình triển khai, sửa đổi câu trả lời của bạn sao cho phù hợp để phản ánh những thay đổi đó.

Phản hồi SYNC mẫu

Yêu cầu
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Phản hồi
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.BLANKET",
        "traits": [
          "action.devices.traits.OnOff",
          "action.devices.traits.Modes",
          "action.devices.traits.Toggles"
        ],
        "name": {
          "name": "Blanket"
        },
        "willReportState": true,
        "attributes": {
          "availableModes": [
            {
              "name": "temp_mode",
              "name_values": [
                {
                  "name_synonym": [
                    "Temperature",
                    "Temp"
                  ],
                  "lang": "en"
                }
              ],
              "settings": [
                {
                  "setting_name": "hot_temp",
                  "setting_values": [
                    {
                      "setting_synonym": [
                        "Hot"
                      ],
                      "lang": "en"
                    }
                  ]
                },
                {
                  "setting_name": "warm_temp",
                  "setting_values": [
                    {
                      "setting_synonym": [
                        "Warm"
                      ],
                      "lang": "en"
                    }
                  ]
                }
              ]
            }
          ],
          "availableToggles": [
            {
              "name": "auto_off",
              "name_values": [
                {
                  "name_synonym": [
                    "Auto off"
                  ],
                  "lang": "en"
                }
              ]
            }
          ]
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

Phản hồi QUERY mẫu

Yêu cầu
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
Phản hồi
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "on": true,
        "currentModeSettings": {
          "temp_mode": "warm_temp"
        },
        "currentToggleSettings": {
          "auto_off": true
        }
      }
    }
  }
}

Lệnh EXECUTE mẫu

OnOff

Để biết thêm thông tin chi tiết về các tham số lệnh, hãy xem action.devices.traits.OnOff tham chiếu.

Yêu cầu
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OnOff",
                "params": {
                  "on": true
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Phản hồi
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "on": true
        }
      }
    ]
  }
}

SetModes

Để biết thêm thông tin chi tiết về các tham số lệnh, hãy xem action.devices.traits.Modes tham chiếu.

Yêu cầu
{
  "requestId": "6894439706274654518",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetModes",
                "params": {
                  "updateModeSettings": {
                    "temp_mode": "hot_temp"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Phản hồi
{
  "requestId": "6894439706274654518",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "currentModeSettings": {
            "temp_mode": "hot_temp"
          }
        }
      }
    ]
  }
}

SetToggles

Để biết thêm thông tin chi tiết về các tham số lệnh, hãy xem action.devices.traits.Toggles tham chiếu.

Yêu cầu
{
  "requestId": "6894439706274654520",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetToggles",
                "params": {
                  "updateToggleSettings": {
                    "auto_off": false
                  }
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Phản hồi
{
  "requestId": "6894439706274654520",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "currentToggleSettings": {
            "auto_off": false
          }
        }
      }
    ]
  }
}

Thiết bị ERRORS

Xem toàn bộ danh sách lỗi và ngoại lệ.