Enfileiramento

O framework do Google Cast oferece classes de enfileiramento que oferecem suporte à criação de listas de instâncias de MediaQueueItem, que podem ser criadas a partir de instâncias de MediaInfo, como transmissões de vídeo ou áudio, para serem reproduzidas sequencialmente no receptor. Essa fila de itens de conteúdo pode ser editada, reordenada, atualizada e assim por diante.

O SDK Receiver mantém a fila e responde a operações nela enquanto ela tiver pelo menos um item ativo (reproduzindo ou pausado). Os remetentes podem participar da sessão e adicionar itens à fila. O receptor mantém uma sessão para os itens da fila até que o último item conclua a reprodução ou o remetente pare a reprodução e encerre a sessão ou até que um remetente carregue uma nova fila no receptor. O receptor não mantém nenhuma informação sobre filas encerradas por padrão. Quando o último item da fila termina, a sessão de mídia termina e a fila desaparece.

Criar e carregar itens da fila de mídia

Um item da fila de mídia é representado no framework do Google Cast como uma instância MediaQueueItem. Ao criar um item da fila de mídia, se você estiver usando a biblioteca do player de mídia com conteúdo adaptável, será possível definir o tempo de pré-carregamento para que o player possa começar a armazenar em buffer o item da fila de mídia antes que o item anterior na fila termine de ser reproduzido. Definir o atributo de reprodução automática do item como "true" permite que o receptor o reproduza automaticamente. Por exemplo, é possível usar um padrão de builder para criar o item da fila de mídia da seguinte maneira:

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();

Carregue uma matriz de itens de fila de mídia na fila usando o método queueLoad adequado de RemoteMediaClient.

Receber atualizações de status da fila de mídia

Quando o receptor carrega um item da fila de mídia, ele atribui um ID exclusivo ao item, que persiste durante a sessão (e a vida útil da fila). O app pode saber o status da fila em termos de qual item está carregado no momento (pode não estar sendo reproduzido), carregando ou pré-carregado. A classe MediaStatus oferece estas informações de status:

  • Método getPreloadedItemId(): se o próximo item foi pré-carregado, retorna o ID do item pré-carregado.
  • Método getLoadingItemId(): retorna o ID do item que está sendo carregado (mas não está ativo na fila) no receptor.
  • Método getCurrentItemId(): retorna o ID do item que estava ativo na fila (pode não estar sendo reproduzido) no momento em que a mudança de status da mídia ocorreu.
  • Método getQueueItems() (descontinuado, use MediaQueue) - retorna a lista de instâncias MediaQueueItem como uma lista não modificável.

O app também pode receber a lista de itens usando a classe MediaQueue. A classe é um modelo de dados esparsa da fila de mídia. Ele mantém a lista de IDs de itens na fila, que é sincronizada automaticamente com o receptor. O MediaQueue não mantém todos os MediaQueueItem porque consome muita memória quando a fila é muito longa. Em vez disso, ele busca os itens sob demanda e mantém um LruCache de itens acessados recentemente. Use estes métodos para acessar a fila de mídia:

  • Método getItemIds(): retorna a lista de todos os IDs de itens na ordem.
  • Método getItemAtIndex(): retorna o item em cache em um índice específico. Se o item não estiver armazenado em cache, MediaQueue vai retornar null e programar para buscar o item. Quando o item é buscado, MediaQueue.Callback#itemsUpdatedAtIndexes() é chamado, e chamar getItemAtIndex() com o mesmo ID novamente retorna o item.
  • fetchMoteItemsRelativeToIndex() é usado quando o usuário rola a interface da fila para cima ou para baixo e o app quer buscar mais itens da nuvem.

Use esses métodos com os outros métodos de status de mídia para informar ao app sobre o status da fila e dos itens nela. Além das atualizações de status de mídia do receptor, o app pode detectar mudanças na fila implementando RemoteMediaClient.Callback e MediaQueue.Callback.

Além disso, o SDK do Cast oferece duas classes de utilitário para criar uma interface para enfileirar.

Por exemplo, para criar um RecyclerView usando MediaQueueRecyclerViewAdapter:

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);
}

Editar a fila

Para operar os itens na fila, use os métodos de fila da classe RemoteMediaClient. Elas permitem carregar uma matriz de itens em uma nova fila, inserir itens em uma fila existente, atualizar as propriedades dos itens na fila, fazer com que um item pule para frente ou para trás na fila, definir as propriedades da própria fila (por exemplo, mudar o algoritmo repeatMode que seleciona o próximo item), remover itens da fila e reordenar os itens na fila.

Anterior
Faixas de mídia
Próxima
Intenção de participar