미디어 재생 메시지

Google Cast 전송자 애플리케이션은 수신기 애플리케이션에 JSON 형식으로 메시지를 전송하여 수신기 기기에서 재생을 제어합니다. 마찬가지로 수신자는 발신자에게 메시지를 다시 보냅니다(JSON 형식). 메시지는 플레이어 상태를 변경하는 발신자의 명령어, 수신자의 명령어에 대한 응답 또는 수신자 애플리케이션의 미디어를 설명하는 데이터 구조일 수 있습니다.

Google Cast SDK 추가 개발자 서비스 약관에 따라 Cast 미디어 애플리케이션은 여기에 정의된 메시지를 사용하여 수신기에서 미디어 재생을 제어해야 합니다. 이렇게 하면 미디어 앱에 플랫폼 전반에서 일관된 사용자 환경이 제공되고 Cast 애플리케이션이 새 사용 사례와 향후 사용 사례를 지원할 수 있습니다. 이러한 구조는 적절한 경우 맞춤 데이터도 지원하며 애플리케이션은 SDK에서 지원하지 않는 명령어에 대한 자체 메시지를 정의할 수 있습니다.

미디어 재생 메시지의 네임스페이스는 urn:x-cast:com.google.cast.media로 정의됩니다.

참고: 이 사양의 메시지와 구조에는 전송 메시지의 최대 크기에 따라 결정되는 암시적 최대 크기가 있으며 개별 필드에는 제한이 없습니다. 전송 메시지의 최대 크기는 현재 64KB입니다.

일반적인 네임스페이스 데이터 구조

모든 미디어 네임스페이스 아티팩트에서 사용하는 데이터 구조의 상위 집합은 공통 네임스페이스에 정의되어 있습니다.

이미지

이는 이미지를 렌더링하는 방식에 따라 발신자 애플리케이션이 이미지를 선택할 수 있도록 하는 소량의 메타데이터를 포함한 이미지 설명입니다.

높이와 너비는 이미지 배열의 항목 하나에서만 선택사항입니다. 예를 들어 반환된 항목이 하나인 경우 선택사항입니다. 반환된 항목이 두 개인 경우 한 항목은 높이와 너비를 지정해야 하지만, 특정 매개변수와 함께 전달된 항목이 마음에 들지 않으면 '기본' 옵션을 선택할 수 있습니다.

이름 유형 설명
url URI 이미지의 URI
height 정수 선택사항 이미지의 높이
width 정수 선택사항  이미지의 너비

볼륨

미디어 스트림 볼륨입니다. 미디어 스트림의 페이드 인/페이드 아웃 효과에 사용됩니다. (참고: 시스템 볼륨은 발신자 API를 사용하여 변경됩니다.) 스트림 볼륨은 볼륨 슬라이더 또는 볼륨 버튼과 함께 사용하여 기기 볼륨을 제어하면 안 됩니다. 스트림 볼륨을 변경하려면 다음 매개변수 중 하나 이상을 전달해야 합니다.

이름 유형 설명
level double 선택사항 현재 스트림 볼륨 수준입니다. 0.0~1.0 사이의 값으로, 1.0은 최대 볼륨입니다.
음소거됨 부울 선택사항 볼륨 수준과 관계없이 Cast 기기가 음소거되었는지 여부

미디어 네임스페이스 데이터 구조

이러한 메시지는 미디어 플레이어의 상태를 설명합니다. 네임스페이스는 urn:x-cast:com.google.cast.media입니다.

MediaInformation

이 데이터 구조는 미디어 스트림을 설명합니다.

이름 유형 설명
contentId 문자열 미디어 플레이어에서 현재 로드된 콘텐츠의 서비스별 식별자입니다. 이는 자유 형식 문자열이며 애플리케이션에 따라 다릅니다. 대부분의 경우 미디어의 URL이지만, 수신자가 올바르게 해석할 수 있는 문자열을 전송자가 선택할 수 있습니다. 최대 길이: 1,000
streamType enum
(문자열)

미디어 아티팩트의 유형을 다음 중 하나로 설명합니다.

  • NONE
  • BUFFERED
  • 라이브
