ApsaraVideo Live:Time shifting

Configurar o time shifting

// 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);
        }        
    }
}

Solicitar reprodução com time shifting

Após a configuração do time shifting, o ApsaraVideo Live salva os arquivos de segmentos TS da transmissão ao vivo. O cliente pode então enviar uma solicitação de reprodução com time shifting para reproduzir segmentos gravados anteriormente.

O código a seguir apresenta um exemplo de solicitação de reprodução com time shifting:

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

Conforme mostrado no exemplo, a solicitação de time shifting é semelhante a uma URL de transmissão ao vivo para uma playlist M3U8, mas inclui dois parâmetros adicionais. aliyunols=on é um parâmetro obrigatório, e lhs_offset_unix_s_0=300 indica um retrocesso de 300 segundos.

Neste exemplo, o conteúdo ao vivo retrocede 300 segundos. Durante a reprodução de conteúdo com time shifting, use o parâmetro lhs_offset_unix_s_0 para definir o tempo de reprodução. O formato do parâmetro é lhs_{type}_{format}_{unit}_{zone}.

A tabela a seguir descreve as variáveis do parâmetro.

Os exemplos a seguir mostram os parâmetros de time shifting:

• 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 (retrocesso de 30 minutos)

Caso não saiba os horários exatos de início e término, consulte a linha do tempo do time shifting para obtê-los.

O exemplo a seguir mostra como consultar a linha do tempo do time shifting:

// 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>

A tabela a seguir descreve os parâmetros do exemplo.

O exemplo a seguir mostra uma resposta de amostra:

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

Reprodução transcodificada com time shifting

Combine o time shifting com a transcodificação para reproduzir transmissões transcodificadas. Configure primeiro a transcodificação para habilitar essa funcionalidade. Para mais informações sobre como configurar a transcodificação, consulte Live stream transcoding.

Esta seção pressupõe que você já concluiu a configuração de transcodificação.

Ao configurar o time shifting, gere também dados de time shifting para as transmissões transcodificadas. O exemplo a seguir mostra o código de amostra:

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

Para ativar a reprodução com time shifting, add the time-shifting parameters à URL da transmissão transcodificada.

O exemplo a seguir mostra uma URL de reprodução:

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

Reprodução encapsulada com time shifting

Utilize o recurso Time Shifting.

Se não estiver familiarizado com o recurso de encapsulamento de transmissão ao vivo, consulte Live stream encapsulation.

Esta seção pressupõe que você já concluiu a configuração de encapsulamento de transmissão ao vivo.

Para reproduzir transmissões encapsuladas com time shifting, não é necessário modificar a configuração de time shifting. Basta adicionar os parâmetros de time shifting à URL da transmissão encapsulada.

O exemplo a seguir mostra uma URL de reprodução:

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

Referências

Para mais informações sobre as APIs de time shifting, consulte Time shifting.