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

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 บูลีน

ต้องระบุ

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

ตัวอย่าง

ระบบรักษาความปลอดภัยที่มีระดับการเปิดใช้งานที่แตกต่างกัน 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

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

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