contentType 문자열 재생 중인 미디어의 MIME 콘텐츠 유형
메타데이터 객체

선택사항 미디어 메타데이터 객체입니다. 다음 중 하나입니다.

duration double 선택사항 현재 재생 중인 스트림의 시간(초)
customData 객체 선택사항 발신자 애플리케이션 또는 수신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob

GenericMediaMetadata

일반 미디어 아티팩트를 설명합니다.

이름 유형 설명
metadataType 정수 0  (유일한 값)
title 문자열 선택사항 콘텐츠의 설명 제목입니다. 플레이어는 content_id를 사용하여 제목을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.
subtitle 문자열 선택사항 콘텐츠의 설명이 포함된 부제목입니다. 플레이어는 content_id를 사용하여 제목을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.
images 이미지[] 선택사항 콘텐츠와 연결된 이미지의 URL 배열입니다. 필드의 초기 값은 송신자가 Load 메시지에서 제공할 수 있습니다. 권장 크기를 제공해야 합니다.
releaseDate 문자열 (ISO 8601) 선택사항 이 콘텐츠가 출시된 ISO 8601 날짜 및 시간입니다. 플레이어는 content_id를 사용하여 제목을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.

MovieMediaMetadata

영화 미디어 아티팩트를 설명합니다.

이름 유형 설명
metadataType 정수 1  (유일한 값)
title 문자열 선택사항 콘텐츠의 설명 제목입니다. 플레이어는 content_id를 사용하여 제목을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.
subtitle 문자열 선택사항 콘텐츠의 설명이 포함된 부제목입니다. 플레이어는 content_id를 사용하여 제목을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.
studio 문자열 콘텐츠를 출시한 선택사항  스튜디오입니다. 플레이어는 content_id를 사용하여 스튜디오를 독립적으로 가져올 수 있으며, 로드 메시지에서 발신자가 제공할 수도 있습니다.
images 이미지[] 선택사항 콘텐츠와 연결된 이미지의 URL 배열입니다. 필드의 초기 값은 송신자가 Load 메시지에서 제공할 수 있습니다. 권장 크기를 제공해야 합니다.
releaseDate 문자열 (ISO 8601) 선택사항 이 콘텐츠가 출시된 ISO 8601 날짜 및 시간입니다. 플레이어는 content_id를 사용하여 제목을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.

TvShowMediaMetadata

TV 프로그램 에피소드 미디어 아티팩트를 설명합니다.

이름 유형 설명
metadataType 정수 2  (유일한 값)
seriesTitle 문자열 선택사항  TV 시리즈의 설명 제목입니다. 플레이어는 content_id를 사용하여 제목을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.
subtitle 문자열 선택사항  TV 에피소드의 설명이 포함된 부제목입니다. 플레이어는 content_id를 사용하여 제목을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.
season 정수 선택사항 TV 프로그램의 시즌 번호
episode 정수 선택사항 TV 프로그램의 에피소드 번호 (시즌 내)
images 이미지[] 선택사항 콘텐츠와 연결된 이미지의 URL 배열입니다. 필드의 초기 값은 송신자가 Load 메시지에서 제공할 수 있습니다. 권장 크기를 제공해야 합니다.
originalAirDate 문자열 (ISO 8601) 선택사항 이 에피소드가 출시된 ISO 8601 날짜 및 시간입니다. 플레이어는 content_id를 사용하여 originalAirDate를 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.

MusicTrackMediaMetadata

음악 트랙 미디어 아티팩트를 설명합니다.

