直播封装

阿里云视频直播支持直播封装服务,支持封装HLS、DASH、LL-HLS(低延迟HLS)等播放协议,支持TS,CMAF切片格式。通过阅读本文,您可以了解直播封装服务的详细信息。

简介

阿里云基础直播服务提供RTMP、HTTP-FLV、HLS等播放协议。为支持更丰富、更低延迟的播放协议和体验,视频直播新增了直播封装服务,根据不同的切片类型支持低延迟HLS-TS、低延迟HLS-CMAF、HLS-CMAF、DASH-CMAF、HLS&DASH-CMAF封装协议,如下所示:

切片类型

支持的封装协议

支持的编码格式

TS

低延迟HLS-TS

  • 音频编码:AAC、OPUS、AC3、EAC3、MP3

  • 视频编码:H.264、H.265

CMAF

  • 低延迟HLS-CMAF

  • HLS-CMAF

  • DASH-CMAF

  • HLS&DASH-CMAF

  • 音频编码:AAC

  • 视频编码:H.264、H.265

说明

低延迟HLS-TS会以TS格式封装低延迟HLS协议,低延迟HLS-CMAF会以CMAF格式封装低延迟HLS协议,其他情况以此类推。

功能及优势

  • 开启直播封装后,视频直播流会被切成TSCMAF切片,通过HLS、LL-HLSDASH协议分发,用户请求的播放列表中包含不断刷新的切片地址。

  • 相对于HLS,LL-HLS可以将切片分割成更小的Part切片(0.2~1秒),并支持阻塞加载,实现3~5秒的低延迟。相对于TS格式,CMAF封装格式支持更多设备和浏览器,并支持更新的编解码器(codec),如H.265。

  • 直播封装服务可与直播转码(含多码率转码)、直播时移等组合使用,可提供灵活、丰富的能力。

使用场景

低延迟直播:直播服务提供HLS播放地址,在您的业务场景中如果需要在支持HLS协议的情况下降低延迟,可以对HLS协议进行封装,使用LL-HLS(低延迟HLS)协议。

多设备浏览器支持:直播服务提供的HLS播放地址默认采用TS切片格式进行封装,如果TS切片格式不能满足您的业务需求,您可以通过封装功能使用CMAF封装格式进行封装,适配更多的设备和浏览器。

注意事项

为了CMAFLL-HLS播放流畅,推流需确保GOP大小稳定,且直播封装切片时长为GOP时长的整数倍。如果封装配置包含转码流,也需确保转码流的GOP稳定。

对于LL-HLS协议,需要注意以下事项:

  • 在网络情况不佳时卡顿率会增高,建议与多码率转码组合使用,网络不佳时自动降低码率。

  • 需要确保直播流GOP固定为1秒或2秒,否则会导致卡顿或播放失败。

  • 需使用支持LL-HLS的播放器,如AliPlayer、hls.js、ExoPlayer等。

  • 同一主播流域名最大支持直播观看人数为10万人,如需支持更多人观看,请提交工单申请。

  • 域名第一次添加封装配置时,会同步下发播放域名加速相关配置,3~5分钟后可生效。

功能使用

配置直播封装

视频直播目前支持两种方式进行直播封装功能配置。

控制台配置直播封装功能

  1. 登录视频直播控制台
  2. 在左侧导航栏单击功能管理>直播封装

  3. 单击您要配置的播流域名,单击添加

    image

    直播封装配置参数及说明如下表所示。

    参数

    描述

    AppName

    • AppName必须与推流地址中的AppName名称一样,封装配置才能生效。

    • AppName不超过256字符,支持数字、大小写字母、短划线(-)、下划线(_)。

    • AppName也支持输入单个星号(*)字符,表示匹配任意字符串(包括空字符串)。

    StreamName

    • StreamName必须与推流地址中的StreamName名称一样,封装配置才能生效。

    • StreamName不超过256字符,支持数字、大小写字母、短划线(-)、下划线(_)。

    • StreamName也支持输入单个星号(*)字符,表示匹配任意字符串(包括空字符串)。

    协议配置

    选择封装协议,可选:

    • HLS - CMAF

    • 低延迟HLS - CMAF

    • 低延迟HLS - TS

    • DASH-CMAF

      说明

      只支持DASH

    • HLS&DASH-CMAF

      说明

      DASHHLS都支持

    切片个数

    选择配置的切片个数,支持输入范围3~5的整数。

    切片时长

    • 当协议配置选择HLS - CMAF、DASH-CMAF、HLS&DASH-CMAF时,取值范围为1~10的整数,单位s。固定GOP,建议GOP5s,需要保证切片时长为GOP的整数倍。

    • 当协议配置选择低延迟HLS - CMAF和低延迟HLS - TS时,取值范围为1~2的整数,单位s。固定GOP,建议GOP1s,需要保证切片时长为GOP的整数倍。

    part切片时长

    仅封装协议选择低延迟HLS - CMAF和低延迟HLS - TS,需要配置part切片时长。取值范围为200-1000的整数,单位ms。建议略大于切片时长的1/3。

    转码流

    可选仅配置原始流和包含转码流。

    说明
    • AppName/StreamName匹配的视频流配置了直播时移功能,直播时移的切片时长和格式,会按照封装配置的切片时长和格式生效。

    • AppName/StreamName匹配的视频流配置了多码率转码,多码率HLS直播的切片时长和格式,会按照封装配置的切片时长和格式生效。

    • 若播放域名对应的区域为海外区域时(新加坡、德国、日本、印尼),可能会存在延迟较大的问题 ,建议配置完成后请先测试验证是否符合预期。

  4. 配置参数后,单击确定

