tencentcloud-sdk-trtc 3.0.1169 → 3.0.1182

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f4e8118206e4c9f25aedab1a06ca3b09be3d8564
-  data.tar.gz: a30203bd6bb719be4517f806e38c3463ea46e9d1
+  metadata.gz: d69a60b421dc1a4ac0b0eb79354930ed3278e198
+  data.tar.gz: 192b7953bfad4285381ed9861f84c92c3acba715
 SHA512:
-  metadata.gz: 5b09cf3ce6955d720c91aaeba2bef2e099f379c2f62d382ae24bb1302673b38a3e23862b52c23e5f7416a79ef10598046cd633f342b124bbc6c561e879834217
-  data.tar.gz: 90bae9108b34f174a9e429776108de16d60755462d49e096249041e38c01f4a65fe8c6f02bfa29a3e92534c39b4248dac19d0046a47bda084bc7c5c52762367a
+  metadata.gz: afbbf36997370c6be066cdc1c8fb4f86b662d2017d02b893df52d47b77b9d7303567f587f1829101821ece30d1de2d59238b51bac8945cf1b0ea42f2854eb4d5
+  data.tar.gz: 2adcfed3fa91f2c46d8d7f5aed4c2b6cd19770e19dc55d8f0055d03d85717dd48cda7ee248812640407bcf67b54927f5bdd7d3acd6d58d30296b98cf355acd8d

data/lib/VERSION

@@ -1 +1 @@
-3.0.1169
+3.0.1182

data/lib/v20190722/client.rb

@@ -109,6 +109,7 @@ module TencentCloud
 
         # 接口说明：
         # 启动云端录制功能，完成房间内的音视频录制，并上传到指定的云存储。您可以通过此 API 接口把TRTC 房间中的每一路音视频流做单独的录制又或者多路视频画面合流混成一路。
+        # 在线上正式运营之前，请关注录制的最佳实践 [录制最佳实践](https://cloud.tencent.com/document/product/647/76497#e7e2f04c-6cde-43c9-9cd0-0f8d22dee68c)，配合最佳实践，可大大提高接口录制的可用性。
 
         # 您可以通过此接口实现如下目标：
         # * 指定订阅流参数（RecordParams）来指定需要录制的主播的黑名单或者白名单。

data/lib/v20190722/models.rb

@@ -278,9 +278,20 @@ module TencentCloud
 
       # TTS音频输出的格式
       class AudioFormat < TencentCloud::Common::AbstractModel
-        # @param Format: 生成的音频格式，默认pcm，目前支持的格式列表：流式：[pcm]，非流式 [pcm，wav]
+        # @param Format: 生成的音频格式
+
+        # - TextToSpeech流式接口
+
+        #  支持 pcm, 默认: pcm
+
+        # - TextToSpeech非流式接口
+
+        #  支持 pcm,wav,  默认: pcm
         # @type Format: String
-        # @param SampleRate: 采样率，默认24000， 可选16000, 24000
+        # @param SampleRate: 生成的音频采样率，默认24000
+        # 可选
+        # - 16000
+        # - 24000
         # @type SampleRate: Integer
 
         attr_accessor :Format, :SampleRate
@@ -4005,7 +4016,7 @@ module TencentCloud
         # @type MediaId: Integer
         # @param ImageLayer: 该画布的图层顺序, 这个值越小表示图层越靠后。默认值为0。
         # @type ImageLayer: Integer
-        # @param SubBackgroundImage: 图片的url地址， 只支持jpg, png, jpeg，大小限制不超过5M。注意，url必须携带格式后缀，url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
+        # @param SubBackgroundImage: 图片的url地址， 只支持jpg, png, jpeg，图片分辨率限制不超过2K，图片大小限制不超过5MB。注意，url必须携带格式后缀，url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
         # @type SubBackgroundImage: String
 
         attr_accessor :Top, :Left, :Width, :Height, :UserId, :Alpha, :RenderMode, :MediaId, :ImageLayer, :SubBackgroundImage
@@ -4064,13 +4075,13 @@ module TencentCloud
         # 1：辅流（屏幕分享）；
         # 这个位置的MediaId代表的是对应MaxResolutionUserId的主辅路，MixLayoutList内代表的是自定义用户的主辅路。
         # @type MediaId: Integer
-        # @param BackgroundImageUrl: 图片的url地址，只支持jpg, png, jpeg，大小限制不超过5M。注意，url必须携带格式后缀，url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
+        # @param BackgroundImageUrl: 图片的url地址，只支持jpg, png, jpeg，图片分辨率限制不超过2K，图片大小限制不超过5MB。注意，url必须携带格式后缀，url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
         # @type BackgroundImageUrl: String
         # @param PlaceHolderMode: 设置为1时代表启用占位图功能，0时代表不启用占位图功能，默认为0。启用占位图功能时，在预设位置的用户没有上行音视频时可显示对应的占位图。
         # @type PlaceHolderMode: Integer
         # @param BackgroundImageRenderMode: 背景画面宽高比不一致的时候处理方案，与MixLayoutList定义的RenderMode一致。
         # @type BackgroundImageRenderMode: Integer
