Google Cast 발신기 애플리케이션은 JSON 형식의 메시지를 수신기 애플리케이션에 전송하여 수신기 기기의 재생을 제어합니다. 마찬가지로 수신기는 보낸 사람에게 다시 JSON으로 메시지를 보냅니다. 메시지는 플레이어 상태를 변경하는 발신자의 명령어, 수신자의 이러한 명령어에 대한 응답 또는 수신기 애플리케이션의 미디어를 설명하는 데이터 구조일 수 있습니다.
Google Cast SDK 추가 개발자 서비스 약관에 따라 Cast 미디어 애플리케이션은 여기에 정의된 대로 이러한 메시지를 사용하여 수신기에서 미디어 재생을 제어해야 합니다. 이렇게 하면 미디어 앱에서 플랫폼 전체에서 일관된 사용자 환경을 제공하고 Cast 애플리케이션이 향후 및 향후 사용 사례를 지원할 수 있습니다. 또한 이러한 구조에서는 커스텀 데이터가 지원되며, 애플리케이션은 SDK에서 지원하지 않는 명령어에 관한 자체 메시지를 정의할 수 있습니다.
미디어 재생 메시지의 네임스페이스는 urn:x-cast:com.google.cast.media로 정의됩니다.
참고: 이 사양의 메시지와 구조는 전송 메시지의 최대 크기에 의해 결정되는 암시적 최대 크기를 나타내며 개별 필드에 대한 한도는 없습니다. 전송 메시지 최대 크기는 현재 64KBytes입니다.
일반적인 네임스페이스 데이터 구조
모든 미디어 네임스페이스 아티팩트에서 사용하는 데이터 구조의 상위 집합은 공통 네임스페이스에 정의됩니다.
이미지
전송자가 애플리케이션을 렌더링하는 방식에 따라 이미지를 선택할 수 있도록 소량의 메타데이터를 포함하는 이미지에 관한 설명입니다.
이미지 배열에서 높이와 너비는 한 항목만 선택할 수 있습니다. 예를 들어 반환되는 항목이 하나인 경우 선택사항입니다. 두 개의 항목이 반환되는 경우 한 항목의 높이와 너비를 지정해야 하지만, 발신자가 'default' 옵션을 사용하여 특정 매개변수와 함께 전달된 것과 다른 옵션을 선택할 수도 있습니다.
이름 | 유형 | 설명 |
---|---|---|
url | URI | 이미지의 URI |
높이 | 정수 | 선택사항 이미지 높이 |
너비 | 정수 | 선택사항 이미지 너비 |
볼륨
미디어 스트림 볼륨 미디어 스트림의 페이드 인/페이드 아웃 효과에 사용됩니다. (참고: 시스템 볼륨은 발신기 API를 사용하여 변경됩니다.) 기기 볼륨을 제어하는 볼륨 볼륨이나 볼륨 버튼과 함께 스트림 볼륨을 사용하면 안 됩니다. 스트림 볼륨을 변경하려면 다음 매개변수 중 하나 이상을 전달해야 합니다.
이름 | 유형 | 설명 |
---|---|---|
수준 | double | 선택사항: 현재 스트림 볼륨 수준(0.0~1.0), 이때 최대 볼륨은 1.0입니다. |
음소거됨 | boolean | 선택사항 볼륨과 관계없이 Cast 기기의 음소거 여부 |
미디어 네임스페이스 데이터 구조
이 메시지는 미디어 플레이어의 상태를 설명합니다. 네임스페이스는 urn:x-cast:com.google.cast.media입니다.
미디어 정보
이 데이터 구조는 미디어 스트림을 설명합니다.
이름 | 유형 | 설명 |
---|---|---|
콘텐츠 ID | 문자열 | 현재 미디어 플레이어에서 로드한 콘텐츠의 서비스별 식별자입니다. 자유 형식 문자열로, 애플리케이션에 따라 다릅니다. 대부분의 경우 이 URL이 미디어 URL이지만, 발신자가 받는 사람이 올바르게 해석할 수 있는 문자열을 전달할 수도 있습니다. 최대 길이: 1k |
스트림 유형 | enum (문자열) |
미디어 아티팩트의 유형을 다음 중 하나로 설명합니다.
|
콘텐츠 유형 | 문자열 | 재생 중인 미디어의 MIME 콘텐츠 유형 |
메타데이터 | 객체 | 선택사항: 미디어 메타데이터 객체이며 다음 중 하나입니다. |
기간 | double | 선택사항: 현재 재생 중인 스트림의 길이(초) |
맞춤 데이터 | 객체 | 선택사항 발신자 애플리케이션 또는 수신자 애플리케이션에서 정의한 애플리케이션의 데이터 blob |
GenericMediaMetadata의 클래스
일반 미디어 아티팩트를 설명합니다.
이름 | 유형 | 설명 |
---|---|---|
metadataType | 정수 | 0 (유일한 값) |
title | 문자열 | 선택사항 콘텐츠를 설명하는 제목입니다. 플레이어는 content_id를 사용하여 독립적으로 제목을 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
자막 | 문자열 | 선택사항: 콘텐츠를 설명하는 자막입니다. 플레이어는 content_id를 사용하여 독립적으로 제목을 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
이미지 | 이미지[] | 선택사항 콘텐츠와 연결된 이미지의 URL 배열입니다. 필드의 초깃값은 발신자가 로드 메시지에서 제공할 수 있습니다. 권장 크기를 제공해야 합니다. |
출시일 | 문자열 (ISO 8601) | 선택사항: ISO 8601 콘텐츠가 게시된 날짜 및 시간입니다. 플레이어는 content_id를 사용하여 독립적으로 제목을 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
영화 미디어 메타데이터
영화 미디어 아티팩트를 설명합니다.
이름 | 유형 | 설명 |
---|---|---|
metadataType | 정수 | 1 (유일한 값) |
title | 문자열 | 선택사항 콘텐츠를 설명하는 제목입니다. 플레이어는 content_id를 사용하여 독립적으로 제목을 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
자막 | 문자열 | 선택사항: 콘텐츠를 설명하는 자막입니다. 플레이어는 content_id를 사용하여 독립적으로 제목을 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
스튜디오 | 문자열 | 선택사항: 콘텐츠를 출시한 스튜디오입니다. 플레이어는 content_id를 사용하여 독립적으로 스튜디오를 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
이미지 | 이미지[] | 선택사항 콘텐츠와 연결된 이미지의 URL 배열입니다. 필드의 초깃값은 발신자가 로드 메시지에서 제공할 수 있습니다. 권장 크기를 제공해야 합니다. |
출시일 | 문자열 (ISO 8601) | 선택사항: ISO 8601 콘텐츠가 게시된 날짜 및 시간입니다. 플레이어는 content_id를 사용하여 독립적으로 제목을 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
TV 프로그램 미디어 메타데이터
TV 프로그램 에피소드 미디어 아티팩트를 설명합니다.
이름 | 유형 | 설명 |
---|---|---|
metadataType | 정수 | 2(유일한 값) |
seriesTitle | 문자열 | 선택사항 TV 시리즈의 제목입니다. 플레이어는 content_id를 사용하여 독립적으로 제목을 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
자막 | 문자열 | 선택사항 TV 에피소드의 설명 자막입니다. 플레이어는 content_id를 사용하여 독립적으로 제목을 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
시즌 | 정수 | 선택사항 TV 프로그램의 시즌 번호 |
에피소드 | 정수 | 선택사항 TV 프로그램의 에피소드 번호 (시즌 내) |
이미지 | 이미지[] | 선택사항 콘텐츠와 연결된 이미지의 URL 배열입니다. 필드의 초깃값은 발신자가 로드 메시지에서 제공할 수 있습니다. 권장 크기를 제공해야 합니다. |
원본 AirDate | 문자열 (ISO 8601) | 선택사항 이 에피소드의 공개 버전인 ISO 8601 날짜 및 시간입니다. 플레이어는 content_id를 사용하여 독자적 원래 AirDate를 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
음악 트랙 미디어 메타데이터
음악 트랙 미디어 아티팩트를 설명합니다.
이름 | 유형 | 설명 |
---|---|---|
metadataType | 정수 | 3 (유일한 값) |
앨범 이름 | 문자열 | 선택사항: 이 트랙을 만든 앨범 또는 컬렉션입니다. 플레이어는 content_id를 사용하여 앨범 이름을 독립적으로 검색하거나 로드 메시지에서 보낸 사람이 앨범 이름을 가져올 수 있습니다. |
title | 문자열 | 선택사항 트랙의 이름입니다 (예: 노래 제목). 플레이어는 content_id를 사용하여 독립적으로 제목을 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
앨범 아티스트 | 문자열 | 선택사항 이 트랙이 포함된 앨범과 관련된 아티스트의 이름입니다. 플레이어는 content_id를 사용하여 앨범아트를 독립적으로 가져오거나 발신자가 로드 메시지에서 제공할 수 있습니다. |
아티스트 | 문자열 | 선택사항: 미디어 트랙과 연결된 아티스트의 이름입니다. 플레이어는 content_id를 사용하여 독립적으로 아티스트를 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
composer | 문자열 | 선택사항: 미디어 트랙과 연결된 작곡가의 이름입니다. 플레이어는 content_id를 사용하여 독립적으로 작곡자를 검색하거나 로드 메시지에서 보내는 사람이 작성할 수 있습니다. |
트랙 번호 | 정수 | 선택사항 앨범의 트랙 번호 |
discNumber | 정수 | 선택사항 앨범의 볼륨 번호 (예: 디스크) |
이미지 | 이미지[] | 선택사항 콘텐츠와 연결된 이미지의 URL 배열입니다. 필드의 초깃값은 발신자가 로드 메시지에서 제공할 수 있습니다. 권장 크기를 제공해야 합니다. |
출시일 | 문자열 (ISO 8601) | 선택사항: ISO 8601 콘텐츠가 게시된 날짜 및 시간입니다. 플레이어는 content_id를 사용하여 독립적으로 ReleaseDate를 검색하거나 로드 메시지에서 발신자에게 제공할 수 있습니다. |
사진 미디어 메타데이터
사진 미디어 아티팩트를 설명합니다.
이름 | 유형 | 설명 |
---|---|---|
metadataType | 정수 | 4(유일한 값) |
title | 문자열 | 선택사항 사진의 제목입니다. 플레이어는 content_id를 사용하여 독립적으로 제목을 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
아티스트 | 문자열 | 선택사항 사진사의 이름입니다. 플레이어는 content_id를 사용하여 독립적으로 아티스트를 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
위치 | 문자열 | 선택사항: 사진이 촬영된 구두 위치(예: '스페인 마드리드'). 플레이어는 content_id를 사용하여 독립적으로 위치를 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
latitude | double | 선택사항 사진이 촬영한 위치의 지리적 위도 값입니다. 플레이어는 content_id를 사용하여 독립적으로 위도를 가져오거나 발신자가 Load 메시지에서 위도를 지정할 수 있습니다. |
longitude | double | 선택사항 사진이 촬영한 위치의 지리적 경도 값입니다. 플레이어는 content_id를 사용하여 독립적으로 경도를 검색하거나 로드 메시지에서 보내는 사람이 경도를 가져올 수 있습니다. |
너비 | 정수 | 선택사항 사진의 너비(픽셀)입니다. 플레이어는 content_id를 사용하여 독립적으로 너비를 가져오거나 Load 메시지에서 발신자가 제공할 수 있습니다. |
높이 | 정수 | 선택사항 사진의 높이(픽셀)입니다. 플레이어는 content_id를 사용하여 독립적으로 높이를 가져오거나 로드 메시지에서 발신자에게 제공할 수 있습니다. |
creationDateTime | 문자열 (ISO 8601) | 선택사항: ISO 8601 사진을 촬영한 날짜 및 시간입니다. 플레이어는 content_id를 사용하여 createDateTime을 독립적으로 가져오거나 로드 메시지에서 보내는 사람이 제공할 수 있습니다. |
미디어 상태
세션과 관련된 미디어 아티팩트의 현재 상태를 설명합니다.
이름 | 유형 | 설명 |
---|---|---|
mediaSessionId | 정수 | 이 특정 세션의 재생에 대한 고유 ID입니다. 이 ID는 LOAD에서 수신자에 의해 설정되며 재생의 특정 인스턴스를 식별하는 데 사용될 수 있습니다. 예를 들어 동일한 세션 내에서 '이곳에 있었다면'을 두 번 재생하면 각각 고유한 mediaSessionId가 있습니다. |
media | 미디어 정보 | 선택사항 (상태 메시지용) 재생 중인 콘텐츠에 대한 자세한 설명입니다. MediaInformation이 변경된 경우에만 상태 메시지에서 반환됩니다. |
playbackRate | float | 미디어 시간이 진행 중인지 여부와 속도를 나타냅니다. 미디어 상태는 모든 상태에서 중지될 수 있으므로 플레이어 상태와는 별개입니다. 1.0은 일반 시간, 0.5는 슬로 모션입니다. |
playerState를 | enum (문자열) | 플레이어의 상태를 다음 중 하나로 설명합니다.
|
idleReason | enum (문자열) | 선택사항 playerState가 IDLE이고 IDLE가 된 이유가 알려진 경우 이 속성이 제공됩니다. 방금 시작해서 플레이어가 유휴 상태인 경우 이 속성이 제공되지 않습니다. 플레이어가 다른 상태에 있는 경우 이 속성을 제공하면 안 됩니다. 다음 값이 적용됩니다.
|
현재 시간 | double | 콘텐츠가 시작된 이후의 미디어 플레이어의 현재 위치(초)입니다. 실시간 스트림 콘텐츠인 경우 이 필드는 이벤트가 시작되어야 플레이어에게 알려져야 하는 시간(초)을 나타냅니다. |
supportedMediaCommands)를 지원합니다. | flags | 미디어 플레이어에서 지원하는 미디어 명령어를 설명하는 플래그:
조합은 합계로 설명됩니다(예: 일시중지+탐색+스트림볼륨+음소거 == 15). |
볼륨 | 볼륨 | 스트림 볼륨 |
맞춤 데이터 | 객체 | 선택사항 수신자 애플리케이션이 정의한 데이터의 애플리케이션 blob |
보내는 사람에서 받는 사람까지 명령어
이 명령어는 미디어 플레이어를 제어합니다. 아래 메시지의 모든 customData 객체는 선택사항이어야 합니다. 즉, 데이터가 전달되지 않으면 수신기가 제대로 성능이 저하되어야 합니다. 이렇게 하면 일반 리모컨 앱이 제대로 작동할 수 있습니다.
로드
미디어 플레이어에 새 콘텐츠를 로드합니다.
이름 | 유형 | 설명 |
---|---|---|
요청 ID | 정수 | 요청 및 응답의 상관관계를 파악하기 위한 요청의 ID |
유형 | 문자열 | LOAD(값만) |
media | 미디어 정보 | 로드할 미디어의 메타데이터 (contentId 포함) |
자동재생 | boolean | 선택사항(기본값: true) 자동재생 매개변수가 지정되면 미디어 플레이어가 로드될 때 콘텐츠 재생을 시작합니다. 자동재생이 지정되지 않은 경우에도 미디어 플레이어 구현에서 재생을 즉시 시작하도록 선택할 수 있습니다. 재생이 시작되면 응답에 있는 플레이어 상태가 BUFFERING으로 설정되어야 하며, 그렇지 않으면 PAUSE로 설정되어야 합니다. |
현재 시간 | double | 선택사항: 콘텐츠 시작 후 경과된 시간(초)입니다. 콘텐츠가 실시간 콘텐츠이고 위치가 지정되지 않은 경우 스트림이 실시간 위치에서 시작됩니다. |
맞춤 데이터 | 객체 | 선택사항 발신자 애플리케이션에서 정의한 애플리케이션의 blob |
응답 | 트리거 | 브로드캐스트 | 오류 |
---|---|---|---|
없음 | 수신기 상태 변경 | 미디어 상태 변경 메시지 | 잘못된 플레이어 상태 로드 실패 로드 취소됨 |
일시중지
현재 콘텐츠의 재생을 일시중지합니다. 모든 발신기 애플리케이션에 STATUS 이벤트 알림을 트리거합니다.
이름 | 유형 | 설명 |
---|---|---|
mediaSessionId | 정수 | 일시중지할 미디어 세션의 ID |
요청 ID | 정수 | 요청/응답을 연결하는 데 사용할 요청의 ID |
유형 | 문자열 | PAUSE(값만) |
맞춤 데이터 | 객체 | 선택사항 발신자 애플리케이션에서 정의한 애플리케이션의 blob |
응답 | 트리거 | 브로드캐스트 | 오류 |
---|---|---|---|
없음 | 수신기 상태 변경 | 미디어 상태 변경 메시지 | 잘못된 플레이어 상태 |
탐색
스트림의 현재 위치를 설정합니다. 모든 발신기 애플리케이션에 STATUS 이벤트 알림을 트리거합니다. 제공된 위치가 현재 콘텐츠의 유효한 게재순위 범위를 벗어나는 경우 플레이어는 요청된 게재순위에 최대한 근접한 유효한 위치를 선택해야 합니다.
이름 | 유형 | 설명 |
---|---|---|
mediaSessionId | 정수 | 스트림 위치가 설정된 미디어 세션의 ID |
요청 ID | 정수 | 요청 및 응답의 상관관계를 파악하기 위한 요청의 ID |
유형 | 문자열 | SEEK(값만) |
ResumeState | enum (문자열) | 선택사항 이 값을 설정하지 않으면 재생 상태가 변경되지 않으며 다음 값이 적용됩니다.
|
현재 시간 | double | 선택사항: 콘텐츠 시작 후 경과된 시간(초)입니다. 콘텐츠가 실시간 콘텐츠이고 위치가 지정되지 않은 경우 스트림이 실시간 위치에서 시작됩니다. |
맞춤 데이터 | 객체 | 선택사항 발신자 애플리케이션에서 정의한 애플리케이션의 blob |
응답 | 트리거 | 브로드캐스트 | 오류 |
---|---|---|---|
없음 | 수신기 상태 변경 | 미디어 상태 변경 메시지 | 잘못된 플레이어 상태 |
중지
현재 콘텐츠 재생을 중지합니다. 모든 발신기 애플리케이션에 STATUS 이벤트 알림을 트리거합니다. 이 명령어 다음에 콘텐츠가 더 이상 로드되지 않고 mediaSessionId가 무효화됩니다.
이름 | 유형 | 설명 |
---|---|---|
mediaSessionId | 정수 | 중지할 콘텐츠의 미디어 세션 ID |
요청 ID | 정수 | 요청 및 응답의 상관관계를 파악하기 위한 요청의 ID |
유형 | 문자열 | STOP(값만) |
맞춤 데이터 | 객체 | 선택사항 발신자 애플리케이션에서 정의한 애플리케이션의 blob |
응답 | 트리거 | 브로드캐스트 | 오류 |
---|---|---|---|
없음 | 수신기 상태 변경 | 미디어 상태 변경 메시지 | 잘못된 플레이어 상태 |
재생
load 호출로 로드된 콘텐츠의 재생을 시작하고 현재 시간 위치에서 재생을 계속합니다.
이름 | 유형 | 설명 |
---|---|---|
mediaSessionId | 정수 | 재생될 콘텐츠의 미디어 세션 ID |
요청 ID | 정수 | 요청 및 응답의 상관관계를 파악하기 위한 요청의 ID |
유형 | 문자열 | PLAY(값만) |
맞춤 데이터 | 객체 | 선택사항 발신자 애플리케이션에서 정의한 애플리케이션의 blob |
응답 | 트리거 | 브로드캐스트 | 오류 |
---|---|---|---|
없음 | 수신기 상태 변경 | 미디어 상태 변경 메시지 | 잘못된 플레이어 상태 |
상태 가져오기
미디어 상태를 검색합니다.
이름 | 유형 | 설명 |
---|---|---|
mediaSessionId | 정수 | 선택사항 미디어 상태를 반환해야 하는 미디어의 미디어 세션 ID입니다. 아무것도 입력하지 않으면 모든 미디어 세션 ID의 상태가 제공됩니다. |
요청 ID | 정수 | 요청 및 응답의 상관관계를 파악하기 위한 요청의 ID |
유형 | 문자열 | GET_STATUS(값만) |
맞춤 데이터 | 객체 | 선택사항 발신자 애플리케이션에서 정의한 애플리케이션의 blob |
응답 | 트리거 | 브로드캐스트 | 오류 |
---|---|---|---|
메시지를 요청한 발신자에게 MediaStatus 메시지 | 없음 | 없음 | 없음 |
볼륨 설정
미디어 스트림 볼륨을 설정합니다. 미디어 스트림의 페이드 인/페이드 아웃 효과에 사용됩니다. (참고: 수신기 볼륨은 웹 발신자 setVolume을 사용하여 변경됩니다.) 기기 볼륨을 제어하는 볼륨 볼륨이나 볼륨 버튼과 함께 스트림 볼륨을 사용하면 안 됩니다. 스트림 볼륨이 변경되어도 수신자의 UI는 트리거되지 않습니다.
이름 | 유형 | 설명 |
---|---|---|
mediaSessionId | 정수 | 스트림 볼륨이 변경된 미디어의 미디어 세션 ID |
요청 ID | 정수 | 요청 및 응답의 상관관계를 파악하기 위한 요청의 ID |
유형 | 문자열 | VOLUME(값만) |
볼륨 | 볼륨 | 스트림 볼륨 |
맞춤 데이터 | 객체 | 선택사항 발신자 애플리케이션에서 정의한 애플리케이션의 blob |
응답 | 트리거 | 브로드캐스트 | 오류 |
---|---|---|---|
없음 | 수신기 상태 변경 | 미디어 상태 변경 메시지 | 잘못된 플레이어 상태 |
수신자에서 발신자로 전송된 메시지
수신자는 다음 두 가지 유형의 메시지를 전송합니다.
- 오류: 발신자 요청에 대한 오류 응답이 있을 때 전송된 Unicast 메시지입니다.
- 상태: 방송 메시지
- 발신자가 시작한 작업의 결과입니다. 변경을 유발한 요청의 requestId를 포함합니다.
- 자발적: 예를 들면 수신기 애플리케이션에 의해 트리거된 변경사항입니다. RequestId는 0입니다.
오류: 잘못된 플레이어 상태
플레이어가 유효한 상태가 아니기 때문에 발신자의 요청을 처리할 수 없을 때 전송됩니다. 애플리케이션이 미디어 요소를 아직 만들지 않은 경우를 예로 들 수 있습니다.
이름 | 유형 | 설명 |
---|---|---|
요청 ID | 정수 | 이 오류를 생성한 요청의 ID |
유형 | 문자열 | INVALID_Player_STATE(값만) |
맞춤 데이터 | 객체 | 선택사항 수신자 애플리케이션이 정의한 데이터의 애플리케이션 blob |
오류: 로드 실패
로드 요청이 실패하면 전송됩니다. 플레이어 상태가 유휴 상태입니다.
이름 | 유형 | 설명 |
---|---|---|
요청 ID | 정수 | 이 오류를 생성한 요청의 ID |
유형 | 문자열 | LOAD_FAILED(값만) |
맞춤 데이터 | 객체 | 선택사항 수신자 애플리케이션이 정의한 데이터의 애플리케이션 blob |
오류: 로드 취소됨
로드 요청이 취소되면 전송됩니다 (두 번째 로드 요청이 수신됨).
이름 | 유형 | 설명 |
---|---|---|
요청 ID | 정수 | 이 오류를 생성한 요청의 ID |
유형 | 문자열 | LOAD_CANCELLED(값만) |
맞춤 데이터 | 객체 | 선택사항 수신자 애플리케이션이 정의한 데이터의 애플리케이션 blob |
오류: 잘못된 요청
요청이 잘못된 경우 전송됩니다 (예: 알 수 없는 요청 유형).
이름 | 유형 | 설명 |
---|---|---|
요청 ID | 정수 | 이 오류를 생성한 요청의 ID |
유형 | 문자열 | INVALID_REQUEST(값만) |
이유 | enum (문자열) | 값:
|
맞춤 데이터 | 객체 | 선택사항 수신자 애플리케이션이 정의한 데이터의 애플리케이션 blob |
미디어 상태
상태 변경 후 또는 미디어 상태 요청 후 전송됩니다. 변경되거나 요청된 MediaStatus 객체만 전송됩니다.
이름 | 유형 | 설명 |
---|---|---|
요청 ID | 정수 | 이 상태 응답을 처음 보낸 요청과 연결하는 데 사용되는 ID 또는 상태 메시지가 자연스러운 경우 (발신자 요청에 의해 트리거되지 않은 경우) 0 발신자 애플리케이션은 랜덤 숫자를 선택하고 지속적으로 늘려 고유 요청 ID를 생성합니다 (0은 사용하지 않음). |
유형 | 문자열 | MEDIA_STATUS(값만) |
상태 | MediaStatus[] | 미디어 상태 객체의 배열입니다. 참고: MediaStatus의 미디어 요소는 변경된 경우에만 반환됩니다. |
맞춤 데이터 | 객체 | 선택사항 수신자 애플리케이션이 정의한 데이터의 애플리케이션 blob |