tencentcloud-sdk-live 3.0.1201 → 3.0.1204

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5f9c77536dd4da2a086d41e66634c142220aa94d
-  data.tar.gz: 264c8cbc162f18854932eaa3b3f7ad4003680432
+  metadata.gz: d851bbd1bfb975cc714598dae907c8a94be61470
+  data.tar.gz: 9afcfef754e6110ec8ae5a3fb72d320522604caa
 SHA512:
-  metadata.gz: 087250f1a2f5cb0529125b423989ccfd86e1eecfc67d375737425d1ea0206193ccf6e5ba694c2a75e60bdf8344dd17a43212cb731208f19f775e2abec1d16f02
-  data.tar.gz: 0b6f9d639ea34d4cbffcc72b8228f695c1311b1ad444bb7111d2c31e6f62b22a41d9a288739f6229b0e01c39683269056724979c650d6479c375e667abaa1e82
+  metadata.gz: 8c4425d85e32ee8ca101fbfc74e0bb8fc098c284b1555a6eb393530437717bae884463946806473aa66870b8e8df4cccc022fcb2a2ba8fe3814a4c64ba7ccaf8
+  data.tar.gz: c8dda4d3d593edb819f944954d15fcf307a9529912f0d8d5d55dfb033f0f698fa2346b259c3d5fb059fb7d9085cf70bc49c244ec9f2c329a992008a0c6849303

data/lib/VERSION

@@ -1 +1 @@
-3.0.1201
+3.0.1204

data/lib/v20180801/client.rb

