publish jdcloud-sdk-python 1.6.51

Author: Tanc009

jdcloud_sdk/services/mps/ChangeLog.md

@@ -1,13 +1,15 @@
 更新历史
 ---------------------------------------------------------------------
-API版本：0.4.7
+API版本：0.4.9
 
 |    发布时间      |  版本号    | 更新       | 说明
 | ---------------| -----------|-----------|---------|
-| 2018-03-31  | 0.2.1 |  按照规范修改；增加参数taskID  |按照规范修改；增加参数taskID
-| 2018-04-28 | 0.3.6 | 完善description  |完善description
-| 2018-08-23  |0.3.7 | 增加接口总述及面向对象；修改截图接口描述 |增加接口总述及面向对象；修改截图接口描述
-| 2019-03-07  |0.4.1 | 增加图片样式分隔符接口 |增加图片样式分隔符接口
-| 2019-05-29  |0.4.5 | 增加图片样式接口 |增加图片样式接口
-| 2020-02-12  |0.4.6 | 增加转码相关接口 |增加接口：提交转码作业/查询转码作业列表
-| 2020-03-03  |0.4.7 | 增加转码模板相关接口；<br>更新提交转码作业部分字段文档描述；<br>修改转码作业查询结果部分字段；|
+| 2018-03-31  | 0.2.1 | 按照规范修改；增加参数taskID  | 按照规范修改；增加参数taskID
+| 2018-04-28  | 0.3.6 | 完善description  | 完善description
+| 2018-08-23  | 0.3.7 | 增加接口总述及面向对象；修改截图接口描述 | 增加接口总述及面向对象；修改截图接口描述
+| 2019-03-07  | 0.4.1 | 增加图片样式分隔符接口 | 增加图片样式分隔符接口
+| 2019-05-29  | 0.4.5 | 增加图片样式接口 | 增加图片样式接口
+| 2020-02-12  | 0.4.6 | 增加转码相关接口 | 增加接口：提交转码作业/查询转码作业列表
+| 2020-03-03  | 0.4.7 | 增加转码模板相关接口；<br>更新提交转码作业部分字段文档描述；<br>修改转码作业查询结果部分字段；| -
+| 2020-03-04  | 0.4.8 | 修改部分字段的约束限定与文档描述；| 涉及字段：rcmode, hlsKey, sampleRate
+| 2020-03-18  | 0.4.9 | 转码模板新增hlsKeyEncodeType支持；提交转码作业时，新增附加参数additionalProperties支持| -

jdcloud_sdk/services/mps/apis/SubmitTranscodeJobRequest.py

@@ -32,7 +32,7 @@ def __init__(self, parameters, header=None, version="v1"):
 
 class SubmitTranscodeJobParameters(object):
 
