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