tencentcloud-sdk-python-trtc 3.0.1202__py2.py3-none-any.whl → 3.0.1223__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1202'
+__version__ = '3.0.1223'

tencentcloud/trtc/v20190722/errorcodes.py

@@ -206,6 +206,9 @@ INVALIDPARAMETER_STRROOMID = 'InvalidParameter.StrRoomId'
 # StreamId参数错误。
 INVALIDPARAMETER_STREAMID = 'InvalidParameter.StreamId'
 
+# StreamUrl参数校验失败
+INVALIDPARAMETER_STREAMURL = 'InvalidParameter.StreamUrl'
+
 # TaskId 参数错误。
 INVALIDPARAMETER_TASKID = 'InvalidParameter.TaskId'
 

tencentcloud/trtc/v20190722/models.py

@@ -166,14 +166,26 @@ class AgentConfig(AbstractModel):
         :param _TargetUserId: 机器人拉流的UserId, 填写后，机器人会拉取该UserId的流进行实时处理
 注意：此字段可能返回 null，表示取不到有效值。
         :type TargetUserId: str
-        :param _MaxIdleTime: 房间内推流用户全部退出后超过MaxIdleTime秒，后台自动关闭任务，默认值是60s。
+        :param _MaxIdleTime: 房间内超过MaxIdleTime 没有推流，后台自动关闭任务，默认值是60s。
 注意：此字段可能返回 null，表示取不到有效值。
         :type MaxIdleTime: int
+        :param _WelcomeMessage: 机器人的欢迎语
+注意：此字段可能返回 null，表示取不到有效值。
+        :type WelcomeMessage: str
+        :param _InterruptMode: 智能打断模式，默认为0，0表示服务端自动打断，1表示服务端不打断，由端上发送打断信令进行打断
+注意：此字段可能返回 null，表示取不到有效值。
+        :type InterruptMode: int
+        :param _InterruptSpeechDuration: InterruptMode为0时使用，单位为毫秒，默认为500ms。表示服务端检测到持续InterruptSpeechDuration毫秒的人声则进行打断。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type InterruptSpeechDuration: int
         """
         self._UserId = None
         self._UserSig = None
         self._TargetUserId = None
         self._MaxIdleTime = None
+        self._WelcomeMessage = None
+        self._InterruptMode = None
+        self._InterruptSpeechDuration = None
 
     @property
     def UserId(self):
@@ -207,12 +219,39 @@ class AgentConfig(AbstractModel):
     def MaxIdleTime(self, MaxIdleTime):
         self._MaxIdleTime = MaxIdleTime
 
+    @property
+    def WelcomeMessage(self):
+        return self._WelcomeMessage
+
+    @WelcomeMessage.setter
+    def WelcomeMessage(self, WelcomeMessage):
+        self._WelcomeMessage = WelcomeMessage
+
+    @property
+    def InterruptMode(self):
+        return self._InterruptMode
+
+    @InterruptMode.setter
+    def InterruptMode(self, InterruptMode):
+        self._InterruptMode = InterruptMode
+
+    @property
+    def InterruptSpeechDuration(self):
+        return self._InterruptSpeechDuration
+
+    @InterruptSpeechDuration.setter
+    def InterruptSpeechDuration(self, InterruptSpeechDuration):
+        self._InterruptSpeechDuration = InterruptSpeechDuration
+
 
     def _deserialize(self, params):
         self._UserId = params.get("UserId")
         self._UserSig = params.get("UserSig")
         self._TargetUserId = params.get("TargetUserId")
         self._MaxIdleTime = params.get("MaxIdleTime")
+        self._WelcomeMessage = params.get("WelcomeMessage")
+        self._InterruptMode = params.get("InterruptMode")
+        self._InterruptSpeechDuration = params.get("InterruptSpeechDuration")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -717,6 +756,8 @@ class CreateCloudRecordingRequest(AbstractModel):
         :param _SdkAppId: TRTC的[SdkAppId](https://cloud.tencent.com/document/product/647/46351#sdkappid)，和录制的房间所对应的SdkAppId相同。
         :type SdkAppId: int
         :param _RoomId: TRTC的[RoomId](https://cloud.tencent.com/document/product/647/46351#roomid)，录制的TRTC房间所对应的RoomId。
+注：房间号类型默认为整型，若房间号类型为字符串，请通过RoomIdType指定。
+
         :type RoomId: str
         :param _UserId: 录制机器人的UserId，用于进房发起录制任务。
 【*注意】这个UserId不能与当前房间内的主播观众[UserId](https://cloud.tencent.com/document/product/647/46351#userid)重复。如果一个房间发起多个录制任务时，机器人的userid也不能相互重复，否则会中断前一个录制任务。建议可以把房间ID作为UserId的标识的一部分，即录制机器人UserId在房间内唯一。
@@ -1271,7 +1312,7 @@ class DescribeAIConversationResponse(AbstractModel):
         :type StartTime: str
         :param _Status: 任务状态。有4个值：1、Idle表示任务未开始2、Preparing表示任务准备中3、InProgress表示任务正在运行4、Stopped表示任务已停止，正在清理资源中
         :type Status: str
-        :param _TaskId: 唯一标识一次任务。
+        :param _TaskId: 任务的唯一标识，在启动任务时生成
         :type TaskId: str
         :param _SessionId: 开启对话任务时填写的SessionId，如果没写则不返回。
         :type SessionId: str
@@ -5916,8 +5957,12 @@ class McuUserInfoParams(AbstractModel):
         r"""
         :param _UserInfo: 用户参数。
         :type UserInfo: :class:`tencentcloud.trtc.v20190722.models.MixUserInfo`
