Hướng dẫn về nồi áp suất thông minh dành cho nhà thông minh
action.devices.types.PRESSURECOOKER – Các hoạt động tương tác với nồi áp suất có thể bao gồm khởi động và dừng, hẹn giờ, điều chỉnh chế độ nấu hoặc giá trị đặt trước thức ăn, hoặc điều chỉnh các chế độ cài đặt khác.
Loại này cho biết thiết bị nhận được biểu tượng Nồi áp suất và một số biểu tượng 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.
Đặc điểm được đề xuất
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 800 mili giây.
- Độ tin cậy: phải lớn hơn hoặc bằng 97%.
Thiết bị ví dụ: Nồi áp suất đơn giản
Phần này nêu các tải trọng ý định mẫu đại diện cho một "Nồi áp suất" thông thường 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.PRESSURECOOKER",
"traits": [
"action.devices.traits.Cook",
"action.devices.traits.OnOff",
"action.devices.traits.Timer",
"action.devices.traits.StartStop"
],
"name": {
"name": "Simple pressure cooker"
},
"willReportState": true,
"attributes": {
"supportedCookingModes": [
"PRESSURE_COOK"
],
"foodPresets": [
{
"food_preset_name": "roast_key",
"supported_units": [
"POUNDS",
"OUNCES"
],
"food_synonyms": [
{
"synonym": [
"Roast",
"Chuck roast"
],
"lang": "en"
}
]
},
{
"food_preset_name": "ribs_key",
"supported_units": [
"POUNDS",
"OUNCES"
],
"food_synonyms": [
{
"synonym": [
"Ribs",
"Rack of ribs"
],
"lang": "en"
}
]
}
],
"maxTimerLimitSec": 1200,
"pausable": 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,
"isRunning": true,
"isPaused": false,
"timerRemainingSec": 600,
"currentCookingMode": "PRESSURE_COOK",
"currentFoodPreset": "roast_key"
}
}
}
}
Lệnh EXECUTE mẫu
Nấu ăn
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.Cook
tham chiếu.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.Cook",
"params": {
"start": false,
"cookingMode": "PRESSURE_COOK"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentCookingMode": "NONE",
"currentFoodPreset": "NONE"
}
}
]
}
}
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": "6894439706274654532",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654532",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}
TimerStart
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.Timer
tham chiếu.
{
"requestId": "6894439706274654522",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerStart",
"params": {
"timerTimeSec": 600
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654522",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 600
}
}
]
}
}
TimerAdjust
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.Timer
tham chiếu.
{
"requestId": "6894439706274654524",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerAdjust",
"params": {
"timerTimeSec": -10
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654524",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 590
}
}
]
}
}
TimerPause
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.Timer
tham chiếu.
{
"requestId": "6894439706274654526",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerPause"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654526",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 600,
"timerPaused": true
}
}
]
}
}
TimerResume
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.Timer
tham chiếu.
{
"requestId": "6894439706274654528",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerResume"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654528",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 600,
"timerPaused": false
}
}
]
}
}
TimerCancel
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.Timer
tham chiếu.
{
"requestId": "6894439706274654530",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.TimerCancel"
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654530",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": -1
}
}
]
}
}
StartStop
Để biết thêm thông tin chi tiết về các tham số lệnh,
hãy xem
action.devices.traits.StartStop
tham chiếu.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.StartStop",
"params": {
"start": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"isRunning": true,
"isPaused": false
}
}
]
}
}