คู่มือเกี่ยวกับก๊อกน้ำสมาร์ทโฮม

action.devices.types.FAUCET - faucets สามารถจ่ายของเหลวในปริมาณและค่าที่กำหนดล่วงหน้าได้ ฟักอาจมีหลายโหมดและแต่ละโหมดมีการตั้งค่าที่เกี่ยวข้องของตัวเอง ซึ่งจะเจาะจงสำหรับแต่ละ Faucet และมีการตีความในรูปแบบทั่วไป

ประเภทนี้บ่งชี้ว่าอุปกรณ์ได้รับไอคอน Faucet และคำพ้องความหมายและคำแทนที่เกี่ยวข้อง

ความสามารถของอุปกรณ์

โปรดดูรายละเอียดการใช้งานในเอกสารประกอบของลักษณะที่เกี่ยวข้อง เช่น แอตทริบิวต์และสถานะที่บริการควรรองรับ และวิธีสร้างการตอบกลับ EXECUTE และ QUERY

เราขอแนะนำให้ใช้ลักษณะเหล่านี้หากอุปกรณ์ของคุณมี อย่างไรก็ตาม คุณผสมและจับคู่จากลักษณะทั้งหมดที่มีอยู่เพื่อให้ตรงกับฟังก์ชันการทำงานของผลิตภัณฑ์ที่มีอยู่มากที่สุดได้

ข้อกำหนดด้านคุณภาพ

  • เวลาในการตอบสนอง: ต้องน้อยกว่าหรือเท่ากับ 800 มิลลิวินาที
  • ความน่าเชื่อถือ: ต้องมากกว่าหรือเท่ากับ 97%

ตัวอย่างอุปกรณ์: faucet แบบธรรมดา

ส่วนนี้มีตัวอย่างเพย์โหลด Intent ที่แสดง "Faucet" ทั่วไปตามประเภทอุปกรณ์และลักษณะข้างต้น หากคุณเพิ่มหรือนําลักษณะในการนําไปใช้ออก ให้แก้ไขคําตอบให้สอดคล้องกับการเปลี่ยนแปลงเหล่านั้น

ตัวอย่างการตอบกลับ SYNC

คำขอ
{   "requestId": "6894439706274654512",   "inputs": [     {       "intent": "action.devices.SYNC"     }   ] }
การตอบกลับ
{   "requestId": "6894439706274654512",   "payload": {     "agentUserId": "user123",     "devices": [       {         "id": "123",         "type": "action.devices.types.FAUCET",         "traits": [           "action.devices.traits.Dispense",           "action.devices.traits.TemperatureControl",           "action.devices.traits.OnOff"         ],         "name": {           "name": "Simple faucet"         },         "willReportState": true,         "attributes": {           "supportedDispenseItems": [             {               "item_name": "water_key",               "item_name_synonyms": [                 {                   "lang": "en",                   "synonyms": [                     "Water"                   ]                 },                 {                   "lang": "es",                   "synonyms": [                     "Agua"                   ]                 },                 {                   "lang": "fr",                   "synonyms": [                     "Eau"                   ]                 }               ],               "supported_units": [                 "TEASPOONS",                 "TABLESPOONS",                 "FLUID_OUNCES",                 "CUPS",                 "PINTS",                 "QUARTS",                 "GALLONS",                 "MILLILITERS",                 "LITERS",                 "DECILITERS"               ],               "default_portion": {                 "amount": 2,                 "unit": "CUPS"               }             }           ],           "supportedDispensePresets": [             {               "preset_name": "cat_water_bowl_key",               "preset_name_synonyms": [                 {                   "lang": "en",                   "synonyms": [                     "Cat water bowl",                     "Cat water dish",                     "Cat water cup"                   ]                 },                 {                   "lang": "es",                   "synonyms": [                     "Plato de agua para gato",                     "Bebedero para gato"                   ]                 },                 {                   "lang": "fr",                   "synonyms": [                     "Bol d'eau de chat",                     "Bac \u00e0 eau pour chat",                     "Tasse d'eau de chat"                   ]                 }               ]             }           ],           "temperatureRange": {             "minThresholdCelsius": 25,             "maxThresholdCelsius": 100           },           "temperatureUnitForUX": "F"         },         "deviceInfo": {           "manufacturer": "smart-home-inc",           "model": "hs1234",           "hwVersion": "3.2",           "swVersion": "11.4"         }       }     ]   } }