+        :param _SoundLevel: 混音的音量调整：取值范围是0到100，100为原始上行音量，不填默认为100，值越小则音量越低。
+注：该参数只在音量白名单下配置生效，其他场景配置无效。
+        :type SoundLevel: int
         """
         self._UserInfo = None
+        self._SoundLevel = None
 
     @property
     def UserInfo(self):
@@ -5927,11 +5972,20 @@ class McuUserInfoParams(AbstractModel):
     def UserInfo(self, UserInfo):
         self._UserInfo = UserInfo
 
+    @property
+    def SoundLevel(self):
+        return self._SoundLevel
+
+    @SoundLevel.setter
+    def SoundLevel(self, SoundLevel):
+        self._SoundLevel = SoundLevel
+
 
     def _deserialize(self, params):
         if params.get("UserInfo") is not None:
             self._UserInfo = MixUserInfo()
             self._UserInfo._deserialize(params.get("UserInfo"))
+        self._SoundLevel = params.get("SoundLevel")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -7538,59 +7592,43 @@ class RecognizeConfig(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Language: 语音识别支持的语言，默认是"zh"。目前全量支持的语言如下，等号左面是语言英文名，右面是Language字段需要填写的值，该值遵循[ISO639](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes)：
-中文 Chinese = "zh"
-中文繁体 Chinese_TW = "zh-TW" 
-中文方言 Chinese_DIALECT = "zh-dialect"
-English = "en"
-Vietnamese = "vi"
-Japanese = "ja"
-Korean = "ko"
-Indonesia = "id"
-Thai = "th"
-Portuguese = "pt"
-Turkish = "tr"
-Arabic = "ar"
-Spanish = "es"
-Hindi = "hi"
-French = "fr"
-Malay = "ms"
-Filipino = "fil"
-German = "de"
-Italian = "it"
-Russian = "ru"
+        :param _Language: 语音转文字支持识别的语言，默认是"zh" 中文
+目前全量支持的语言如下，等号左面是语言英文名，右面是Language字段需要填写的值，该值遵循[ISO639](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes)：
+可通过购买「语音转文本时长包」解锁或领取包月套餐体验版解锁此功能。
+
+语音转文本支持语言类型如下：
+- Chinese = "zh" # 中文
+- Chinese_TW = "zh-TW" # 中国台湾
+- English = "en" # 英语
+- Chinese_YUE = "zh-yue" # 中国粤语
+- Chinese_DIALECT = "zh-dialect" # 中国方言
+- English = "en" # 英语
+- Vietnamese = "vi" # 越南语
+- Japanese = "ja" # 日语
+- Korean = "ko" # 汉语
+- Indonesia = "id" # 印度尼西亚语
+- Thai = "th" # 泰语
+- Portuguese = "pt" # 葡萄牙语
+- Turkish = "tr" # 土耳其语
+- Arabic = "ar" # 阿拉伯语
+- Spanish = "es" # 西班牙语
+- Hindi = "hi" # 印地语
+- French = "fr" # 法语
+- Malay = "ms" # 马来语
+- Filipino = "fil" # 菲律宾语
+- German = "de" # 德语
+- Italian = "it" # 意大利语
+- Russian = "ru" # 俄语
 
 注意：
 如果缺少满足您需求的语言，请联系我们技术人员。
         :type Language: str
-        :param _AlternativeLanguage: 额外的可能替代语言，最多3个，仅高级版支持。Language指定中文方言时，不能设置该字段。
+        :param _AlternativeLanguage: 发起模糊识别额外可能替代语言类型,最多填写3种语言类型。
+注：Language指定为"zh-dialect" # 中国方言 时，不支持模糊识别，该字段无效
         :type AlternativeLanguage: list of str
-        :param _Model: 使用的模型，目前支持tencent和google，默认是tencent。
+        :param _Model: 目前已不支持
         :type Model: str
-        :param _TranslationLanguage: 翻译功能支持的语言，如果填写，则会启用翻译，不填则只会使用语音识别。
-目前全量支持的语言如下，等号左面是语言英文名，右面是Language字段需要填写的值，该值遵循[ISO639](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes)：
-Chinese = "zh"
-Chinese_TW = "zh-TW" 
-English = "en"
-Vietnamese = "vi"
-Japanese = "ja"
-Korean = "ko"
-Indonesia = "id"
-Thai = "th"
-Portuguese = "pt"
-Turkish = "tr"
-Arabic = "ar"
-Spanish = "es"
-Hindi = "hi"
-French = "fr"
-Malay = "ms"
-Filipino = "fil"
-German = "de"
-Italian = "it"
-Russian = "ru"
-
-注意：
-如果缺少满足您需求的语言，请联系我们技术人员。
+        :param _TranslationLanguage: 目前已不支持
         :type TranslationLanguage: str
         """
         self._Language = None