이름 유형 설명
metadataType 정수 3  (유일한 값)
albumName 문자열 선택사항 이 트랙이 추출된 앨범 또는 컬렉션입니다. 플레이어는 content_id를 사용하여 albumName을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.
title 문자열 선택사항 트랙 이름 (예: 노래 제목) 플레이어는 content_id를 사용하여 제목을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.
albumArtist 문자열 선택사항 이 트랙이 수록된 앨범과 연결된 아티스트의 이름입니다. 플레이어는 content_id를 사용하여 albumArtist를 독립적으로 가져올 수 있으며, 발신자가 Load 메시지에서 제공할 수도 있습니다.
artist 문자열 선택사항  미디어 트랙과 연결된 아티스트의 이름입니다. 플레이어는 content_id를 사용하여 아티스트를 독립적으로 가져올 수 있으며, 로드 메시지에서 발신자가 제공할 수도 있습니다.
composer 문자열 선택사항 미디어 트랙과 연결된 작곡가의 이름입니다. 플레이어는 content_id를 사용하여 컴포저를 독립적으로 가져올 수 있으며, 로드 메시지에서 발신자가 제공할 수도 있습니다.
trackNumber 정수 선택사항  앨범의 트랙 번호
discNumber 정수 선택사항 앨범의 볼륨 (예: 디스크) 번호
images 이미지[] 선택사항 콘텐츠와 연결된 이미지의 URL 배열입니다. 필드의 초기 값은 송신자가 Load 메시지에서 제공할 수 있습니다. 권장 크기를 제공해야 합니다.
releaseDate 문자열 (ISO 8601) 선택사항 이 콘텐츠가 출시된 ISO 8601 날짜 및 시간입니다. 플레이어는 content_id를 사용하여 releaseDate를 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.

PhotoMediaMetadata

사진 미디어 아티팩트를 설명합니다.

이름 유형 설명
metadataType 정수 4  (유일한 값)
title 문자열 선택사항 사진의 제목입니다. 플레이어는 content_id를 사용하여 제목을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.
artist 문자열 선택사항 사진작가의 이름입니다. 플레이어는 content_id를 사용하여 아티스트를 독립적으로 가져올 수 있으며, 로드 메시지에서 발신자가 제공할 수도 있습니다.
location 문자열 선택사항 사진을 촬영한 위치를 말로 표현한 것입니다(예: '스페인 마드리드'). 플레이어는 content_id를 사용하여 위치를 독립적으로 가져올 수 있으며, 발신자가 Load 메시지에서 위치를 제공할 수도 있습니다.
latitude double 선택사항  사진이 촬영된 위치의 지리적 위도 값입니다. 플레이어는 content_id를 사용하여 위도를 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 위도를 제공할 수도 있습니다.
longitude double 선택사항 사진이 촬영된 위치의 지리적 경도 값입니다. 플레이어는 content_id를 사용하여 위도를 독립적으로 가져올 수 있으며, 발신자가 Load 메시지에서 위도를 제공할 수도 있습니다.
width 정수 선택사항 사진의 너비(픽셀)입니다. 플레이어는 content_id를 사용하여 너비를 독립적으로 가져올 수 있으며, Load 메시지에서 전송자가 너비를 제공할 수도 있습니다.
height 정수 선택사항 사진의 높이(픽셀)입니다. 플레이어는 content_id를 사용하여 높이를 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 높이를 제공할 수도 있습니다.
creationDateTime 문자열 (ISO 8601) 선택사항 이 사진을 촬영한 ISO 8601 날짜 및 시간입니다. 플레이어는 content_id를 사용하여 creationDateTime을 독립적으로 가져올 수 있으며, Load 메시지에서 발신자가 제공할 수도 있습니다.

MediaStatus

세션과 관련된 미디어 아티팩트의 현재 상태를 설명합니다.

이름 유형 설명
mediaSessionId 정수 이 특정 세션의 재생을 위한 고유 ID입니다. 이 ID는 로드 시 수신기에 의해 설정되며 재생의 특정 인스턴스를 식별하는 데 사용할 수 있습니다. 예를 들어 동일한 세션 내에서 'Wish you were here'을 두 번 재생하면 각각 고유한 mediaSessionId가 있습니다.
media MediaInformation 선택사항 (상태 메시지의 경우) 재생 중인 콘텐츠의 전체 설명입니다. MediaInformation이 변경된 경우에만 상태 메시지로 반환됩니다.
playbackRate float 미디어 시간이 진행되는지 여부와 진행 속도를 나타냅니다. 미디어 시간은 어떤 상태에서도 중지될 수 있으므로 플레이어 상태와는 독립적입니다. 1.0은 일반 속도, 0.5는 슬로 모션
playerState enum (문자열)

