큐

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

리시버 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 알고리즘 변경), 대기열에서 항목을 삭제하고, 대기열의 항목 순서를 변경할 수 있습니다.

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