cast.
미디어 이벤트 대기열 INSERT 요청 데이터입니다.
생성자
QueueInsertRequestData
새 QueueInsertRequestData(items)
매개변수 |
|
|---|---|
|
items |
null이 아닌 cast.framework.messages.QueueItem의 배열 큐 항목 목록입니다. 항목의 itemId 필드가 비어 있어야 합니다. 그렇지 않으면 요청이 INVALID_PARAMS 오류와 함께 실패합니다. 정렬됩니다 (첫 번째 요소가 먼저 재생됩니다). 값은 null이 아니어야 합니다. |
속성
currentItemId
(숫자 또는 정의되지 않음)
삽입 후 현재 미디어 항목의 ID입니다. 제공하지 않으면 currentItem 값은 삽입 전과 동일합니다.
currentItemIndex
(숫자 또는 정의되지 않음)
새로운 현재 미디어 항목의 색인 (항목 배열을 기준으로 0부터 시작) 삽입된 항목의 경우 currentItemId가 아닌 색인 (QUEUE_LOAD의 startIndex와 유사)을 사용합니다. 항목을 삽입할 때까지 itemId를 알 수 없기 때문입니다. 제공하지 않으면 currentItem 값은 삽입 전과 동일합니다 (currentItemId가 제공되지 않은 경우). 이 매개변수를 사용하면 원자적 특성을 항목 삽입 및 재생의 일반적인 사용 사례로 만들 수 있습니다.
currentTime
(숫자 또는 정의되지 않음)
콘텐츠 시작 후 현재 항목의 재생을 시작한 후 경과된 시간(초)입니다. 제공되는 경우 이 값은 QueueItem 수준에서 제공된 startTime 값보다 우선하지만 항목이 처음 재생될 때만 적용됩니다. 이는 QueueItem startTime처럼 사용자가 항목의 중간으로 이동하는 일반적인 사례를 다루므로 currentTime이 항목에 영구적으로 적용되지 않습니다. startTime을 동적으로 재설정할 필요가 없습니다 (휴대전화가 절전 모드로 전환된 경우에는 불가능할 수 있음).
customData
(null이 아닌 객체 또는 정의되지 않음)
이 요청에 대한 애플리케이션별 데이터입니다. 이를 통해 발신자와 수신자는 맞춤 메시지에 새 네임스페이스를 사용하지 않고도 미디어 프로토콜을 쉽게 확장할 수 있습니다.
insertBefore
(숫자 또는 정의되지 않음)
삽입된 목록 바로 뒤에 위치할 상품의 ID입니다. ID를 찾을 수 없거나 ID가 제공되지 않으면 목록이 기존 목록의 끝에 추가됩니다.
items
null이 아닌 cast.framework.messages.QueueItem의 null이 아닌 배열
큐 항목 목록입니다. 항목의 itemId 필드는 비어 있어야 합니다. 정렬됩니다 (첫 번째 요소가 먼저 재생됨).
mediaSessionId
(숫자 또는 정의되지 않음)
요청이 적용되는 미디어 세션의 ID입니다.
requestId
숫자
요청 ID로, 요청/응답의 상관관계를 지정하는 데 사용됩니다.
sequenceNumber
(숫자 또는 정의되지 않음)
모든 큐 명령어를 동기화하는 숫자 큐 명령어에 제공된 경우 SDK는 큐의 최신 시퀀스 번호가 요청과 일치하는지 확인합니다. 현재 시퀀스는 발신 큐 변경 메시지의 일부로 제공됩니다.