tencentcloud-sdk-vod 3.0.1108 → 3.0.1112

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a963b7c943c49597ef3c29d4fc6947b8de6805fa
-  data.tar.gz: edbaffa7ef6db2e9cb982feb9c3995eaec15c62f
+  metadata.gz: 3e165369f1eecafcf46545bb572a574c25a7aff0
+  data.tar.gz: 9aa7e494e385db0a30976ac2eb2419a38cafa7c1
 SHA512:
-  metadata.gz: 5dcbf6c8288936f27e8747b7215dc1002f09433c97f25d6d3a281d8c1a3f81f10a3655e49bb82ac61473d2c6fc6bf1297d96172a5d6862e44bdb23d9ab4cd073
-  data.tar.gz: 7d376268dd944130de1e3b299ca6e4a7f2111a7ebecd9bc39940b2d6d4d3cf06302aabe9bdc9ad4e5d52e13c4c24de7ec303c24a8c2cff7ad224c801847af93e
+  metadata.gz: 45ec2c0c19d0f19794d38d682486b7a49db3b895ab8dc123d0f6feea51dc166355f74da9432259ad80f902499f8d4e11c89a1141a3ceb340293a4658922d45b3
+  data.tar.gz: 35b27cbc8c222595eb4ba8a16665784019d18555ba6edc2d5d1b8616c78d94806743e3d29b19e66d348ae1765cca18d2f2e9a0247bd37fe7c40ccd042bc66c7e

data/lib/VERSION

@@ -1 +1 @@
-3.0.1108
+3.0.1112

data/lib/v20180717/client.rb

