ApsaraVideo Live:Décalage temporel

Configuration du décalage temporel

// This file is auto-generated, don't edit it. Thanks.
package com.aliyun.sample;
import com.aliyun.tea.*;
public class Sample {
    /**
     * <b>description</b> :
     * <p>Initializes a client by using credentials.</p>
     * @return Client
     * 
     * @throws Exception
     */
    public static com.aliyun.live20161101.Client createClient() throws Exception {
        // For production environments, we recommend using a more secure, credential-free method. For more information about how to configure credentials, see https://www.alibabacloud.com/help/document_detail/378657.html.
        com.aliyun.credentials.Client credential = new com.aliyun.credentials.Client();
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
                .setCredential(credential);
        // For the endpoint, see https://api.alibabacloud.com/product/live.
        config.endpoint = "live.aliyuncs.com";
        return new com.aliyun.live20161101.Client(config);
    }
    public static void main(String[] args_) throws Exception {
        com.aliyun.live20161101.Client client = Sample.createClient();
        com.aliyun.live20161101.models.OpenLiveShiftRequest openLiveShiftRequest = new com.aliyun.live20161101.models.OpenLiveShiftRequest()
                .setRegionId("<Your RegionId>")
                .setDomainName("<Your DomainName>")
                .setAppName("<Your AppName>")
                .setStreamName("<Your StreamName>");
        com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
        try {
            // When you copy the code to run, print the API response on your own.
            client.openLiveShiftWithOptions(openLiveShiftRequest, runtime);
        } catch (TeaException error) {
            // This is for demonstration purposes only. In your production environment, handle exceptions with care and do not ignore them.
            // Error message
            System.out.println(error.getMessage());
            // Diagnostic address
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        } catch (Exception _error) {
            TeaException error = new TeaException(_error.getMessage(), _error);
            // This is for demonstration purposes only. In your production environment, handle exceptions with care and do not ignore them.
            // Error message
            System.out.println(error.getMessage());
            // Diagnostic address
            System.out.println(error.getData().get("Recommend"));
            com.aliyun.teautil.Common.assertAsString(error.message);
        }        
    }
}

Demande de lecture en décalage temporel

Une fois le décalage temporel configuré, ApsaraVideo Live enregistre les fichiers de segments TS du flux en direct. Le client peut alors envoyer une requête de lecture en décalage temporel pour lire les segments précédemment enregistrés du flux en direct.

Le code suivant fournit un exemple de requête de lecture en décalage temporel :

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

Comme illustré dans l'exemple, la requête de décalage temporel est similaire à une URL de diffusion en direct pour une liste de lecture M3U8, mais elle inclut deux paramètres supplémentaires. aliyunols=on est un paramètre obligatoire, et lhs_offset_unix_s_0=300 indique un rembobinage de 300 secondes.

Dans cet exemple, le contenu en direct est rembobiné de 300 secondes. Lors de la lecture de contenu en décalage temporel, vous pouvez utiliser le paramètre lhs_offset_unix_s_0 pour définir l'heure de lecture. Le format du paramètre est lhs_{type}_{format}_{unit}_{zone}.

Le tableau suivant décrit les variables du paramètre.

Les exemples suivants montrent les paramètres de décalage temporel :

• 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 (rembobinage de 30 minutes)

Si vous ne connaissez pas les heures de début et de fin spécifiques, vous pouvez interroger la chronologie du décalage temporel pour les obtenir.

L'exemple suivant montre comment interroger la chronologie du décalage temporel :

// Replace the values in angle brackets (<>) with your actual values.
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>

Le tableau suivant décrit les paramètres de l'exemple.

L'exemple suivant montre un échantillon de réponse :

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

Lecture transcodée en décalage temporel

Vous pouvez utiliser la fonctionnalité de décalage temporel avec la fonctionnalité de transcodage pour lire des flux transcodés. Pour lire des flux transcodés avec décalage temporel, vous devez d'abord configurer le transcodage. Pour plus d'informations sur la configuration du transcodage, consultez Transcodage de flux en direct.

Cette section suppose que vous avez terminé la configuration du transcodage.

Lorsque vous configurez le décalage temporel, vous devez également générer des données de décalage temporel pour les flux transcodés. L'exemple suivant montre le code d'exemple :

// Specifies whether to ignore the corresponding transcoded stream when generating time-shifted data. Valid values: true and false. Default value: true.
openLiveShiftRequest.setIgnoreTranscode("<false>");

Pour activer la lecture en décalage temporel, add the time-shifting parameters à l'URL du flux transcodé.

L'exemple suivant montre une URL de lecture :

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

Lecture encapsulée en décalage temporel

Vous pouvez utiliser la fonctionnalité Time Shifting conjointement avec la fonctionnalité Encapsulation.

Si vous n'êtes pas familier avec la fonctionnalité d'encapsulation de flux en direct, consultez Encapsulation de flux en direct.

Cette section suppose que vous avez terminé la configuration de l'encapsulation de flux en direct.

Pour lire des flux encapsulés avec décalage temporel, vous n'avez pas besoin de modifier la configuration du décalage temporel. Vous pouvez simplement ajouter les paramètres de décalage temporel à l'URL du flux encapsulé.

L'exemple suivant montre une URL de lecture :

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

Références

Pour plus d'informations sur les API de décalage temporel, consultez Décalage temporel.