媒体与 HLS

ctx := context.Background()

resp, httpRes, err := apiClient.HlsAPI.GetMediaFileInfo(ctx, "your-library-id", "your-space-id", "/videos/movie.mp4").
    Info(1).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    fmt.Printf("分辨率: %sx%s\\n", *resp.Width, *resp.Height)
    fmt.Printf("码率: %s kbps, 时长: %s 秒\\n", *resp.Bitrate, *resp.Duration)
    fmt.Printf("可用转码模板: %v\\n", resp.AllowedTranscodingTemplates)
}

ctx := context.Background()

resp, httpRes, err := apiClient.HlsAPI.CreateTranscodeTask(ctx, "your-library-id", "your-space-id", "/videos/movie.mp4").
    Transcode(1).
    CreateTranscodeTaskRequest(client.CreateTranscodeTaskRequest{
        TranscodingTemplateId: "h264_720p",
    }).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 && resp.TaskId != nil {
    fmt.Printf("转码任务已提交，taskId: %d\\n", *resp.TaskId)
    // 通过任务管理接口轮询转码结果
}

ctx := context.Background()

// 如需获取 Location 中的播放地址而非自动跟随跳转，注入自定义 http.Client 阻止重定向
cfg := client.NewConfiguration()
cfg.Servers = client.ServerConfigurations{
    {URL: "https://smhxxx.api.tencentsmh.cn", Description: "SMH API Server"},
}
cfg.HTTPClient = &http.Client{
    CheckRedirect: func(req *http.Request, via []*http.Request) error {
        return http.ErrUseLastResponse // 阻止自动跟随，保留 302 响应
    },
}
apiClient := client.NewAPIClient(cfg)

_, httpRes, err := apiClient.HlsAPI.LiveTranscodeMediaFile(ctx, "your-library-id", "your-space-id", "/videos/movie.mp4").
    LiveTranscode(1).
    TranscodingTemplateId("h264_720p").
    AccessToken("your-access-token").
    Execute()
if err != nil {
    // 阻止跟随后，302 会因状态码 >= 300 被 SDK 判为错误，此时从 Location 取播放地址
    if httpRes != nil && httpRes.StatusCode == 302 {
        fmt.Printf("播放地址: %s\\n", httpRes.Header.Get("Location"))
    } else {
        panic(err)
    }
}

// 若使用默认 apiClient（自动跟随），则 err 为 nil、httpRes.StatusCode 为 200，
// 但 200 不在本接口声明的响应码中，Execute 第一个返回值为 nil，
// m3u8 内容不会被解析返回，请按上面的方式获取播放地址

ctx := context.Background()

httpRes, err := apiClient.FileAPI.DownloadTranscodedVideo(ctx, "your-library-id", "your-space-id", "/videos/movie.mp4").
    TranscodingTemplateId("h264_720p").
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

// 服务端返回 302，SDK 默认自动跟随跳转后 httpRes.StatusCode 为最终响应的 200
fmt.Printf("Status: %d\\n", httpRes.StatusCode)

ctx := context.Background()

prepareReq := client.PrepareM3u8UploadRequest{
    Segments: []client.PrepareM3u8UploadRequestSegmentsInner{
        {Path: client.PtrString("1.ts")},
        {Path: client.PtrString("2.ts")},
    },
}

resp201, resp200, httpRes, err := apiClient.HlsAPI.PrepareM3u8Upload(ctx, "your-library-id", "your-space-id", "/videos/hls/movie.m3u8").
    ConflictResolutionStrategy("rename").
    PrepareM3u8UploadRequest(prepareReq).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

switch httpRes.StatusCode {
case 201:
    fmt.Printf("ConfirmKey: %s\\n", *resp201.ConfirmKey)
    // 按 resp201.Playlist 与 resp201.Segments 中的预签名信息直传 COS
case 200:
    fmt.Println("秒传成功")
}

ctx := context.Background()

confirmReq := client.ConfirmM3u8UploadRequest{
    Segments: []client.ConfirmM3u8UploadRequestSegmentsInner{
        {Path: client.PtrString("1.ts"), Crc64: client.PtrString("crc64-of-segment-1")},
        {Path: client.PtrString("2.ts"), Crc64: client.PtrString("crc64-of-segment-2")},
    },
    // Playlist 的 crc64 与最后一批 Segments 同传，或单独最后提交
}

resp, httpRes, err := apiClient.HlsAPI.ConfirmM3u8Upload(ctx, "your-library-id", "your-space-id", "confirm-key-from-prepare").
    Confirm(1).
    ConfirmM3u8UploadRequest(confirmReq).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 && resp.Playlist != nil {
    fmt.Printf("播放列表路径: %v\\n", resp.Playlist.Path)
}

ctx := context.Background()

renewReq := client.RenewM3u8UploadRequest{
    Segments: []string{"1.ts", "2.ts"},
}

resp, httpRes, err := apiClient.HlsAPI.RenewM3u8Upload(ctx, "your-library-id", "your-space-id", "confirm-key-from-prepare").
    Renew(1).
    RenewM3u8UploadRequest(renewReq).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    // 使用新的预签名信息（含新的 expiration）继续上传
    for path := range *resp.Segments {
        fmt.Printf("已续期分片: %s\\n", path)
    }
}