스마트 홈 채널 특성 스키마
action.devices.traits.Channel
- 이 특성은 미디어 기기에서 TV 채널을 지원하는 기기에 속합니다.
availableChannels
속성을 통해 사용자 또는 기기별로 목록으로 공유되어야 합니다. 이 목록은 사용자 또는 기기가 구독하는 모든 상위 또는 인기 채널로 구성되어야 합니다. 쿼리 지연 시간을 줄이려면 채널 목록을 30개 이하의 채널로 유지하는 것이 좋습니다.
기기 속성
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
availableChannels |
배열 |
필수. 이 기기에서 사용 가능한 미디어 채널을 설명하는 객체 목록입니다. 각 항목은 사용자가 이 기기에서 선택할 수 있는 채널을 설명합니다. |
[item, ...] |
객체 |
사용 가능한 미디어 채널 |
key |
String |
필수. 이 채널의 고유 식별자입니다. 사용자에게 노출되지 않습니다. |
names |
배열 |
필수. 사용자에게 표시되는 이 채널의 이름입니다. |
[item, ...] |
String |
채널 이름 |
number |
String |
이 채널의 숫자 식별자입니다(선택사항). |
commandOnlyChannels |
Boolean |
(기본값: 기기에서 단방향 통신 (true) 또는 양방향 통신 (false)을 지원하는지 여부를 나타냅니다. 기기가 이 특성에 관해 QUERY 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 true로 설정하세요. |
예시
두 채널을 지원하는 기기
{ "availableChannels": [ { "key": "ktvu2", "names": [ "Fox", "KTVU" ], "number": "2" }, { "key": "abc1", "names": [ "ABC", "ABC East" ], "number": "4-11" } ] }
기기 상태: STATES
없음
기기 COMMANDS
이 특성이 있는 기기는 EXECUTE
작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
action.devices.commands.selectChannel
현재 채널을 특정 값으로 설정합니다.
매개변수
페이로드에는 다음 중 하나가 포함됩니다.
ID로 채널 선택
매개변수 | 유형 | 설명 |
---|---|---|
channelCode |
String |
필수. 요청된 채널의 고유 식별자로, |
channelName |
String |
요청된 채널의 사용자 친화적인 이름입니다. |
channelNumber |
String |
요청된 채널의 숫자 식별자입니다. |
번호별 채널 선택
매개변수 | 유형 | 설명 |
---|---|---|
channelNumber |
String |
필수. 요청된 채널의 숫자 식별자입니다. |
예시
KTVU로 변경
{ "command": "action.devices.commands.selectChannel", "params": { "channelCode": "ktvu2", "channelName": "KTVU" } }
채널 3으로 이동합니다.
{ "command": "action.devices.commands.selectChannel", "params": { "channelNumber": "3" } }
관련 오류
기기에서 새 채널을 선택하는 중에 오류가 발생했습니다.
지원되는 값:
noAvailableChannel
noChannelSubscription
channelSwitchFailed
action.devices.commands.relativeChannel
현재 채널을 상대적인 금액으로 조정합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
relativeChannelChange |
정수 |
필수. 늘리거나 줄일 채널 수입니다. |
예시
다음 채널로 전환
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": 1 } }
이전 채널로 전환
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": -1 } }
관련 오류
기기의 채널을 조정하는 중에 오류가 발생했습니다.
지원되는 값:
channelSwitchFailed
action.devices.commands.returnChannel
사용자가 마지막으로 사용한/이전 채널로 돌아갑니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
속성이 없습니다. |
예시
마지막 채널로 돌아가기
{ "command": "action.devices.commands.returnChannel", "params": {} }
관련 오류
기기의 마지막 채널로 돌아가는 중에 오류가 발생했습니다.
지원되는 값:
channelSwitchFailed