前提条件
ライブストリームのスクリーンショット 機能では、スナップショットファイルをバケットに保存する必要があります。このため、OSS サービスを有効化し、スナップショットファイルを保存するためのバケットを少なくとも 1 つ用意する必要があります。詳細については、「OSS サービスを有効化する」および「バケットの作成」をご参照ください。
重要
バケットは、アップストリーミングドメインのライブセンターと同じリージョンにある必要があります。クロスリージョンのスナップショットはサポートされていません。
スナップショットの設定と管理
説明
新しく設定されたスナップショットテンプレートは、進行中のライブストリームには適用されません。変更を有効にするには、アップストリーミングを再起動する必要があります。
スナップショット設定
ビデオのライブストリームのスクリーンショット機能は、次の 2 つの方法で設定できます：
コンソールでのスナップショット設定
-
ApsaraVideo Live コンソール にログインします。
-
左側のナビゲーションバーで、機能管理 > ライブストリームのスクリーンショット を選択します。ライブストリームのスクリーンショット ページで、スナップショット設定 タブを選択します。
-
設定するアップストリーミングドメインを選択します。
-
追加 をクリックします。
-
スナップショットテンプレートを設定します。
次の表で、スナップショットテンプレートのパラメーターを説明します。
|
パラメーター
|
説明
|
|
[アプリケーション名]
|
アプリケーション名。この設定は、入力した アプリケーション名 がライブストリームのインジェストに使用される アプリケーション名 と一致する場合にのみ有効になります。ドメインレベルでスナップショットを設定するには、アスタリスク (*) を入力します。
|
|
[スナップショット間隔]
|
スナップショットをキャプチャする間隔。単位：秒。有効な値：5～3600。
|
|
[格納場所]
|
スナップショットファイルを保存する OSS 上の場所を選択します。
OSS バケットは、アップストリーミングドメインのライブセンターと同じリージョンにある必要があります。クロスリージョンのスナップショットはサポートされていません。
|
|
[格納モード]
|
2 つの保存モードが利用可能です。一方または両方を選択できます。
説明
両方のモードを選択した場合、スナップショットは両方の方法で生成および保存されます。
|
説明
設定が完了すると、設定されたテンプレートに従って、このドメイン名配下で設定されたすべてのアプリケーション名のスクリーンショットが撮影され、保存されます。
スナップショット設定の変更は、次回のアップストリーミングから有効になります。
-
OK をクリックします。
スナップショットファイルの管理
スナップショットの表示
スナップショットファイルは、次の 3 つの方法で表示できます。
コンソールでのスナップショットファイルの表示
-
ApsaraVideo Live コンソール にログインします。
-
左側のナビゲーションバーで、機能管理 > ライブストリームのスクリーンショット を選択します。ライブストリームのスクリーンショット ページで、スナップショット管理 を選択します。
-
クエリのドメインと時間範囲を選択します。次に、AppName と StreamName を入力または選択します。
-
検索 をクリックして、選択した時間範囲内のスナップショットを表示します。 スナップショットを表示できない場合は、OSS バケットの権限が public-read に設定されていることを確認してください。 詳細については、「OSS バケットの ACL を設定する」をご参照ください。
[スナップショット管理] タブでは、日付、AppName、および StreamName でスナップショットをフィルタリングできます。
-
画像にカーソルを合わせると、拡大版の表示やスナップショット URL のコピーができます。
OSS でのスナップショットファイルの表示
スナップショット機能の設定時に、OSS の保存パスを指定しました。OSS でスナップショットファイルを表示するには、「オブジェクトのリスト」をご参照ください。
スナップショットの削除
ApsaraVideo Live は、AppName、StreamName、OSS 保存パスなどの スナップショットファイルのメタデータ を保存します。実際の ファイル は OSS に保存されます。ApsaraVideo Live で対応するスナップショットレコードを削除する際に OSS 上のファイルを削除するには、AliyunMTSVideoLifecycleRole サービスロールを作成し、AliyunMTSVideoLifecycleRolePolicy システムポリシーを使用して権限を付与する必要があります。
承認手順
ApsaraVideo Live コンソールでスナップショットや録画を削除する前に、必要な権限を付与する必要があります。次の手順に従って、Resource Access Management (RAM) コンソールで RAM ロールを作成して承認し、その後 ApsaraVideo Live コンソールに戻ってファイルを削除します。
サービスロールの作成
-
RAM 管理者として RAM コンソール にログインします。
-
左側のナビゲーションペインで、 を選択します。
-
ロール ページで、ロールの作成 をクリックします。
-
ロールの作成 ページで、[信頼できるエンティティタイプ] に [Alibaba Cloud Service] を選択し、OK をクリックします。
説明
[信頼できるサービス] ドロップダウンリストから、[メディア処理] を選択します。
-
「ロールの作成」ダイアログボックスで、ロール名 に「AliyunMTSVideoLifecycleRole」と入力し、OK をクリックします。ロール名の長さは最大 64 文字で、英字、数字、ハイフン (-)、ピリオド (.) を使用できます。
-
ロールの作成後、基本情報 ページで 権限管理 タブをクリックします。
-
Input and Attach をクリックし、次のパラメーターを設定します。
パラメーターを設定した後、[OK] をクリックします。
コンソールでのスナップショットファイルの削除
-
ApsaraVideo Live コンソール にログインします。
-
左側のナビゲーションバーで、機能管理> ライブストリームのスクリーンショット を選択します。ライブストリームのスクリーンショット ページで、スナップショット管理 を選択します。
-
クエリのドメインと時間範囲を選択します。次に、AppName と StreamName を入力または選択します。
-
画像にカーソルを合わせ、削除アイコンをクリックして、単一のスナップショットを削除します。
複数のスナップショットを削除するには、チェックボックスを選択し、一括削除 をクリックします。一度に最大 200 個のスナップショットを削除できます。
API を使用したスナップショットファイルの削除
DeleteSnapshotFiles API を呼び出してスナップショットファイルを削除します。これにより、OSS に保存されているファイルも削除されます。
イベントコールバックを設定して、タイムスタンプなどのスナップショット情報をビジネスシステムに送信できます。これにより、定期的なクリーンアップなど、カスタムポリシーに基づいて対応するファイルを削除できます。詳細については、「イベントコールバック」開発ガイドをご参照ください。