tencentcloud-sdk-trtc 3.0.742 → 3.0.744

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3dcd15d1a3a9685607d8c9f505f793437134a359
-  data.tar.gz: b4abbb12f885fbc29172b8dca3a37e057dbf1848
+  metadata.gz: b72f62a4002983e90eefdce6995b9f8bcfb47b4d
+  data.tar.gz: e91c3e6dddc20d4a5405defebe17a894f45cceb3
 SHA512:
-  metadata.gz: b64f2b7e8428cabfb668d2c1a104087b60c728ba314d61055035c7a96d6fd360bd53d73b4529bda8f26e0078e75aeedc7277bed25b2ba6449a47cc8d2308813d
-  data.tar.gz: ba31a9c3086122a93c971d8337188298847d7b05a94af7ccd280674cd967b13cbdaa700326403c07cec5d9b32744806a11a068836b9a8898d6e65641530e3c9b
+  metadata.gz: 28c91a8c965427ccd77af276ab5b47d999836ad1b67eeb14be5ce1005948297f0d4cd0d98f70c890452b6aad1b64f2c73f5de6a8b0f21eaa6ed4b77c14652e0e
+  data.tar.gz: 2c60c29d9dfe28d9b30c5aa79b8d1ac058b20a8ab87c3cb932a5fa476e8ad18db6dfd2a99217a95a4dfcea96cc6bbd838e022cce9a0a0653370ed355ff0a2b97

data/lib/VERSION

@@ -1 +1 @@
-3.0.742
+3.0.744

data/lib/v20190722/client.rb

@@ -1162,6 +1162,8 @@ module TencentCloud
         end
 
         # 将一个在线媒体流推到TRTC房间。
+        # 使用此接口的前提条件：需要购买 [尊享版或旗舰版套餐包](https://cloud.tencent.com/document/product/647/85386
+        # )
 
         # @param request: Request instance for StartStreamIngest.
         # @type request: :class:`Tencentcloud::trtc::V20190722::StartStreamIngestRequest`

data/lib/v20190722/models.rb

@@ -2284,16 +2284,20 @@ module TencentCloud
         # 白色：0xFFFFFF。
         # 灰色：0x999999。
         # @type BackGroundColor: String
-        # @param BackgroundImageUrl: 子画面的背景图url，填写该参数，当用户关闭摄像头或未进入TRTC房间时，会在布局位置填充为指定图片。若指定图片与布局位置尺寸比例不一致，则会对图片进行拉伸处理，优先级高于BackGroundColor。
+        # @param BackgroundImageUrl: 子画面的背景图url，填写该参数，当用户关闭摄像头或未进入TRTC房间时，会在布局位置填充为指定图片。若指定图片与布局位置尺寸比例不一致，则会对图片进行拉伸处理，优先级高于BackGroundColor。支持png、jpg、jpeg、bmp、gif、webm格式。图片大小限制不超过5MB。
+        # 注：您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，子画面的背景图将不会生效。
         # @type BackgroundImageUrl: String
         # @param CustomCrop: 客户自定义裁剪，针对原始输入流裁剪
         # @type CustomCrop: :class:`Tencentcloud::Trtc.v20190722.models.McuCustomCrop`
         # @param BackgroundRenderMode: 子背景图在输出时的显示模式：0为裁剪，1为缩放并显示背景，2为缩放并显示黑底，3为变比例伸缩。不填默认为3。
         # @type BackgroundRenderMode: Integer
+        # @param TransparentUrl: 子画面的透明模版url，指向一张包含透明通道的模板图片。填写该参数，后台混流时会提取该模板图片的透明通道，将其缩放作为目标画面的透明通道，再和其他画面进行混合。您可以通过透明模版实现目标画面的半透明效果和任意形状裁剪（如圆角、星形、心形等）。 支持png格式。图片大小限制不超过5MB。
+        # 注：1，模板图片宽高比应接近目标画面宽高比，以避免缩放适配目标画面时出现模板效果变形；2，透明模版只有RenderMode为0（裁剪）时才生效；3，您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，透明模版将不会生效。
+        # @type TransparentUrl: String
 
-        attr_accessor :UserMediaStream, :ImageWidth, :ImageHeight, :LocationX, :LocationY, :ZOrder, :RenderMode, :BackGroundColor, :BackgroundImageUrl, :CustomCrop, :BackgroundRenderMode
+        attr_accessor :UserMediaStream, :ImageWidth, :ImageHeight, :LocationX, :LocationY, :ZOrder, :RenderMode, :BackGroundColor, :BackgroundImageUrl, :CustomCrop, :BackgroundRenderMode, :TransparentUrl
 
-        def initialize(usermediastream=nil, imagewidth=nil, imageheight=nil, locationx=nil, locationy=nil, zorder=nil, rendermode=nil, backgroundcolor=nil, backgroundimageurl=nil, customcrop=nil, backgroundrendermode=nil)
+        def initialize(usermediastream=nil, imagewidth=nil, imageheight=nil, locationx=nil, locationy=nil, zorder=nil, rendermode=nil, backgroundcolor=nil, backgroundimageurl=nil, customcrop=nil, backgroundrendermode=nil, transparenturl=nil)
           @UserMediaStream = usermediastream
           @ImageWidth = imagewidth
           @ImageHeight = imageheight
@@ -2305,6 +2309,7 @@ module TencentCloud
           @BackgroundImageUrl = backgroundimageurl
           @CustomCrop = customcrop
           @BackgroundRenderMode = backgroundrendermode
+          @TransparentUrl = transparenturl
         end
 
         def deserialize(params)
