Giản đồ về đặc điểm thể tích của nhà thông minh

action.devices.traits.Volume – Đặc điểm này thuộc về các thiết bị có thể thay đổi âm lượng (ví dụ: đặt âm lượng ở một mức nhất định, tắt tiếng hoặc bật tiếng).

ATTRIBUTE của thiết bị

Những thiết bị có đặc điểm này có thể báo cáo những điều sau trong thao tác SYNC. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem Thực hiện ý định.

Thuộc tính Loại Mô tả
volumeMaxLevel Số nguyên

Bắt buộc.

Mức âm lượng tối đa, giả sử đường cơ sở là 0 (tắt tiếng). Trợ lý sẽ điều chỉnh các lệnh bằng trạng thái (ví dụ: "làm cho tivi to hơn một chút") cho phù hợp.
volumeCanMuteAndUnmute Boolean

Bắt buộc.

Cho biết liệu thiết bị có thể tắt và bật tiếng hay không. Tắt tiếng là một tùy chọn riêng biệt có tên "tắt tiếng" sẽ đưa âm lượng về 0 trong khi ghi nhớ âm lượng trước đó. Nhờ vậy, chế độ bật tiếng sẽ khôi phục âm lượng đó. Điều này được thể hiện qua trạng thái âm lượng. Nếu âm lượng là 5 và người dùng tắt tiếng, thì âm lượng vẫn là 5 và isMuted là true.
volumeDefaultPercentage Số nguyên

(Mặc định: 40)

Âm lượng (tính bằng phần trăm) của âm lượng mặc định do người dùng hoặc nhà sản xuất xác định. Thang điểm phải từ 0 đến 100.
levelStepSize Số nguyên

(Mặc định: 1)

Kích thước bước mặc định cho các truy vấn âm lượng tương đối như 'tăng âm lượng trên <device_name>.
commandOnlyVolume Boolean

(Mặc định: false)

Cho biết thiết bị hoạt động bằng giao tiếp một chiều (true) hay hai chiều (false). Ví dụ: nếu tay điều khiển có thể xác nhận trạng thái mới của thiết bị sau khi gửi yêu cầu, thì trường này sẽ là false. Nếu không thể xác nhận xem yêu cầu có được thực thi thành công hay không hoặc biết trạng thái của thiết bị (ví dụ: nếu thiết bị là điều khiển từ xa hồng ngoại truyền thống), hãy đặt trường này thành true.

Ví dụ

Thiết bị loa có thể tắt tiếng và báo cáo trạng thái hiện tại

{
  "volumeMaxLevel": 11,
  "volumeCanMuteAndUnmute": true,
  "levelStepSize": 2,
  "commandOnlyVolume": false,
  "volumeDefaultPercentage": 6
}

Thiết bị STATES

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

Tiểu bang Loại Mô tả
currentVolume Số nguyên

Bắt buộc.

Phần trăm âm lượng hiện tại. Giá trị này phải nằm trong khoảng từ >0 đến volumeMaxLevel.
isMuted Boolean

Bắt buộc nếu thuộc tính volumeCanMuteAndUnmute được đặt thành true. Đúng nếu thiết bị đang tắt tiếng; false. Nếu isMuted là true, thiết bị vẫn trả về currentVolume cho điểm đã nhớ.

Ví dụ

Thiết bị loa có thể tắt tiếng và báo cáo trạng thái hiện tại

{
  "currentVolume": 5,
  "isMuted": false
}

lệnh của thiết bị

Những thiết bị có đặc điểm này có thể phản hồi với những đặc điểm sau các lệnh trong thao tác EXECUTE. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem Thực hiện ý định.

action.devices.commands.mute

Tắt tiếng hoặc bật tiếng thiết bị.

Tham số

Tham số Loại Mô tả
mute Boolean

Bắt buộc.

Chọn tắt tiếng thiết bị hoặc bật tiếng thiết bị.

Ví dụ

Tắt tiếng thiết bị loa

{
  "command": "action.devices.commands.mute",
  "params": {
    "mute": true
  }
}

action.devices.commands.setVolume

Đặt âm lượng ở mức được yêu cầu, dựa trên volumeMaxLevel.

Tham số

Tham số Loại Mô tả
volumeLevel Số nguyên

Bắt buộc.

Tập mới, từ 0 đến volumeMaxLevel.

Ví dụ

Đặt âm lượng tuyệt đối cho loa

{
  "command": "action.devices.commands.setVolume",
  "params": {
    "volumeLevel": 6
  }
}

action.devices.commands.volumeRelative

Đặt âm lượng tăng hoặc giảm n bước, dựa trên volumeMaxLevel. Đối với các lệnh sử dụng thang đo tương đối, Trợ lý sẽ chọn n một cách thích hợp để điều chỉnh theo các bước có sẵn. Ví dụ: Tăng âm lượng của TV lên nhiều sẽ đặt nhiều bước hơn so với Tăng âm lượng của TV lên một chút.

Tham số

Tham số Loại Mô tả
relativeSteps Số nguyên

Bắt buộc.

âm cho "giảm".

Ví dụ

Đặt âm lượng tương đối của thiết bị loa ở chế độ chỉ dùng lệnh

{
  "command": "action.devices.commands.volumeRelative",
  "params": {
    "relativeSteps": -1
  }
}

Thiết bị ERRORS

Xem toàn bộ danh sách lỗi và ngoại lệ.
  • volumeAlreadyMax: Thiết bị nhận được lệnh VolumeUp khi đã ở mức âm lượng cao nhất.
  • volumeAlreadyMin: Thiết bị nhận được lệnh VolumeDown khi đã ở mức âm lượng thấp nhất.