큐

Cast 프레임워크는 동영상 또는 오디오 스트림과 같은 MediaInfo 인스턴스에서 빌드하여 수신기에서 순차적으로 재생할 수 있는 MediaQueueItem 인스턴스 목록 생성을 지원하는 현재 재생목록 클래스를 제공합니다. 이 콘텐츠 항목의 현재 재생목록은 수정, 재정렬, 업데이트 등을 할 수 있습니다.

Receiver SDK는 현재 활성 상태 (재생 중 또는 일시중지됨)인 항목이 하나 이상 있는 경우 재생목록을 유지하고 재생목록의 작업에 응답합니다. 발신자는 세션에 참여하여 대기열에 항목을 추가할 수 있습니다. 수신기는 마지막 항목의 재생이 완료되거나, 발신자가 재생을 중지하고 세션을 종료하거나, 발신자가 수신기에 새 큐를 로드할 때까지 큐 항목의 세션을 유지합니다. 수신기는 기본적으로 종료된 대기열에 관한 정보를 유지하지 않습니다. 대기열의 마지막 항목이 완료되면 미디어 세션이 종료되고 대기열이 사라집니다.

미디어 현재 재생목록 항목 만들기 및 로드

미디어 현재 재생목록 항목은 Cast 프레임워크에서 MediaQueueItem 인스턴스로 표현됩니다. 미디어 현재 재생목록 항목을 만들 때 적응형 콘텐츠와 함께 미디어 플레이어 라이브러리를 사용하는 경우, 현재 재생목록에서 앞의 항목이 재생이 끝나기 전에 플레이어가 미디어 현재 재생목록 항목의 버퍼링을 시작할 수 있도록 미리 로드 시간을 설정할 수 있습니다. 항목의 자동 재생 속성을 true로 설정하면 수신기에서 자동으로 재생할 수 있습니다. 예를 들어 다음과 같이 빌더 패턴을 사용하여 미디어 현재 재생목록 항목을 만들 수 있습니다.

Kotlin
val queueItem: MediaQueueItem = MediaQueueItem.Builder(mediaInfo)
    .setAutoplay(true)
    .setPreloadTime(20.0)
    .build()
Java
MediaQueueItem queueItem = new MediaQueueItem.Builder(mediaInfo)
  .setAutoplay(true)
  .setPreloadTime(20)
  .build();

RemoteMediaClient의 적절한 queueLoad 메서드를 사용하여 대기열에 미디어 대기열 항목 배열을 로드합니다.

미디어 대기열 상태 업데이트 받기

수신기가 미디어 대기열 항목을 로드하면 세션 기간 (및 대기열 전체 기간) 동안 유지되는 고유 ID를 항목에 할당합니다. 앱은 현재 로드 중인 항목(재생 중이 아닐 수 있음), 로드 중인 항목 또는 미리 로드된 항목의 관점에서 현재 재생목록의 상태를 파악할 수 있습니다. MediaStatus 클래스는 다음과 같은 상태 정보를 제공합니다.

  • getPreloadedItemId() 메서드 - 다음 항목이 미리 로드된 경우 미리 로드된 항목 ID를 반환합니다.
  • getLoadingItemId() 메서드 - 현재 수신기에서 로드 중이지만 대기열에서 활성 상태가 아닌 항목의 항목 ID를 반환합니다.
  • getCurrentItemId() 메서드 - 미디어 상태 변경이 발생했을 때 현재 재생 중이 아닐 수도 있는 대기열에서 활성 상태였던 항목의 항목 ID를 반환합니다.
  • getQueueItems()(지원 중단됨, 대신 MediaQueue 사용) 메서드 - 수정 불가능한 목록으로 MediaQueueItem 인스턴스 목록을 반환합니다.