-    def __init__(self, accessKey, secretKey, endpoint, bucket, objectKey, templateIds, outputConfig):
+    def __init__(self, accessKey, secretKey, endpoint, bucket, objectKey, templateIds, outputConfig, ):
         """
         :param accessKey: 输入对象存储 accessKey，必须参数
         :param secretKey: 输入对象存储 accessKey，必须参数
@@ -51,10 +51,27 @@ def __init__(self, accessKey, secretKey, endpoint, bucket, objectKey, templateId
         self.title = None
         self.templateIds = templateIds
         self.outputConfig = outputConfig
+        self.additionalProperties = None
 
     def setTitle(self, title):
         """
         :param title: (Optional) 输入视频标题，可选参数，默认会从 objectKey 中截取
         """
         self.title = title
 
+    def setAdditionalProperties(self, additionalProperties):
+        """
+        :param additionalProperties: (Optional) 附加参数，JSON格式的字符串。除非清楚了解其用途和用法，请勿使用此字段。
+若参数在本次作业提交所关联的模板中，存在相同用途的对应字段，则该属性值会覆盖模板中的对应字段；
+若参数在本次作业提交所关联的模板中，不存在相同用途的对应字段，则该属性值会作为补充设置，用于生产任务；
+有特殊说明的除外。
+当前支持的附加参数：
+  - hls.encrypt.key - HLS加密公钥，对应于转码模板中 encryption.hlsKey 字段
+  - hls.encrypt.keyUrl - HLS加密公钥地址，对应于转码模板中 encryption.hlsKeyUrl 字段
+  - hls.encrypt.encodeType - HLS加密公钥编码方式，对应于转码模板中 encryption.hlsKeyEncodeType 字段
+特殊说明：
+  -  HLS加密相关参数，具有完整性要求，故 hls.encrypt 命名空间下的附加参数，依赖于 hls.encrypt.key 参数的设置情况。若设置 hls.encrypt.key 参数，则命名空间 hls.encrypt 下的其他参数也须同时设置；否则，其他参数会被忽略。
+
+        """
+        self.additionalProperties = additionalProperties
+

jdcloud_sdk/services/mps/client/MpsClient.py

@@ -26,4 +26,4 @@ def __init__(self, credential, config=None, logger=None):
         if config is None:
             config = Config('mps.jdcloud-api.com')
 
-        super(MpsClient, self).__init__(credential, config, 'mps', '0.4.7', logger)
+        super(MpsClient, self).__init__(credential, config, 'mps', '0.4.9', logger)

jdcloud_sdk/services/mps/models/AudioStreamSettings.py

@@ -19,12 +19,13 @@
 
 class AudioStreamSettings(object):
 
-    def __init__(self, codec, bitrate, sampleRate, channels=None, comfortable=None):
+    def __init__(self, codec, bitrate, sampleRate=None, channels=None, comfortable=None):
         """
         :param codec:  音频编码。取值范围：aac 。目前仅支持 acc
         :param bitrate:  音频目标码率。取值范围：[8, 1000]，单位为 Kbps
-        :param sampleRate:  音频采样率。取值范围：22050、24000、32000、44100、48000、64000、88200、96000
-当容器封装格式为 flv 时，只支持 22050、44100
+        :param sampleRate: (Optional) 音频采样率。
+若容器封装格式为 flv ，该字段为必须参数，其取值范围：22050、44100
+若容器封装格式不为 flv ，则此字段为非必须参数，未设置时，与源文件音频采样率保持一致，若设置值，其取值范围：22050、24000、32000、44100、48000、64000、88200、96000
 
         :param channels: (Optional) 音频声道数。取值范围：1、2 。默认值为 2
         :param comfortable: (Optional) 是否开启舒适音频。取值范围：true、false，默认值为 true

jdcloud_sdk/services/mps/models/EncryptionSettings.py

@@ -19,14 +19,19 @@
 
 class EncryptionSettings(object):
 
-    def __init__(self, hlsKey=None, hlsKeyUrl=None):
+    def __init__(self, hlsKey=None, hlsKeyUrl=None, hlsKeyEncodeType=None):
         """
-        :param hlsKey: (Optional) 加密Key。HLS AES129KEY，必须为 16 个 ASCII 可打印字符
+        :param hlsKey: (Optional) HLS加密公钥，按指定编码方式编码
+必须为 16 字节值，按照 hlsKeyEncodeType 所指定的编码方式进行编码后的字符串
 
-        :param hlsKeyUrl: (Optional) 加密Key地址。必须为合法的HTTP地址。
-若 hleKey 已设置，表示开启 HLS 加密，其时该参数必须
+        :param hlsKeyUrl: (Optional) HLS加密公钥地址，仅支持HTTP(s)地址
+若 hlsKey 已设置，则表示开启 HLS 加密，此时为必须参数
+
+        :param hlsKeyEncodeType: (Optional) HLS加密公钥编码方式。取值范围：base16, base32, base64
+若 hlsKey 已设置，则表示开启 HLS 加密，此时为必须参数
 
         """
 
         self.hlsKey = hlsKey
         self.hlsKeyUrl = hlsKeyUrl
+        self.hlsKeyEncodeType = hlsKeyEncodeType

jdcloud_sdk/services/mps/models/SubmitTranscodeJobRequestInfo.py

@@ -19,7 +19,7 @@
 
 class SubmitTranscodeJobRequestInfo(object):
 