플레이어의 상태를 다음 중 하나로 설명합니다.

  • IDLE  플레이어가 아직 로드되지 않았습니다.
  • 재생 중  플레이어가 콘텐츠를 적극적으로 재생하고 있습니다.
  • 버퍼링  플레이어가 재생 모드이지만 콘텐츠를 적극적으로 재생하지 않습니다 (currentTime이 변경되지 않음).
  • 일시중지됨  플레이어가 일시중지됨
idleReason enum (문자열)

선택사항  playerState가 IDLE이고 IDLE이 된 이유를 알 수 있는 경우 이 속성이 제공됩니다. 플레이어가 방금 시작되어 IDLE 상태인 경우 이 속성이 제공되지 않습니다. 플레이어가 다른 상태인 경우 이 속성이 제공되면 안 됩니다. 다음 값이 적용됩니다.

  • 취소됨  발신자가 STOP 명령어를 사용하여 재생 중지를 요청함
  • 인터럽트됨  발신자가 LOAD 명령어를 사용하여 다른 미디어 재생을 요청했습니다.
  • FINISHED  미디어 재생이 완료됨
  • ERROR  오류로 인해 미디어가 중단되었습니다. 예를 들어 플레이어가 네트워크 문제로 인해 미디어를 다운로드할 수 없는 경우입니다.
currentTime double 콘텐츠 시작 이후 미디어 플레이어의 현재 위치(초)입니다. 라이브 스트림 콘텐츠인 경우 이 필드는 플레이어가 알아야 하는 이벤트 시작부터의 시간을 초 단위로 나타냅니다.
supportedMediaCommands flags

미디어 플레이어가 지원하는 미디어 명령어를 설명하는 플래그:

  • 1 << 0  일시중지
  • 1 << 1  탐색
  • 1 << 2  스트림 볼륨
  • 1 << 3  스트림 음소거
  • 1 << 4  앞으로 건너뛰기 (지원 중단됨)
  • 1 << 5  뒤로 건너뛰기 (지원 중단됨)
  • 1 << 6  다음 항목 대기열에 추가
  • 1 << 7  이전 곡 대기열에 추가
  • 1 << 8  대기열 셔플
  • 1 << 9  광고 건너뛰기
  • 1 << 10  모두 반복 대기열에 추가
  • 1 << 11  한 곡 반복 대기열에 추가
  • 1 << 12  트랙 수정
  • 1 << 13  재생 속도
  • 1 << 14  좋아요
  • 1 << 15  싫어요
  • 1 << 16  팔로우
  • 1 << 17  팔로우 해제

조합은 합계로 설명됩니다(예: Pause+Seek+StreamVolume+Mute == 15).

볼륨 볼륨 스트림 볼륨
customData 객체 선택사항 수신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob

발신자에서 수신자로 전송되는 명령어

이 명령어는 미디어 플레이어를 제어합니다. 아래 메시지의 모든 customData 객체는 선택사항이어야 합니다 (즉, 데이터가 전달되지 않으면 수신자가 적절하게 다운그레이드되어야 함). 이렇게 하면 일반적인 리모컨 앱이 제대로 작동합니다.

로드

미디어 플레이어에 새 콘텐츠를 로드합니다.

이름 유형 설명
requestId 정수 요청과 응답을 연결하는 요청 ID
type 문자열 LOAD (값만 해당)
media MediaInformation 로드할 미디어의 메타데이터 (contentId 포함)
autoplay 부울

선택사항 (기본값은 true) 자동재생 매개변수가 지정되면 미디어 플레이어가 콘텐츠가 로드될 때 재생을 시작합니다. 자동 재생이 지정되지 않은 경우에도 미디어 플레이어 구현은 즉시 재생을 시작할 수 있습니다. 재생이 시작되면 응답의 플레이어 상태가 BUFFERING으로 설정되어야 하고, 그렇지 않으면 PAUSED로 설정되어야 합니다.