API配置直播封装功能

// This file is auto-generated, don't edit it. Thanks.
package demo;

import com.aliyun.auth.credentials.Credential;
import com.aliyun.auth.credentials.provider.StaticCredentialProvider;
import com.aliyun.core.http.HttpClient;
import com.aliyun.core.http.HttpMethod;
import com.aliyun.core.http.ProxyOptions;
import com.aliyun.httpcomponent.httpclient.ApacheAsyncHttpClientBuilder;
import com.aliyun.sdk.service.live20161101.models.*;
import com.aliyun.sdk.service.live20161101.*;
import com.google.gson.Gson;
import darabonba.core.RequestConfiguration;
import darabonba.core.client.ClientOverrideConfiguration;
import darabonba.core.utils.CommonUtil;
import darabonba.core.TeaPair;

//import javax.net.ssl.KeyManager;
//import javax.net.ssl.X509TrustManager;
import java.net.InetSocketAddress;
import java.time.Duration;
import java.util.*;
import java.util.concurrent.CompletableFuture;
import java.io.*;

public class AddLivePackageConfig {
    public static void main(String[] args) throws Exception {

        // HttpClient Configuration
        /*HttpClient httpClient = new ApacheAsyncHttpClientBuilder()
                .connectionTimeout(Duration.ofSeconds(10)) // Set the connection timeout time, the default is 10 seconds
                .responseTimeout(Duration.ofSeconds(10)) // Set the response timeout time, the default is 20 seconds
                .maxConnections(128) // Set the connection pool size
                .maxIdleTimeOut(Duration.ofSeconds(50)) // Set the connection pool timeout, the default is 30 seconds
                // Configure the proxy
                .proxy(new ProxyOptions(ProxyOptions.Type.HTTP, new InetSocketAddress("<YOUR-PROXY-HOSTNAME>", 9001))
                        .setCredentials("<YOUR-PROXY-USERNAME>", "<YOUR-PROXY-PASSWORD>"))
                // If it is an https connection, you need to configure the certificate, or ignore the certificate(.ignoreSSL(true))
                .x509TrustManagers(new X509TrustManager[]{})
                .keyManagers(new KeyManager[]{})
                .ignoreSSL(false)
                .build();*/

        // Configure Credentials authentication information, including ak, secret, token
        StaticCredentialProvider provider = StaticCredentialProvider.create(Credential.builder()
                // Please ensure that the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are set.
                .accessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                .accessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
                //.securityToken(System.getenv("ALIBABA_CLOUD_SECURITY_TOKEN")) // use STS token
                .build());

        // Configure the Client
        AsyncClient client = AsyncClient.builder()
                .region("<Your RegionId>") // Region ID
                //.httpClient(httpClient) // Use the configured HttpClient, otherwise use the default HttpClient (Apache HttpClient)
                .credentialsProvider(provider)
                //.serviceConfiguration(Configuration.create()) // Service-level configuration
                // Client-level configuration rewrite, can set Endpoint, Http request parameters, etc.
                .overrideConfiguration(
                        ClientOverrideConfiguration.create()
                                  // Endpoint 请参考 https://api.aliyun.com/product/live
                                .setEndpointOverride("live.aliyuncs.com")
                        //.setConnectTimeout(Duration.ofSeconds(30))
                )
                .build();

        // Parameter settings for API request
        AddLivePackageConfigRequest addLivePackageConfigRequest = AddLivePackageConfigRequest.builder()
                .regionId("<Your RegionId>")
                .domainName("<Your DomainName>")
                .appName("<Your AppName>")
                .streamName("<Your StreamName>")
                // Request-level configuration rewrite, can set Http request parameters, etc.
                // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
                .build();

        // Asynchronously get the return value of the API request
        CompletableFuture<AddLivePackageConfigResponse> response = client.addLivePackageConfig(addLivePackageConfigRequest);
        // Synchronously get the return value of the API request
        AddLivePackageConfigResponse resp = response.get();
        System.out.println(new Gson().toJson(resp));
        // Asynchronous processing of return values
        /*response.thenAccept(resp -> {
            System.out.println(new Gson().toJson(resp));
        }).exceptionally(throwable -> { // Handling exceptions
            System.out.println(throwable.getMessage());
            return null;
        });*/

        // Finally, close the client
        client.close();
    }

}
说明

