すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:ライブストリームスナップショット

    ドキュメントセンター

    ApsaraVideo Live:ライブストリームスナップショット

    最終更新日:Mar 03, 2026

    ライブストリームのスクリーンショットを使用すると、ライブストリームのリアルタイムスクリーンショットをキャプチャできます。このトピックでは、ライブストリームのスクリーンショット機能について説明します。

    前提条件

    ライブストリームのスクリーンショット機能を使用するには、スナップショットファイルを Object Storage Service (OSS) バケットに保存する必要があります。そのため、OSS をアクティブ化し、スナップショットを保存するためのバケットを少なくとも 1 つ作成する必要があります。詳細については、「OSS のアクティブ化」および「バケットの作成」をご参照ください。

    重要

    バケットは、ご利用のストリーミングドメインのライブセンターと同じリージョンにある必要があります。クロスリージョンスナップショットはサポートされていません。

    ライブストリームスナップショットルール

    • ライブストリームのスクリーンショットは、AppName ごとに構成できます。これにより、特定の AppName のすべてのストリームにスナップショットルールを設定できます。

      説明

      AppName をアスタリスク (*) に設定すると、そのストリーミングドメインのすべてのストリームにスナップショットルールが適用されます。

    • ライブストリームのスクリーンショットを構成する際、上書きスナップショットとリアルタイムスナップショットのいずれかを選択できます。

      • 上書きスナップショットは、新しいスナップショットが生成されるたびに以前のスナップショットファイルを置き換えます。

      • リアルタイムスナップショットは、新しいスナップショットをそれぞれ個別のファイルとして保存します。ファイルは N+1 (N ≥ 0) のように昇順で命名されます。

      • 現在、ライブストリームのスクリーンショット機能は JPG 形式のみをサポートしています。

        説明

        両方のタイプのスナップショットを同時に有効にできます。少なくとも 1 つのタイプを有効にする必要があります。

    ライブストリームスナップショットの概要

    説明

    新しいスナップショットテンプレートは、進行中のライブストリームには適用されません。ストリーミングを再開した後にのみ有効になります。

    ビデオスナップショットの構成

    ライブストリームのスクリーンショットは、次のいずれかの方法で構成できます。

    コンソールでのスナップショット機能の構成

    1. ApsaraVideo Live コンソールにログインします。

    2. 左側のナビゲーションウィンドウで、機能管理 > ライブストリームのスクリーンショット を選択します。[スナップショット] ページで、スナップショット設定 タブをクリックします。

    3. 構成するストリーミングドメインを選択します。

    4. 追加 をクリックします。

    5. スナップショットテンプレートを構成します。

      image

      次の表に、テンプレートパラメーターを示します。

      パラメーター

      説明

      アプリケーション名

      ビデオのアプリケーション名。入力する アプリケーション名は、ライブストリーミングに使用される アプリケーション名と一致する必要があります。ドメインレベルでスナップショットを構成するには、アスタリスク (*) を入力します。

      スナップショット間隔

      スナップショット間の間隔 (秒単位)。有効な値: 5 ～ 3600。

      格納場所

      スナップショットファイルを保存する OSS の場所を選択します。

      OSS バケットは、ご利用のストリーミングドメインのライブセンターと同じリージョンにある必要があります。クロスリージョンスナップショットはサポートされていません。

      格納モード

      いずれかまたは両方のストレージ方法を選択できます。

      • 上書き：新しいスナップショットが、以前のスナップショットを置き換えます。

      • 新規作成：新しいスナップショットは、OSS に昇順 (N+1、N ≥ 0) で個別のファイルとして保存されます。

      説明

      両方の方法を選択した場合、スナップショットは両方の方法を使用して保存されます。

      説明

      テンプレートを構成すると、既に構成済みのものを含め、ドメイン下のすべての アプリケーション名の値に適用されます。

      スナップショット設定の変更は、ストリーミングを再開した後にのみ有効になります。

    6. OK をクリックします。

    API 構成スクリーンショット機能

    AddLiveAppSnapshotConfig 操作を呼び出して、スナップショットを設定できます。

    スナップショットファイルの管理

    スナップショットファイルの表示

    スナップショットファイルは、次の 3 つの方法のいずれかで表示できます。

    コンソールでのスナップショットの表示

    1. ApsaraVideo Live コンソールにログインします。

    2. 左側のナビゲーションウィンドウで、機能管理 ＞ ライブストリームのスクリーンショット を選択します。ライブストリームのスクリーンショット ページで、スナップショット管理 をクリックします。

    3. ドメインと期間を選択します。次に、AppName と StreamName を入力または選択します。

    4. 「検索」をクリックして、選択した期間のスナップショットを表示します。スナップショットが表示されない場合は、OSS バケットに公開読み取り 権限が設定されているか確認してください。詳細については、「OSS バケットの読み取りおよび書き込み権限の設定」をご参照ください。

      image

    5. スナップショットにカーソルを合わせると、フルサイズで表示したり、ストリーム URL をコピーしたりできます。

    API 操作を呼び出してスナップショットを表示

    DescribeLiveStreamSnapshotInfo 操作を呼び出してスナップショットファイルを表示できます。

    OSS スナップショットファイルの表示

    スナップショットを構成する際に、OSS のストレージ場所を指定しました。OSS でスナップショットを表示するには、「OSS オブジェクトのリスト表示」をご参照ください。

    スナップショットファイルの削除

    ApsaraVideo Live は、AppName、StreamName、OSS ファイルストレージパスなどのスナップショットファイル情報を保存します。ファイルは OSS に保存されます。スナップショットを削除する際に OSS に保存されているファイルを削除するには、AliyunMTSVideoLifecycleRole サービスロールを作成し、AliyunMTSVideoLifecycleRolePolicy システムポリシーをそのロールに付与する必要があります。

    詳細な権限付与手順

    ApsaraVideo Live コンソールでスナップショットまたは録画を削除する前に、権限を付与する必要があります。まず、Resource Access Management (RAM) コンソールで次の手順を完了します。次に、ApsaraVideo Live コンソールにログインしてスナップショットまたは録画を削除します。

    サービスロールの作成

    1. RAM 管理者として RAM コンソールにログインします。

    2. 左側のナビゲーションウィンドウで、アイデンティティ > ロール を選択します。

    3. ロール ページで、ロールの作成 をクリックします。

      image

    4. 「ロールの作成」ページで、[信頼されたエンティティの種類]を[Alibaba Cloud サービス]に設定します。Alibaba Cloud サービスを選択します。その後、OKをクリックします。

      image

      説明

      [信頼できるサービスを選択] ドロップダウンリストで、ApsaraVideo Media Processing を選択します。

    5. ロールの作成 パネルで、ロール名 フィールドに `AliyunMTSVideoLifecycleRole` を入力し、OK をクリックします。image

    6. ロールを作成した後、その基本情報ページで、権限管理タブを選択できます。

    7. Input and Attach をクリックし、以下のパラメーターを設定します。

      • 権限タイプ: システムポリシー

      • ポリシー名: AliyunMTSVideoLifecycleRolePolicy

      [OK] をクリックします。image

    スナップショットファイルは、次の 3 つの方法のいずれかで削除できます。

    コンソールでのスナップショットの削除

    1. ApsaraVideo Live コンソールにログインします。

    2. 左側のナビゲーションウィンドウで、機能管理 > ライブストリームのスクリーンショット を選択します。 ライブストリームのスクリーンショット ページで、スナップショット管理 をクリックします。

    3. ドメインと期間を選択します。次に、AppName と StreamName を入力または選択します。

    4. スナップショットにカーソルを合わせ、削除アイコンをクリックしてスナップショットを削除します。

      複数のスナップショットを選択し、一括削除 をクリックして、一括で削除できます。一度に最大200個のスナップショットを削除できます。

    API 操作を呼び出してスナップショットを削除

    DeleteSnapshotFiles 操作を呼び出して、スナップショットファイルとそれに対応する OSS ファイルを削除できます。

    スナップショットコールバックを構成して、タイムスタンプを含むスナップショット情報を業務システムに送信できます。その後、スケジュールされたクリーンアップなどのカスタムポリシーを使用してファイルを削除できます。詳細については、「ライブストリームスナップショットコールバック」をご参照ください。

    関連ドキュメント

    Java SDK を使用するには、「Java SDK ドキュメント」をご参照ください。

    ライブストリームスナップショットに関連するその他の API 操作については、「ライブストリームスナップショット API 操作」をご参照ください。