チュートリアル：プレイリストの作成・更新・アイテムの追加と削除

このチュートリアルでは、プレイリストの作成方法と、API を通じてプレイリストに割り当てられたアセットを管理する方法について説明します。一般的に、4つのステップが含まれます。まず、プレイリストを作成する必要があります。次に、プレイリストにコンテンツを追加する必要があります。その後、プレイリストアイテムを更新して、プレイリストアイテムの設定を変更できます（例：再生時間の変更）。最後に、プレイリストからコンテンツを削除できます。

1. プレイリストを作成する

プレイリストを作成するには、savePlaylist ミューテーションを使用する必要があります。そして、ペイロードの引数としてプレイリスト名を指定します。正常に実行されると、サーバーからリクエストされたデータが返され、プレイリストに ID が割り当てられます。この ID は、次のステップでプレイリストにコンテンツを割り当てる際に必要になります。

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

2. プレイリストにコンテンツを割り当てる

プレイリストにコンテンツを割り当てるには、addPlaylistItems ミューテーションを使用できます。上記のステップで取得したプレイリスト ID を指定し、ペイロードにアセット ID も提供する必要があります。

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

3. プレイリスト内のコンテンツの再生時間を変更する

プレイリスト内のアセットの再生時間を変更するには、updatePlaylistItems ミューテーションを使用できます。上記のステップで取得したプレイリスト ID を指定し、ペイロードに変更を適用したいプレイリスト内のアセットの再生時間と位置を提供する必要があります。

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

これで、選択したアセットを含む demo_playlist がアカウントに作成されたことが確認できます。そして、アイテムの再生時間は15秒に設定されています。

4. プレイリストからコンテンツを削除する

プレイリストからコンテンツを削除するには、removePlaylistItems ミューテーションを使用できます。上記のステップで取得したプレイリスト ID を指定し、ペイロードに削除したいプレイリスト内のアセットの位置を提供する必要があります。

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

これで、プレイリストの最初の2つのアセットがプレイリストから削除されたことが確認できます。

前の記事 - チュートリアル：スクリーンへのペアリングとコンテンツの割り当て

次の記事 - チュートリアル：GraphQL を使用したウェブサイトアセットの作成または更新