ApsaraVideo Live:タイムシフト

タイムシフト機能の設定

// このファイルは自動生成されます。編集しないでください。
package com.aliyun.sample;

import com.aliyun.tea.*;

public class Sample {

    /**
     * description

タイムシフト機能の利用

タイムシフトを設定すると、ApsaraVideo Live はライブストリームの TS セグメントファイルを保存します。その後、クライアントはタイムシフト再生リクエストを送信して、ライブコンテンツを再生できます。

次の例は、タイムシフト再生リクエストを示しています。

http://<DomainName>/<AppName>/<StreamName.m3u8>?aliyunols=on&lhs_offset_unix_s_0=300&auth_key=3sdda******

例に示すように、タイムシフトリクエストは M3U8 ファイルのライブストリーミング URL に似ていますが、2 つの追加パラメーターが含まれています。aliyunols=on は固定フィールドで、lhs_offset_unix_s_0=300 は 300 秒の巻き戻しを示します。

この例では、ライブコンテンツは 300 秒巻き戻されます。タイムシフトされたコンテンツを再生する場合、lhs_offset_unix_s_0 パラメーターを使用して再生時間を設定できます。パラメーターの形式は lhs_{type}_{format}_{unit}_{zone} です。

次の表に、パラメーターの変数を説明します。

次の例は、タイムシフトパラメーターを示しています。

• lhs_start_human_s_8=20170809200010

• lhs_start_unix_s_0=1502280113

• lhs_end_human_s_8=20170809200010

• lhs_vodend_unix_s_0=1502280113

• lhs_offset_unix_ms_0=1800000 (30 分巻き戻し)

ビジネスで特定の start と end の時刻がわからない場合は、タイムシフトのタイムラインをクエリして取得できます。

次の例は、タイムシフトのタイムラインをクエリする方法を示しています。

// 角度括弧 (<>) 内の値を実際の値に置き換えてください。
http://<DomainName>/openapi/timeline/query?aliyunols=on&app=<AppName>&stream=<StreamName>&format=ts&lhs_start_unix_s_0=<StartTime>&lhs_end_unix_s_0=<endTime>&auth_key=<auth_key>

以下に例を示します。

次の例は、サンプル応答を示しています。

{
  "retCode": 0,
  "description": "success",
  "content": {
    "current": 1514269063,
    "timeline": [
      {
        "start": 1514269054,
        "end": 1514269058
      }
    ]
  }
}

タイムシフトによるトランスコードストリームの再生

タイムシフト機能とトランスコード機能を組み合わせて、トランスコードされたストリームを再生できます。タイムシフトでトランスコードされたストリームを再生するには、まずトランスコードを設定する必要があります。トランスコードの設定方法の詳細については、「ライブストリームのトランスコード」をご参照ください。

このセクションでは、トランスコード設定が完了していることを前提としています。

タイムシフトを設定する際には、トランスコードされたストリームのタイムシフトデータも生成する必要があります。次の例は、サンプルコードを示しています。

// タイムシフトデータを生成する際に、対応するトランスコードストリームを無視するかどうかを指定します。有効値: true および false。デフォルト値: true。
openLiveShiftRequest.setIgnoreTranscode("<false>");

タイムシフト再生を有効にするには、トランスコードされたストリーム URL にタイムシフトパラメーターを追加します。

次の例は、再生 URL を示しています。

http://<DomainName>/<AppName>/<StreamName_TranscodingTemplateID.m3u8>?aliyunols=on&lhs_offset_unix_s_0=300&auth_key=3sdda******

タイムシフトによるカプセル化ストリームの再生

タイムシフトでカプセル化されたストリームを再生するには、タイムシフト 機能と ライブストリームのカプセル化 機能を組み合わせて使用します。

ライブストリームカプセル化機能に慣れていない場合は、「ライブストリームカプセル化」をご参照ください。

このセクションでは、ライブストリームカプセル化設定が完了していることを前提としています。

タイムシフトでカプセル化されたストリームを再生するには、タイムシフト設定を変更する必要はありません。カプセル化されたストリーム URL にタイムシフトパラメーターを追加するだけです。

次の例は、再生 URL を示しています。

http://<DomainName>/<AppName>/<StreamName-ContainerFormat.m3u8>?aliyunols=on&lhs_offset_unix_s_0=300&auth_key=3sdda******

関連ドキュメント

タイムシフトの API の詳細については、「タイムシフト」をご参照ください。