สคีมาลักษณะการเปิด/ปิดระบบสมาร์ทโฮม

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

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

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

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

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

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

ต้องระบุ

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

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

ต้องระบุ

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

ต้องระบุ

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

คำพ้องความหมายของระดับสำหรับภาษาที่ระบุ ต้องระบุอย่างน้อย 1 รายการที่มีค่า lang เป็น en เพื่อให้ระบบใช้ภาษาสำรองได้
level_synonym อาร์เรย์

ต้องระบุ

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

ชื่อคำพ้องความหมาย ต้องระบุอย่างน้อย 1 รายการที่มีค่า lang เป็น en เพื่อให้ระบบใช้ภาษาสำรองได้
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 ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการQUERYเจตนาได้ที่การดำเนินการตามเจตนา

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

ต้องระบุ

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

ต้องระบุ

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

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

ตัวอย่าง

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

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

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

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

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

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

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