Tutoriel : créer, mettre à jour, ajouter et supprimer des éléments de playlists

Dans ce tutoriel, nous allons parcourir comment créer une playlist et gérer les éléments assignés à la playlist via l'API. En général, cela implique 4 étapes. Tout d'abord, vous devrez créer une playlist. Ensuite, vous devrez ajouter du contenu à la playlist. Puis vous pourrez mettre à jour les éléments de la playlist pour modifier les paramètres des éléments de la playlist, par exemple changer la durée de lecture. Enfin, vous pourrez supprimer les contenus de la playlist.

1. Créer une playlist

Pour créer une playlist, vous devrez utiliser la mutation savePlaylist. Et fournir le nom de la playlist comme argument dans le payload. Si cela s'exécute avec succès, cela renverra les données demandées depuis le serveur, et un id sera attribué à la playlist. Cet id sera nécessaire à l'étape suivante lors de l'attribution de contenus à la playlist.

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

2. Attribuer des contenus à la playlist

Pour attribuer les contenus à la playlist, vous pouvez utiliser la mutation addPlaylistItems. Vous devrez fournir l'id de la playlist récupéré depuis l'étape ci-dessus, et également fournir l'id de l'élément dans le payload.

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

3. Modifier la durée du contenu dans la playlist

Pour modifier la durée des éléments dans la playlist, vous pouvez utiliser la mutation updatePlaylistItems. Vous devrez fournir l'id de la playlist récupéré depuis l'étape ci-dessus, et également fournir la durée et la position de l'élément dans la playlist auquel vous souhaitez appliquer le changement dans le payload.

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

Maintenant, vous pouvez voir que demo_playlist est créée dans le compte avec les éléments sélectionnés. Et la durée des éléments est définie à 15 secondes.

4. Supprimer le contenu de la playlist

Pour supprimer les contenus de la playlist, vous pouvez utiliser la mutation removePlaylistItems. Vous devrez fournir l'id de la playlist récupéré depuis l'étape ci-dessus, et également fournir la position de l'élément dans la playlist que vous souhaitez supprimer dans le payload.

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

Maintenant vous pouvez voir que les 2 premiers éléments de la playlist sont supprimés de la playlist.

Article précédent - Tutoriel : Appairer et attribuer du contenu à l'écran

Article suivant - Tutoriel : Créer ou mettre à jour des éléments de site Web avec GraphQL