@@ -2325,6 +2330,7 @@ module TencentCloud
             @CustomCrop.deserialize(params['CustomCrop'])
           end
           @BackgroundRenderMode = params['BackgroundRenderMode']
+          @TransparentUrl = params['TransparentUrl']
         end
       end
 
@@ -2511,7 +2517,8 @@ module TencentCloud
         # 白色：0xFFFFFF。
         # 灰色：0x999999。
         # @type BackGroundColor: String
-        # @param BackgroundImageUrl: 整个画布的背景图url，优先级高于BackGroundColor。
+        # @param BackgroundImageUrl: 整个画布的背景图url，优先级高于BackGroundColor。支持png、jpg、jpeg格式。图片大小限制不超过5MB。
+        # 注：您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，背景图将不会生效。
         # @type BackgroundImageUrl: String
         # @param WaterMarkList: 混流布局的水印参数。
         # @type WaterMarkList: Array
@@ -2555,6 +2562,7 @@ module TencentCloud
       # 图片水印参数。
       class McuWaterMarkImage < TencentCloud::Common::AbstractModel
         # @param WaterMarkUrl: 水印图片URL地址，支持png、jpg、jpeg格式。图片大小限制不超过5MB。
+        # 注：您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，水印图片将不会生效。
         # @type WaterMarkUrl: String
         # @param WaterMarkWidth: 水印在输出时的宽。单位为像素值。
         # @type WaterMarkWidth: Integer
@@ -3835,7 +3843,7 @@ module TencentCloud
 
       # StartStreamIngest请求参数结构体
       class StartStreamIngestRequest < TencentCloud::Common::AbstractModel
-        # @param SdkAppId: TRTC的[SdkAppId](https://cloud.tencent.com/document/product/647/46351#sdkappid)，和录制的房间所对应的SdkAppId相同。
+        # @param SdkAppId: TRTC的[SdkAppId](https://cloud.tencent.com/document/product/647/46351#sdkappid)，和TRTC的房间所对应的SdkAppId相同。
         # @type SdkAppId: Integer
         # @param RoomId: TRTC的[RoomId](https://cloud.tencent.com/document/product/647/46351#roomid)，录制的TRTC房间所对应的RoomId。
         # @type RoomId: String
@@ -3848,7 +3856,7 @@ module TencentCloud
         # @type UserId: String
         # @param UserSig: 拉流转推机器人UserId对应的校验签名，即UserId和UserSig相当于机器人进房的登录密码，具体计算方法请参考TRTC计算[UserSig](https://cloud.tencent.com/document/product/647/45910#UserSig)的方案。
         # @type UserSig: String
-        # @param SourceUrl: 源流URL。示例值：https://a.b/test.mp4
+        # @param SourceUrl: 【本字段已废弃，请使用 StreamUrl 字段】源流URL，支持一个地址。
         # @type SourceUrl: Array
         # @param PrivateMapKey: TRTC房间权限加密串，只有在TRTC控制台启用了高级权限控制的时候需要携带，在TRTC控制台如果开启高级权限控制后，TRTC 的后台服务系统会校验一个叫做 [PrivateMapKey] 的“权限票据”，权限票据中包含了一个加密后的 RoomId 和一个加密后的“权限位列表”。由于 PrivateMapKey 中包含 RoomId，所以只提供了 UserSig 没有提供 PrivateMapKey 时，并不能进入指定的房间。
         # @type PrivateMapKey: String
@@ -3856,10 +3864,12 @@ module TencentCloud
         # @type VideoEncodeParams: :class:`Tencentcloud::Trtc.v20190722.models.VideoEncodeParams`
         # @param AudioEncodeParams: 音频编码参数。可选，如果不填，保持原始流的参数。
         # @type AudioEncodeParams: :class:`Tencentcloud::Trtc.v20190722.models.AudioEncodeParams`
+        # @param StreamUrl: 源流URL。历史原因本字段【必填】。
+        # @type StreamUrl: String
 
-        attr_accessor :SdkAppId, :RoomId, :RoomIdType, :UserId, :UserSig, :SourceUrl, :PrivateMapKey, :VideoEncodeParams, :AudioEncodeParams
+        attr_accessor :SdkAppId, :RoomId, :RoomIdType, :UserId, :UserSig, :SourceUrl, :PrivateMapKey, :VideoEncodeParams, :AudioEncodeParams, :StreamUrl
 
-        def initialize(sdkappid=nil, roomid=nil, roomidtype=nil, userid=nil, usersig=nil, sourceurl=nil, privatemapkey=nil, videoencodeparams=nil, audioencodeparams=nil)
+        def initialize(sdkappid=nil, roomid=nil, roomidtype=nil, userid=nil, usersig=nil, sourceurl=nil, privatemapkey=nil, videoencodeparams=nil, audioencodeparams=nil, streamurl=nil)
           @SdkAppId = sdkappid
           @RoomId = roomid
           @RoomIdType = roomidtype
@@ -3869,6 +3879,7 @@ module TencentCloud
           @PrivateMapKey = privatemapkey
           @VideoEncodeParams = videoencodeparams
           @AudioEncodeParams = audioencodeparams
+          @StreamUrl = streamurl
         end
 
         def deserialize(params)
@@ -3887,6 +3898,7 @@ module TencentCloud
             @AudioEncodeParams = AudioEncodeParams.new
             @AudioEncodeParams.deserialize(params['AudioEncodeParams'])
           end
+          @StreamUrl = params['StreamUrl']
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-trtc
 version: !ruby/object:Gem::Version
-  version: 3.0.742
+  version: 3.0.744
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-04 00:00:00.000000000 Z
+date: 2024-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common