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.

ATTRIBUTE của 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 hoạt động 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 một ngôn ngữ cụ thể.
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 với 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 an ninh có hai nhóm thử nghiệm 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 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 thiết bị hiện có đang bật 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) người dùng phải rời đ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.

Thông 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

Thông số Loại Mô tả
followUpToken String

Mã thông báo do Google cung cấp cho phản hồ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 huỷ giá trị arm.

Bật hoặc tắt chuông báo động trên thiết bị với một cấp độ bảo mật tuỳ chọn.

Thông số Loại Mô tả
followUpToken String

Mã thông báo do Google cung cấp cho phản hồ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 để bật chuông báo động.

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 độ cánh tay 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
  }
}

Đã 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ệ.