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.

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

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

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

Lỗi liên quan

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