-        # @param DefaultSubBackgroundImage: 子画面占位图url地址，只支持jpg, png, jpeg，大小限制不超过5M。注意，url必须携带格式后缀，url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
+        # @param DefaultSubBackgroundImage: 子画面占位图url地址，只支持jpg, png, jpeg，图片分辨率限制不超过2K，图片大小限制不超过5MB。注意，url必须携带格式后缀，url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
         # @type DefaultSubBackgroundImage: String
         # @param WaterMarkList: 水印布局参数， 最多支持25个。
         # @type WaterMarkList: Array
@@ -4775,10 +4786,10 @@ module TencentCloud
 
         attr_accessor :Language, :AlternativeLanguage, :Model, :TranslationLanguage, :HotWordList, :VadSilenceTime, :VadLevel
         extend Gem::Deprecate
-        deprecate :Model, :none, 2025, 11
-        deprecate :Model=, :none, 2025, 11
-        deprecate :TranslationLanguage, :none, 2025, 11
-        deprecate :TranslationLanguage=, :none, 2025, 11
+        deprecate :Model, :none, 2025, 12
+        deprecate :Model=, :none, 2025, 12
+        deprecate :TranslationLanguage, :none, 2025, 12
+        deprecate :TranslationLanguage=, :none, 2025, 12
 
         def initialize(language=nil, alternativelanguage=nil, model=nil, translationlanguage=nil, hotwordlist=nil, vadsilencetime=nil, vadlevel=nil)
           @Language = language
@@ -5327,10 +5338,12 @@ module TencentCloud
         # @type Priority: Integer
         # @param AddHistory: 是否将文本加入到llm历史上下文中
         # @type AddHistory: Boolean
+        # @param MetaInfo: 如果填写，会和字幕绑定发送到端上，注意确保内容为json字符串
+        # @type MetaInfo: String
 
-        attr_accessor :Text, :Interrupt, :StopAfterPlay, :Audio, :DropMode, :Priority, :AddHistory
+        attr_accessor :Text, :Interrupt, :StopAfterPlay, :Audio, :DropMode, :Priority, :AddHistory, :MetaInfo
 
-        def initialize(text=nil, interrupt=nil, stopafterplay=nil, audio=nil, dropmode=nil, priority=nil, addhistory=nil)
+        def initialize(text=nil, interrupt=nil, stopafterplay=nil, audio=nil, dropmode=nil, priority=nil, addhistory=nil, metainfo=nil)
           @Text = text
           @Interrupt = interrupt
           @StopAfterPlay = stopafterplay
@@ -5338,6 +5351,7 @@ module TencentCloud
           @DropMode = dropmode
           @Priority = priority
           @AddHistory = addhistory
+          @MetaInfo = metainfo
         end
 
         def deserialize(params)
@@ -5348,6 +5362,7 @@ module TencentCloud
           @DropMode = params['DropMode']
           @Priority = params['Priority']
           @AddHistory = params['AddHistory']
+          @MetaInfo = params['MetaInfo']
         end
       end
 
@@ -5901,12 +5916,12 @@ module TencentCloud
 
         attr_accessor :SdkAppId, :RoomId, :RoomIdType, :UserId, :UserSig, :StreamUrl, :PrivateMapKey, :VideoEncodeParams, :AudioEncodeParams, :SourceUrl, :SeekSecond, :AutoPush, :RepeatNum, :MaxDuration, :Volume
         extend Gem::Deprecate
-        deprecate :VideoEncodeParams, :none, 2025, 11
-        deprecate :VideoEncodeParams=, :none, 2025, 11
-        deprecate :AudioEncodeParams, :none, 2025, 11
-        deprecate :AudioEncodeParams=, :none, 2025, 11
-        deprecate :SourceUrl, :none, 2025, 11
-        deprecate :SourceUrl=, :none, 2025, 11
+        deprecate :VideoEncodeParams, :none, 2025, 12
+        deprecate :VideoEncodeParams=, :none, 2025, 12
+        deprecate :AudioEncodeParams, :none, 2025, 12
+        deprecate :AudioEncodeParams=, :none, 2025, 12
+        deprecate :SourceUrl, :none, 2025, 12
+        deprecate :SourceUrl=, :none, 2025, 12
 
         def initialize(sdkappid=nil, roomid=nil, roomidtype=nil, userid=nil, usersig=nil, streamurl=nil, privatemapkey=nil, videoencodeparams=nil, audioencodeparams=nil, sourceurl=nil, seeksecond=nil, autopush=nil, repeatnum=nil, maxduration=nil, volume=nil)
           @SdkAppId = sdkappid
@@ -6603,15 +6618,15 @@ module TencentCloud
         # @type AudioFormat: :class:`Tencentcloud::Trtc.v20190722.models.AudioFormat`
         # @param APIKey: TTS的API密钥
         # @type APIKey: String
