Hướng dẫn về quạt nhà thông minh
action.devices.types.FAN – Quạt thường có thể bật/tắt và cài đặt tốc độ. Một số quạt cũng có thể có các chế độ hỗ trợ bổ sung, chẳng hạn như hướng/hướng quạt (ví dụ: thiết bị treo tường có thể có các chế độ cài đặt để điều chỉnh mức độ hướng quạt lên hoặc xuống).
Loại này cho biết thiết bị nhận được biểu tượng Quạt và một số biểu tượng có liên quan 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.
Đặc điểm bắt buộc
Đây là những đặc điểm và lệnh bắt buộc, nếu phù hợp với
thiết bị. Nếu thiết bị của bạn không hỗ trợ những đặc điểm này, hãy nhập mã lỗi của
functionNotSupported trong phản hồi QUERY hoặc EXECUTE. Xem
Lỗi và ngoại lệ để biết thêm thông tin.
Yêu cầu về chất lượng
- Độ trễ: phải nhỏ hơn hoặc bằng 700 mili giây.
- Độ tin cậy: phải lớn hơn hoặc bằng 97%.
Thiết bị mẫu: Quạt đơn giản
Phần này chứa các tải trọng ý định mẫu đại diện cho một "Fan" 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
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.FAN",
"traits": [
"action.devices.traits.FanSpeed",
"action.devices.traits.OnOff"
],
"name": {
"name": "Simple fan"
},
"willReportState": true,
"attributes": {
"availableFanSpeeds": {
"speeds": [
{
"speed_name": "low_key",
"speed_values": [
{
"speed_synonym": [
"Low",
"Slow"
],
"lang": "en"
},
{
"speed_synonym": [
"Niedrig",
"Schleppend"
],
"lang": "de"
}
]
},
{
"speed_name": "high_key",
"speed_values": [
{
"speed_synonym": [
"High"
],
"lang": "en"
},
{
"speed_synonym": [
"Hoch"
],
"lang": "de"
}
]
}
],
"ordered": true
},
"reversible": true
},
"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,
"on": true,
"currentFanSpeedSetting": "low_key"
}
}
}
}
Lệnh EXECUTE mẫu
SetFanSpeed
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.FanSpeed
tham chiếu.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetFanSpeed",
"params": {
"fanSpeed": "high_key"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentFanSpeedSetting": "high_key"
}
}
]
}
}
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.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}