currentTime double 선택사항 콘텐츠가 시작된 후 경과된 시간(초)입니다. 콘텐츠가 라이브 콘텐츠이고 위치가 지정되지 않은 경우 스트림이 라이브 위치에서 시작됩니다.
customData 객체 선택사항 발신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob
응답 트리거 브로드캐스트 오류
없음 수신기 상태 변경 미디어 상태 변경 메시지 잘못된 플레이어 상태
로드 실패
로드 취소됨

일시중지

현재 콘텐츠의 재생을 일시중지합니다. 모든 발신자 애플리케이션에 STATUS 이벤트 알림을 트리거합니다.

이름 유형 설명
mediaSessionId 정수 일시중지할 미디어 세션의 ID
requestId 정수 요청/응답을 연결하는 데 사용할 요청 ID
type 문자열 PAUSE (유일한 값)
customData 객체 선택사항 발신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob
응답 트리거 브로드캐스트 오류
없음 수신기 상태 변경 미디어 상태 변경 메시지 잘못된 플레이어 상태

탐색

스트림의 현재 위치를 설정합니다. 모든 발신자 애플리케이션에 STATUS 이벤트 알림을 트리거합니다. 제공된 위치가 현재 콘텐츠의 유효한 위치 범위를 벗어나는 경우 플레이어는 요청된 위치에 최대한 가까운 유효한 위치를 선택해야 합니다.

이름 유형 설명
mediaSessionId 정수 스트림의 위치가 설정된 미디어 세션의 ID
requestId 정수 요청과 응답을 연결하는 요청 ID
type 문자열 SEEK (값만)
resumeState enum (문자열)

선택사항 이 값이 설정되지 않으면 재생 상태가 변경되지 않습니다. 다음 값이 적용됩니다.

  • PLAYBACK_START  미디어가 시작되도록 강제합니다.
  • PLAYBACK_PAUSE  미디어를 강제로 일시중지합니다.
currentTime double 선택사항 콘텐츠가 시작된 후 경과된 시간(초)입니다. 콘텐츠가 라이브 콘텐츠이고 위치가 지정되지 않은 경우 스트림이 라이브 위치에서 시작됩니다.
customData 객체 선택사항 발신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob
응답 트리거 브로드캐스트 오류
없음 수신기 상태 변경 미디어 상태 변경 메시지 잘못된 플레이어 상태

중지

현재 콘텐츠의 재생을 중지합니다. 모든 발신자 애플리케이션에 STATUS 이벤트 알림을 트리거합니다. 이 명령어가 실행된 후에는 콘텐츠가 더 이상 로드되지 않으며 mediaSessionId가 무효화됩니다.

이름 유형 설명
mediaSessionId 정수 중지할 콘텐츠의 미디어 세션 ID
requestId 정수 요청과 응답을 연결하는 요청 ID
type 문자열 STOP (값만 해당)
customData 객체 선택사항 발신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob
응답 트리거 브로드캐스트 오류
없음 수신기 상태 변경 미디어 상태 변경 메시지 잘못된 플레이어 상태

재생

로드 호출로 로드된 콘텐츠의 재생을 시작합니다. 재생은 현재 시간 위치에서 계속됩니다.

이름 유형 설명
mediaSessionId 정수 재생할 콘텐츠의 미디어 세션 ID
requestId 정수 요청과 응답을 연결하는 요청 ID
type 문자열 PLAY (값만 해당)
customData 객체 선택사항 발신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob
응답 트리거 브로드캐스트 오류
없음 수신기 상태 변경 미디어 상태 변경 메시지 잘못된 플레이어 상태

상태 가져오기

미디어 상태를 가져옵니다.

이름 유형 설명
mediaSessionId 정수 선택사항 미디어 상태를 반환해야 하는 미디어의 미디어 세션 ID입니다. 제공되지 않으면 모든 미디어 세션 ID의 상태가 제공됩니다.
requestId 정수 요청과 응답을 연결하는 요청 ID
type 문자열 GET_STATUS (값만 해당)
customData 객체 선택사항 발신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob
응답 트리거 브로드캐스트 오류
요청한 발신자에게 MediaStatus 메시지 없음 없음 없음

SetVolume