@@ -7628,10 +7666,14 @@ Russian = "ru"
 
     @property
     def TranslationLanguage(self):
+        warnings.warn("parameter `TranslationLanguage` is deprecated", DeprecationWarning) 
+
         return self._TranslationLanguage
 
     @TranslationLanguage.setter
     def TranslationLanguage(self, TranslationLanguage):
+        warnings.warn("parameter `TranslationLanguage` is deprecated", DeprecationWarning) 
+
         self._TranslationLanguage = TranslationLanguage
 
 
@@ -8195,7 +8237,8 @@ class STTConfig(AbstractModel):
 如果缺少满足您需求的语言，请联系我们技术人员。
 注意：此字段可能返回 null，表示取不到有效值。
         :type Language: str
-        :param _AlternativeLanguage: 额外识别可能替代语言,最多3个, 需高级版支持,Language指定方言时，不允许设置该字段
+        :param _AlternativeLanguage: 发起模糊识别额外可能替代语言类型,最多填写3种语言类型, 
+注：Language指定为"zh-dialect" # 中国方言 时，不支持模糊识别，该字段无效
 
 注意：此字段可能返回 null，表示取不到有效值。
         :type AlternativeLanguage: list of str
@@ -8559,9 +8602,12 @@ class ServerPushText(AbstractModel):
         :type Text: str
         :param _Interrupt: 是否允许该文本打断机器人说话
         :type Interrupt: bool
