全部产品
云市场

请求参数说明

更新时间:2019-07-21 10:56:28

媒体播放自定义设置 PlayConfig

媒体播放时的自定义设置字段,为JSON字符串,目前支持指定域名播放的设置。
支持如下字段:

名称类型必填描述
PlayDomainString播放域名名称。当配置多个播放域名时,可指定使用其中一个域名播放当前视频。当指定域名不存在时,播放地址返回当前视频存储对应的默认播放域名。
取值示例:"vod.test_domain"
XForwardedForString客户端请求的真实IP。可用于验证 审核安全IP 等场景。可解决经过多层代理后,点播服务无法获取到原始客户端IP的问题。为了保障数据安全性,该IP值为加密后的值,加密方式为AES/ECB/PKCS5Padding,加密使用的密钥请提交工单后由点播后台处理。
取值示例:"yqCD7Fp1uqChoVj/sl/p5Q=="
PreviewTimeString视频点播试看时长,单位为秒。最小值1,最大值为视频总时长,未指定时表示观看完整视频,开启试看功能详见 点播试看最佳实践
MtsHlsUriTokenString 业务方令牌服务生成的MtsHlsUriToken,适用于 HLS标准加密 的视频播放,实现对业务方解密秘钥的保护,防止秘钥被窃取。
EncryptTypeString加密类型,可用于筛选非加密或加密流进行播放。取值范围:
  • Unencrypted(非加密)
  • AliyunVoDEncryption(阿里云私有加密)
  • HLSEncryption(HLS标准加密)

示例:

  1. PlayConfig={"PlayDomain":"vod.test_domain","XForwardedFor":"yqCD7Fp1uqChoVj/sl/p5Q==","PreviewTime":"20","MtsHlsUriToken":"yqCD7Fp1uqChoVjslp5Q"}

CDN二次鉴权设置 ReAuthInfo

媒体播放时设置的CDN二次鉴权参数,为JSON字符串。当开启了CDN二次鉴权功能时,可通过该参数设置鉴权URL的uid和rand。
支持如下字段:

名称类型必填描述
uidString附加参数,一般为0,可自定义。
randString随机数,一般为0,如要确保每次生成的URL不同则可使用UUID等做随机数。

示例:

  1. ReAuthInfo={"uid":"12345","rand":"abckljd"}

媒体上传自定义设置 UserData

媒体上传时的自定义设置字段,为JSON字符串,支持消息回调等设置。
支持如下字段:

名称类型必填描述
MessageCallbackString消息回调设置,指定时以此为准,否则以 全局设置的事件通知 为准。
取值示例:{"CallbackType":"http", "CallbackURL":"http://callback-host/addr"}
其中 CallbackType为回调方式,默认为http,CallbackURL为回调地址。
ExtendString用户自定义的扩展字段,用于回调时透传返回,最大长度512字节。

示例:

  1. UserData={"MessageCallback":"{"CallbackURL":"http://test.test.com"}", "Extend":"{"localId":"xxx", "test":"www"}"}

加密配置 EncryptConfig

标准加密配置。

名称 类型 描述
CipherText String 密文秘钥,用来获取明文秘钥
DecryptKeyUri String 根据密文秘钥获取解密秘钥地址,例如:http://decrypt.demo.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt
KeyServiceType String 密钥服务类型,默认值:KMS(阿里云密钥管理服务KMS)

截雪碧图配置 SpriteSnapshotConfig

字段名称 类型 描述
CellWidth String 雪碧图中小图的高 ,默认为截图输出的宽,单位:px
CellHeight String 雪碧图中小图的宽,默认为截图输出的高,单位:px
Padding String 小图内边距大小,默认为0,单位:px
Margin String 小图外边距大小 ,默认为0,单位:px
Color String 雪碧图背景颜色 ,默认为Black
Columns String 小图列数 ,取值范围:[1,10000],默认取值:10
Lines String 小图行数,取值范围:[1,10000],默认取值:10
KeepCellPic String 是否保留小图,取值:keep(保留),delete(删除)。默认为keep

说明:当SpriteSnapshotConfig需要全部采用默认值,传入JSON空串:{}。