-        # @param Model: TTS的模型：flow_01_turbo，flow_01_ex
+        # @param Model: TTS的模型，当前固定为：flow_01_turbo
         # @type Model: String
-        # @param Language: 语言参数，默认为空， 参考： (ISO 639-1)
+        # @param Language:  需要合成的语言（ISO 639-1），支持 zh（中文）、en（英文）、yue（粤语）、ja（日语）、ko（韩语），默认自动识别
         # @type Language: String
 
         attr_accessor :Text, :Voice, :SdkAppId, :AudioFormat, :APIKey, :Model, :Language
         extend Gem::Deprecate
-        deprecate :APIKey, :none, 2025, 11
-        deprecate :APIKey=, :none, 2025, 11
+        deprecate :APIKey, :none, 2025, 12
+        deprecate :APIKey=, :none, 2025, 12
 
         def initialize(text=nil, voice=nil, sdkappid=nil, audioformat=nil, apikey=nil, model=nil, language=nil)
           @Text = text
@@ -6672,12 +6687,15 @@ module TencentCloud
         # @type AudioFormat: :class:`Tencentcloud::Trtc.v20190722.models.AudioFormat`
         # @param APIKey: TTS的API密钥
         # @type APIKey: String
-        # @param Model: TTS的模型：flow_01_turbo，flow_01_ex
+        # @param Model: TTS的模型，当前固定为：flow_01_turbo
         # @type Model: String
-        # @param Language: 语言参数，默认为空， 参考： (ISO 639-1)
+        # @param Language:  需要合成的语言（ISO 639-1），支持 zh（中文）、en（英文）、yue（粤语）、ja（日语）、ko（韩语），默认自动识别
         # @type Language: String
 
         attr_accessor :Text, :Voice, :SdkAppId, :AudioFormat, :APIKey, :Model, :Language
+        extend Gem::Deprecate
+        deprecate :APIKey, :none, 2025, 12
+        deprecate :APIKey=, :none, 2025, 12
 
         def initialize(text=nil, voice=nil, sdkappid=nil, audioformat=nil, apikey=nil, model=nil, language=nil)
           @Text = text
@@ -6769,10 +6787,10 @@ module TencentCloud
 
         attr_accessor :UserId, :UserSig, :IMAdminUserId, :IMAdminUserSig, :MaxIdleTime, :TranscriptionMode, :TargetUserId, :TargetUserIdList, :VoicePrint, :TurnDetection
         extend Gem::Deprecate
-        deprecate :IMAdminUserId, :none, 2025, 11
-        deprecate :IMAdminUserId=, :none, 2025, 11
-        deprecate :IMAdminUserSig, :none, 2025, 11
-        deprecate :IMAdminUserSig=, :none, 2025, 11
+        deprecate :IMAdminUserId, :none, 2025, 12
+        deprecate :IMAdminUserId=, :none, 2025, 12
+        deprecate :IMAdminUserSig, :none, 2025, 12
+        deprecate :IMAdminUserSig=, :none, 2025, 12
 
         def initialize(userid=nil, usersig=nil, imadminuserid=nil, imadminusersig=nil, maxidletime=nil, transcriptionmode=nil, targetuserid=nil, targetuseridlist=nil, voiceprint=nil, turndetection=nil)
           @UserId = userid
@@ -7315,15 +7333,15 @@ module TencentCloud
         end
       end
 
-      # TTS的声音参数
+      # TTS的声音参数配置
       class Voice < TencentCloud::Common::AbstractModel
-        # @param VoiceId: TTS的声音的ID
+        # @param VoiceId:  音色 ID，可从音色列表获取，或使用声音克隆生成的自定义音色 ID
         # @type VoiceId: String
-        # @param Speed: 语速，范围 0.5-2.0，默认 1.0
+        # @param Speed: 语速调节，0.5 为半速慢放，2.0 为两倍速快放，1.0 为正常语速，区间：[0.5, 2.0]，默认1.0
         # @type Speed: Float
-        # @param Volume: (0, 10]   默认值1.0
+        # @param Volume:  音量调节，0 为静音，10 为最大音量，建议保持默认值 1.0，区间：[0, 10]，默认1.0
         # @type Volume: Float
-        # @param Pitch: 取值[-12,12],默认0
+        # @param Pitch:  音高调节，负值声音更低沉，正值声音更尖锐，0 为原始音高，区间 [-12, 12],  默认0
         # @type Pitch: Integer
 
         attr_accessor :VoiceId, :Speed, :Volume, :Pitch

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-trtc
 version: !ruby/object:Gem::Version
-  version: 3.0.1169
+  version: 3.0.1182
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-11-19 00:00:00.000000000 Z
+date: 2025-12-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,9 +33,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/v20190722/client.rb
-- lib/v20190722/models.rb
 - lib/tencentcloud-sdk-trtc.rb
+- lib/v20190722/models.rb
+- lib/v20190722/client.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: