สคีมาฟีเจอร์เติมบ้านอัจฉริยะ
action.devices.traits.Fill
- ลักษณะเฉพาะนี้มีผลกับอุปกรณ์ที่รองรับการเติมอาหาร เช่น อ่างอาบน้ํา
แอตทริบิวต์อุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
ได้ที่การดําเนินการตามความตั้งใจ
แอตทริบิวต์ | ประเภท | คำอธิบาย |
---|---|---|
availableFillLevels |
วัตถุ |
อธิบายระดับการเติมอุปกรณ์ในแบบต่างๆ |
levels |
อาร์เรย์ |
ต้องระบุ รายชื่อระดับและคําพ้องความหมายเฉพาะภาษา |
[item, ...] |
วัตถุ |
ชื่อระดับและคําพ้องความหมายของภาษานั้นๆ |
level_name |
สตริง |
ต้องระบุ ชื่อภายในของระดับ อาจไม่เป็นมิตรต่อผู้ใช้ และจะแชร์กับทุกภาษา |
level_values |
อาร์เรย์ |
ต้องระบุ คําพ้องความหมายของระดับในภาษาที่รองรับแต่ละภาษา |
[item, ...] |
วัตถุ |
คําพ้องความหมายของระดับในภาษาหนึ่งๆ |
level_synonym |
อาร์เรย์ |
ต้องระบุ คําพ้องความหมายของระดับ ระบบจะใช้สตริงแรกในรายการนี้เป็นชื่อ Canonical ของระดับในภาษานั้น |
[item, ...] |
สตริง |
ชื่อคําพ้องความหมาย |
lang |
สตริง |
ต้องระบุ รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ |
ordered |
บูลีน |
ต้องระบุ หาก "จริง" อุปกรณ์จะจัดการไวยากรณ์เพิ่มเติมเพื่อเพิ่มหรือลดตรรกะตามที่แสดงในอาร์เรย์ |
supportsFillPercent |
บูลีน |
(ค่าเริ่มต้น: หากจริง ให้ยอมรับคําสั่งให้ปรับระดับเป็นเปอร์เซ็นต์ |
ตัวอย่าง
อุปกรณ์ที่มีความสามารถในการเติมหรือระบายสีพื้นฐาน ซึ่งไม่รองรับอัตราการส่งโฆษณา
{}
อุปกรณ์ที่รองรับระดับการเติมอย่างไม่ต่อเนื่อง
{ "availableFillLevels": { "levels": [ { "level_name": "half_level", "level_values": [ { "level_synonym": [ "Half", "Half way", "One half" ], "lang": "en" } ] }, { "level_name": "full_level", "level_values": [ { "level_synonym": [ "Full", "All the way", "Complete" ], "lang": "en" } ] } ], "ordered": true } }
สถานะอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
ได้ที่การดําเนินการตามความตั้งใจ
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
isFilled |
บูลีน |
ต้องระบุ เป็นจริงหากอุปกรณ์เติมเต็มระดับ เท็จ หากอุปกรณ์หมดเร็ว |
currentFillLevel |
สตริง |
ต้องระบุหากตั้งค่าแอตทริบิวต์ |
currentFillPercent |
Number |
ต้องระบุหากตั้งค่าแอตทริบิวต์ |
ตัวอย่าง
เติมอ่างอาบน้ําแล้วใช่ไหม
{ "isFilled": true }
เติมอ่างอาบน้ําแล้วใช่ไหม (ที่มีระดับ)
{ "isFilled": true, "currentFillLevel": "half_level" }
คําสั่งของอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดําเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE
ได้ที่การดําเนินการตามความตั้งใจ
action.devices.commands.Fill
เติมหรือระบายอุปกรณ์ให้เต็ม
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
fill |
บูลีน |
ต้องระบุ True tofill, false toเดรด |
fillLevel |
สตริง |
ระบุ |
fillPercent |
Number |
ระบุเปอร์เซ็นต์ระดับที่ขอ |
ตัวอย่าง
เติมอ่างอาบน้ํา
{ "command": "action.devices.commands.Fill", "params": { "fill": true } }
ปล่อยน้ําอ่างอาบน้ํา
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
เติมอ่างอาบน้ําครึ่งหนึ่ง
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "half_level" } }
เพิ่มอัตราการส่งโฆษณาของอ่างอาบน้ําขึ้น 1 ครั้ง (แอตทริบิวต์ ordered
ต้องเป็น true
)
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }