このガイドでは、ブロードキャストとストリームの概要について説明します。また、放送局が YouTube Live Streaming API を使用してこれらのリソースを作成、管理する方法を示すユースケースについても説明します。
-
ブロードキャスト: YouTube 上でライブ視聴できるイベントを表します。各ブロードキャストは個別の YouTube 動画です。ブロードキャストは 1 つのストリームにのみバインドでき、バインドする必要があります。
-
ストリームでは、音声動画コンテンツを YouTube に送信することができます。ストリームによって、YouTube へのコンテンツのストリーミング方法の設定を定義できます。同じストリームは最大 3 つのライブ配信にバインドできます。また、放送局が時刻が異なる複数のブロードキャストで同じストリームを再利用することもよくあります。
残りのセクションでは、API ユーザーがブロードキャストとストリームを通常どのように使用するかを説明する 3 つのユースケースを紹介します。
単一のエンコーダを構成する
最も一般的な API ユースケースでは、YouTube チャンネルに一連のライブイベントや定期的なライブイベントがあります。チャンネル所有者はエンコーダが 1 つで、そのエンコーダを 1 回だけ設定したいと考えています。そのため、次の手順を行います。
- API で
liveStreamリソースを 1 つ作成します。 - そのリソースのコンテンツ配信設定を使用して、チャンネルのエンコーダを構成します。
- API で
liveBroadcastリソースを作成し、それらのリソースをすべてliveStreamリソースにバインドします。このシナリオでは、チャンネルでスケジュールしたすべてのライブイベントで同じストリーミング設定が使用されます。ただし、一度に配信できるイベントは 1 つのみです。また、各配信の動画コンテンツは一意です。 - イベントが発生したら、ブロードキャストのステータスを
testingまたはliveに更新して、YouTube でそのイベントのブロードキャストに進みます。
チャンネルが複数ある場合は、チャンネルごとに異なるストリームを作成する必要があります。
ブロードキャストごとに 1 つのストリームを作成する
もう 1 つの一般的な方法は、ブロードキャストごとに個別のストリームを作成することです。このシナリオでは、liveBroadcast リソースごとに個別の liveStream リソースを作成し、配信ごとに適切な設定を使用するようにストリーミング エンコーダを設定します。
この方法は、チャンネルに繰り返しの複数のブロードキャストがあり、2 つのブロードキャストが同時に発生する可能性があるため、両方のブロードキャストで同じストリーミング設定を使用できない場合に理にかなっています。実際、チャンネルは定期的な放送を 1 つの番組として扱い、番組ごとに 1 つの liveStream リソースを作成するだけです。そうすれば、同じ番組の各エピソードが 1 つのブロードキャストを表し、同じ番組のすべてのブロードキャストが同じストリームにバインドされます。
1 つのストリームで同時ブロードキャストを作成する
このシナリオでは、ライブ配信を複数の同時配信に分割する必要があります。そのため、1 つの liveStream リソースが、同時に live ステータスの 2 つ（または複数）の liveBroadcast リソースにバインドされていることになります。
たとえば、チャンネルで 24 時間 365 日のライブフィードを配信する一方で、その配信中に行われるインタビュー用に別の動画を作成する必要があるとします。この場合、インタビューの内容は、24 時間 365 日放送のコンテンツのサブセットです。
このような場合は、2 つの liveBroadcast リソースを作成し、両方のブロードキャストを同じストリームにバインドします。24 時間 365 日ブロードキャストが進行中で、そのリソースは、インタビューが開始されるかなり前に live ステータスになります。インタビューが開始されると、24 時間 365 日ブロードキャストのリソースを変更せずに、インタビューに関連付けられているリソースのステータスを live に更新します。つまり、同じコンテンツを 2 つの異なる動画に同時にストリーミングすることになります。
インタビューが終了したら、インタビュー ブロードキャストのリソースを再度更新しますが、今回はステータスを complete に設定します。ただし、24 時間 365 日ブロードキャストは継続するため、動画のストリーミングは停止しません。