+        :param _StopAfterPlay: 播报完文本后，是否自动关闭对话任务
+        :type StopAfterPlay: bool
         """
         self._Text = None
         self._Interrupt = None
+        self._StopAfterPlay = None
 
     @property
     def Text(self):
@@ -8579,10 +8625,19 @@ class ServerPushText(AbstractModel):
     def Interrupt(self, Interrupt):
         self._Interrupt = Interrupt
 
+    @property
+    def StopAfterPlay(self):
+        return self._StopAfterPlay
+
+    @StopAfterPlay.setter
+    def StopAfterPlay(self, StopAfterPlay):
+        self._StopAfterPlay = StopAfterPlay
+
 
     def _deserialize(self, params):
         self._Text = params.get("Text")
         self._Interrupt = params.get("Interrupt")
+        self._StopAfterPlay = params.get("StopAfterPlay")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -8734,18 +8789,18 @@ class StartAIConversationRequest(AbstractModel):
         :type RoomId: str
         :param _AgentConfig: 机器人参数
         :type AgentConfig: :class:`tencentcloud.trtc.v20190722.models.AgentConfig`
-        :param _SessionId: 调用方传入的唯一Id，服务端用来去重。
+        :param _SessionId: 调用方传入的唯一Id，可用于客户侧防止重复发起任务以及可以通过该字段查询任务状态。
         :type SessionId: str
         :param _RoomIdType: TRTC房间号的类型，0代表数字房间号，1代表字符串房间号。不填默认是数字房间号。
         :type RoomIdType: int
         :param _STTConfig: 语音识别配置。
         :type STTConfig: :class:`tencentcloud.trtc.v20190722.models.STTConfig`
         :param _LLMConfig: LLM配置。需符合openai规范，为JSON字符串，示例如下：
-<pre> { <br> &emsp;  "LLMType": “大模型类型"，  // String 必填，目前固定为"openai" <br> &emsp;  "Model": "您的模型名称", // String 必填，指定使用的模型<br>    "APIKey": "您的OpenAI API密钥", // String 必填，相当于环境变量中的OPENAI_API_KEY<br> &emsp;  "APIBaseUrl": "https://api.openai.com", // String 必填，OpenAI API的基础URL<br> &emsp;  "Streaming": true // Boolean 非必填，指定是否使用流式传输<br> &emsp;} </pre>
+<pre> { <br> &emsp;  "LLMType": “大模型类型"，  // String 必填，如："openai" <br> &emsp;  "Model": "您的模型名称", // String 必填，指定使用的模型<br>    "APIKey": "您的LLM API密钥", // String 必填 <br> &emsp;  "APIUrl": "https://api.xxx.com/chat/completions", // String 必填，LLM API访问的URL<br> &emsp;  "Streaming": true // Boolean 非必填，指定是否使用流式传输<br> &emsp;} </pre>
 
         :type LLMConfig: str
-        :param _TTSConfig: TTS配置。目前支持腾讯云TTS, 为JSON字符串，示例如下：
- <pre>{ <br> &emsp; "AppId": "您的应用ID", // String 必填<br> &emsp; "TTSType": "TTS类型", // String TTS类型, 固定为"tencent"<br> &emsp; "SercetId": "您的密钥ID", // String 必填<br> &emsp; "SercetKey":  "您的密钥Key", // String 必填<br> &emsp; "VoiceType": 101001, // Integer  必填，音色 ID，包括标准音色与精品音色，精品音色拟真度更高，价格不同于标准音色，请参见<a href="https://cloud.tencent.com/document/product/1073/34112">语音合成计费概述</a>。完整的音色 ID 列表请参见<a href="https://cloud.tencent.com/document/product/1073/92668#55924b56-1a73-4663-a7a1-a8dd82d6e823">语音合成音色列表</a>。<br> &emsp; "Speed": 1.25, // Integer 非必填，语速，范围：[-2，6]，分别对应不同语速： -2: 代表0.6倍 -1: 代表0.8倍 0: 代表1.0倍（默认） 1: 代表1.2倍 2: 代表1.5倍  6: 代表2.5倍  如果需要更细化的语速，可以保留小数点后 2 位，例如0.5/1.25/2.81等。 参数值与实际语速转换，可参考 <a href="https://sdk-1300466766.cos.ap-shanghai.myqcloud.com/sample/speed_sample.tar.gz">语速转换</a><br> &emsp; "Volume": 5, // Integer 非必填，音量大小，范围：[0，10]，分别对应11个等级的音量，默认值为0，代表正常音量。<br> &emsp; "PrimaryLanguage": "zh-CN" // String 非必填，主要语言<br> &emsp;}</pre>
+        :param _TTSConfig: TTS配置，为JSON字符串，腾讯云TTS示例如下：
+ <pre>{ <br> &emsp; "AppId": 您的应用ID, // Integer 必填<br> &emsp; "TTSType": "TTS类型", // String TTS类型, 固定为"tencent"<br> &emsp; "SecretId": "您的密钥ID", // String 必填<br> &emsp; "SecretKey":  "您的密钥Key", // String 必填<br> &emsp; "VoiceType": 101001, // Integer  必填，音色 ID，包括标准音色与精品音色，精品音色拟真度更高，价格不同于标准音色，请参见<a href="https://cloud.tencent.com/document/product/1073/34112">语音合成计费概述</a>。完整的音色 ID 列表请参见<a href="https://cloud.tencent.com/document/product/1073/92668#55924b56-1a73-4663-a7a1-a8dd82d6e823">语音合成音色列表</a>。<br> &emsp; "Speed": 1.25, // Integer 非必填，语速，范围：[-2，6]，分别对应不同语速： -2: 代表0.6倍 -1: 代表0.8倍 0: 代表1.0倍（默认） 1: 代表1.2倍 2: 代表1.5倍  6: 代表2.5倍  如果需要更细化的语速，可以保留小数点后 2 位，例如0.5/1.25/2.81等。 参数值与实际语速转换，可参考 <a href="https://sdk-1300466766.cos.ap-shanghai.myqcloud.com/sample/speed_sample.tar.gz">语速转换</a><br> &emsp; "Volume": 5, // Integer 非必填，音量大小，范围：[0，10]，分别对应11个等级的音量，默认值为0，代表正常音量。<br> &emsp; "PrimaryLanguage": "zh-CN" // String 非必填，主要语言<br> &emsp;}</pre>
         :type TTSConfig: str
         """
         self._SdkAppId = None
