ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

สคีมาของห้องเช่าพลังงานสําหรับสมาร์ทโฮม

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

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
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
}

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

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

รัฐ ประเภท คำอธิบาย
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"
}

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

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

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: ผู้ใช้พยายามชาร์จอุปกรณ์ที่ไม่ได้เสียบปลั๊ก