Sơ đồ đặc điểm Bật/tắt chế độ bảo vệ của nhà thông minh

action.devices.traits.ArmDisarm – Đặc điểm này hỗ trợ bật và tắt chế độ bảo vệ như trong hệ thống an ninh.

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

THUỘC TÍNH 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 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 thiết bị hỗ trợ. 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

Cấp độ 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ả các ngôn ngữ.
level_values Mảng

Bắt buộc.

Có 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. Bạn phải có ít nhất một mặt hàng có giá trị lang là en để cung cấp ngôn ngữ dự phòng.
level_synonym Mảng

Bắt buộc.

Tên thân thiện với người dùng cho cấp độ bằng từng ngôn ngữ được hỗ trợ. Mục đầu tiên được coi là tên chuẩn.
[item, ...] String

Tên từ đồng nghĩa. Bạn phải có ít nhất một mặt hàng có giá trị lang là en để cung cấp ngôn ngữ dự phòng.
lang String

Bắt buộc.

Mã ngôn ngữ cho từ đồng nghĩa ở cấp độ. Xem Ngôn ngữ được hỗ trợ.
ordered Boolean

Bắt buộc.

Nếu bạn đặt thành true, thì ngữ pháp bổ sung cho logic tăng/giảm sẽ được áp dụng theo thứ tự của mảng cấp độ. Ví dụ: "Ok Google, tăng mức độ bảo mật của tôi lên 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 đó lên 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ó 2 cấp độ bậ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 hoạt động 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 ở trạng thái được kích hoạt hay không.
currentArmLevel String

Bắt buộc.

Bạn phải cung cấp nếu 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 an ninh báo cáo cấp độ bật riêng biệt

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

Lệnh cho 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 trong thao tác 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 động của thiết bị này.

Thông số

Phần dữ liệu 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à bật chế độ bảo vệ. Sai khi tắt.
cancel Boolean

Bắt buộc.

True 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.

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à bật chế độ bảo vệ. Sai khi tắt.
armLevel String

level_name để bật chuông báo động.

Ví dụ

Bật hệ thống

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

Đặt hệ thống ở mức kích hoạt L1

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

Huỷ thao tác bật chế độ cảnh báo

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

Đã xảy ra lỗi khi bật hoặc tắt chế độ bảo vệ 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 đủ các lỗi và trường hợp ngoại lệ.