ライブストリームのスクリーンショット 機能は、ライブストリームのリアルタイムスナップショットを撮ります。
前提条件
ライブストリームのスクリーンショット 機能は、スナップショットファイルをバケットに保存します。Object Storage Service (OSS) をアクティブ化し、スナップショットファイルを保存するために少なくとも 1 つのバケットを作成する必要があります。詳細については、「OSS のアクティブ化」および「バケットの作成」をご参照ください。
バケットは、ストリーミングドメインのライブセンターと同じリージョンにある必要があります。リージョンをまたいだスナップショットはサポートされていません。
スナップショットルール
ライブストリームのスクリーンショット は、各
AppNameごとに設定できます。特定のAppNameの下のすべてのアップストリーミングに対してスナップショットルールを設定できます。説明AppNameをアスタリスク (*) に設定した場合、スナップショットルールはドメイン名の下のすべてのアップストリーミングに適用されます。ライブストリームのスクリーンショット 機能を設定する際、上書きとリアルタイムの 2 つのスナップショットタイプから選択できます。
上書きスナップショット: 新しいスナップショットはそれぞれ前のスナップショットを上書きします。
リアルタイムスナップショット: 新しいスナップショットはそれぞれ前のスナップショットを上書きせずに保存されます。スナップショットは増分的に保存されます。
ライブストリームのスクリーンショット は現在 JPG フォーマットのみをサポートしています。
説明両方のタイプを選択できます。少なくとも 1 つのタイプを選択する必要があります。
機能の概要
新しく設定されたスナップショットテンプレートは、進行中のライブストリームには適用されません。テンプレートを有効にするには、アップストリーミングを再起動する必要があります。
ビデオスナップショット機能の設定
ライブストリームのスクリーンショット 機能は、次のいずれかの方法で設定できます。
ApsaraVideo Live コンソールにログインします。
左側のナビゲーションウィンドウで、機能管理 > ライブストリームのスクリーンショット を選択します。ライブストリームのスクリーンショット ページで、スナップショット設定 タブをクリックします。
設定するストリーミングドメインを選択します。
追加 をクリックします。
スナップショットテンプレートを設定します。
次の表に、スナップショットテンプレートのパラメーターを示します。
パラメーター
説明
アプリケーション名
アプリケーション名。アプリケーション名 は、アップストリーミングに使用される [AppName] と同じである必要があります。ドメイン名のスナップショットを設定するには、アスタリスク (*) を入力します。
スナップショット間隔
スナップショット間隔 (秒)。有効値: 5～3600。
格納場所
OSS 内のスナップショットファイルのストレージの場所を選択します。
OSS バケットは、ストリーミングドメインのライブセンターと同じリージョンにある必要があります。リージョンをまたいだスナップショットはサポートされていません。
格納モード
2 つのストレージメソッドが利用可能です。両方を選択できます。
上書き: 指定された間隔でスナップショットが撮られます。新しいスナップショットはそれぞれ前のスナップショットを上書きします。
新規作成: 指定された間隔でスナップショットが撮られます。新しいスナップショットは、N+1 (N≥0) の順序で OSS に順次保存されます。
説明両方を選択した場合、両方のメソッドを使用してスナップショットが撮られます。
説明設定が完了すると、テンプレートに基づいて、ドメイン名の下の指定されたすべての アプリケーション名 に対してスナップショットが撮られ、保存されます。
スナップショット設定の変更は、アップストリーミングを再起動した後に有効になります。
[OK] をクリックします。
スナップショットファイルの管理
スナップショットファイルの表示
次のいずれかの方法でスナップショットファイルを表示できます。
ApsaraVideo Live コンソールにログインします。
左側のナビゲーションウィンドウで、機能管理 > ライブストリームのスクリーンショット を選択します。ライブストリームのスクリーンショット ページで、スナップショット管理 をクリックします。
ドメイン名と時間範囲を選択します。次に、AppName と StreamName を入力または選択します。
検索 をクリックして、選択した時間範囲内のスナップショットを表示します。スナップショットを表示できない場合は、OSS バケットのアクセス制御リスト (ACL) が public-read に設定されていることを確認してください。詳細については、「OSS バケットの ACL の設定」をご参照ください。
イメージの上にポインターを移動して、拡大版を表示したり、スナップショット URL をコピーしたりします。
スナップショットファイルの削除
ApsaraVideo Live は、AppName、StreamName、OSS ストレージパスなどの スナップショットファイル情報 を保存します。スナップショット ファイル は OSS に保存されます。スナップショットを削除する際に OSS からファイルを削除するには、AliyunMTSVideoLifecycleRole サービスロールを作成し、AliyunMTSVideoLifecycleRolePolicy システムポリシーをそのロールにアタッチする必要があります。
ApsaraVideo Live コンソールでスナップショットや録画を削除する前に、権限を付与する必要があります。必要な権限を付与するには、RAM コンソールで RAM ロールを作成して承認します。その後、ApsaraVideo Live コンソールにログインしてファイルを削除できます。
サービスロールの作成
RAM 管理者として RAM コンソール にログインします。
左側のナビゲーションウィンドウで、 を選択します。
ロール ページで、ロールの作成 をクリックします。
ロールの作成 ページで、[プリンシパルタイプ] を [クラウドサービス] に設定します。次に、信頼できるサービスを選択し、[OK] をクリックします。
説明[プリンシパル名] ドロップダウンリストから、ApsaraVideo Media Processing を選択します。
[ロールの作成] ダイアログボックスで、[ロール名] フィールドに「AliyunMTSVideoLifecycleRole」と入力し、[OK] をクリックします。
ロールが作成された後、その [基本情報] ページで、[権限] タブをクリックします。
[詳細な権限] をクリックします。 パラメーターを以下のように設定します：
ポリシータイプ: システムポリシー
ポリシー名: AliyunMTSVideoLifecycleRolePolicy
設定が完了したら、[OK] をクリックします。
次のいずれかの方法でスナップショットファイルを削除できます。
参考資料
Java SDK を使用するには、「Java SDK ユーザーガイド」をご参照ください。
ライブストリームのスナップショットに関連するその他の API については、「ライブストリームのスナップショット API」をご参照ください。