สคีมาลักษณะ FanSpeed สมาร์ทโฮม

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

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

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

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

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

รัฐ	ประเภท	คำอธิบาย
currentFanSpeedSetting	String	ค่านี้แสดงชื่อภายในของการตั้งค่าความเร็วปัจจุบันจากแอตทริบิวต์ availableFanSpeeds
currentFanSpeedPercent	Number	ระบุความเร็วพัดลมปัจจุบันตามเปอร์เซ็นต์ ต้องระบุหากตั้งค่าแอตทริบิวต์ supportsFanSpeedPercent เป็น true

ตัวอย่าง

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

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

คำสั่งของอุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE ได้ที่การดำเนินการตามคำสั่งซื้อใน 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: อุปกรณ์ตั้งค่าเป็นความเร็วต่ำสุดอยู่แล้ว