注意：说明：
注意：该能力为白名单功能，如需使用，请 联系我们 。
一、背景介绍
对于 HLS/DASH 等采用 M3U8 分片协议的流媒体服务，缓存预热能够有效解决首播阶段的性能瓶颈。由于传统分发模式中，用户首次访问需从源站逐级拉取 M3U8 索引文件及关联 TS 分片资源，若边缘节点无缓存，将导致显著的首播延迟与播放卡顿。M3U8 预热的核心原理在于，获取 M3U8 索引文件关联的所有 TS 分片资源进行预热。
二、核心价值
·降低访问延迟：用户请求直接从最近的 EdgeOne 节点获取资源，无需回源到源站。
·提升播放成功率：减少因网络波动导致的视频中断。
·优化源站成本：高频热点资源通过 EdgeOne 的缓存能力，降低源站带宽压力。
三、示例场景
假设你是一家视频厂商，已将站点域名 www.example.com 接入到 EdgeOne 加速，因为有热门剧集更新，期望提交影片的 M3U8 资源即可自动将关联的 TS 资源预热至 EdgeOne。
四、步骤 1：创建 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。
调用 CreatePrefetchTask 接口，其中：
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 的预热任务状态
调用 DescribePrefetchTasks 接口，可以根据创建预热任务返回的 job-id 或者通过 target 进行查询，任务状态的说明如下：
·processing：处理中。
·success：成功。
·failed：失败。
·timeout：超时。
·invalid：无效。
六、调用示例
curlGolangcurl -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())}