@@ -541,6 +541,31 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 使用该接口生成云端特效。特效可用于叠加到直播流上，供播放端观看。
+        # 注意：云端特效生成需要一定时间，调用生成接口后，可通过查询接口，获取是否特效已生成。
+
+        # @param request: Request instance for CreateLiveCloudEffect.
+        # @type request: :class:`Tencentcloud::live::V20180801::CreateLiveCloudEffectRequest`
+        # @rtype: :class:`Tencentcloud::live::V20180801::CreateLiveCloudEffectResponse`
+        def CreateLiveCloudEffect(request)
+          body = send_request('CreateLiveCloudEffect', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateLiveCloudEffectResponse.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
+
         # 创建直播垫片规则。
 
         # @param request: Request instance for CreateLivePadRule.
@@ -2358,6 +2383,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 使用该接口查询云端特效配置信息。
+
+        # @param request: Request instance for DescribeLiveCloudEffectConfig.
+        # @type request: :class:`Tencentcloud::live::V20180801::DescribeLiveCloudEffectConfigRequest`
+        # @rtype: :class:`Tencentcloud::live::V20180801::DescribeLiveCloudEffectConfigResponse`
+        def DescribeLiveCloudEffectConfig(request)
+          body = send_request('DescribeLiveCloudEffectConfig', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeLiveCloudEffectConfigResponse.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
+
         # 使用该接口查询云端特效列表，特效列表中包含一部分官方精品特效，同时包含用户自定义生成的特效。
 
         # @param request: Request instance for DescribeLiveCloudEffectList.

data/lib/v20180801/models.rb

@@ -1755,6 +1755,38 @@ module TencentCloud
         end
       end
 
+      # 云端特效模板信息。
+      class CloudEffectTemplateInfo < TencentCloud::Common::AbstractModel
+        # @param TemplateId: <p>特效模板ID。</p>
+        # @type TemplateId: String
+        # @param TemplateName: <p>特效模板名称。</p>
+        # @type TemplateName: String
+        # @param VideoUrl: <p>模板预览URL。</p>
+        # @type VideoUrl: String
+        # @param CoverImageUrl: <p>模板封面图片URL。</p>
+        # @type CoverImageUrl: String
+        # @param VideoRatio: <p>模板视频宽高比。</p>
+        # @type VideoRatio: String
+
+        attr_accessor :TemplateId, :TemplateName, :VideoUrl, :CoverImageUrl, :VideoRatio
+
+        def initialize(templateid=nil, templatename=nil, videourl=nil, coverimageurl=nil, videoratio=nil)
+          @TemplateId = templateid
+          @TemplateName = templatename
+          @VideoUrl = videourl
+          @CoverImageUrl = coverimageurl
+          @VideoRatio = videoratio
+        end
+
+        def deserialize(params)
+          @TemplateId = params['TemplateId']
+          @TemplateName = params['TemplateName']
+          @VideoUrl = params['VideoUrl']
+          @CoverImageUrl = params['CoverImageUrl']
+          @VideoRatio = params['VideoRatio']
+        end
+      end
+
       # 通用混流控制参数
       class CommonMixControlParams < TencentCloud::Common::AbstractModel
         # @param UseMixCropCenter: 取值范围[0,1]。
@@ -2652,6 +2684,58 @@ module TencentCloud
         end
       end
 
+      # CreateLiveCloudEffect请求参数结构体
+      class CreateLiveCloudEffectRequest < TencentCloud::Common::AbstractModel
+        # @param Prompt: <p>用于生成云端特效的 Prompt。示例：飞鸟。Prompt 和 ImageUrl 二选一。</p>
+        # @type Prompt: String
+        # @param TemplateId: <p>模板生礼物的模板ID。目前支持的模板ID：queen_accession, wizard_of_oz，red_envelopes，fishermen，captain_america。</p>
+        # @type TemplateId: String
+        # @param ImageUrl: <p>输入我的图片地址，用于生成云端特效。ImageUrl 和 Prompt 二选一。</p>
+        # @type ImageUrl: String
+        # @param Type: <p>指定生成云端特效的方式。默认自动选取。标准方式：text2video，高品质方式：text2video_hq。</p>
+        # @type Type: String
+        # @param Operator: <p>操作者名称。</p>
+        # @type Operator: String
+
+        attr_accessor :Prompt, :TemplateId, :ImageUrl, :Type, :Operator
+
+        def initialize(prompt=nil, templateid=nil, imageurl=nil, type=nil, operator=nil)
+          @Prompt = prompt
+          @TemplateId = templateid
+          @ImageUrl = imageurl
+          @Type = type
+          @Operator = operator
+        end
+
+        def deserialize(params)
+          @Prompt = params['Prompt']
+          @TemplateId = params['TemplateId']
+          @ImageUrl = params['ImageUrl']
+          @Type = params['Type']
+          @Operator = params['Operator']
+        end
+      end
+
+      # CreateLiveCloudEffect返回参数结构体
+      class CreateLiveCloudEffectResponse < TencentCloud::Common::AbstractModel
+        # @param Id: <p>云端特效 ID。</p>
+        # @type Id: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Id, :RequestId
+
+        def initialize(id=nil, requestid=nil)
+          @Id = id
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Id = params['Id']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateLivePadRule请求参数结构体
       class CreateLivePadRuleRequest < TencentCloud::Common::AbstractModel
         # @param DomainName: 推流域名。
@@ -6583,6 +6667,44 @@ module TencentCloud
         end
       end
 
+      # DescribeLiveCloudEffectConfig请求参数结构体
+      class DescribeLiveCloudEffectConfigRequest < TencentCloud::Common::AbstractModel
+
+
+        def initialize()
+        end
+
+        def deserialize(params)
+        end
+      end
+
+      # DescribeLiveCloudEffectConfig返回参数结构体
+      class DescribeLiveCloudEffectConfigResponse < TencentCloud::Common::AbstractModel
+        # @param EffectTemplateList: <p>模板生礼物的模板信息列表。</p>
+        # @type EffectTemplateList: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :EffectTemplateList, :RequestId
+
+        def initialize(effecttemplatelist=nil, requestid=nil)
+          @EffectTemplateList = effecttemplatelist
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['EffectTemplateList'].nil?
+            @EffectTemplateList = []
+            params['EffectTemplateList'].each do |i|
+              cloudeffecttemplateinfo_tmp = CloudEffectTemplateInfo.new
+              cloudeffecttemplateinfo_tmp.deserialize(i)
+              @EffectTemplateList << cloudeffecttemplateinfo_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeLiveCloudEffectList请求参数结构体
       class DescribeLiveCloudEffectListRequest < TencentCloud::Common::AbstractModel
         # @param Id: 云端特效ID。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-live
 version: !ruby/object:Gem::Version
-  version: 3.0.1201
+  version: 3.0.1204
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-13 00:00:00.000000000 Z
+date: 2026-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common