แบบแผน SmartDisrmrma

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
  }
}

อุปกรณ์ STATES

เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY โปรดดูการดําเนินการ Intent

รัฐ	ประเภท	คำอธิบาย
isArmed	บูลีน	ต้องระบุ ระบุว่าอุปกรณ์เปิดอยู่ไหม
currentArmLevel	String	ต้องระบุ ต้องระบุหากมีการระบุแอตทริบิวต์ availableArmLevels ถ้ามีระดับความปลอดภัยหลายระดับ ให้ระบุชื่อของระดับความปลอดภัยปัจจุบัน
exitAllowance	จำนวนเต็ม	ระบุเวลาที่ผู้ใช้ต้องออกจากไม่กี่วินาทีก่อนที่ currentArmLevel จะมีผล

ตัวอย่าง

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

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

อุปกรณ์ COMMANDS

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ 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

อุปกรณ์ ERRORS

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