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

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

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

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