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

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

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