Giản đồ thuộc tính âm lượng của nhà thông minh

action.devices.traits.Volume – Đặc điểm này thuộc về những 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).

Thuộc tính 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 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ả
volumeMaxLevel Số nguyên

Bắt buộc.

Cấp â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 trạng từ (ví dụ: "tăng âm lượng TV lê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 tuỳ chọn riêng biệt vì hành vi "tắt tiếng" sẽ đặt âm lượng thành 0 trong khi vẫn ghi nhớ âm lượng trước đó để khi bật tiếng, âm lượng sẽ được khôi phục. Điều này được phản ánh trong 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 theo tỷ lệ phần trăm) cho âm lượng mặc định do người dùng hoặc nhà sản xuất xác định. Tỷ lệ phải nằm trong khoảng từ 0 đến 100.
levelStepSize Số nguyên

(Mặc định: 1)

Kích thước bước mặc định cho các cụm từ tìm kiếm về â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 liệu thiết bị có hoạt động bằng cách giao tiếp một chiều (true) hay hai chiều (false) hay không. Ví dụ: nếu tay điều khiển có thể xác nhận trạng thái thiết bị mới sau khi gửi yêu cầu, thì trường này sẽ có giá trị 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
}

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ả
currentVolume Số nguyên

Bắt buộc.

Phần trăm âm lượng hiện tại. 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ị bị tắt tiếng; sai nếu không. Nếu isMuted là true, thiết bị vẫn trả về currentVolume cho điểm đã ghi 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 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 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.mute

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

Thông số

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

Thông số

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

Bắt buộc.

Dung lượng 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ăng hoặc giảm âm lượng n bước, dựa trên volumeMaxLevel. Đối với các lệnh sử dụng tỷ lệ tương đối, Trợ lý sẽ chọn n sao cho phù hợp với 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.

Thông số

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

Bắt buộc.

âm đối với "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
  }
}

LỖI thiết bị

Xem danh sách đầy đủ lỗi và ngoại lệ.
  • volumeAlreadyMax: Thiết bị nhận lệnh VolumeUp khi thiết bị đã ở 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.