สคีมาลักษณะการทำงานของ Smart Home EnergyStorage

action.devices.traits.EnergyStorage - ลักษณะการทำงานนี้เป็นของอุปกรณ์ที่สามารถเก็บพลังงานไว้ในแบตเตอรี่และอาจชาร์จใหม่ได้ หรืออุปกรณ์ที่สามารถชาร์จอุปกรณ์อื่นได้

ATTRIBUTES ของอุปกรณ์

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

Attributes ประเภท คำอธิบาย
queryOnlyEnergyStorage บูลีน

ต้องระบุ

เป็น "จริง" หากอุปกรณ์นี้รองรับเฉพาะการค้นหาเกี่ยวกับระดับพลังงานที่เก็บไว้ และอาจรองรับสถานะการชาร์จที่ใช้งานอยู่ (ขึ้นอยู่กับแอตทริบิวต์ isRechargeable) แต่ไม่รองรับการเริ่มและหยุดการชาร์จ
energyStorageDistanceUnitForUX สตริง

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

จะใช้ในการตอบกลับผู้ใช้

ค่าที่รองรับมีดังนี้

KILOMETERS
MILES
isRechargeable บูลีน

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

ตั้งค่าเป็น "จริง" หากอุปกรณ์นี้ชาร์จใหม่ได้ ซึ่งบ่งบอกว่าอุปกรณ์อาจรายงานสถานะ capacityUntilFull, isCharging และอาจรายงานสถานะ isPluggedIn และรับคำสั่ง Charge ได้

ตัวอย่าง

อุปกรณ์ที่ชาร์จใหม่ได้

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

อุปกรณ์ที่ชาร์จใหม่ได้ซึ่งแสดงระดับการชาร์จปัจจุบันเป็นไมล์

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

อุปกรณ์ที่ชาร์จใหม่ไม่ได้ซึ่งรองรับเฉพาะการรายงานระดับการชาร์จปัจจุบัน

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

STATES ของอุปกรณ์

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

รัฐ ประเภท คำอธิบาย
descriptiveCapacityRemaining สตริง

ต้องระบุ

คำอธิบายเชิงคุณภาพของระดับความจุพลังงาน โปรดทราบว่าข้อมูลนี้ใช้ในกรณีที่ไม่มีข้อมูลความจุที่เป็นตัวเลข หากมีข้อมูลความจุที่เป็นตัวเลข ระบบจะเลือกใช้ข้อมูลดังกล่าวมากกว่าคำอธิบายเมื่อเป็นไปได้

ค่าที่รองรับมีดังนี้

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining อาร์เรย์

อาร์เรย์ของคู่หน่วย/ค่าที่เก็บข้อมูลเกี่ยวกับความจุพลังงานที่อุปกรณ์มีอยู่ในปัจจุบัน เช่น <device> ของฉันวิ่งได้อีกกี่ไมล์ หรือ <device> ของฉันมีแบตเตอรี่เหลืออยู่กี่เปอร์เซ็นต์
[item, ...] ออบเจ็กต์

ความจุที่เหลือในคู่หน่วยและค่า
rawValue จำนวนเต็ม

ต้องระบุ

ค่าความจุ
unit สตริง

ต้องระบุ

หน่วยความจุ

ค่าที่รองรับมีดังนี้

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull อาร์เรย์

อาร์เรย์ของคู่หน่วย/ค่าที่เก็บข้อมูลเกี่ยวกับความจุจนกว่าอุปกรณ์จะชาร์จเต็ม เช่น อีกนานเท่าใด <device> จะชาร์จเต็ม
[item, ...] ออบเจ็กต์

ความจุจนกว่าจะชาร์จ
rawValue จำนวนเต็ม

ต้องระบุ

ค่าความจุ
unit สตริง

ต้องระบุ

หน่วยความจุ

ค่าที่รองรับมีดังนี้

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging บูลีน

ระบุว่าอุปกรณ์กำลังชาร์จอยู่หรือไม่
isPluggedIn บูลีน

ระบุว่าอุปกรณ์เสียบปลั๊กอยู่หรือไม่ อุปกรณ์อาจเสียบปลั๊กอยู่แต่ไม่ได้ชาร์จ

ตัวอย่าง

อุปกรณ์ที่ชาร์จใหม่ได้

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

อุปกรณ์ที่ชาร์จใหม่ได้ซึ่งแสดงระดับการชาร์จปัจจุบันเป็นไมล์

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

อุปกรณ์ที่ชาร์จใหม่ไม่ได้ซึ่งรองรับเฉพาะการรายงานระดับการชาร์จปัจจุบัน

{
  "descriptiveCapacityRemaining": "LOW"
}

COMMANDS ของอุปกรณ์

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

action.devices.commands.Charge

เริ่มหรือหยุดการชาร์จ

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
charge บูลีน

ต้องระบุ

เป็น "จริง" เพื่อเริ่มการชาร์จ และเป็น "เท็จ" เพื่อหยุดการชาร์จ

ตัวอย่าง

คำสั่งเริ่มการชาร์จ

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

คำสั่งหยุดการชาร์จ

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

ERRORS ของอุปกรณ์

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

deviceUnplugged: ผู้ใช้พยายามชาร์จอุปกรณ์ที่ไม่ได้เสียบปลั๊ก