Huweicai/vcloud-sdk-golang

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，一步上传

STS2 鉴权

点播提供的 API

GetVideoPlayAuth ( vidList,streamTypeList,watermarkList []string)

vidList、streamTypeList、watermarkList 为3种资源，分别代表视频vid、stream type和水印三种资源，切片为空是代表允许访问所有资源。

默认的 action 为 vod::GetPlayInfo（不需手动设置）

默认过期时间为1小时，可以通过如下 API 自定义过期时间

GetVideoPlayAuthWithExpiredTime(vidList, streamTypeList, watermarkList []string, expiredTime time.Duration)

示例代码：

func main() {
       instance := vod.NewInstance()
       vidList, streamTypeList, watermarkList := make([]string, 0), make([]string, 0), make([]string, 0)
       ret, _ := instance.GetVideoPlayAuth(vidList, streamTypeList, watermarkList)
       b, _ := json.Marshal(ret)
       fmt.Println(string(b))
}

自定义 STS2 授权模式

// 第1步 创建 Policy
inlinePolicy := new(base.Policy)

// 第2步 创建  actions 和 resources
actions := []string{"service:Method"} // eg: vod:GetPlayInfo
resources := make([]string, 0)
// 其中每个 resource 格式类似 "trn:vod::*:video_id/%s"，若允许全部则用 * 替代，否则用实际字符串替代，本例可以填写实际的 vid
if len(vidList) == 0 {
       resources = append(resources, fmt.Sprintf(ResourceVideoFormat, "*"))
} else {
       for _, vid := range vidList {
              resources = append(resources, fmt.Sprintf(ResourceVideoFormat, vid))
       }
}

// 第3步 创建 Statement,允许的 NewAllowStatement, 拒绝的 NewDenyStatement，并添加到 Policy 对应的 Statement 切片里
statement := base.NewAllowStatement(actions, resources)
inlinePolicy.Statement = append(inlinePolicy.Statement, statement)

// 第4步 调用 SignSts2 生成签名
return SignSts2(inlinePolicy, expiredTime)