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

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

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

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

Attributes	ประเภท	คำอธิบาย
queryOnlyEnergyStorage	บูลีน	ต้องระบุ เป็นจริงหากอุปกรณ์นี้รองรับคำค้นหาเกี่ยวกับระดับพลังงานที่จัดเก็บไว้เท่านั้นและสถานะการชาร์จที่ใช้งานอยู่ (ขึ้นอยู่กับแอตทริบิวต์ isRechargeable) แต่ไม่รองรับการเริ่มต้นและหยุดการชาร์จ
energyStorageDistanceUnitForUX	String	(ค่าเริ่มต้น: "KILOMETERS") จะนำไปใช้เพื่อตอบกลับผู้ใช้ ค่าที่รองรับ KILOMETERS MILES
isRechargeable	บูลีน	(ค่าเริ่มต้น: false) ตั้งค่าเป็น "จริง" หากอุปกรณ์นี้ชาร์จได้ ซึ่งหมายความว่าอุปกรณ์อาจรายงานสถานะ capacityUntilFull, isCharging รวมทั้งสถานะ isPluggedIn (ไม่บังคับ) และยอมรับคำสั่ง Charge ได้

ตัวอย่าง

อุปกรณ์แบบชาร์จได้

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

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

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

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

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

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

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

รัฐ	ประเภท	คำอธิบาย
descriptiveCapacityRemaining	String	ต้องระบุ คำอธิบายเชิงคุณภาพของระดับความจุพลังงาน โปรดทราบว่านี่เป็นกรณีที่ไม่มีข้อมูลความจุที่เป็นตัวเลข หากมีข้อมูลความจุที่เป็นตัวเลขด้วย ระบบจะใช้ข้อมูลแทนคำอธิบายหากเป็นไปได้ ค่าที่รองรับ CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	อาร์เรย์	อาร์เรย์ของคู่หน่วย/ค่าที่เก็บข้อมูลเกี่ยวกับความจุพลังงานที่อุปกรณ์มีอยู่ เช่น <device> ของฉันกี่ไมล์ ปัจจุบันมีหรือ<device> ชาร์จกี่เปอร์เซ็นต์ มี
[item, ...]	ออบเจ็กต์	ความจุที่เหลือในการจับคู่หน่วยและคู่ค่า
rawValue	จำนวนเต็ม	ต้องระบุ ค่าความจุ
unit	String	ต้องระบุ หน่วยความจุ ค่าที่รองรับ SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	อาร์เรย์	อาร์เรย์ของคู่หน่วย/ค่าที่เก็บข้อมูลเกี่ยวกับความจุไว้จนกว่าอุปกรณ์จะชาร์จเต็ม เช่นอีกเท่าไรกว่า <device> ชาร์จเต็มแล้ว
[item, ...]	ออบเจ็กต์	ความจุจนกว่าจะชาร์จ
rawValue	จำนวนเต็ม	ต้องระบุ ค่าความจุ
unit	String	ต้องระบุ หน่วยความจุ ค่าที่รองรับ 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"
}

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

อุปกรณ์ที่มีลักษณะนี้อาจตอบสนองต่อสิ่งต่อไปนี้ เป็นส่วนหนึ่งของการดำเนินการ 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
  }
}

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

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

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