-    def __init__(self, accessKey, secretKey, endpoint, bucket, objectKey, templateIds, outputConfig, title=None):
+    def __init__(self, accessKey, secretKey, endpoint, bucket, objectKey, templateIds, outputConfig, title=None, additionalProperties=None):
         """
         :param accessKey:  输入对象存储 accessKey，必须参数
         :param secretKey:  输入对象存储 accessKey，必须参数
@@ -29,6 +29,17 @@ def __init__(self, accessKey, secretKey, endpoint, bucket, objectKey, templateId
         :param title: (Optional) 输入视频标题，可选参数，默认会从 objectKey 中截取
         :param templateIds:  转码模板ID集合，必须参数，非空集合
         :param outputConfig:  输出配置，必须参数
+        :param additionalProperties: (Optional) 附加参数，JSON格式的字符串。除非清楚了解其用途和用法，请勿使用此字段。
+若参数在本次作业提交所关联的模板中，存在相同用途的对应字段，则该属性值会覆盖模板中的对应字段；
+若参数在本次作业提交所关联的模板中，不存在相同用途的对应字段，则该属性值会作为补充设置，用于生产任务；
+有特殊说明的除外。
+当前支持的附加参数：
+  - hls.encrypt.key - HLS加密公钥，对应于转码模板中 encryption.hlsKey 字段
+  - hls.encrypt.keyUrl - HLS加密公钥地址，对应于转码模板中 encryption.hlsKeyUrl 字段
+  - hls.encrypt.encodeType - HLS加密公钥编码方式，对应于转码模板中 encryption.hlsKeyEncodeType 字段
+特殊说明：
+  -  HLS加密相关参数，具有完整性要求，故 hls.encrypt 命名空间下的附加参数，依赖于 hls.encrypt.key 参数的设置情况。若设置 hls.encrypt.key 参数，则命名空间 hls.encrypt 下的其他参数也须同时设置；否则，其他参数会被忽略。
+
         """
 
         self.accessKey = accessKey
@@ -39,3 +50,4 @@ def __init__(self, accessKey, secretKey, endpoint, bucket, objectKey, templateId
         self.title = title
         self.templateIds = templateIds
         self.outputConfig = outputConfig
+        self.additionalProperties = additionalProperties

jdcloud_sdk/services/mps/models/VideoStreamSettings.py

@@ -22,18 +22,18 @@ class VideoStreamSettings(object):
     def __init__(self, codec, rcmode=None, rateFactor=None, bitrate=None, frameRate=None, width=None, height=None):
         """
         :param codec:  视频编码。取值范围：h264、h265
-        :param rcmode: (Optional) 码率质量控制模式。取值范围：
+        :param rcmode: (Optional) 码率控制模式。取值范围：
   crf - 恒定码率系数模式。设置此模式时，rateFactor 生效，bitrate 会被忽略
   abr - 平均码率模式。设置此模式时，bitrate 生效，rateFactor 会被忽略
 默认值为 abr
 
-        :param rateFactor: (Optional) 码率质量控制因子。取值范围：[0, 51]，支持2位小数的浮点数
+        :param rateFactor: (Optional) 码率控制因子。取值范围：[0, 51]，支持2位小数的浮点数
 当 codec 为 h264 时，默认值为 23；当 codec 为 h265 时，默认值为 28
 
         :param bitrate: (Optional) 视频码率。取值范围：[128, 10000]，单位为 Kbps
 
         :param frameRate: (Optional) 视频帧率。取值范围：[1, 60]，单位为 fps
-未设置时，与源文件帧率保持一致
+未设置时，与源文件视频帧率保持一致
 
         :param width: (Optional) 视频输出宽度。取值范围：[128, 4096] 整数。单位为 px
 未设置时，若 height 也未设置值，则 width 和 height 与原视频保持一致；若 height 设置值，则 width 按照原视频的分辨率等比缩放

setup.py

@@ -9,7 +9,7 @@
 
 setup(
     name='jdcloud_sdk',
-    version="1.6.50",
+    version="1.6.51",
     long_description=long_description,
     long_description_content_type="text/markdown",
     author='JDCloud API Gateway Team',