Giản đồ về tính năng Smart Arm Arm

action.devices.traits.ArmDisarm – Đặc điểm này hỗ trợ việc bật/tắt chuông báo động như trong các hệ thống an ninh chẳng hạn.

Đố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.

ATTRIBUTES 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 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 Nội dung mô tả
availableArmLevels Đối tượng

Mô tả các mức 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, thiết bị chỉ hỗ trợ một cấp.
levels Mảng

Bắt buộc.

Danh sách các mức độ bảo mật có sẵn mà thiết bị hỗ trợ.
[item, ...] Đối tượng

Cấp độ bảo mật.
level_name Chuỗi

Bắt buộc.

Tên nội bộ của cấp độ bảo mật được sử 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 chia sẻ trên tất cả ngôn ngữ.
level_values Mảng

Bắt buộc.

Chứa level_synonym và lang.
[item, ...] Đối tượng

Cấp độ đồng nghĩa của một ngôn ngữ cụ thể.
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 mỗi ngôn ngữ được hỗ trợ. Mục đầu tiên được xem là tên chuẩn.
[item, ...] Chuỗi

Tên từ đồng nghĩa.
lang Chuỗi

Bắt buộc.

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

Bắt buộc.

Nếu bạn đặt chính sách này thành true, thì ngữ pháp bổ sung cho logic tăng/giảm sẽ áp dụng theo thứ tự trong mảng mức độ. Ví dụ: "Ok Google, tăng cấp độ bảo mật của tôi thêm 1" để Trợ lý xác định cấp độ bảo mật hiện tại, sau đó tăng một cấp độ bảo mật. Nếu bạn đặt giá trị này thành false, thì hệ thống không hỗ trợ thêm ngữ pháp cho logic tăng/giảm.

Ví dụ

Hệ thống an ninh có hai cấp cánh tay 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
  }
}

Thiết bị STATES

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 toán tử 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 Nội dung mô tả
isArmed Boolean

Bắt buộc.

Cho biết thiết bị hiện có được bật hay không.
currentArmLevel Chuỗi

Bắt buộc.

Bắt buộc nếu thuộc tính availableArmLevels được chỉ định. 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 độ riêng biệt của hệ thống

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

Thiết bị COMMANDS

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây 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 thức cho thiết bị này.

Các tham số

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

Hủy thao tác bật/tắt cánh tay

Các tham số Loại Mô tả
followUpToken Chuỗi

Mã thông báo do Google cung cấp để phản hồi theo dõi.
arm Boolean

Bắt buộc.

True khi có lệnh để khởi động. Sai để tước vũ khí.
cancel Boolean

Bắt buộc.

True khi lệnh là huỷ giá trị arm.

Bật hoặc tắt thiết bị bằng mức bảo mật tuỳ chọn.

Các tham số Loại Mô tả
followUpToken Chuỗi

Mã thông báo do Google cung cấp để phản hồi theo dõi.
arm Boolean

Bắt buộc.

True khi có lệnh để khởi động. Sai để tước vũ khí.
armLevel Chuỗi

level_name để chuyển sang.

Ví dụ

Định hướng hệ thống

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

Đặt hệ thống ở mức L1

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

Huỷ thao tác bật hệ thống vũ khí

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

Đã xảy ra lỗi khi bật hoặc tắt thiết bị.

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

alreadyInState
deviceTampered
passphraseIncorrect
pinIncorrect
securityRestriction
tooManyFailedAttempts
userCancelled

Thiết bị ERRORS

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