สคีมาของฟีเจอร์ FanHome FanSpeed Trait
action.devices.traits.FanSpeed
- ลักษณะนี้เป็นของอุปกรณ์ที่รองรับการตั้งค่าความเร็วของพัดลม
แอตทริบิวต์อุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
ได้ที่การดําเนินการตามความตั้งใจ
แอตทริบิวต์ | ประเภท | คำอธิบาย |
---|---|---|
reversible |
บูลีน |
(ค่าเริ่มต้น: หากตั้งค่าเป็น "จริง" อุปกรณ์นี้รองรับการเป่าพัดลมในทั้ง 2 ทิศทาง และสามารถยอมรับคําสั่งเพื่อย้อนกลับทิศทางของพัดลมได้ |
commandOnlyFanSpeed |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบกลับ Intent ของ QUERY หรือสถานะรายงานสําหรับลักษณะนี้ไม่ได้ |
มีสิ่งใดสิ่งหนึ่งต่อไปนี้ | ||
0
|
วัตถุ |
รองรับการตั้งค่าความเร็ว |
availableFanSpeeds |
วัตถุ |
ต้องระบุ การตั้งค่าความเร็วที่อุปกรณ์รองรับ |
speeds |
อาร์เรย์ |
ต้องระบุ รายการการตั้งค่าความเร็ว |
[item, ...] |
วัตถุ |
การตั้งค่าความเร็ว |
speed_name |
สตริง |
ต้องระบุ ชื่อภายในของการตั้งค่าความเร็ว อาจไม่เป็นมิตรต่อผู้ใช้ และจะแชร์กับทุกภาษา |
speed_values |
อาร์เรย์ |
ต้องระบุ คําพ้องความหมายสําหรับการตั้งค่าความเร็วแต่ละภาษาที่รองรับ |
[item, ...] |
วัตถุ |
คําพ้องความหมายสําหรับการตั้งค่าความเร็วในภาษาหนึ่งๆ |
speed_synonym |
อาร์เรย์ |
ต้องระบุ คําพ้องความหมายสําหรับการตั้งค่าความเร็วควรมีทั้งรูปเอกพจน์และพหูพจน์ (หากมี) คําพ้องความหมายแรกของรายการจะถือเป็นชื่อ Canonical ของการตั้งค่าความเร็ว |
[item, ...] |
สตริง |
คําพ้องความหมาย |
lang |
สตริง |
ต้องระบุ รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ |
ordered |
บูลีน |
ต้องระบุ หากตั้งค่าเป็น "จริง" ระบบจะใช้ไวยากรณ์เพิ่มเติมเพื่อเพิ่มหรือลดตรรกะ ตามลําดับอาร์เรย์ความเร็ว (เพิ่มขึ้น) |
1
|
วัตถุ |
รองรับเปอร์เซ็นต์ความเร็ว |
supportsFanSpeedPercent |
บูลีน |
ต้องระบุ (ค่าเริ่มต้น: หากตั้งค่าเป็น "จริง" อุปกรณ์นี้จะยอมรับคําสั่งให้ปรับความเร็วโดยใช้เปอร์เซ็นต์จาก 0.0 ถึง 100.0 |
ตัวอย่าง
อุปกรณ์ที่มีการตั้งค่าความเร็ว 2 ระดับ รองรับการปรับทิศทางแบบย้อนกลับและเปอร์เซ็นต์
{ "availableFanSpeeds": { "speeds": [ { "speed_name": "speed_low", "speed_values": [ { "speed_synonym": [ "Low", "Slow" ], "lang": "en" } ] }, { "speed_name": "speed_high", "speed_values": [ { "speed_synonym": [ "High", "Fast" ], "lang": "en" } ] } ], "ordered": true }, "reversible": true, "supportsFanSpeedPercent": true }
สถานะอุปกรณ์
เอนทิตีที่มีลักษณะเฉพาะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
ได้ที่การดําเนินการตามความตั้งใจ
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
currentFanSpeedSetting |
สตริง |
ชื่อนี้จะแสดงชื่อภายในของการตั้งค่าความเร็วปัจจุบันจากแอตทริบิวต์ |
currentFanSpeedPercent |
Number |
ระบุความเร็วพัดลมปัจจุบันตามเปอร์เซ็นต์ ต้องระบุหากตั้งค่าแอตทริบิวต์ |
ตัวอย่าง
พัดลมในห้องนั่งเล่นมีความเร็วเท่าใด
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }