스마트 홈 볼륨 특성 스키마
action.devices.traits.Volume
- 이 특성은 볼륨을 변경할 수 있는 기기에 속합니다 (예: 볼륨을 특정 수준으로 설정, 음소거 또는 음소거 해제).
기기 속성
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
volumeMaxLevel |
정수 |
필수. 기준을 0 (음소거)으로 가정하고 최대 볼륨 수준 어시스턴트는 부사 명령 (예: 'TV를 좀 더 크게')을 조정합니다. |
volumeCanMuteAndUnmute |
Boolean |
필수. 기기에서 볼륨을 음소거하거나 음소거 해제할 수 있는지 여부를 나타냅니다. 음소거는 이전 옵션으로 기억될 수 있도록 '음소거' 동작으로 볼륨을 0으로 조절하므로 음소거 해제가 복원됩니다. 이는 볼륨 상태에 반영됩니다. 볼륨이 5이고 사용자가 음소거한 경우 볼륨은 5로 유지되며 |
volumeDefaultPercentage |
정수 |
(기본값: 사용자 또는 제조업체가 정의한 기본 볼륨의 볼륨 (백분율)입니다. 척도는 0~100이어야 합니다. |
levelStepSize |
정수 |
(기본값: '<device_name>의 볼륨 크게'와 같은 상대적인 볼륨 쿼리의 기본 단계 크기입니다. |
commandOnlyVolume |
Boolean |
(기본값: 기기가 단방향 (true) 통신 또는 양방향 (false) 통신을 사용하여 작동하는지 나타냅니다. 예를 들어 컨트롤러가 요청을 보낸 후 새 기기 상태를 확인할 수 있는 경우 이 필드는 false입니다. 요청이 성공적으로 실행되었는지 확인하거나 기기의 상태를 확인할 수 없는 경우 (예: 기기가 기존 적외선 리모컨인 경우) 이 필드를 true로 설정합니다. |
예
음소거할 수 있고 현재 상태를 보고하는 스피커 기기
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
기기 상태
이 특성이 있는 항목은 QUERY
작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
상태 | 유형 | 설명 |
---|---|---|
currentVolume |
정수 |
필수. 현재 볼륨 비율입니다. |
isMuted |
Boolean |
|
예
음소거할 수 있고 현재 상태를 보고하는 스피커 기기
{ "currentVolume": 5, "isMuted": false }
기기 명령어
이 특성이 있는 기기는 EXECUTE
작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
action.devices.commands.mute
기기를 음소거하거나 음소거 해제합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
mute |
Boolean |
필수. 기기를 음소거할지 또는 음소거를 해제할지 여부입니다. |
예
스피커 기기 음소거
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
volumeMaxLevel
에 따라 요청된 수준으로 볼륨을 설정합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
volumeLevel |
정수 |
필수.
|
예
스피커 기기의 절대 볼륨 설정
{ "command": "action.devices.commands.setVolume", "params": { "volumeLevel": 6 } }
action.devices.commands.volumeRelative
volumeMaxLevel
에 따라 볼륨을 n만큼 높이거나 낮춥니다. 상대적 배율을 사용하는 명령어의 경우 어시스턴트는 n을 적절히 선택하여 사용 가능한 단계로 확장합니다. 예를 들어 TV 소리 크게는 TV를 약간 크게 설정보다 더 높은 걸음 수를 설정합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
relativeSteps |
정수 |
필수. '감액'을 음수로 지정. |
예
명령어 전용 모드에서 스피커 기기의 상대적 볼륨 설정하기
{ "command": "action.devices.commands.volumeRelative", "params": { "relativeSteps": -1 } }
기기 오류
오류 및 예외의 전체 목록을 참조하세요.volumeAlreadyMax
: 기기가 이미 최대 볼륨에 있으면VolumeUp
명령어를 수신합니다.volumeAlreadyMin
: 이미 볼륨이 가장 적을 때 기기에서VolumeDown
명령어를 수신합니다.