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

สคีมาของ HomeDisarm Trait ของ Smart Home

action.devices.traits.ArmDisarm - ลักษณะเฉพาะนี้รองรับการเปิดระบบและปิดใช้ระบบต่างๆ อย่างเช่นระบบรักษาความปลอดภัย

สําหรับอุปกรณ์ที่มีระดับความปลอดภัยหลายระดับ ควรรายงานระดับเหล่านี้ด้วยแอตทริบิวต์ availableArmLevels

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
availableArmLevels วัตถุ

อธิบายระดับความปลอดภัยที่รองรับของอุปกรณ์ หากไม่รายงานแอตทริบิวต์นี้ อุปกรณ์จะรองรับเพียงระดับเดียวเท่านั้น

levels อาร์เรย์

ต้องระบุ

รายการระดับความปลอดภัยที่ใช้ได้ซึ่งอุปกรณ์รองรับ

[item, ...] วัตถุ

ระดับความปลอดภัย

level_name สตริง

ต้องระบุ

ชื่อภายในของระดับความปลอดภัยที่ใช้ในคําสั่งและสถานะ ชื่อนี้อาจใช้งานยากและแชร์ได้ในทุกภาษา

level_values อาร์เรย์

ต้องระบุ

มี level_synonym และ lang

[item, ...] วัตถุ

คําพ้องความหมายของภาษาที่ระบุ

level_synonym อาร์เรย์

ต้องระบุ

ชื่อที่ใช้ง่ายสําหรับระดับในแต่ละภาษาที่รองรับ รายการแรกจะถือเป็นชื่อ Canonical

[item, ...] สตริง

ชื่อคําพ้องความหมาย

lang สตริง

ต้องระบุ

รหัสภาษาสําหรับคําพ้องความหมายระดับ ดูภาษาที่รองรับ

ordered บูลีน

ต้องระบุ

หากตั้งค่าเป็น "จริง" ระบบจะใช้ไวยากรณ์เพิ่มเติมสําหรับตรรกะการเพิ่ม/ลดตามลําดับของอาร์เรย์ระดับ ตัวอย่างเช่น "Ok Google เพิ่มระดับความปลอดภัยเป็น 1" ทําให้ Assistant ตั้งระดับความปลอดภัยปัจจุบันได้ แล้วเพิ่มระดับความปลอดภัยนั้นอีก 1 ระดับ หากตั้งค่านี้เป็น "เท็จ" ระบบจะไม่รองรับไวยากรณ์เพิ่มเติมสําหรับตรรกะการเพิ่ม/ลด

ตัวอย่าง

ระบบรักษาความปลอดภัยที่มี 2 ระดับแตกต่างกัน

{
  "availableArmLevels": {
    "levels": [
      {
        "level_name": "L1",
        "level_values": [
          {
            "level_synonym": [
              "Home and Guarding",
              "SL1"
            ],
            "lang": "en"
          },
          {
            "level_synonym": [
              "Zuhause und Bewachen",
              "SL1"
            ],
            "lang": "de"
          }
        ]
      },
      {
        "level_name": "L2",
        "level_values": [
          {
            "level_synonym": [
              "Away and Guarding",
              "SL2"
            ],
            "lang": "en"
          },
          {
            "level_synonym": [
              "Weg und Bewachen",
              "SL2"
            ],
            "lang": "de"
          }
        ]
      }
    ],
    "ordered": true
  }
}

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

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

รัฐ ประเภท คำอธิบาย
isArmed บูลีน

ต้องระบุ

ระบุว่าอุปกรณ์เปิดอยู่หรือไม่

currentArmLevel สตริง

ต้องระบุ

ต้องระบุหากระบุแอตทริบิวต์ availableArmLevels หากมีระดับความปลอดภัยหลายระดับ ให้ระบุชื่อของระดับความปลอดภัยปัจจุบัน

exitAllowance จำนวนเต็ม

ระบุเวลาเป็นวินาทีที่ผู้ใช้ต้องออกจากก่อนที่ currentArmLevel จะมีผล

ตัวอย่าง

ระบบรักษาความปลอดภัยที่รายงานระดับแขนที่แตกต่าง

{
  "isArmed": true,
  "currentArmLevel": "L1"
}

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

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

action.devices.commands.ArmDisarm

ตั้งค่าระดับการปลุกของอุปกรณ์นี้

พารามิเตอร์

เพย์โหลดมีองค์ประกอบอย่างใดอย่างหนึ่งต่อไปนี้

ยกเลิกการเปิดและปิดระบบป้องกัน

พารามิเตอร์ ประเภท คำอธิบาย
followUpToken สตริง

โทเค็นที่ Google มีให้สําหรับการตอบกลับติดตามผล

arm บูลีน

ต้องระบุ

เป็นจริงเมื่อคําสั่งเริ่มทํางาน เท็จที่จะปิดระบบ

cancel บูลีน

ต้องระบุ

เป็นจริงเมื่อคําสั่งคือการยกเลิกค่า arm

เปิดหรือปิดระบบป้องกันอุปกรณ์ด้วยระดับความปลอดภัยที่ไม่บังคับ

พารามิเตอร์ ประเภท คำอธิบาย
followUpToken สตริง

โทเค็นที่ Google มีให้สําหรับการตอบกลับติดตามผล

arm บูลีน

ต้องระบุ

เป็นจริงเมื่อคําสั่งเริ่มทํางาน เท็จที่จะปิดระบบ

armLevel สตริง

level_name เป็นประตูสู่ความสําเร็จ

ตัวอย่าง

เปิดระบบ

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "followUpToken": "123"
  }
}

ตั้งค่าระบบให้อยู่ในระดับ L1

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "armLevel": "L1",
    "followUpToken": "456"
  }
}

ยกเลิกการดําเนินการเปิดใช้งาน

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "cancel": true
  }
}

เกิดข้อผิดพลาดเมื่อเปิดระบบหรือปิดอุปกรณ์

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

alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled

อุปกรณ์ ERRORS

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