สคีมาแอตทริบิวต์ ArmDisarm สมาร์ทโฮม

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

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

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

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

Attributes ประเภท คำอธิบาย
availableArmLevels ออบเจ็กต์

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

ต้องระบุ

รายการระดับการรักษาความปลอดภัยที่ใช้ได้ซึ่งอุปกรณ์รองรับ
[item, ...] ออบเจ็กต์

ระดับการรักษาความปลอดภัย
level_name String

ต้องระบุ

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

ต้องระบุ

มี level_synonym และ lang
[item, ...] ออบเจ็กต์

คำพ้องความหมายของระดับสำหรับภาษาหนึ่งๆ
level_synonym อาร์เรย์

ต้องระบุ

ชื่อที่ใช้งานง่ายสำหรับระดับในแต่ละภาษาที่รองรับ ระบบจะถือว่ารายการแรกเป็นชื่อตามหลักเกณฑ์
[item, ...] String

ชื่อคำพ้อง
lang String

ต้องระบุ

รหัสภาษาสำหรับคำพ้องความหมายของระดับ ดูภาษาที่รองรับ
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 ได้ที่การดำเนินการตาม Intent

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

ต้องระบุ

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

ต้องระบุ

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

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

ตัวอย่าง

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

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

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

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

action.devices.commands.ArmDisarm

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

พารามิเตอร์

เพย์โหลดมีข้อมูลอย่างใดอย่างหนึ่งต่อไปนี้

ยกเลิกการเปิดหรือปิดระบบ

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

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

ต้องระบุ

จริงเมื่อคำสั่งคือเปิดใช้งาน ตั้งค่าเป็นเท็จเพื่อปิดระบบ
cancel บูลีน

ต้องระบุ

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

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

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

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

ต้องระบุ

จริงเมื่อคำสั่งคือเปิดใช้งาน ตั้งค่าเป็นเท็จเพื่อปิดระบบ
armLevel String

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

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

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