스마트 홈 채널 특성 스키마

action.devices.traits.Channel - 이 트레잇은 미디어 기기에서 TV 채널을 지원하는 기기에 속합니다.

사용 가능한 채널은 availableChannels 속성을 통해 동기화 중에 사용자 또는 기기별로 목록으로 공유되어야 합니다. 이 목록은 사용자 또는 기기가 구독하는 모든 인기 채널 또는 인기 채널로 구성되어야 합니다. 쿼리 지연 시간을 짧게 유지하려면 채널 목록을 작게 유지하는 것이 좋습니다(채널 30개 이하).

기기 속성

이 트레잇이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성 유형 설명
availableChannels 배열

필수사항.

이 특정 기기에서 사용할 수 있는 미디어 채널을 설명하는 객체 목록입니다. 각 항목은 사용자가 이 기기에서 선택할 수 있는 채널을 설명합니다.
[item, ...] 객체

사용 가능한 미디어 채널입니다.
key String

필수사항.

이 채널의 고유 식별자입니다. 사용자에게 노출되지 않습니다.
names 배열

필수사항.

이 채널의 사용자에게 표시되는 이름 목록입니다.
[item, ...] String

채널 이름
number String

이 채널의 숫자 식별자입니다(선택사항).
commandOnlyChannels Boolean

(기본값: false)

기기가 단방향 (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

필수사항.

요청된 채널의 고유 식별자로, availableChannels 중 하나와 일치합니다.
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

기기 오류

오류 및 예외의 전체 목록을 참고하세요.