@@ -9515,6 +9570,15 @@ class StartStreamIngestRequest(AbstractModel):
         :type SourceUrl: list of str
         :param _SeekSecond: 指定视频从某个秒时间戳播放
         :type SeekSecond: int
+        :param _AutoPush: 开启自动旁路推流，请确认控制台已经开启该功能。
+        :type AutoPush: bool
+        :param _RepeatNum: 循环播放次数, 取值范围[-1, 1000],  默认1次。
+ - 0 无效值
+ - -1 循环播放, 需要主动调用停止接口或设置MaxDuration
+
+        :type RepeatNum: int
+        :param _MaxDuration: 循环播放最大时长,仅支持RepeatNum设置-1时生效，取值范围[1, 10080]，单位分钟。
+        :type MaxDuration: int
         """
         self._SdkAppId = None
         self._RoomId = None
@@ -9527,6 +9591,9 @@ class StartStreamIngestRequest(AbstractModel):
         self._AudioEncodeParams = None
         self._SourceUrl = None
         self._SeekSecond = None
+        self._AutoPush = None
+        self._RepeatNum = None
+        self._MaxDuration = None
 
     @property
     def SdkAppId(self):
@@ -9628,6 +9695,30 @@ class StartStreamIngestRequest(AbstractModel):
     def SeekSecond(self, SeekSecond):
         self._SeekSecond = SeekSecond
 
+    @property
+    def AutoPush(self):
+        return self._AutoPush
+
+    @AutoPush.setter
+    def AutoPush(self, AutoPush):
+        self._AutoPush = AutoPush
+
+    @property
+    def RepeatNum(self):
+        return self._RepeatNum
+
+    @RepeatNum.setter
+    def RepeatNum(self, RepeatNum):
+        self._RepeatNum = RepeatNum
+
+    @property
+    def MaxDuration(self):
+        return self._MaxDuration
+
+    @MaxDuration.setter
+    def MaxDuration(self, MaxDuration):
+        self._MaxDuration = MaxDuration
+
 
     def _deserialize(self, params):
         self._SdkAppId = params.get("SdkAppId")
@@ -9645,6 +9736,9 @@ class StartStreamIngestRequest(AbstractModel):
             self._AudioEncodeParams._deserialize(params.get("AudioEncodeParams"))
         self._SourceUrl = params.get("SourceUrl")
         self._SeekSecond = params.get("SeekSecond")
+        self._AutoPush = params.get("AutoPush")
+        self._RepeatNum = params.get("RepeatNum")
+        self._MaxDuration = params.get("MaxDuration")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -11012,6 +11106,124 @@ class TrtcUsage(AbstractModel):
         
 
 
+class UpdateAIConversationRequest(AbstractModel):
+    """UpdateAIConversation请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _TaskId: 唯一标识一个任务
+        :type TaskId: str
+        :param _WelcomeMessage: 不填写则不进行更新，机器人的欢迎语
+        :type WelcomeMessage: str
+        :param _InterruptMode: 不填写则不进行更新。智能打断模式，0表示服务端自动打断，1表示服务端不打断，由端上发送打断信令进行打断
+        :type InterruptMode: int
+        :param _InterruptSpeechDuration: 不填写则不进行更新。InterruptMode为0时使用，单位为毫秒，默认为500ms。表示服务端检测到持续InterruptSpeechDuration毫秒的人声则进行打断
+        :type InterruptSpeechDuration: int
+        :param _LLMConfig: 不填写则不进行更新，LLM配置，详情见StartAIConversation接口
+        :type LLMConfig: str
+        :param _TTSConfig: 不填写则不进行更新，TTS配置，详情见StartAIConversation接口
+        :type TTSConfig: str
+        """
+        self._TaskId = None
+        self._WelcomeMessage = None
+        self._InterruptMode = None
+        self._InterruptSpeechDuration = None
+        self._LLMConfig = None
+        self._TTSConfig = None
+
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
+    @property
+    def WelcomeMessage(self):
+        return self._WelcomeMessage
+
+    @WelcomeMessage.setter
+    def WelcomeMessage(self, WelcomeMessage):
+        self._WelcomeMessage = WelcomeMessage
+
+    @property
+    def InterruptMode(self):
+        return self._InterruptMode
+
+    @InterruptMode.setter
+    def InterruptMode(self, InterruptMode):
+        self._InterruptMode = InterruptMode
+
+    @property
+    def InterruptSpeechDuration(self):
+        return self._InterruptSpeechDuration
+
+    @InterruptSpeechDuration.setter
+    def InterruptSpeechDuration(self, InterruptSpeechDuration):
+        self._InterruptSpeechDuration = InterruptSpeechDuration
+
+    @property
+    def LLMConfig(self):
+        return self._LLMConfig
+
+    @LLMConfig.setter
+    def LLMConfig(self, LLMConfig):
+        self._LLMConfig = LLMConfig
+
+    @property
+    def TTSConfig(self):
+        return self._TTSConfig
+
+    @TTSConfig.setter
+    def TTSConfig(self, TTSConfig):
+        self._TTSConfig = TTSConfig
+
+
+    def _deserialize(self, params):
+        self._TaskId = params.get("TaskId")
+        self._WelcomeMessage = params.get("WelcomeMessage")
+        self._InterruptMode = params.get("InterruptMode")
+        self._InterruptSpeechDuration = params.get("InterruptSpeechDuration")
+        self._LLMConfig = params.get("LLMConfig")
+        self._TTSConfig = params.get("TTSConfig")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class UpdateAIConversationResponse(AbstractModel):
+    """UpdateAIConversation返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._RequestId = None
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._RequestId = params.get("RequestId")
+
+
 class UpdatePublishCdnStreamRequest(AbstractModel):
     """UpdatePublishCdnStream请求参数结构体
 
@@ -11208,6 +11420,100 @@ class UpdatePublishCdnStreamResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class UpdateStreamIngestRequest(AbstractModel):
+    """UpdateStreamIngest请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _SdkAppId: TRTC的SDKAppId，和任务的房间所对应的SDKAppId相同
+        :type SdkAppId: int
+        :param _TaskId: 任务的唯一Id，在启动任务成功后会返回。
+        :type TaskId: str
+        :param _StreamUrl: 源流URL【必填】。
+        :type StreamUrl: str
+        """
+        self._SdkAppId = None
+        self._TaskId = None
+        self._StreamUrl = None
+
+    @property
+    def SdkAppId(self):
+        return self._SdkAppId
+
+    @SdkAppId.setter
+    def SdkAppId(self, SdkAppId):
+        self._SdkAppId = SdkAppId
+
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
+    @property
+    def StreamUrl(self):
+        return self._StreamUrl
+
+    @StreamUrl.setter
+    def StreamUrl(self, StreamUrl):
+        self._StreamUrl = StreamUrl
+
+
+    def _deserialize(self, params):
+        self._SdkAppId = params.get("SdkAppId")
+        self._TaskId = params.get("TaskId")
+        self._StreamUrl = params.get("StreamUrl")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class UpdateStreamIngestResponse(AbstractModel):
+    """UpdateStreamIngest返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Status: 任务的状态信息。InProgress：表示当前任务正在进行中。NotExist：表示当前任务不存在。示例值：InProgress
+        :type Status: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._Status = None
+        self._RequestId = None
+
+    @property
+    def Status(self):
+        return self._Status
+
+    @Status.setter
+    def Status(self, Status):
+        self._Status = Status
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._Status = params.get("Status")
+        self._RequestId = params.get("RequestId")
+
+
 class UserInformation(AbstractModel):
     """用户信息，包括用户进房时间，退房时间等
 

tencentcloud/trtc/v20190722/trtc_client.py

@@ -1015,7 +1015,9 @@ class TrtcClient(AbstractClient):
 
 
     def StartAIConversation(self, request):
-        """启动一个任务，机器人将进入TRTC房间，与指定成员进行AI对话
+        """启动AI对话任务，AI通道机器人进入TRTC房间，与房间内指定的成员进行AI对话，适用于智能客服，AI口语教师等场景
+
+        TRTC AI对话功能内置语音转文本能力，同时提供通道服务，即客户可灵活指定第三方AI模型（LLM）服务和文本转音频（TTS)服务，更多[功能说明](https://cloud.tencent.com/document/product/647/108901)。
 
         :param request: Request instance for StartAIConversation.
         :type request: :class:`tencentcloud.trtc.v20190722.models.StartAIConversationRequest`
@@ -1038,48 +1040,12 @@ class TrtcClient(AbstractClient):
 
 
     def StartAITranscription(self, request):
-        """这个接口调用后，后台会启动转录机器人，实时进行语音识别并下发字幕和转录消息。
+        """启动转录机器人，后台会通过机器人拉流进行实时进行语音识别并下发字幕和转录消息。
         转录机器人支持两种拉流方式，通过TranscriptionMode字段控制：
         - 拉取全房间的流。
         - 拉取特定用户的流。
 
-        服务端通过TRTC的自定义消息实时下发字幕和会议记录，CmdId固定是1。客户端只需监听自定义消息的回调即可，比如[c++回调](https://cloud.tencent.com/document/product/647/79637#4cd82f4edb24992a15a25187089e1565)。其他客户端比如安卓、Web等同样可在该链接处找到。
-
-        服务端实时下发的消息是JSON字符串，实时字幕具体格式如下：
-        `{
-            "type": "subtitle",
-            "userid": "xxx",
-            "text": "xxx",
-            "translation_text": "xxx",
-            "start_time": "00:00:02",
-            "end_time": "00:00:05"
-        }`
-        字段作用如下：
-        - type是subtitle，表示这是实时字幕消息。
-        - userid表示是哪个用户说的话。
-        - text是语音识别出的文本。
-        - translation_text是text翻译后的文本，如果不启用翻译，则是空字符串。
-        - start_time和end_time表示该字幕消息从任务开启后的开始和结束时间。
-
-        转录消息具体格式如下：
-        `{
-            "type": "transcription",
-            "userid": "xxx",
-            "text": "xxx",
-            "translation_text": "xx",
-            "start_time": "00:00:02",
-            "end_time": "00:00:05"
-        }`
-        字段作用如下：
-        - type是transcription，表示这是转录消息。
-        - 其余字段同实时字幕消息。
-
-        转录消息和实时字幕消息的区别是，转录消息是完整的一句话，实时字幕消息则是这一句话的中间阶段。
-        假如有一句完整的话，“今天天气怎么样？”，那么服务的下发消息的顺序可能是这样：
-        - 字幕消息，“今天”
-        - 字幕消息，“今天天气”
-        - 字幕消息，“今天天气怎么样”
-        - 转录消息，“今天天气怎么样？”
+        服务端通过TRTC的自定义消息实时下发字幕以及转录消息，CmdId固定是1。客户端只需监听自定义消息的回调即可，比如[c++回调](https://cloud.tencent.com/document/product/647/79637#4cd82f4edb24992a15a25187089e1565)。其他客户端比如安卓、Web等同样可在该链接处找到。
 
         :param request: Request instance for StartAITranscription.
         :type request: :class:`tencentcloud.trtc.v20190722.models.StartAITranscriptionRequest`
@@ -1452,6 +1418,29 @@ class TrtcClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def UpdateAIConversation(self, request):
+        """更新AIConversation参数
+
+        :param request: Request instance for UpdateAIConversation.
+        :type request: :class:`tencentcloud.trtc.v20190722.models.UpdateAIConversationRequest`
+        :rtype: :class:`tencentcloud.trtc.v20190722.models.UpdateAIConversationResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("UpdateAIConversation", params, headers=headers)
+            response = json.loads(body)
+            model = models.UpdateAIConversationResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def UpdatePublishCdnStream(self, request):
         """接口说明：
         成功发起混流转推后，可以使用此接口来更新任务。仅在任务进行时有效，任务退出后更新将会返回错误。更新操作为增量更新模式。
@@ -1470,6 +1459,29 @@ class TrtcClient(AbstractClient):
             model = models.UpdatePublishCdnStreamResponse()
             model._deserialize(response["Response"])
             return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def UpdateStreamIngest(self, request):
+        """更新输入在线媒体流任务的StreamUrl
+
+        :param request: Request instance for UpdateStreamIngest.
+        :type request: :class:`tencentcloud.trtc.v20190722.models.UpdateStreamIngestRequest`
+        :rtype: :class:`tencentcloud.trtc.v20190722.models.UpdateStreamIngestResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("UpdateStreamIngest", params, headers=headers)
+            response = json.loads(body)
+            model = models.UpdateStreamIngestResponse()
+            model._deserialize(response["Response"])
+            return model
         except Exception as e:
             if isinstance(e, TencentCloudSDKException):
                 raise

