스마트 홈 볼륨 특성 스키마

action.devices.traits.Volume - 이 특성은 볼륨을 변경할 수 있는 기기에 속합니다 (예: 볼륨을 특정 수준으로 설정, 음소거 또는 음소거 해제).

기기 속성

이 특성이 있는 기기는 다음을 보고할 수 있습니다. 속성을 SYNC 작업의 일부로 사용할 수 있습니다. 배우기 위해 SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

속성 유형 설명
volumeMaxLevel 정수

필수사항.

기준치를 0 (음소거)이라고 가정하는 최대 볼륨 수준입니다. 어시스턴트는 부사 명령어를 적절하게 조정합니다 (예: 'TV 소리 크게 높여 줘').
volumeCanMuteAndUnmute Boolean

필수사항.

기기가 볼륨을 음소거하거나 음소거 해제할 수 있는지를 나타냅니다. 음소거는 '음소거'와 별도로 옵션으로 이전 볼륨을 기억하는 동안 볼륨이 0으로 바뀌므로 음소거를 해제하면 볼륨이 복원됩니다. 이는 볼륨 상태에 반영됩니다. 볼륨이 5이고 사용자가 음소거하면 볼륨은 5로 유지되고 isMuted는 true가 됩니다.
volumeDefaultPercentage 정수

(기본값: 40)

사용자 또는 제조업체가 정의한 기본 볼륨의 볼륨 (백분율)입니다. 범위는 0~100이어야 합니다.
levelStepSize 정수

(기본값: 1)

'<device_name>의 볼륨 업'과 같은 상대적 볼륨 쿼리의 기본 보폭입니다.
commandOnlyVolume Boolean

(기본값: false)

기기가 단방향 (true) 통신 또는 양방향 (false) 통신을 사용하여 작동하는지를 나타냅니다. 예를 들어 컨트롤러가 요청을 보낸 후 새 기기 상태를 확인할 수 있다면 이 필드는 false가 됩니다. 요청이 성공적으로 실행되었는지 확인하거나 기기 상태를 가져올 수 없는 경우 (예: 기기가 기존 적외선 리모컨인 경우) 이 필드를 true로 설정합니다.

예

음소거할 수 있고 현재 상태를 보고하는 스피커 기기

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

기기 상태

이 특성을 가진 항목은 다음을 보고할 수 있습니다. QUERY 작업의 일부로 제공됩니다. 배우기 위해 QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리.

주 유형 설명
currentVolume 정수

필수사항.

현재 볼륨 비율입니다. >0에서 volumeMaxLevel 사이여야 합니다.
isMuted Boolean

volumeCanMuteAndUnmute 속성이 true로 설정된 경우 필수입니다. 기기가 음소거되면 true이고, false를 반환합니다. isMuted이 true인 경우 기기는 저장된 지점에 여전히 currentVolume를 반환합니다.

예

음소거할 수 있고 현재 상태를 보고하는 스피커 기기

{
  "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 정수

필수사항.

0부터 volumeMaxLevel까지 새 볼륨입니다.

예

스피커 기기의 절대 볼륨 설정

{
  "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
  }
}

기기 ERRORS

전체 목록 보기 오류 및 예외를 방지합니다.
  • volumeAlreadyMax: 기기가 다음과 같은 경우 VolumeUp 명령어를 수신합니다. 이미 최대 볼륨으로 설정되어 있습니다.
  • volumeAlreadyMin: 기기가 다음과 같은 경우 VolumeDown 명령어를 수신합니다. 볼륨이 이미 가장 낮습니다.