Tutorial: Creare, Aggiornare, Aggiungere, Rimuovere elementi dalle Playlist

In questo tutorial, illustreremo come creare una playlist e gestire gli asset assegnati alla playlist tramite l'API. In generale, il processo prevede 4 passaggi. Innanzitutto, dovrai creare una playlist. In secondo luogo, dovrai aggiungere contenuti alla playlist. Quindi puoi aggiornare gli elementi della playlist per modificare le impostazioni degli elementi della playlist, ad esempio modificare la durata di riproduzione. Infine, puoi rimuovere i contenuti dalla playlist.

1. Creare una playlist

Per creare una playlist, dovrai utilizzare la mutation savePlaylist. E fornire il nome della playlist come argomento nel payload. Se l'esecuzione avviene con successo, restituirà i dati richiesti dal server e verrà assegnato un id alla playlist. Questo id sarà necessario nel passaggio successivo quando si assegnano i contenuti alla playlist.

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

2. Assegnare contenuti alla playlist

Per assegnare i contenuti alla playlist, puoi utilizzare la mutation addPlaylistItems. Dovrai fornire l'id della playlist recuperato dal passaggio precedente e anche fornire l'id dell'asset nel payload.

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

3. Modificare la durata del contenuto nella playlist

Per modificare la durata degli asset nella playlist, puoi utilizzare la mutation updatePlaylistItems. Dovrai fornire l'id della playlist recuperato dal passaggio precedente e anche fornire la durata e la posizione dell'asset nella playlist a cui vuoi applicare la modifica nel payload.

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

Ora puoi vedere che la demo_playlist è stata creata nell'account con gli asset selezionati. E la durata degli elementi è impostata su 15 secondi.

4. Rimuovere il contenuto dalla playlist

Per rimuovere i contenuti dalla playlist, puoi utilizzare la mutation removePlaylistItems. Dovrai fornire l'id della playlist recuperato dal passaggio precedente e anche fornire la posizione dell'asset nella playlist che vuoi rimuovere nel payload.

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

Ora puoi vedere che i primi 2 asset nella playlist sono stati rimossi dalla playlist.

Articolo precedente - Tutorial: Associare e Assegnare Contenuti allo Schermo

Articolo successivo - Tutorial: Creare o Aggiornare Asset del Sito Web Utilizzando GraphQL