请求参数说明_附录_服务端API

媒体播放自定义设置 PlayConfig

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

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

示例：

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

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

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

示例：

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

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

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

示例：

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

标准加密配置。

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

字段名称	类型	描述
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空串：{}。