ตัวอย่างการตอบกลับ QUERY

คำขอ
{   "requestId": "6894439706274654514",   "inputs": [     {       "intent": "action.devices.QUERY",       "payload": {         "devices": [           {             "id": "123"           }         ]       }     }   ] }
การตอบกลับ
{   "requestId": "6894439706274654514",   "payload": {     "devices": {       "123": {         "status": "SUCCESS",         "online": true,         "on": false,         "temperatureSetpointCelsius": 30,         "dispenseItems": [           {             "itemName": "water_key",             "amountLastDispensed": {               "amount": 2.5,               "unit": "CUPS"             },             "isCurrentlyDispensing": false           }         ]       }     }   } }

ตัวอย่างคำสั่ง EXECUTE

จ่าย

ดูรายละเอียดเพิ่มเติมเกี่ยวกับพารามิเตอร์คําสั่งได้ที่ข้อมูลอ้างอิง action.devices.traits.Dispense

คำขอ
{   "requestId": "6894439706274654516",   "inputs": [     {       "intent": "action.devices.EXECUTE",       "payload": {         "commands": [           {             "devices": [               {                 "id": "123"               }             ],             "execution": [               {                 "command": "action.devices.commands.Dispense",                 "params": {                   "amount": 1,                   "unit": "CUPS",                   "item": "water_key"                 }               }             ]           }         ]       }     }   ] }
การตอบกลับ
{   "requestId": "6894439706274654516",   "payload": {     "commands": [       {         "ids": [           "123"         ],         "status": "SUCCESS",         "states": {           "online": true,           "dispenseItems": [             {               "itemName": "water_key",               "amountLastDispensed": {                 "amount": 1,                 "unit": "CUPS"               },               "isCurrentlyDispensing": true             }           ]         }       }     ]   } }

SetTemperature

ดูรายละเอียดเพิ่มเติมเกี่ยวกับพารามิเตอร์คําสั่งได้ที่ข้อมูลอ้างอิง action.devices.traits.TemperatureControl

คำขอ
{   "requestId": "6894439706274654518",   "inputs": [     {       "intent": "action.devices.EXECUTE",       "payload": {         "commands": [           {             "devices": [               {                 "id": "123"               }             ],             "execution": [               {                 "command": "action.devices.commands.SetTemperature",                 "params": {                   "temperature": 65                 }               }             ]           }         ]       }     }   ] }
การตอบกลับ
{   "requestId": "6894439706274654518",   "payload": {     "commands": [       {         "ids": [           "123"         ],         "status": "SUCCESS",         "states": {           "online": true,           "temperatureSetpointCelsius": 65         }       }     ]   } }

OnOff

ดูรายละเอียดเพิ่มเติมเกี่ยวกับพารามิเตอร์คําสั่งได้ที่ข้อมูลอ้างอิง action.devices.traits.OnOff

คำขอ
{   "requestId": "6894439706274654520",   "inputs": [     {       "intent": "action.devices.EXECUTE",       "payload": {         "commands": [           {             "devices": [               {                 "id": "123"               }             ],             "execution": [               {                 "command": "action.devices.commands.OnOff",                 "params": {                   "on": true                 }               }             ]           }         ]       }     }   ] }
การตอบกลับ
{   "requestId": "6894439706274654520",   "payload": {     "commands": [       {         "ids": [           "123"         ],         "status": "SUCCESS",         "states": {           "online": true,           "on": true         }       }     ]   } }

ข้อผิดพลาดของอุปกรณ์

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด