สคีมาคุณสมบัติของ FanSpeed สำหรับสมาร์ทโฮม

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

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

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

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

Attributes	ประเภท	คำอธิบาย
reversible	บูลีน	(ค่าเริ่มต้น: false) หากตั้งค่าเป็น "จริง" อุปกรณ์นี้รองรับการเป่าพัดลมทั้ง 2 ทิศทางและยอมรับคำสั่งเพื่อเปลี่ยนทิศทางของพัดลมได้
commandOnlyFanSpeed	บูลีน	(ค่าเริ่มต้น: false) ระบุว่าอุปกรณ์รองรับการสื่อสารแบบทางเดียว (จริง) หรือ 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	บูลีน	ต้องระบุ (ค่าเริ่มต้น: 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: ความเร็วอุปกรณ์นี้ตั้งเป็นระดับต่ำสุดอยู่แล้ว