สคีมาแอตทริบิวต์ 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

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

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