스마트 홈 채널 특성 스키마
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
action.devices.traits.Channel
- 이 트레잇은 미디어 기기에서 TV 채널을 지원하는 기기에 속합니다.
availableChannels
속성을 통해 동기화 중에 사용자 또는 기기별로 목록으로 공유되어야 합니다. 이 목록은 사용자 또는 기기가 구독하는 모든 인기 채널 또는 인기 채널로 구성되어야 합니다. 쿼리 지연 시간을 짧게 유지하려면 채널 목록을 작게 유지하는 것이 좋습니다(채널 30개 이하).
기기 속성
이 트레잇이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
availableChannels |
배열 |
필수사항. 이 특정 기기에서 사용할 수 있는 미디어 채널을 설명하는 객체 목록입니다. 각 항목은 사용자가 이 기기에서 선택할 수 있는 채널을 설명합니다. |
[item, ...] |
객체 |
사용 가능한 미디어 채널입니다. |
key |
String |
필수사항. 이 채널의 고유 식별자입니다. 사용자에게 노출되지 않습니다. |
names |
배열 |
필수사항. 이 채널의 사용자에게 표시되는 이름 목록입니다. |
[item, ...] |
String |
채널 이름 |
number |
String |
이 채널의 숫자 식별자입니다(선택사항). |
commandOnlyChannels |
Boolean |
(기본값: 기기가 단방향 (true) 통신 사용을 지원하는지 또는 양방향 (false) 통신 사용을 지원하는지 여부를 나타냅니다. 기기가 이 트레잇에 관한 쿼리 인텐트 또는 보고서 상태에 응답할 수 없는 경우 이 속성을 true로 설정합니다. |
예
2개의 채널을 지원하는 기기
{
"availableChannels": [
{
"key": "ktvu2",
"names": [
"Fox",
"KTVU"
],
"number": "2"
},
{
"key": "abc1",
"names": [
"ABC",
"ABC East"
],
"number": "4-11"
}
]
}
기기 상태
없음
기기 명령어
이 트레잇이 있는 기기는 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