tencentcloud-sdk-python 3.0.1207__py2.py3-none-any.whl → 3.0.1233__py2.py3-none-any.whl

tencentcloud/trtc/v20190722/models.py

@@ -172,12 +172,20 @@ class AgentConfig(AbstractModel):
         :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):
@@ -219,6 +227,22 @@ class AgentConfig(AbstractModel):
     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")
@@ -226,6 +250,8 @@ class AgentConfig(AbstractModel):
         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:]
@@ -7579,7 +7605,7 @@ class RecognizeConfig(AbstractModel):
 - English = "en" # 英语
 - Vietnamese = "vi" # 越南语
 - Japanese = "ja" # 日语
-- Korean = "ko" # 汉语
+- Korean = "ko" # 韩语
 - Indonesia = "id" # 印度尼西亚语
 - Thai = "th" # 泰语
 - Portuguese = "pt" # 葡萄牙语
@@ -7596,39 +7622,13 @@ class RecognizeConfig(AbstractModel):
 
 注意：
 如果缺少满足您需求的语言，请联系我们技术人员。
-示例值：zh
         :type Language: str
         :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"
-
-注意：
-如果缺少满足您需求的语言，请联系我们技术人员。
-示例值：en
+        :param _TranslationLanguage: 目前已不支持
         :type TranslationLanguage: str
         """
         self._Language = None
@@ -7666,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
 
 
@@ -8214,7 +8218,7 @@ class STTConfig(AbstractModel):
 4.     English = "en" # 英语
 5.     Vietnamese = "vi" # 越南语
 6.     Japanese = "ja" # 日语
-7.     Korean = "ko" # 汉语
+7.     Korean = "ko" # 韩语
 8.     Indonesia = "id" # 印度尼西亚语
 9.     Thai = "th" # 泰语
 10.     Portuguese = "pt" # 葡萄牙语
@@ -8238,9 +8242,13 @@ class STTConfig(AbstractModel):
 
 注意：此字段可能返回 null，表示取不到有效值。
         :type AlternativeLanguage: list of str
+        :param _VadSilenceTime: 语音识别vad的时间，范围为240-2000，默认为1000，单位为ms。更小的值会让语音识别分句更快。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type VadSilenceTime: int
         """
         self._Language = None
         self._AlternativeLanguage = None
+        self._VadSilenceTime = None
 
     @property
     def Language(self):
@@ -8258,10 +8266,19 @@ class STTConfig(AbstractModel):
     def AlternativeLanguage(self, AlternativeLanguage):
         self._AlternativeLanguage = AlternativeLanguage
 
+    @property
+    def VadSilenceTime(self):
+        return self._VadSilenceTime
+
+    @VadSilenceTime.setter
+    def VadSilenceTime(self, VadSilenceTime):
+        self._VadSilenceTime = VadSilenceTime
+
 
     def _deserialize(self, params):
         self._Language = params.get("Language")
         self._AlternativeLanguage = params.get("AlternativeLanguage")
+        self._VadSilenceTime = params.get("VadSilenceTime")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -11102,6 +11119,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请求参数结构体
 
@@ -11298,6 +11433,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

@@ -1040,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`
@@ -1454,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):
         """接口说明：
         成功发起混流转推后，可以使用此接口来更新任务。仅在任务进行时有效，任务退出后更新将会返回错误。更新操作为增量更新模式。
@@ -1472,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