Go SDK使用方式

安装

go get github.com/TTvcloud/vcloud-sdk-golang

AK/SK设置

• 在代码里显示调用VodService的方法SetAccessKey/SetSecretKey

• 在当前环境变量中分别设置 VCLOUD_ACCESSKEY="your ak" VCLOUD_SECRETKEY = "your sk"

• json格式放在～/.vcloud/config中，格式为：{"ak":"your ak","sk":"your sk"}

以上优先级依次降低，建议在代码里显示设置，以便问题排查

地域Region设置

• 目前已开放三个地域设置，分别为

  - cn-north-1 (默认)
  - ap-singapore-1
  - us-east-1
  

• 默认为cn-north-1（NewInstance初始化即默认为该地域），如果需要调用其它地域服务，请在初始化函数NewInstanceWithRegion中传入指定地域region，例如：

  ret, err := vod.NewInstanceWithRegion("us-east-1").GetRedirectPlayUrl(params)
  

• 注意1：IAM模块目前只开放cn-north-1区域
• 注意2：不要同时调用NewInstanceWithRegion 和 NewInstance，因为初始化为单例模式，会导致第二次调用不生效

API

上传

• 通过指定url地址上传

UploadMediaByUrl

• 服务端直接上传

上传视频包括 ApplyUpload 和 CommitUpload 两步

上传封面图包括 ApplyUpload 和 ModifyVideoInfo 两步

为方便用户使用，封装方法 UploadVideo 和 UploadPoster， 一步上传

转码

StartTranscode

发布

SetVideoPublishStatus

播放

GetPlayInfo

GetOriginVideoPlayInfo

GetRedirectPlay

封面图

GetPosterUrl

token相关

GetUploadAuthToken

GetPlayAuthToken

PS: 上述两个接口和 GetRedirectPlay 接口中均含有 X-Amz-Expires 这个参数

关于这个参数的解释为：设置返回的playAuthToken或uploadToken或follow 302地址的有效期，目前服务端默认该参数为15min（900s），如果用户认为该有效期过长，可以传递该参数来控制过期时间 。

更多示例参见

example目录