腾讯云云点播Go SDK

对于在服务端上传视频的场景，云点播提供 Go SDK 来实现。上传流程请参见 服务端上传指引。

集成方式

使用 go get 引入

go get -u github.com/tencentcloud/tencentcloud-sdk-gogo get -u github.com/tencentyun/cos-go-sdk-v5go get -u github.com/tencentyun/vod-go-sdk

通过源码包安装

如果项目中需要直接引用源码，可以直接下载源码导入项目中使用：从 Github 访问单击下载 Go SDK

简单视频上传

初始化上传对象

使用云 API 密钥初始化 VodUploadClient 实例。

import (    "github.com/tencentyun/vod-go-sdk")
client := &vod.VodUploadClient{}client.SecretId = "your secretId"client.SecretKey = "your secretKey"

构造上传请求对象

import (    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common")
req := vod.NewVodUploadRequest()req.MediaFilePath = common.StringPtr("/data/video/Wildlife.mp4")

调用上传

调用上传方法，传入接入点地域及上传请求。

rsp, err := client.Upload("ap-guangzhou", req)if err != nil {    fmt.Println(err)    return}fmt.Println(*rsp.Response.FileId)fmt.Println(*rsp.Response.MediaUrl)

说明：上传方法根据用户文件的长度，自动选择普通上传以及分片上传，用户不用关心分片上传的每个步骤，即可实现分片上传。

高级功能

携带封面

package main
import (    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"    "github.com/tencentyun/vod-go-sdk"    "fmt")
func main() {    client := &vod.VodUploadClient{}    client.SecretId = "your secretId"    client.SecretKey = "your secretKey"
    req := vod.NewVodUploadRequest()    req.MediaFilePath = common.StringPtr("/data/video/Wildlife.mp4")    req.CoverFilePath = common.StringPtr("/data/video/Wildlife-cover.png")
    rsp, err := client.Upload("ap-guangzhou", req)    if err != nil {        fmt.Println(err)        return    }    fmt.Println(*rsp.Response.FileId)    fmt.Println(*rsp.Response.MediaUrl)    fmt.Println(*rsp.Response.CoverUrl)}

指定任务流

首先 创建任务流模板 并为模板命名，发起任务流时，可以用任务流模板名设置Procedure参数，上传成功后会自动执行任务流。

package main
import (    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"    "github.com/tencentyun/vod-go-sdk"    "fmt")
func main() {    client := &vod.VodUploadClient{}    client.SecretId = "your secretId"    client.SecretKey = "your secretKey"
    req := vod.NewVodUploadRequest()    req.MediaFilePath = common.StringPtr("/data/video/Wildlife.mp4")    req.Procedure = common.StringPtr("Your Proceducre Name")
    rsp, err := client.Upload("ap-guangzhou", req)    if err != nil {        fmt.Println(err)        return    }    fmt.Println(*rsp.Response.FileId)    fmt.Println(*rsp.Response.MediaUrl)}

应用上传

传入 应用 ID，上传成功后资源只属于具体的应用。

package main
import (    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"    "github.com/tencentyun/vod-go-sdk"    "fmt")
func main() {    client := &vod.VodUploadClient{}    client.SecretId = "your secretId"    client.SecretKey = "your secretKey"
    req := vod.NewVodUploadRequest()    req.MediaFilePath = common.StringPtr("/data/video/Wildlife.mp4")    req.SubAppId = common.Uint64Ptr(101)
    rsp, err := client.Upload("ap-guangzhou", req)    if err != nil {        fmt.Println(err)        return    }    fmt.Println(*rsp.Response.FileId)    fmt.Println(*rsp.Response.MediaUrl)}

指定存储地域

在 控制台 确认已经开通目标存储地域，若没有开通可以参考 上传存储设置，最后通过StorageRegion属性设置存储地域的 英文简称。

package main
import (    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"    "github.com/tencentyun/vod-go-sdk"    "fmt")
func main() {    client := &vod.VodUploadClient{}    client.SecretId = "your secretId"    client.SecretKey = "your secretKey"
    req := vod.NewVodUploadRequest()    req.MediaFilePath = common.StringPtr("/data/video/Wildlife.mp4")    req.StorageRegion = common.StringPtr("ap-chongqing")
    rsp, err := client.Upload("ap-guangzhou", req)    if err != nil {        fmt.Println(err)        return    }    fmt.Println(*rsp.Response.FileId)    fmt.Println(*rsp.Response.MediaUrl)}

指定分片并发数

分片并发数是针对大文件，拆分成多个分片同时进行上传。分片并发上传的优势在于可以快速完成单个文件的上传，SDK 会根据用户文件的长度，自动选择普通上传以及分片上传，用户不用关心分片上传的每个步骤，即可实现分片上传。而文件的分片并发数通过ConcurrentUploadNumber参数进行指定。

package main
import (    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"    "github.com/tencentyun/vod-go-sdk"    "fmt")
func main() {    client := &vod.VodUploadClient{}    client.SecretId = "your secretId"    client.SecretKey = "your secretKey"
    req := vod.NewVodUploadRequest()    req.MediaFilePath = common.StringPtr("/data/video/Wildlife.mp4")    req.ConcurrentUploadNumber = common.Uint64Ptr(5)
    rsp, err := client.Upload("ap-guangzhou", req)    if err != nil {        fmt.Println(err)        return    }    fmt.Println(*rsp.Response.FileId)    fmt.Println(*rsp.Response.MediaUrl)}

使用临时证书上传

传入 临时证书 的相关密钥信息，使用临时证书验证身份并进行上传。

package main
import (    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"    "github.com/tencentyun/vod-go-sdk"    "fmt")
func main() {    client := &vod.VodUploadClient{}    client.SecretId = "Credentials TmpSecretId"    client.SecretKey = "Credentials TmpSecretKey"    client.Token = "Credentials Token"
    req := vod.NewVodUploadRequest()    req.MediaFilePath = common.StringPtr("/data/video/Wildlife.mp4")
    rsp, err := client.Upload("ap-guangzhou", req)    if err != nil {        fmt.Println(err)        return    }    fmt.Println(*rsp.Response.FileId)    fmt.Println(*rsp.Response.MediaUrl)}

设置代理上传

设置上传代理，涉及协议及数据都会经过代理进行处理，开发者可以借助代理在自己公司内网上传文件到腾讯云。

package main
import (    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"    "github.com/tencentyun/vod-go-sdk"    "fmt"    "net/http"    "net/url")
func main() {    client := &vod.VodUploadClient{}    client.SecretId = "your secretId"    client.SecretKey = "your secretKey"    proxyUrl, _ := url.Parse("your proxy url")    client.Transport = &http.Transport{        Proxy: http.ProxyURL(proxyUrl),    }
    req := vod.NewVodUploadRequest()    req.MediaFilePath = common.StringPtr("/data/video/Wildlife.mp4")
    rsp, err := client.Upload("ap-guangzhou", req)    if err != nil {        fmt.Println(err)        return    }    fmt.Println(*rsp.Response.FileId)    fmt.Println(*rsp.Response.MediaUrl)}

自适应码流文件上传

本 SDK 支持上传的自适应码流格式包括 HLS 和 DASH，同时要求 manifest（M3U8 或 MPD）所引用的媒体文件必须为相对路径（即不可以是 URL 和绝对路径），且位于 manifest 的同级目录或者下级目录（即不可以使用../）。在调用 SDK 上传接口时，MediaFilePath参数填写 manifest 路径，SDK 会解析出相关的媒体文件列表一并上传。

package main
import (    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"    "github.com/tencentyun/vod-go-sdk"    "fmt")
func main() {    client := &vod.VodUploadClient{}    client.SecretId = "your secretId"    client.SecretKey = "your secretKey"
    req := vod.NewVodUploadRequest()    req.MediaFilePath = common.StringPtr("/data/video/prog_index.m3u8")
    rsp, err := client.Upload("ap-guangzhou", req)    if err != nil {        fmt.Println(err)        return    }    fmt.Println(*rsp.Response.FileId)    fmt.Println(*rsp.Response.MediaUrl)    fmt.Println(*rsp.Response.CoverUrl)}

接口描述

上传客户端类VodUploadClient

上传请求类VodUploadRequest

上传响应类 VodUploadResponse

上传方法 VodUploadClient.Upload(region string, request *VodUploadRequest)

错误码表



云点播官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