สคีมาของฟีเจอร์เติมบ้านอัจฉริยะ

action.devices.traits.Fill - ลักษณะนี้มีผลกับอุปกรณ์ที่รองรับการเติม เช่น อ่างอาบน้ํา

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

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

แอตทริบิวต์	Type	คำอธิบาย
availableFillLevels	ออบเจ็กต์	อธิบายอุปกรณ์แต่ละระดับ
levels	อาร์เรย์	ต้องระบุ รายการของชื่อระดับและคําพ้องความหมายเฉพาะภาษา
[item, ...]	ออบเจ็กต์	ชื่อระดับและคําพ้องความหมายเฉพาะภาษา
level_name	สตริง	ต้องระบุ ชื่อภายในของระดับ ปัญหานี้อาจไม่เป็นมิตรกับผู้ใช้ และจะแชร์กับทุกภาษา
level_values	อาร์เรย์	ต้องระบุ คําพ้องความหมายของระดับในภาษาที่รองรับแต่ละภาษา
[item, ...]	ออบเจ็กต์	คําพ้องความหมายของระดับในภาษาหนึ่งๆ
level_synonym	อาร์เรย์	ต้องระบุ คําพ้องความหมายของระดับ สตริงแรกในรายการนี้จะใช้เป็นชื่อตามรูปแบบบัญญัติของระดับในภาษานั้น
[item, ...]	สตริง	ชื่อคําพ้องความหมาย
lang	สตริง	ต้องระบุ รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ
ordered	บูลีน	ต้องระบุ หาก "จริง" อุปกรณ์จะจัดการไวยากรณ์เพิ่มเติมเพื่อเพิ่มหรือลดตรรกะ ดังที่แสดงด้วยอาร์เรย์ levels (เช่น ครึ่งหนึ่ง)
supportsFillPercent	บูลีน	(ค่าเริ่มต้น: false) หากเป็น "จริง" ให้ยอมรับคําสั่งสําหรับปรับระดับเป็นเปอร์เซ็นต์

ตัวอย่าง

อุปกรณ์ที่มีความสามารถในการเติมหรือระบายพื้นฐานในระดับที่ไม่รองรับ

{}

อุปกรณ์ที่รองรับระดับการเติมที่ไม่ต่อเนื่อง

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

อุปกรณ์ STATES

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

รัฐ	Type	คำอธิบาย
isFilled	บูลีน	ต้องระบุ จริงหากเติมอุปกรณ์ทุกระดับ เท็จ หากระบายอุปกรณ์จนสนิท
currentFillLevel	สตริง	ต้องระบุหากมีการตั้งค่าแอตทริบิวต์ availableFillLevels ระบุ level_name ปัจจุบันจากแอตทริบิวต์ availableFillLevels ที่มีการเติมค่าอุปกรณ์
currentFillPercent	Number	ต้องระบุหากมีการตั้งค่าแอตทริบิวต์ supportsFillPercent ระบุเปอร์เซ็นต์อัตราการส่งโฆษณาปัจจุบัน

ตัวอย่าง

อ่างอาบน้ํามีน้ําอยู่แล้วใช่ไหม

{
  "isFilled": true
}

อ่างอาบน้ํามีอ่างอาบน้ําหรือเปล่า (พร้อมระดับ)

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

อุปกรณ์ COMMANDS

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

action.devices.commands.Fill

เติมหรือระบายอุปกรณ์จนเสร็จ

พารามิเตอร์

พารามิเตอร์	Type	คำอธิบาย
fill	บูลีน	ต้องระบุ True ไว้เติม False เพื่อระบาย
fillLevel	สตริง	ระบุ level_name จากแอตทริบิวต์ availableFillLevels เพื่อตั้งค่า หากไม่ได้ระบุ ให้กรอกระดับเริ่มต้น
fillPercent	Number	ระบุเปอร์เซ็นต์ระดับที่ขอ

ตัวอย่าง

เติมอ่างอาบน้ํา

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

ปล่อยอ่างอาบน้ํา

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

เติมอ่างอาบน้ําครึ่งหนึ่ง

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

เพิ่มระดับการเติมอ่างอาบน้ําทีละ 1 ระดับ (ต้องมีแอตทริบิวต์ ordered เป็น true)

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

อุปกรณ์ ERRORS

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