使用直播封装

推流

在使用直播封装功能时,为了CMAF和低延迟HLS播放流畅,推流需确保GOP大小稳定。

OBS推流可参考如下设置(关于OBS更多使用信息,请参见OBS推流工具):

image.png

播放

对于不同的封装协议,需使用不同的播放地址。各封装协议播放地址示例如下:

封装协议

地址示例

HLS

http://<DomainName>/<AppName>/<StreamName>.m3u8?aliyunols=on&auth_key=1725503*****

DASH

http://<DomainName>/<AppName>/<StreamName>.mpd?aliyunols=on&auth_key=17255038******

低延迟HLS

http://<DomainName>/<AppName>/<StreamName>-llhls.m3u8?aliyunols=on&auth_key=1725503******
说明
  • 在播放封装流时,aliyunols=on为必填固定参数。

  • 各封装格式提供的协议地址如下:

    • 低延迟HLS-TS:低延迟HLS地址和HLS地址。

    • 低延迟HLS-CMAF:低延迟HLS地址和HLS地址。

    • HLS-CMAF:HLS地址。

    • DASH-CMAF:DASH地址。

    • HLS&DASH-CMAF:HLS地址和DASH地址。

  • 推荐您使用阿里云播放器,关于阿里云播放器说明请参见播放器SDK

  • 使用Web端阿里云播放器或直接通过控制台播放时,需要配置HTTPS证书与跨域访问。配置HTTPS证书请参见配置HTTPS安全加速,跨域访问配置请参见配置HTTP消息头

您可以参考以下示例使用Web端阿里云播放器播放:

image

  1. 选择播放类型为直播

  2. 输入播放地址。

  3. 点击播放预览进行播放。

重要
  • 为支持浏览器跨域播放,需要配置HTTPAccess-Control-Allow-Origin,详情请参见配置HTTP消息头

进阶使用

封装转码流

直播封装功能可以结合转码功能使用,对转码流进行协议封装。

封装转码流,需要先完成直播转码功能配置,具体操作请参见直播转码

此处假设您已完成转码功能配置。

在进行封装配置时,将转码流也进行封装。

//是否忽略转码流,true/false,默认值true
addLivePackageConfigRequest.setIgnoreTranscode(<false>);

播放封装转码流只需要将封装协议地址StreamName替换成StreamName_转码模板ID的形式。

例如现在要播放一个低延迟HLS的转码流,示例地址如下:

http://<DomainName>/<AppName>/<StreamName_转码模板ID>-llhls.m3u8?aliyunols=on&auth_key=1725503******
说明
  • 建议您可以将封装功能与多码率转码功能结合使用,在网络不佳时自动调整码率播放。

  • 播放封装多码率转码流只需将StreamName替换成StreamName_转码模板组ID的形式。

重要
  • 封装多码率转码流,转码流地址会按照直播封装指定的协议和切片格式改变(例如指定封装格式为DASH-CMAF,多码率转码将只会提供DASH转码流地址,不会提供HLS转码流地址)。

  • 封装通用转码或自定义转码流,转码流地址不受影响,会另外增加转码流的封装地址。

  • 封装地址请参见本文档播放封装流相关内容。

时移播放封装流

直播时移功能可以让直播观众在直播过程中回看直播内容,直播封装功能可与直播时移功能组合使用,详情可参见直播时移

说明

如果开启了直播时移,时移的封装格式将采用直播封装指定的切片长度和格式。对于HLS或低延迟HLS-CMAF格式,直播时移切片也将变成CMAF格式;对于低延迟HLS-TS格式,直播时移切片仍为TS格式。

相关文档

直播封装相关API