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

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

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

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

แอตทริบิวต์	ประเภท	คำอธิบาย
availableFillLevels	วัตถุ	อธิบายระดับการเติมอุปกรณ์ในแบบต่างๆ
levels	อาร์เรย์	ต้องระบุ รายชื่อระดับและคําพ้องความหมายเฉพาะภาษา
[item, ...]	วัตถุ	ชื่อระดับและคําพ้องความหมายของภาษานั้นๆ
level_name	สตริง	ต้องระบุ ชื่อภายในของระดับ อาจไม่เป็นมิตรต่อผู้ใช้ และจะแชร์กับทุกภาษา
level_values	อาร์เรย์	ต้องระบุ คําพ้องความหมายของระดับในภาษาที่รองรับแต่ละภาษา
[item, ...]	วัตถุ	คําพ้องความหมายของระดับในภาษาหนึ่งๆ
level_synonym	อาร์เรย์	ต้องระบุ คําพ้องความหมายของระดับ ระบบจะใช้สตริงแรกในรายการนี้เป็นชื่อ Canonical ของระดับในภาษานั้น
[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
  }
}

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

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

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

ตัวอย่าง

เติมอ่างอาบน้ําแล้วใช่ไหม

{
  "isFilled": true
}

เติมอ่างอาบน้ําแล้วใช่ไหม (ที่มีระดับ)

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

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

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

action.devices.commands.Fill

เติมหรือระบายอุปกรณ์ให้เต็ม

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
fill	บูลีน	ต้องระบุ True tofill, false toเดรด
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

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