Tutorial: Criar, Atualizar, Adicionar, Remover itens de Playlists

Neste tutorial, vamos demonstrar como criar uma playlist e gerenciar os ativos atribuídos à playlist através da API. Geralmente, envolve 4 passos. Primeiro, você precisará criar uma playlist. Segundo, você precisará adicionar conteúdo à playlist. Em seguida, você pode atualizar os itens da playlist para alterar as configurações dos itens da playlist, por exemplo, alterar a duração de reprodução. Por último, você pode remover os conteúdos da playlist.

1. Criar uma playlist

Para criar uma playlist, você precisará usar a mutation savePlaylist. E fornecer o nome da playlist como argumento no payload. Se executar com sucesso, retornará os dados solicitados do servidor, e um id será atribuído à playlist. Este id será necessário no próximo passo ao atribuir conteúdos à playlist.

mutation {
  savePlaylist(payload:{name:"demo_playlist"}){
          _id,
          name,
          path,
          assets{
            _id,
          	fileType,
            filename,
          	duration,
          	appType
          },
          teamId,
          tags
  }
}

2. Atribuir conteúdos à playlist

Para atribuir conteúdos à playlist, você pode usar a mutation addPlaylistItems. Você precisará fornecer o id da playlist recuperado do passo anterior, e também fornecer o id do ativo no payload.

mutation {
  addPlaylistItems(_id:"4Xt7P6eYJGc4bXjR8",payload:{
    ids: ["uRQynMhDsJ6QY35Wf",
          "6744ff5add229e00123cf5e6"],
    pos: 1
  }){
          	_id,
          	fileType,
          	filename,
          	duration,
          	appType
  }
}

3. Alterar a duração do conteúdo na playlist

Para alterar a duração dos ativos na playlist, você pode usar a mutation updatePlaylistItems. Você precisará fornecer o id da playlist recuperado do passo anterior, e também fornecer a duração e a posição do ativo na playlist que você deseja aplicar a alteração no payload.

mutation {
  updatePlaylistItems(_id:"4Xt7P6eYJGc4bXjR8",payload:{
    items:  [{item: {duration:15}, pos: [0,1]}]
  }){
            _id,
            fileType,
            filename,
            duration,
            appType
  }
}

Agora, você pode ver que a demo_playlist foi criada na conta com os ativos selecionados. E a duração dos itens está definida para 15 segundos.

4. Remover o conteúdo da playlist

Para remover conteúdos da playlist, você pode usar a mutation removePlaylistItems. Você precisará fornecer o id da playlist recuperado do passo anterior, e também fornecer a posição do ativo na playlist que você deseja remover no payload.

mutation {
  removePlaylistItems(_id:"d87B9ARKPyH8YYBbs",payload:{pos: [0,1]}){
            _id,
            fileType,
            filename,
            duration,
            appType
  }
}

Agora você pode ver que os primeiros 2 ativos na playlist foram removidos da playlist.

Artigo Anterior - Tutorial: Parear e Atribuir Conteúdo à Tela

Próximo Artigo - Tutorial: Criando ou Atualizando Ativos de Website Usando GraphQL