{tencentcloud_sdk_python_trtc-3.0.1202.dist-info → tencentcloud_sdk_python_trtc-3.0.1223.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-trtc
-Version: 3.0.1202
+Version: 3.0.1223
 Summary: Tencent Cloud Trtc SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common (==3.0.1202)
+Requires-Dist: tencentcloud-sdk-python-common (==3.0.1223)
 
 ============================
 Tencent Cloud SDK for Python

tencentcloud_sdk_python_trtc-3.0.1223.dist-info/RECORD

@@ -0,0 +1,10 @@
+tencentcloud/__init__.py,sha256=5d-_9TB6206UdZcePn8JnwNxGLG_AymNZeJyPS5l958,631
+tencentcloud/trtc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tencentcloud/trtc/v20190722/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tencentcloud/trtc/v20190722/errorcodes.py,sha256=WNu9Hx8kn4lpbc342xXM1lw4uTQIx2JCvZchRlUXBL8,10987
+tencentcloud/trtc/v20190722/models.py,sha256=u0n5Wjl8Ax2vvKoCG1TsSAbJccaBfY1SB4zBNI-TbfI,399772
+tencentcloud/trtc/v20190722/trtc_client.py,sha256=sTzamtT7sp-ul08Ekv4xEa9sWm03AEDqQMcioZX4LtE,78132
+tencentcloud_sdk_python_trtc-3.0.1223.dist-info/METADATA,sha256=MgjeOdcaXbPdy3GE3kFuFsNoC0UzV3z_5R3in0PhYn8,1497
+tencentcloud_sdk_python_trtc-3.0.1223.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
+tencentcloud_sdk_python_trtc-3.0.1223.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
+tencentcloud_sdk_python_trtc-3.0.1223.dist-info/RECORD,,

tencentcloud_sdk_python_trtc-3.0.1202.dist-info/RECORD

@@ -1,10 +0,0 @@
-tencentcloud/__init__.py,sha256=MRhmf8qYzKiISF-A18v9HHqE8Aob-YvRu2_WZ8ECOoU,631
-tencentcloud/trtc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tencentcloud/trtc/v20190722/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tencentcloud/trtc/v20190722/errorcodes.py,sha256=K4q7UWQkdedEyrQJFz67cH3xzyKo78PS0EseWry0JXo,10898
-tencentcloud/trtc/v20190722/models.py,sha256=jQ3dyyTZiHhDEA-f2IU_8rBANerjKFNwkvYROwPifPY,389205
-tencentcloud/trtc/v20190722/trtc_client.py,sha256=7LEm9-06cMUwXOEpm-ueDS7tx9hln3zcZxexC1Fc6Ak,77573
-tencentcloud_sdk_python_trtc-3.0.1202.dist-info/METADATA,sha256=Na9XzmVWOv5Tm4AS9ouRYyr6fBWKKV7ZjLz2orPhPn8,1497
-tencentcloud_sdk_python_trtc-3.0.1202.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
-tencentcloud_sdk_python_trtc-3.0.1202.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
-tencentcloud_sdk_python_trtc-3.0.1202.dist-info/RECORD,,