全部产品
Search
文档中心

智能媒体服务:点播封装

更新时间:Jan 27, 2026

本文介绍点播封装功能。

功能介绍

点播封装功能可以对点播媒体资源进行内容封装,使您的播放内容能够支持不同的播放协议(目前支持封装HLS,DASH和HLS_CMAF播放协议),也支持对视频内容进行DRM加密。

重要

使用点播封装功能会产生费用,计费说明请参见点播封装计费

使用限制

  • 封装输入端(需要被封装的资源文件)只能是m3u8主播放列表。

    m3u8文件分为主播放列表和媒体播放列表。

    常见的主播放列表和媒体播放列表内容如下:

    主播放列表

    #EXTM3U
    #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=100000,CODECS="mp4a.40.2,avc1.64001e",RESOLUTION=640x302
    video/player-ld.m3u8
    #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=200000,CODECS="mp4a.40.2,avc1.64001f",RESOLUTION=848x402
    video/player-sd.m3u8
    #EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=300000,CODECS="mp4a.40.2,avc1.640020",RESOLUTION=1280x606
    video/player-hd.m3u8
    

    媒体播放列表

    #EXTM3U
    #EXT-X-VERSION:3
    #EXT-X-MEDIA-SEQUENCE:1
    #EXT-X-TARGETDURATION:17
    #EXTINF:15.500,
    1723518810_120.ts
    #EXT-X-DISCONTINUITY
    #EXTINF:16.666,
    1723518884_121.ts
    #EXTINF:2.533,
    1723518886_122.ts
    #EXT-X-ENDLIST
  • 目前点播封装功能只能使用OSS中的文件,因此在使用点播封装功能之前,您需要将文件存储至OSS中。使用OSS可参见快速入门

    重要

    文件存储在OSS中,会产生存储费用,在OSS中计费请参见OSS存储费用

  • OSSBucket地域需要与封装功能地域一致。

功能配置

  1. 创建打包组。登录智能媒体服务控制台,在左侧导航栏选择媒体封装 > 点播封装 > 封装组,可以创建打包组。

    image

    参数说明:

    参数名

    说明

    名称

    自定义输入,不能重复。

  2. 创建打包配置。点击打包组名称进入打包组详情页可以创建打包配置。

    image

    创建打包配置:

    image

    参数名

    说明

    打包配置详情(基础配置)

    名称

    自定义输入,不能重复。

    说明

    不同的打包组之间也不能重复。

    打包格式

    打包协议和切片格式。

    Apple HLS:以TS切片打包HLS协议。

    DASH-ISO:以CMAF切片打包DASH协议。

    CMAF:以CMAF切片打包HLS协议。

    分片时长

    打包流中单个切片文件的时长。

    建议设置该值为6,不建议设置过大或过小。设置越大,单个切片的内容越多,延迟越高。设置越小,单个切片内容越少,会间接增加请求次数导致资源开销增加。

    清单设置(播放相关配置)

    清单名称

    播放清单文件名。比如选择Apple HLS打包格式,填写index,则播放地址为:https://example.aliyundoc.com/index.m3u8。

    流选择(封装流扩展配置)

    流选择

    开关。

    流排序

    该配置项可以让打包流主播放列表的清单文件顺序区别于源流的清单文件顺序。比如源流中BANDWIDTH高的清单文件在前,通过此配置可以实现BANDWIDTH低的清单文件在前。

    取值:

    • Original:用于按传入源使用的相同顺序对清单文件进行排序。

    • ASCENDING:对清单文件进行排序,从最低比特率开始,到最高比特率结束。

    • DESCENDING:对清单文件进行排序,从最高比特率开始,到最低比特率结束。

    最小视频码率

    打包流主播放列表中将不会包含低于该值的清单文件。

    最大视频码率

    打包流主播放列表中将不会包含高于该值的清单文件。

    加密方法(DRM加密相关配置,使用该配置前您可能需要先了解DRM加密相关技术的使用)

    说明

    Media Package不直接提供DRM密钥服务及密钥管理能力,如需开启并使用DRM能力,需要提前选定第三方DRM供应商并与第三方供应商沟通加密解决方案,相应DRM费用也将在DRM供应商平台产生,Media Package不收取DRM加密相关费用。

    加密方法

    • AES 128-bit

    • Sample AES

    系统 ID

    • Apple FairPlay (94ce86fb-07ff-4f43-adb8-93d2fa968ca2)

    • Google Widevine (edef8ba9-79d6-4ace-a3c8-27dcd51d21ed)

    • Microsoft PlayReady (9a04f079-9840-4286-ab92-e65be0885f95)

    URL

    代理服务器的 URL,确保媒体打包能够通过该代理与密钥服务器进行通信。

    示例1:https://example.aliyundoc.com/encryption/{token}

    示例2:https://example.aliyundoc.com/encryption -H "{key:value}"

    示例3:https://example.aliyundoc.com/encryption?key1=value1&key2=value2

    固定初始化向量

    自定义输入。输入 128 位、32 字符、十六进制编码的字符串。不指定时,初始化向量将定期轮换。

功能使用

完成封装配置之后,需要对点播资源进行关联。您可以点击打包配置名称进入详情页,点击关联资产页签,导入资产。也可以通过资产管理功能导入资产。

资产管理

在左侧导航栏选择媒体封装 > 点播封装 > 资产管理,导入资产。

image

导入资产:

image

参数说明:

参数名

说明

打包组(封装相关配置)

打包组

选择打包组,打包组内的打包配置会整体生效。比如一个打包组内有多种打包配置,资源会根据每个打包配置进行打包。

添加资产(添加需要打包的媒体资源,可添加多个)

资产名称

自定义输入。不能和已有资产名称重复。

相对路径

选择存储在OSS中的m3u8清单文件。只能从同地域的OSSBucket中选取文件。

内容ID

如您配置了 DRM 加密,则该项必填。

使用说明:

  • 点击资产名称进入资产详情页,可以获取到打包后的播放URL。您也可以通过预览操作,体验打包后的播放效果。

    image

    资产详情:

    image

常见问题

打包是在什么时候执行

使用输出地址进行播放时执行打包(导入资产时不会执行打包)。

播放打包流失败

如果播放打包流失败,请检查输出地址的状态是否为可播放。如果不是可播放状态,请检查您打包配置是否正确,此外打包输入端需要是m3u8主播放列表,详情请参见使用限制

资产管理功能和打包配置关联资产有什么区别

两者都可以实现打包。资产管理展示的是所有的资产,打包配置关联资产内展示的是当前打包组的资产。