Giản đồ đặ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).

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 quá trình SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, vui lòng xem phần Thực hiện ý định.

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

Bắt buộc.

Mức âm lượng tối đa, giả sử giá trị 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 cho TV 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 tiếng và bật tiếng hay không. Tắt tiếng là một tùy chọn riêng biệt vì hành vi 'tắt tiếng' đưa âm lượng về 0 trong khi ghi nhớ âm lượng trước đó, để bật tiếng sẽ khôi phục âm lượng. Điều này được phản ánh ở 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à đúng.

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 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 truy vấn khối 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 cách sử dụ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 liệu yêu cầu đã được thực thi thành công hay chưa hoặc để biết trạng thái của thiết bị (ví dụ: nếu thiết bị là thiết bị điều khiển từ xa hồng ngoại truyền thống), hãy đặt trường này thành true (đúng).

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 của 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 trong thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, vui lòng xem phần Thực hiện ý định.

Tiểu bang Loại Nội dung mô tả
currentVolume Số nguyên

Bắt buộc.

Tỷ lệ phần trăm âm lượng hiện tại. Giá trị 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. "True" nếu thiết bị bị tắt tiếng; "false" nếu không tắt. Nếu isMuted là đúng, 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 trên thiết bị

Các thiết bị có trait này có thể phản hồi các lệnh sau đây trong quá trình thao tác EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, vui lòng 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 Nội dung mô tả
mute Boolean

Bắt buộc.

Liệu có tắt tiếng thiết bị hay bật tiếng thiết bị nào không.

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 yêu cầu, dựa trên volumeMaxLevel.

Thông số

Thông số Loại Nội dung 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 thiết bị loa

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

action.devices.commands.volumeRelative

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

Thông số

Thông số Loại Nội dung 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ỉ lệnh

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

Thiết bị ERRORS

Xem danh sách đầy đủ lỗi và trường hợp 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 lệnh VolumeDown khi thiết bị đang ở mức âm lượng thấp nhất.