스마트 홈 채널 특성 스키마

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

사용 가능한 채널은 SYNC하는 동안 availableChannels 속성을 통해 사용자 또는 기기별로 목록으로 공유되어야 합니다. 이 목록은 사용자 또는 기기가 구독하는 모든 상위 또는 인기 채널로 구성되어야 합니다. 쿼리 지연 시간을 줄이려면 채널 목록을 30개 이하의 채널로 유지하는 것이 좋습니다.

기기 속성

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

속성 유형 설명
availableChannels 배열

필수.

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

[item, ...] 객체

사용 가능한 미디어 채널

key String

필수.

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

names 배열

필수.

사용자에게 표시되는 이 채널의 이름입니다.

[item, ...] String

채널 이름

number String

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

commandOnlyChannels Boolean

(기본값: false)

기기에서 단방향 통신 (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

필수.

요청된 채널의 고유 식별자로, 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

기기 ERRORS

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