สคีมาของฟีเจอร์ FanHome FanSpeed Trait

action.devices.traits.FanSpeed - ลักษณะนี้เป็นของอุปกรณ์ที่รองรับการตั้งค่าความเร็วของพัดลม

ความเร็วพัดลม (เช่น การเป่าลมจากอุปกรณ์ในระดับต่างๆ ซึ่งอาจเป็นส่วนหนึ่งของเครื่องปรับอากาศหรือเครื่องทําความร้อน หรือในรถ) อาจรวมถึงการตั้งค่า เช่น ต่ํา ปานกลาง และสูงหรือเปอร์เซ็นต์

แอตทริบิวต์อุปกรณ์

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC ได้ที่การดําเนินการตามความตั้งใจ

แอตทริบิวต์	ประเภท	คำอธิบาย
reversible	บูลีน	(ค่าเริ่มต้น: false) หากตั้งค่าเป็น "จริง" อุปกรณ์นี้รองรับการเป่าพัดลมในทั้ง 2 ทิศทาง และสามารถยอมรับคําสั่งเพื่อย้อนกลับทิศทางของพัดลมได้
commandOnlyFanSpeed	บูลีน	(ค่าเริ่มต้น: false) ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบกลับ Intent ของ QUERY หรือสถานะรายงานสําหรับลักษณะนี้ไม่ได้
มีสิ่งใดสิ่งหนึ่งต่อไปนี้
0	วัตถุ	รองรับการตั้งค่าความเร็ว
availableFanSpeeds	วัตถุ	ต้องระบุ การตั้งค่าความเร็วที่อุปกรณ์รองรับ
speeds	อาร์เรย์	ต้องระบุ รายการการตั้งค่าความเร็ว
[item, ...]	วัตถุ	การตั้งค่าความเร็ว
speed_name	สตริง	ต้องระบุ ชื่อภายในของการตั้งค่าความเร็ว อาจไม่เป็นมิตรต่อผู้ใช้ และจะแชร์กับทุกภาษา
speed_values	อาร์เรย์	ต้องระบุ คําพ้องความหมายสําหรับการตั้งค่าความเร็วแต่ละภาษาที่รองรับ
[item, ...]	วัตถุ	คําพ้องความหมายสําหรับการตั้งค่าความเร็วในภาษาหนึ่งๆ
speed_synonym	อาร์เรย์	ต้องระบุ คําพ้องความหมายสําหรับการตั้งค่าความเร็วควรมีทั้งรูปเอกพจน์และพหูพจน์ (หากมี) คําพ้องความหมายแรกของรายการจะถือเป็นชื่อ Canonical ของการตั้งค่าความเร็ว
[item, ...]	สตริง	คําพ้องความหมาย
lang	สตริง	ต้องระบุ รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ
ordered	บูลีน	ต้องระบุ หากตั้งค่าเป็น "จริง" ระบบจะใช้ไวยากรณ์เพิ่มเติมเพื่อเพิ่มหรือลดตรรกะ ตามลําดับอาร์เรย์ความเร็ว (เพิ่มขึ้น)
1	วัตถุ	รองรับเปอร์เซ็นต์ความเร็ว
supportsFanSpeedPercent	บูลีน	ต้องระบุ (ค่าเริ่มต้น: false) หากตั้งค่าเป็น "จริง" อุปกรณ์นี้จะยอมรับคําสั่งให้ปรับความเร็วโดยใช้เปอร์เซ็นต์จาก 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	สตริง	ชื่อนี้จะแสดงชื่อภายในของการตั้งค่าความเร็วปัจจุบันจากแอตทริบิวต์ availableFanSpeeds
currentFanSpeedPercent	Number	ระบุความเร็วพัดลมปัจจุบันตามเปอร์เซ็นต์ ต้องระบุหากตั้งค่าแอตทริบิวต์ supportsFanSpeedPercent เป็น true

ตัวอย่าง

พัดลมในห้องนั่งเล่นมีความเร็วเท่าใด

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}