预热 M3U8
本文将详细为您介绍如何通过 EdgeOne 实现 M3U8 预热,从而系统性规避首播阶段的缓存穿透问题,确保用户请求可直接从节点获取完整资源,提升访问质量。
说明:
背景介绍
对于 HLS/DASH 等采用 M3U8 分片协议的流媒体服务,缓存预热能够有效解决首播阶段的性能瓶颈。由于传统分发模式中,用户首次访问需从源站逐级拉取M3U8 索引文件及关联 TS 分片资源,若边缘节点无缓存,将导致显著的首播延迟与播放卡顿。M3U8 预热的核心原理在于,获取 M3U8 索引文件关联的所有 TS 分片资源进行预热。
核心价值
降低访问延迟:用户请求直接从最近的 EdgeOne 节点获取资源,无需回源到源站。
提升播放成功率:减少因网络波动导致的视频中断。
优化源站成本:高频热点资源通过 EdgeOne 的缓存能力,降低源站带宽压力。
操作步骤
示例场景
假设您是一家视频厂商,已将站点域名
www.example.com
接入到 EdgeOne 加速,因为有热门剧集更新,期望提交影片的 M3U8 资源即可自动将关联的 TS 资源预热至 EdgeOne。步骤 1:创建 M3U8 的预热任务
注意:
M3U8 描述文件需要确保可正常请求,并按行业标准描述分片路径,支持的格式如下:
假设请求 URL 为:
https://www.example.com/c8679239vodtranssgp1500031474/5fac87c91397757892217228202/adp.1505647.m3u8
。该 URL 的内容格式为相对路径,如 1505647_0_0.ts,则 EdgeOne 会自行拼接为如下的 TS URL:
https://www.example.com/c8679239vodtranssgp1500031474/5fac87c91397757892217228202/1505647_0_0.ts
。M3U8 描述文件递归解析深度不超过
3
层。解析获取的分片数会正常累加每日预热用量,当用量超出配额时,会静默处理,不再执行预热。
1. Targets 字段:值为 M3U8 的 URL,如
https://www.example.com/c8679239vodtranssgp1500031474/5fac87c91397757892217228202/adp.1505647.m3u8
。2. PrefetchMediaSegments 字段,值为 on。该字段取值说明:
on:预热 M3U8 描述文件的同时,递归解析描述文件的 TS 资源进行预热。
off:不填时,默认值为 off。仅预热提交的 M3U8 描述文件。
3. 其它入参字段按需填写即可。
步骤 2:查询 M3U8 的预热任务状态
processing:处理中。
success:成功。
failed:失败。
timeout:超时。
invalid:无效。
调用示例
curl -X POST https://teo.tencentcloudapi.com -H "Authorization: TC3-HMAC-SHA256 Credential=******************************/2025-02-19/teo/tc3_request, SignedHeaders=content-type;host, Signature=9ec53d3ba8d4049c219052b0a2275ff3a30d3429d6295ae4c799c74d32c8f015" -H "Content-Type: application/json" -H "Host: teo.tencentcloudapi.com" -H "X-TC-Action: CreatePrefetchTask" -H "X-TC-Timestamp: 1739965395" -H "X-TC-Version: 2022-09-01" -H "X-TC-Language: zh-CN" -d '{"ZoneId":"zone-xxx","Targets":["https://www.example.com/c8679239vodtranssgp1500031474/5fac87c91397757892217228202/adp.1505647.m3u8"]}'
package mainimport ("fmt""github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common""github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/errors""github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/profile"teo "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/teo/v20220901")func main() {// 实例化一个认证对象,入参需要传入腾讯云账户 SecretId 和 SecretKey,此处还需注意密钥对的保密// 代码泄露可能会导致 SecretId 和 SecretKey 泄露,并威胁账号下所有资源的安全性。以下代码示例仅供参考,建议采用更安全的方式来使用密钥,请参见:https://cloud.tencent.com/document/product/1278/85305// 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取credential := common.NewCredential("SecretId","SecretKey",)// 实例化一个client选项,可选的,没有特殊需求可以跳过cpf := profile.NewClientProfile()cpf.HttpProfile.Endpoint = "teo.tencentcloudapi.com"// 实例化要请求产品的 client 对象,国内站可填 ap-guangzhou 作为接入地域,国际站可填写 ap-singapore 作为接入地域,clientProfile 是可选的client, _ := teo.NewClient(credential, "ap-guangzhou", cpf)// 实例化一个请求对象,每个接口都会对应一个 request 对象request := teo.NewCreatePrefetchTaskRequest()request.ZoneId = common.StringPtr("zone-364ni75dvzva")request.Targets = common.StringPtrs([]string{"https://www.example.com/1.m3u8"})request.PrefetchMediaSegments = common.StringPtr("on")// 返回的 resp 是一个 CreatePrefetchTaskResponse 的实例,与请求对象对应response, err := client.CreatePrefetchTask(request)if _, ok := err.(*errors.TencentCloudSDKError); ok {fmt.Printf("An API error has returned: %s", err)return}if err != nil {panic(err)}// 输出 json 格式的字符串回包fmt.Printf("%s", response.ToJsonString())}