ユースケース use-cases

ストリームカウントサービスの主なユースケースは、ユーザーが視聴した同時ビデオストリームの数をカウントし、同じアカウント ID の同時な使用に関する決定を提供することです。

購読者の使用状況を監視するためには、プログラマーの web サイトやアプリケーション、MVPDのコンテンツポータル、または同時配信プロパティのいずれで発生した場合でも、ユーザーアクティビティを集計できる一元化されたサービスが必要です。

この一元化されたサービスでサポートされる主なユースケースは、次のとおりです。

一般的なユースケース common-use-cases

基本ストリーム制限

すべてのアプリケーションで、サブスクライバーごとの同時ストリーム数を制限します。

デバイスベースの制限

デバイスタイプ（モバイル、タブレット、テレビなど）ごとに一定数のストリームのみを許可します。

コンテンツ固有のルール

ライブコンテンツとVOD コンテンツに異なる制限を適用します。

場所ベースのポリシー

地理的な場所やネットワークタイプに基づいてストリーミングを制限します。

セッションの作成 create-session

この API 呼び出しを使用すると、ユーザーが「再生」ボタンを押してコンテンツを視聴する際に、クライアントが新しい CM セッションを作成できます。 サーバー応答には、ストリームを維持するための新しいストリーム URL （ストリーム ID を含む）と、ストリームがタイムアウトする時間が含まれます。 これにより、クライアントアプリケーションが、ハートビートを通じてアクティビティをレポートすることが期待されます。 セッション初期化呼び出しでは、フォームデータ（またはクエリ文字列パラメーター）として送信されるキーと値のペアの形式でメタデータを含める必要があります。 さらに、応答には、再生が「ポリシーに準拠」しているかどうかを示すフラグも含まれます。 ない場合、再生は許可されません。

レポートアクティビティ reporting-activity

セッションを作成した後、そのストリームをアクティブなままにするには、アプリケーションでハートビートを定期的に送信する必要があります。 また、ユーザーが再生を停止するとクライアントアプリがストリームを停止し、タイムアウトまでストリームがアクティブとカウントされないようにすることをお勧めします。

ハートビート呼び出しの応答により、クライアントアプリケーションは（ポリシーに準拠している場合は）ビデオ再生を続行したり、ビデオ再生を停止するように指示したりできます。 ビデオストリームが準拠していない場合、クライアントアプリケーションはビデオストリームを停止する必要があります。 応答には、クライアントアプリケーションにエラーメッセージを表示するための情報や、ユーザーが再生を続行するために使用できるアクションが表示されます。