스마트 홈 볼륨 특성 스키마
action.devices.traits.Volume
: 이 특성은 볼륨을 변경 (예: 볼륨을 특정 수준으로 설정, 음소거 또는 음소거 해제)할 수 있는 기기에 속합니다.
기기 ATTRIBUTES
이 특성이 있는 기기는 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
명령어를 수신합니다.