미디어 스트림 볼륨을 설정합니다. 미디어 스트림의 페이드 인/페이드 아웃 효과에 사용됩니다. (참고: 수신기 볼륨은 웹 전송기 setVolume을 사용하여 변경됩니다.) 스트림 볼륨은 볼륨 슬라이더 또는 볼륨 버튼과 함께 사용하여 기기 볼륨을 제어하면 안 됩니다. 스트림 볼륨이 변경되어도 수신기의 UI는 트리거되지 않습니다.

이름 유형 설명
mediaSessionId 정수 스트림 볼륨이 변경된 미디어의 미디어 세션 ID
requestId 정수 요청과 응답을 연결하는 요청 ID
type 문자열 볼륨 (값만 해당)
볼륨 볼륨 스트림 볼륨
customData 객체 선택사항 발신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob
응답 트리거 브로드캐스트 오류
없음 수신기 상태 변경 미디어 상태 변경 메시지 잘못된 플레이어 상태

수신자가 발신자에게 보낸 메시지

수신자는 두 가지 유형의 메시지를 전송합니다.

  • 오류: 보내는 사람 요청에 대한 오류 응답이 있을 때 전송되는 유니캐스트 메시지입니다.
  • 상태: 메시지를 방송하세요.
    • 발신자가 시작한 작업의 결과입니다. 변경을 유발한 요청의 requestId를 포함합니다.
    • 자발적: 예를 들어 수신기 애플리케이션에서 트리거된 변경으로 인해 RequestId는 0이 됩니다.

오류: 잘못된 플레이어 상태

플레이어가 유효한 상태가 아니므로 발신자의 요청을 처리할 수 없는 경우 전송됩니다. 예를 들어 애플리케이션에서 아직 미디어 요소를 만들지 않은 경우입니다.

이름 유형 설명
requestId 정수 이 오류를 생성한 요청의 ID
type 문자열 INVALID_PLAYER_STATE (단일 값)
customData 객체 선택사항 수신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob

오류: 로드 실패

로드 요청이 실패하면 전송됩니다. 플레이어 상태는 IDLE이 됩니다.

이름 유형 설명
requestId 정수 이 오류를 생성한 요청의 ID
type 문자열 LOAD_FAILED (유일한 값)
customData 객체 선택사항 수신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob

오류: 로드 취소됨

로드 요청이 취소된 경우 전송됩니다 (두 번째 로드 요청이 수신됨).

이름 유형 설명
requestId 정수 이 오류를 생성한 요청의 ID
type 문자열 LOAD_CANCELLED (유일한 값)
customData 객체 선택사항 수신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob

오류: 잘못된 요청

요청이 잘못된 경우 (예: 알 수 없는 요청 유형) 전송됩니다.

이름 유형 설명
requestId 정수 이 오류를 생성한 요청의 ID
type 문자열 INVALID_REQUEST (값만 해당)
reason 열거형 (문자열)

값:

  • INVALID_COMMAND  명령어가 지원되지 않습니다.
  • DUPLICATE_REQUESTID  요청 ID가 고유하지 않습니다 (수신자가 동일한 ID의 요청을 처리하고 있음).
customData 객체 선택사항 수신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob

미디어 상태

상태 변경 후 또는 미디어 상태 요청 후에 전송됩니다. 변경되었거나 요청된 MediaStatus 객체만 전송됩니다.

이름 유형 설명
requestId 정수 이 상태 응답을 시작된 요청과 연결하는 데 사용되는 ID입니다. 상태 메시지가 자발적인 경우 (발신자 요청에 의해 트리거되지 않음) 0입니다. 발신자 애플리케이션은 난수를 선택하고 이를 지속적으로 늘려 고유 요청 ID를 생성합니다 (0은 사용하지 않음).
type 문자열 MEDIA_STATUS (단일 값)
상태 MediaStatus[] 미디어 상태 객체의 배열입니다. 참고: MediaStatus의 미디어 요소는 변경된 경우에만 반환됩니다.
customData 객체 선택사항 수신자 애플리케이션에서 정의한 애플리케이션별 데이터 blob