Giản đồ đặc điểm ArmDisarm của nhà thông minh

action.devices.traits.ArmDisarm – Đặc điểm này hỗ trợ việc kích hoạt và huỷ kích hoạt như được sử dụng trong các hệ thống bảo mật, chẳng hạn.

Đối với các thiết bị có nhiều cấp độ bảo mật, các cấp độ này phải được báo cáo bằng thuộc tính availableArmLevels.

Thuộc tính thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong quá trình thực hiện thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Thuộc tính	Loại	Mô tả
availableArmLevels	Đối tượng	Mô tả các cấp độ bảo mật được hỗ trợ của thiết bị. Nếu thuộc tính này không được báo cáo, thì thiết bị chỉ hỗ trợ một cấp.
levels	Mảng	Bắt buộc. Danh sách các cấp độ bảo mật hiện có mà thiết bị hỗ trợ.
[item, ...]	Đối tượng	Mức độ bảo mật.
level_name	String	Bắt buộc. Tên nội bộ của cấp độ bảo mật được dùng trong các lệnh và trạng thái. Tên này có thể không thân thiện với người dùng và được dùng chung cho tất cả ngôn ngữ.
level_values	Mảng	Bắt buộc. Chứa level_synonym và lang.
[item, ...]	Đối tượng	Từ đồng nghĩa của cấp độ cho một ngôn ngữ nhất định.
level_synonym	Mảng	Bắt buộc. Tên dễ hiểu cho cấp độ bằng mỗi ngôn ngữ được hỗ trợ. Mục đầu tiên được coi là tên chuẩn hoá.
[item, ...]	String	Tên từ đồng nghĩa.
lang	String	Bắt buộc. Mã ngôn ngữ cho các từ đồng nghĩa của cấp độ. Xem phần Ngôn ngữ được hỗ trợ.
ordered	Boolean	Bắt buộc. Nếu bạn đặt thành true, thì cú pháp bổ sung cho logic tăng/giảm sẽ được áp dụng, theo thứ tự của mảng levels. Ví dụ: "Ok Google, tăng mức bảo mật của tôi thêm 1", Trợ lý sẽ xác định mức bảo mật hiện tại rồi tăng mức bảo mật đó thêm 1. Nếu bạn đặt giá trị này thành false, thì ngữ pháp bổ sung cho logic tăng/giảm sẽ không được hỗ trợ.

Ví dụ

Hệ thống bảo mật có hai cấp độ kích hoạt riêng biệt

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

Trạng thái thiết bị

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong quá trình thực hiện thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Tiểu bang	Loại	Mô tả
isArmed	Boolean	Bắt buộc. Cho biết liệu thiết bị có đang ở chế độ báo động hay không.
currentArmLevel	String	Bắt buộc. Bắt buộc nếu bạn chỉ định thuộc tính availableArmLevels. Nếu có nhiều cấp độ bảo mật, hãy cho biết tên của cấp độ bảo mật hiện tại.
exitAllowance	Số nguyên	Cho biết thời gian (tính bằng giây) mà người dùng phải rời khỏi trước khi currentArmLevel có hiệu lực.

Ví dụ

Hệ thống bảo mật báo cáo cấp độ cánh tay riêng biệt

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

LỆNH thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong quá trình hoạt động EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.

action.devices.commands.ArmDisarm

Đặt mức độ báo thức của thiết bị này.

Tham số

Trọng tải chứa một trong những nội dung sau:

Huỷ thao tác bật hoặc tắt chuông báo động

Tham số	Loại	Mô tả
followUpToken	String	Mã thông báo do Google cung cấp để trả lời tiếp theo.
arm	Boolean	Bắt buộc. Đúng khi lệnh là kích hoạt. Giá trị sai để huỷ kích hoạt.
cancel	Boolean	Bắt buộc. Đúng khi lệnh là huỷ giá trị arm.

Bật hoặc tắt thiết bị, với cấp độ bảo mật không bắt buộc.

Tham số	Loại	Mô tả
followUpToken	String	Mã thông báo do Google cung cấp để trả lời tiếp theo.
arm	Boolean	Bắt buộc. Đúng khi lệnh là kích hoạt. Giá trị sai để huỷ kích hoạt.
armLevel	String	level_name để kích hoạt.

Ví dụ

Chuẩn bị sẵn sàng hệ thống

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "followUpToken": "123"
  }
}

Đặt hệ thống ở cấp độ báo động L1

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "armLevel": "L1",
    "followUpToken": "456"
  }
}

Huỷ thao tác kích hoạt

{
  "command": "action.devices.commands.ArmDisarm",
  "params": {
    "arm": true,
    "cancel": true
  }
}

Lỗi liên quan

Đã xảy ra lỗi khi kích hoạt hoặc huỷ kích hoạt thiết bị.

Các giá trị được hỗ trợ:

alreadyInState

deviceTampered

passphraseIncorrect

pinIncorrect

securityRestriction

tooManyFailedAttempts

userCancelled

LỖI thiết bị

Xem danh sách đầy đủ lỗi và ngoại lệ.