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

action.devices.traits.HumiditySetting - แอตทริบิวต์นี้ใช้กับอุปกรณ์ที่รองรับการตั้งค่าความชื้น เช่น เครื่องทำความชื้นและเครื่องลดความชื้น

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

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

Attributes ประเภท คำอธิบาย
humiditySetpointRange ออบเจ็กต์

มีระดับความชื้นต่ำสุดและสูงสุดเป็นเปอร์เซ็นต์

minPercent จำนวนเต็ม

(ค่าเริ่มต้น: 0)

แสดงระดับความชื้นขั้นต่ำเป็นเปอร์เซ็นต์

maxPercent จำนวนเต็ม

(ค่าเริ่มต้น: 100)

แสดงระดับความชื้นสูงสุดเป็นเปอร์เซ็นต์

commandOnlyHumiditySetting บูลีน

(ค่าเริ่มต้น: false)

ระบุว่าอุปกรณ์รองรับการสื่อสารแบบ 1 ทิศทาง (จริง) หรือ 2 ทิศทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบสนองต่อ Intent ของ QUERY หรือสถานะรายงานสำหรับลักษณะนี้ไม่ได้

queryOnlyHumiditySetting บูลีน

(ค่าเริ่มต้น: false)

ต้องระบุหากอุปกรณ์รองรับการดำเนินการแบบค้นหาเท่านั้น แอตทริบิวต์นี้ระบุว่าอุปกรณ์สามารถค้นหาข้อมูลสถานะได้เท่านั้นและไม่สามารถควบคุมได้

ตัวอย่าง

อุปกรณ์ที่รองรับช่วงความชื้นเริ่มต้น

{}

อุปกรณ์ที่รองรับช่วงความชื้นที่กำหนดเอง

{
  "humiditySetpointRange": {
    "minPercent": 25,
    "maxPercent": 75
  }
}

สถานะอุปกรณ์

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

รัฐ ประเภท คำอธิบาย
humiditySetpointPercent จำนวนเต็ม

ระบุเปอร์เซ็นต์ความชื้นเป้าหมายปัจจุบันของอุปกรณ์ ต้องอยู่ภายใน humiditySetpointRange

humidityAmbientPercent จำนวนเต็ม

แสดงค่าความชื้นสัมพัทธ์ปัจจุบันของอุปกรณ์เป็นเปอร์เซ็นต์

ตัวอย่าง

อุปกรณ์แสดงความชื้นเท่าไร

{
  "humiditySetpointPercent": 20,
  "humidityAmbientPercent": 15
}

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

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

action.devices.commands.SetHumidity

ตั้งค่าระดับความชื้นเป็นค่าสัมบูรณ์

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
humidity จำนวนเต็ม

ต้องระบุ

เปอร์เซ็นต์ความชื้นที่กำหนด ต้องอยู่ในช่วง humiditySetpointRange

ตัวอย่าง

ตั้งค่าความชื้นเป็น 20 เปอร์เซ็นต์

{
  "command": "action.devices.commands.SetHumidity",
  "params": {
    "humidity": 20
  }
}

เกิดข้อผิดพลาดขณะตั้งค่าความชื้นเป้าหมาย

ค่าที่รองรับ

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

ปรับระดับความชื้นตามค่าปัจจุบัน

คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "commandOnlyHumiditySetting": true
}

พารามิเตอร์

เพย์โหลดมีข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้

ตั้งค่าเปอร์เซ็นต์ความชื้น

พารามิเตอร์ ประเภท คำอธิบาย
humidityRelativePercent จำนวนเต็ม

ต้องระบุ

ค่าเปอร์เซ็นต์สำหรับปรับระดับความชื้น

ตั้งค่าน้ำหนักความชื้น

พารามิเตอร์ ประเภท คำอธิบาย
humidityRelativeWeight จำนวนเต็ม

ต้องระบุ

บ่งชี้ปริมาณการเปลี่ยนแปลงของความชื้นที่ไม่ชัดเจนจากน้อย ("เล็กน้อย") เป็นมาก ("มาก")

ตัวอย่าง

เพิ่มความชื้น 10 เปอร์เซ็นต์

{
  "command": "action.devices.commands.HumidityRelative",
  "params": {
    "humidityRelativePercent": 10
  }
}

ลดความชื้นลงอย่างมาก

{
  "command": "action.devices.commands.HumidityRelative",
  "params": {
    "humidityRelativeWeight": -5
  }
}

เกิดข้อผิดพลาดขณะปรับความชื้น

ค่าที่รองรับ

maxSettingReached
minSettingReached
valueOutOfRange

ตัวอย่างคำพูด

de-DE

  • Welche Luftfeuchtigkeit zeigt das Thermostat an?

en-US

  • what is the humidity upstairs

es-ES

  • cuánta humedad hay ahora en la cocina

fr-FR

  • le thermostat donne quel taux d'humidité

hi-IN

  • ह्यूमिडिटी का स्तर किचन के थर्मोस्टैट से कितना है?

it-IT

  • quanta umidità segna il termostato

ja-JP

  • サーモスタット にどれくらいの湿度ってでてる

ko-KR

  • 온도 조절계 에 습도 몇이야?

nl-NL

  • wat is de vochtigheid op de thermostaat

pt-BR

  • Qual é o nível de humidade mostrado no termostato ?
  • diga qual é a umidade relativa do ar mostrada no termostato

sv-SE

  • Vad är det för luftfuktighet i badrummet ?

ข้อผิดพลาดของอุปกรณ์

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด