สคีมาลักษณะของ Smart Home FanSpeed
action.devices.traits.FanSpeed
- ลักษณะนี้เป็นของอุปกรณ์ที่รองรับการตั้งค่าความเร็วของพัดลม
ATTRIBUTES ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเช่นนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC
ได้ที่Fulfillment Intent
Attributes | ประเภท | คำอธิบาย |
---|---|---|
reversible |
บูลีน |
(ค่าเริ่มต้น: หากตั้งค่าเป็น "จริง" อุปกรณ์นี้รองรับการเป่าพัดลมทั้ง 2 ทิศทาง และสามารถรับคำสั่งเพื่อกลับทิศทางของพัดลมได้ |
commandOnlyFanSpeed |
บูลีน |
(ค่าเริ่มต้น: ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ไม่สามารถตอบสนองต่อ Intent ของ QUERY หรือสถานะรายงานสำหรับลักษณะนี้ |
มีรายการดังต่อไปนี้ | ||
0
|
ออบเจ็กต์ |
รองรับการตั้งค่าความเร็ว |
availableFanSpeeds |
ออบเจ็กต์ |
ต้องระบุ การตั้งค่าความเร็วที่อุปกรณ์รองรับ |
speeds |
อาร์เรย์ |
ต้องระบุ รายการการตั้งค่าความเร็ว |
[item, ...] |
ออบเจ็กต์ |
การตั้งค่าความเร็ว |
speed_name |
String |
ต้องระบุ ชื่อภายในของการตั้งค่าความเร็ว ซึ่งอาจใช้งานได้ยากสำหรับผู้ใช้ และจะมีการแชร์ในทุกภาษา |
speed_values |
อาร์เรย์ |
ต้องระบุ คำพ้องความหมายของการตั้งค่าความเร็วในภาษาที่รองรับแต่ละภาษา |
[item, ...] |
ออบเจ็กต์ |
คำพ้องของการตั้งค่าความเร็วในภาษาที่กำหนด |
speed_synonym |
อาร์เรย์ |
ต้องระบุ คำพ้องความหมายของการตั้งค่าความเร็วควรมีทั้งรูปเอกพจน์และพหูพจน์ (หากมี) คำพ้องความหมายแรกในรายการจะถือเป็นชื่อ Canonical ของการตั้งค่าความเร็ว |
[item, ...] |
String |
คำพ้องความหมาย |
lang |
String |
ต้องระบุ รหัสภาษา (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
ได้ที่Fulfillment Intent
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
currentFanSpeedSetting |
String |
ค่านี้แสดงชื่อภายในของการตั้งค่าความเร็วปัจจุบันจากแอตทริบิวต์ |
currentFanSpeedPercent |
Number |
ระบุความเร็วพัดลมปัจจุบันเป็นเปอร์เซ็นต์ ต้องระบุหากตั้งค่าแอตทริบิวต์ |
ตัวอย่าง
พัดลมในห้องนั่งเล่นเร็วแค่ไหน
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
COMMANDS ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเช่นนี้อาจตอบสนองต่อคำสั่งต่อไปนี้โดยเป็นส่วนหนึ่งของการดำเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE
ได้ที่Fulfillment Intent
action.devices.commands.SetFanSpeed
ตั้งค่าความเร็ว
พารามิเตอร์
เพย์โหลดมีข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้
ตั้งค่าความเร็วตามการตั้งค่า
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
fanSpeed |
String |
ต้องระบุ การตั้งค่าความเร็วพัดลมที่ขอ |
ตั้งค่าความเร็วเป็นเปอร์เซ็นต์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
fanSpeedPercent |
Number |
ต้องระบุ เปอร์เซ็นต์การตั้งค่าความเร็วที่ขอ |
ตัวอย่าง
ปรับพัดลมไปที่ระดับสูง
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "speed_high" } }
ปรับพัดลมไปที่ 50%
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeedPercent": 50 } }
action.devices.commands.SetFanSpeedRelative
ตั้งค่าความเร็วสัมพัทธ์
คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้{ "commandOnlyFanSpeed": true }
พารามิเตอร์
เพย์โหลดมีข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้
ตั้งค่าความเร็วสัมพัทธ์ตามน้ำหนัก
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
fanSpeedRelativeWeight |
จำนวนเต็ม |
ต้องระบุ ค่านี้จะระบุปริมาณสัมพัทธ์ของการเปลี่ยนแปลงความเร็ว ค่าสัมบูรณ์จะระบุจำนวนที่ปรับขนาด ในขณะที่สัญลักษณ์ตัวเลขแสดงทิศทางของการเปลี่ยนแปลง |
ตั้งค่าความเร็วสัมพัทธ์เป็นเปอร์เซ็นต์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
fanSpeedRelativePercent |
Number |
ต้องระบุ ค่านี้แสดงเปอร์เซ็นต์ของความเร็วในการเปลี่ยนแปลง |
ตัวอย่าง
ลดความเร็วพัดลมเล็กน้อย
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativeWeight": -1 } }
เพิ่มความเร็วพัดลม 10 เปอร์เซ็นต์
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativePercent": 10 } }
action.devices.commands.Reverse
กลับทิศทางของพัดลม
คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้{ "reversible": true }
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
ไม่มีพร็อพเพอร์ตี้ |
ตัวอย่าง
กลับทิศทางพัดลม
{ "command": "action.devices.commands.Reverse", "params": {} }
ตัวอย่างการเปล่งเสียง
de-DE
- stell die Geschwindigkeit vom Ventilator auf hoch
en-US
- drop the AC fan speed to medium
es-ES
- cambia la velocidad del ventilador a medio
fr-FR
- mets la ventilation au maximum
hi-IN
- बेडरूम में पंखे की गति मीडियम करें
it-IT
- metti il condizionatore in salotto a velocità media
ja-JP
- エアコン の風量を 高速 にセット
ko-KR
- 선풍기 강풍 으로 틀어 줘
nl-NL
- zet de snelheid van de ventilator op medium
pt-BR
- definir a velocidade do ventilador para baixa
- põe a ventoinha no máximo
sv-SE
- Ställ in fläkten på medel
ข้อผิดพลาดเกี่ยวกับอุปกรณ์
ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมดmaxSpeedReached
: ความเร็วอุปกรณ์ตั้งเป็นระดับสูงสุดอยู่แล้วminSpeedReached
: ความเร็วอุปกรณ์ตั้งเป็นระดับต่ำสุดแล้ว