@@ -4102,6 +4102,37 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 使用媒体处理服务（MPS）的媒体处理能力，对点播中的视频发起媒体处理，任务发起时需将 MPS 相关参数以 JSON 格式填入 MPSProcessMediaParams 参数中。具体任务参数配置请参考[媒体处理 ProcessMedia 接口](https://cloud.tencent.com/document/api/862/37578)。
+        # 当前支持的 MPS 功能：
+        # 1. [智能擦除](https://cloud.tencent.com/document/product/862/101530)：能够对视频画面中的 Logo、字幕、人脸和车牌等元素进行模糊、马赛克或无痕化处理，从而便于内容的传播和分享。该任务产生的新视频将生成新的 FileId 存储在点播平台的子应用中。
+
+        # > 以该种方式发起的视频处理任务：
+        # > 1. 任务状态及结果的查询仍在点播平台中完成，使用 [DescribeTaskDetail](https://cloud.tencent.com/document/product/266/33431) 或 [DescribeTasks](https://cloud.tencent.com/document/product/266/33430) 查询任务。
+        # > 2. 相关功能的用量及账单将在 MPS 平台给出，因此在使用该功能前，首先需要开通 MPS 服务。
+        # > 3. 该功能目前仍在内测中，如需测试体验，您可以联系我们获得支持。
+
+        # @param request: Request instance for ProcessMediaByMPS.
+        # @type request: :class:`Tencentcloud::vod::V20180717::ProcessMediaByMPSRequest`
+        # @rtype: :class:`Tencentcloud::vod::V20180717::ProcessMediaByMPSResponse`
+        def ProcessMediaByMPS(request)
+          body = send_request('ProcessMediaByMPS', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ProcessMediaByMPSResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 使用任务流模板，对点播中的视频发起处理任务。
         # 有两种方式创建任务流模板：
         # 1. 在控制台上创建和修改任务流模板；

data/lib/v20180717/models.rb

@@ -12577,7 +12577,7 @@ module TencentCloud
 
       # DescribeTaskDetail返回参数结构体
       class DescribeTaskDetailResponse < TencentCloud::Common::AbstractModel
-        # @param TaskType: 任务类型，取值：<li>Procedure：视频处理任务；</li><li>EditMedia：视频编辑任务；</li><li>SplitMedia：视频拆条任务；</li><li>ComposeMedia：制作媒体文件任务；</li><li>WechatPublish：微信发布任务；</li><li>WechatMiniProgramPublish：微信小程序视频发布任务；</li><li>PullUpload：拉取上传媒体文件任务；</li><li>FastClipMedia：快速剪辑任务；</li><li>RemoveWatermarkTask：智能去除水印任务；</li><li>DescribeFileAttributesTask：获取文件属性任务；</li><li>RebuildMedia：音画质重生任务（不推荐使用）；</li><li>ReviewAudioVideo：音视频审核任务；</li><li>ExtractTraceWatermark：提取溯源水印任务；</li><li>ExtractCopyRightWatermark：提取版权水印任务；</li><li>QualityInspect：音画质检测任务；</li><li>QualityEnhance：音画质重生任务；</li><li>ComplexAdaptiveDynamicStreaming：复杂自适应码流任务。</li>
+        # @param TaskType: 任务类型，取值：<li>Procedure：视频处理任务；</li><li>EditMedia：视频编辑任务；</li><li>SplitMedia：视频拆条任务；</li><li>ComposeMedia：制作媒体文件任务；</li><li>WechatPublish：微信发布任务；</li><li>WechatMiniProgramPublish：微信小程序视频发布任务；</li><li>PullUpload：拉取上传媒体文件任务；</li><li>FastClipMedia：快速剪辑任务；</li><li>RemoveWatermarkTask：智能去除水印任务；</li><li>DescribeFileAttributesTask：获取文件属性任务；</li><li>RebuildMedia：音画质重生任务（不推荐使用）；</li><li>ReviewAudioVideo：音视频审核任务；</li><li>ExtractTraceWatermark：提取溯源水印任务；</li><li>ExtractCopyRightWatermark：提取版权水印任务；</li><li>QualityInspect：音画质检测任务；</li><li>QualityEnhance：音画质重生任务；</li><li>ComplexAdaptiveDynamicStreaming：复杂自适应码流任务；</li><li>ProcessMediaByMPS：MPS 视频处理任务。</li>
         # @type TaskType: String
         # @param Status: 任务状态，取值：
         # <li>WAITING：等待中；</li>
@@ -12657,12 +12657,14 @@ module TencentCloud
         # @param ComplexAdaptiveDynamicStreamingTask: 复杂自适应码流任务信息，仅当 TaskType 为 ComplexAdaptiveDynamicStreaming，该字段有值。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ComplexAdaptiveDynamicStreamingTask: :class:`Tencentcloud::Vod.v20180717.models.ComplexAdaptiveDynamicStreamingTask`
+        # @param ProcessMediaByMPSTask: MPS 视频处理任务信息，仅当 TaskType 为 ProcessMediaByMPS，该字段有值。
+        # @type ProcessMediaByMPSTask: :class:`Tencentcloud::Vod.v20180717.models.ProcessMediaByMPS`
         # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
 
-        attr_accessor :TaskType, :Status, :CreateTime, :BeginProcessTime, :FinishTime, :ProcedureTask, :EditMediaTask, :WechatPublishTask, :ComposeMediaTask, :SplitMediaTask, :WechatMiniProgramPublishTask, :PullUploadTask, :TranscodeTask, :ConcatTask, :ClipTask, :CreateImageSpriteTask, :SnapshotByTimeOffsetTask, :RemoveWatermarkTask, :RebuildMediaTask, :ExtractTraceWatermarkTask, :ExtractCopyRightWatermarkTask, :ReviewAudioVideoTask, :ReduceMediaBitrateTask, :DescribeFileAttributesTask, :QualityInspectTask, :QualityEnhanceTask, :ComplexAdaptiveDynamicStreamingTask, :RequestId
+        attr_accessor :TaskType, :Status, :CreateTime, :BeginProcessTime, :FinishTime, :ProcedureTask, :EditMediaTask, :WechatPublishTask, :ComposeMediaTask, :SplitMediaTask, :WechatMiniProgramPublishTask, :PullUploadTask, :TranscodeTask, :ConcatTask, :ClipTask, :CreateImageSpriteTask, :SnapshotByTimeOffsetTask, :RemoveWatermarkTask, :RebuildMediaTask, :ExtractTraceWatermarkTask, :ExtractCopyRightWatermarkTask, :ReviewAudioVideoTask, :ReduceMediaBitrateTask, :DescribeFileAttributesTask, :QualityInspectTask, :QualityEnhanceTask, :ComplexAdaptiveDynamicStreamingTask, :ProcessMediaByMPSTask, :RequestId
 
-        def initialize(tasktype=nil, status=nil, createtime=nil, beginprocesstime=nil, finishtime=nil, proceduretask=nil, editmediatask=nil, wechatpublishtask=nil, composemediatask=nil, splitmediatask=nil, wechatminiprogrampublishtask=nil, pulluploadtask=nil, transcodetask=nil, concattask=nil, cliptask=nil, createimagespritetask=nil, snapshotbytimeoffsettask=nil, removewatermarktask=nil, rebuildmediatask=nil, extracttracewatermarktask=nil, extractcopyrightwatermarktask=nil, reviewaudiovideotask=nil, reducemediabitratetask=nil, describefileattributestask=nil, qualityinspecttask=nil, qualityenhancetask=nil, complexadaptivedynamicstreamingtask=nil, requestid=nil)
+        def initialize(tasktype=nil, status=nil, createtime=nil, beginprocesstime=nil, finishtime=nil, proceduretask=nil, editmediatask=nil, wechatpublishtask=nil, composemediatask=nil, splitmediatask=nil, wechatminiprogrampublishtask=nil, pulluploadtask=nil, transcodetask=nil, concattask=nil, cliptask=nil, createimagespritetask=nil, snapshotbytimeoffsettask=nil, removewatermarktask=nil, rebuildmediatask=nil, extracttracewatermarktask=nil, extractcopyrightwatermarktask=nil, reviewaudiovideotask=nil, reducemediabitratetask=nil, describefileattributestask=nil, qualityinspecttask=nil, qualityenhancetask=nil, complexadaptivedynamicstreamingtask=nil, processmediabympstask=nil, requestid=nil)
           @TaskType = tasktype
           @Status = status
           @CreateTime = createtime
@@ -12690,6 +12692,7 @@ module TencentCloud
           @QualityInspectTask = qualityinspecttask
           @QualityEnhanceTask = qualityenhancetask
           @ComplexAdaptiveDynamicStreamingTask = complexadaptivedynamicstreamingtask
+          @ProcessMediaByMPSTask = processmediabympstask
           @RequestId = requestid
         end
 
@@ -12787,6 +12790,10 @@ module TencentCloud
             @ComplexAdaptiveDynamicStreamingTask = ComplexAdaptiveDynamicStreamingTask.new
             @ComplexAdaptiveDynamicStreamingTask.deserialize(params['ComplexAdaptiveDynamicStreamingTask'])
           end
+          unless params['ProcessMediaByMPSTask'].nil?
+            @ProcessMediaByMPSTask = ProcessMediaByMPS.new
+            @ProcessMediaByMPSTask.deserialize(params['ProcessMediaByMPSTask'])
+          end
           @RequestId = params['RequestId']
         end
       end
@@ -16162,6 +16169,101 @@ module TencentCloud
         end
       end
 
+      # 用于描述 MPS 视频处理任务中的返回文件结果。
+      class MPSOutputFile < TencentCloud::Common::AbstractModel
+        # @param FileType: 文件类型。用于标识 MPS 视频处理任务执行结果中的特定返回文件。
+        # 取值：<li>AiAnalysis.DeLogo.Video: 智能擦除任务中产生的擦除后视频文件；</li><li>AiAnalysis.DeLogo.OriginSubtitle: 智能擦除任务中基于画面提取的字幕文件；</li><li>AiAnalysis.DeLogo.TranslateSubtitle: 智能擦除任务中基于画面提取的字幕翻译文件。</li>
+        # @type FileType: String
+        # @param StorageMode: 存储形式。用于表示该结果文件的存储形式，取值有：<li> Permanent：永久存储；</li><li> Temporary：临时存储。</li>
+        # @type StorageMode: String
+        # @param FileId: 媒体文件 ID。当 Type 为 Permanent 时有效，表示该结果文件以视频媒资形式存储在点播平台中，字段值为视频媒资的 FileId。
+        # @type FileId: String
+        # @param Url: 结果文件的可下载 Url。
+        # @type Url: String
+        # @param ExpiredTime: 过期时间。当 StorageMode 为 Temporary 时有效，表示 Url 的过期时间，单位为秒。
+        # @type ExpiredTime: Integer
+
+        attr_accessor :FileType, :StorageMode, :FileId, :Url, :ExpiredTime
+
+        def initialize(filetype=nil, storagemode=nil, fileid=nil, url=nil, expiredtime=nil)
+          @FileType = filetype
+          @StorageMode = storagemode
+          @FileId = fileid
+          @Url = url
+          @ExpiredTime = expiredtime
+        end
+
+        def deserialize(params)
+          @FileType = params['FileType']
+          @StorageMode = params['StorageMode']
+          @FileId = params['FileId']
+          @Url = params['Url']
+          @ExpiredTime = params['ExpiredTime']
+        end
+      end
+
+      # MPS 具体子任务查询结果类型。
+      class MPSSubTaskResult < TencentCloud::Common::AbstractModel
+        # @param TaskType: 任务类型。MPS 的 WorkflowTask 结构中的具体子任务类型。取值：<li>AiAnalysis.DeLogo：智能擦除任务。</li>
+        # @type TaskType: String
+        # @param Status: 任务状态。有 PROCESSING，SUCCESS 和 FAIL 三种。
+        # @type Status: String
+        # @param ErrCode: 错误码。返回0时成功，其他值为失败。
+        # @type ErrCode: String
+        # @param Message: 错误信息。
+        # @type Message: String
+        # @param Input: MPS 视频处理任务输入。该字段对应 MPS 任务返回中的 Input 结果，以 JSON 格式返回。
+        # @type Input: String
+        # @param Output: MPS 视频处理任务输出。
+        # @type Output: :class:`Tencentcloud::Vod.v20180717.models.MPSTaskOutput`
+
+        attr_accessor :TaskType, :Status, :ErrCode, :Message, :Input, :Output
+
+        def initialize(tasktype=nil, status=nil, errcode=nil, message=nil, input=nil, output=nil)
+          @TaskType = tasktype
+          @Status = status
+          @ErrCode = errcode
+          @Message = message
+          @Input = input
+          @Output = output
+        end
+
+        def deserialize(params)
+          @TaskType = params['TaskType']
+          @Status = params['Status']
+          @ErrCode = params['ErrCode']
+          @Message = params['Message']
+          @Input = params['Input']
+          unless params['Output'].nil?
+            @Output = MPSTaskOutput.new
+            @Output.deserialize(params['Output'])
+          end
+        end
+      end
+
+      # MPS 子任务输出返回结果。
+      class MPSTaskOutput < TencentCloud::Common::AbstractModel
+        # @param OutputFiles: 任务返回结果中的文件类型结果。如智能擦除中，擦除后的视频文件将被存入媒资，并在此字段中给出 FileId；基于画面提取的字幕文件 Url 将在此字段中给出。
+        # @type OutputFiles: Array
+
+        attr_accessor :OutputFiles
+
+        def initialize(outputfiles=nil)
+          @OutputFiles = outputfiles
+        end
+
+        def deserialize(params)
+          unless params['OutputFiles'].nil?
+            @OutputFiles = []
+            params['OutputFiles'].each do |i|
+              mpsoutputfile_tmp = MPSOutputFile.new
+              mpsoutputfile_tmp.deserialize(i)
+              @OutputFiles << mpsoutputfile_tmp
+            end
+          end
+        end
+      end
+
       # ManageTask请求参数结构体
       class ManageTaskRequest < TencentCloud::Common::AbstractModel
         # @param TaskId: 视频处理的任务 ID。
@@ -22069,6 +22171,93 @@ module TencentCloud
         end
       end
 
+      # MPS 媒体处理任务信息。
+      class ProcessMediaByMPS < TencentCloud::Common::AbstractModel
+        # @param TaskId: 任务 ID。
+        # @type TaskId: String
+        # @param Status: 任务状态，取值：<li>PROCESSING：处理中；</li><li>FINISH：已完成。</li>
+        # @type Status: String
+        # @param ErrCode: 错误码。源异常时返回非0错误码，返回0时请使用各个具体任务的 ErrCode。
+        # @type ErrCode: Integer
+        # @param Message: 错误信息。源异常时返回对应异常 Message，否则请使用各个具体任务的 Message。
+        # @type Message: String
+        # @param SubTaskSet: MPS 视频处理任务。
+        # @type SubTaskSet: Array
+
+        attr_accessor :TaskId, :Status, :ErrCode, :Message, :SubTaskSet
+
+        def initialize(taskid=nil, status=nil, errcode=nil, message=nil, subtaskset=nil)
+          @TaskId = taskid
+          @Status = status
+          @ErrCode = errcode
+          @Message = message
+          @SubTaskSet = subtaskset
+        end
+
+        def deserialize(params)
+          @TaskId = params['TaskId']
+          @Status = params['Status']
+          @ErrCode = params['ErrCode']
+          @Message = params['Message']
+          unless params['SubTaskSet'].nil?
+            @SubTaskSet = []
+            params['SubTaskSet'].each do |i|
+              mpssubtaskresult_tmp = MPSSubTaskResult.new
+              mpssubtaskresult_tmp.deserialize(i)
+              @SubTaskSet << mpssubtaskresult_tmp
+            end
+          end
+        end
+      end
+
+      # ProcessMediaByMPS请求参数结构体
+      class ProcessMediaByMPSRequest < TencentCloud::Common::AbstractModel
+        # @param FileId: 媒体文件 ID，即该文件在云点播上的全局唯一标识符，在上传成功后由云点播后台分配。可以在 [视频上传完成事件通知](/document/product/266/7830) 或 [云点播控制台](https://console.cloud.tencent.com/vod/media) 获取该字段。
+        # @type FileId: String
+        # @param SubAppId: <b>点播[应用](/document/product/266/14574) ID。</b>
+        # @type SubAppId: Integer
+        # @param MPSProcessMediaParams: 该参数用于透传至媒体处理服务（MPS），以便从云点播侧发起 MPS 视频处理任务。
+        # 视频处理参数详情请参考：[MPS 发起媒体处理](https://cloud.tencent.com/document/api/862/37578)。
+        # 填写说明：
+        # 1. 目前仅需要配置 MPS “发起媒体处理”接口中的 AiAnalysisTask 参数，其他参数无需填写，若包含其它参数，系统将自动忽略；
+        # 2. 当前仅支持通过此方式发起智能擦除任务。若配置了其他任务类型的相关参数，系统将自动忽略这些参数。
+        # @type MPSProcessMediaParams: String
+
+        attr_accessor :FileId, :SubAppId, :MPSProcessMediaParams
+
+        def initialize(fileid=nil, subappid=nil, mpsprocessmediaparams=nil)
+          @FileId = fileid
+          @SubAppId = subappid
+          @MPSProcessMediaParams = mpsprocessmediaparams
+        end
+
+        def deserialize(params)
+          @FileId = params['FileId']
+          @SubAppId = params['SubAppId']
+          @MPSProcessMediaParams = params['MPSProcessMediaParams']
+        end
+      end
+
+      # ProcessMediaByMPS返回参数结构体
+      class ProcessMediaByMPSResponse < TencentCloud::Common::AbstractModel
+        # @param TaskId: 任务 ID。
+        # @type TaskId: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :TaskId, :RequestId
+
+        def initialize(taskid=nil, requestid=nil)
+          @TaskId = taskid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @TaskId = params['TaskId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # ProcessMediaByProcedure请求参数结构体
       class ProcessMediaByProcedureRequest < TencentCloud::Common::AbstractModel
         # @param FileId: 媒体文件 ID。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-vod
 version: !ruby/object:Gem::Version
-  version: 3.0.1108
+  version: 3.0.1112
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-07-24 00:00:00.000000000 Z
+date: 2025-07-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common