앱은 MediaQueue 클래스를 사용하여 항목 목록을 가져올 수도 있습니다. 이 클래스는 미디어 대기열의 희소 데이터 모델입니다. 이는 수신기와 자동으로 동기화되는 대기열에 항목 ID 목록을 유지합니다. 대기열이 너무 길면 메모리를 너무 많이 사용하게 되므로 MediaQueue는 모든 MediaQueueItem를 유지하지 않습니다. 대신 요청 시 항목을 가져오고 최근에 액세스한 항목의 LruCache를 유지합니다. 다음 메서드를 사용하여 미디어 대기열에 액세스할 수 있습니다.

  • getItemIds() 메서드 - 모든 상품 ID 목록을 순서대로 반환합니다.
  • getItemAtIndex() 메서드 - 지정된 색인의 캐시된 항목을 반환합니다. 항목이 캐시되지 않은 경우 MediaQueue는 null를 반환하고 항목 가져오기를 예약합니다. 항목이 가져오면 MediaQueue.Callback#itemsUpdatedAtIndexes()가 호출되고 동일한 ID로 getItemAtIndex()를 다시 호출하면 항목이 반환됩니다.
  • fetchMoteItemsRelativeToIndex()는 사용자가 현재 재생목록 UI를 위 또는 아래로 스크롤하고 앱에서 클라우드에서 더 많은 항목을 가져오려는 경우에 사용됩니다.

이러한 메서드를 다른 미디어 상태 메서드와 함께 사용하여 앱에 현재 재생목록의 상태와 현재 재생목록의 항목을 알립니다. 앱은 수신기의 미디어 상태 업데이트 외에도 RemoteMediaClient.Callback 및 MediaQueue.Callback를 구현하여 현재 재생목록의 변경사항을 수신 대기할 수 있습니다.

또한 Cast SDK는 현재 재생목록을 위한 UI를 만드는 두 가지 유틸리티 클래스를 제공합니다.

예를 들어 MediaQueueRecyclerViewAdapter를 사용하여 RecyclerView를 만들려면 다음을 실행합니다.

Kotlin
class MyRecyclerViewAdapter(mediaQueue: MediaQueue?) :
    MediaQueueRecyclerViewAdapter<MyViewHolder?>(mediaQueue) {
    override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
        val item = getItem(position)

        // Update the view using `item`.
        ...
    }
}

class MyViewHolder : RecyclerView.ViewHolder {
    // Implement your own ViewHolder.
    ...
}

fun someMethod() {
    val adapter = MyRecyclerViewAdapter(
        mCastSession.remoteMediaClient.getMediaQueue())
    val recyclerView =
        activity.findViewById(R.id.my_recycler_view_id) as RecyclerView
    recyclerView.adapter = adapter
}
Java
public class MyRecyclerViewAdapter extends MediaQueueRecyclerViewAdapter<MyViewHolder> {
    public MyRecyclerViewAdapter(MediaQueue mediaQueue) {
        super(mediaQueue);
    }

    @Override
    public void onBindViewHolder(MyViewHolder holder, int position) {
      MediaQueueItem item = getItem(position);

      // Update the view using `item`.
      ...
    }
}

public class MyViewHolder implements RecyclerView.ViewHolder {
  // Implement your own ViewHolder.
  ...
}

public void someMethod() {
    RecyclerView.Adapter adapter = new MyRecyclerViewAdapter(
        mCastSession.getRemoteMediaClient().getMediaQueue());
    RecyclerView recyclerView =
        (RecyclerView) getActivity().findViewById(R.id.my_recycler_view_id);
    recyclerView.setAdapter(adapter);
}

현재 재생목록 수정

대기열의 항목을 처리하려면 RemoteMediaClient 클래스의 대기열 메서드를 사용하세요. 이를 통해 항목 배열을 새 대기열에 로드하고, 기존 대기열에 항목을 삽입하고, 대기열의 항목 속성을 업데이트하고, 대기열에서 항목을 앞뒤로 이동하고, 대기열 자체의 속성을 설정(예: 다음 항목을 선택하는 repeatMode 알고리즘 변경)하고, 대기열에서 항목을 삭제하고, 대기열의 항목 순서를 변경할 수 있습니다.

이전
미디어 트랙
다음
가입 의도