tencentcloud-sdk-python-trtc 3.0.1204__py2.py3-none-any.whl → 3.0.1214__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1204'
+__version__ = '3.0.1214'

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
@@ -7551,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
@@ -7641,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
 
 
@@ -8208,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
@@ -8572,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):
@@ -8592,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:]
@@ -8747,7 +8789,7 @@ 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
@@ -9528,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
@@ -9540,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):
@@ -9641,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")
@@ -9658,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:]

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`
@@ -1050,7 +1052,6 @@ class TrtcClient(AbstractClient):
             "type": "subtitle",
             "userid": "xxx",
             "text": "xxx",
-            "translation_text": "xxx",
             "start_time": "00:00:02",
             "end_time": "00:00:05"
         }`
@@ -1058,7 +1059,6 @@ class TrtcClient(AbstractClient):
         - type是subtitle，表示这是实时字幕消息。
         - userid表示是哪个用户说的话。
         - text是语音识别出的文本。
-        - translation_text是text翻译后的文本，如果不启用翻译，则是空字符串。
         - start_time和end_time表示该字幕消息从任务开启后的开始和结束时间。
 
         转录消息具体格式如下：
@@ -1066,7 +1066,6 @@ class TrtcClient(AbstractClient):
             "type": "transcription",
             "userid": "xxx",
             "text": "xxx",
-            "translation_text": "xx",
             "start_time": "00:00:02",
             "end_time": "00:00:05"
         }`

{tencentcloud_sdk_python_trtc-3.0.1204.dist-info → tencentcloud_sdk_python_trtc-3.0.1214.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-trtc
-Version: 3.0.1204
+Version: 3.0.1214
 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.1204)
+Requires-Dist: tencentcloud-sdk-python-common (==3.0.1214)
 
 ============================
 Tencent Cloud SDK for Python

tencentcloud_sdk_python_trtc-3.0.1214.dist-info/RECORD

@@ -0,0 +1,10 @@
+tencentcloud/__init__.py,sha256=suDnhH_XJOsfR7sfDvKRSXvGEjcOmXDnf-op3JKXSBA,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=BxRhIt6tCdG7EVXwMydSHviPu_M85CZtWDZY-r-sAe0,393251
+tencentcloud/trtc/v20190722/trtc_client.py,sha256=1qXvD_oecbj3wr_LRHO9yscDsRFAnuB85TV0hbMFFTo,77719
+tencentcloud_sdk_python_trtc-3.0.1214.dist-info/METADATA,sha256=BtECJ9wujCcdw170_2bwxqCpafRk6JBn34nz8HDWuJk,1497
+tencentcloud_sdk_python_trtc-3.0.1214.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
+tencentcloud_sdk_python_trtc-3.0.1214.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
+tencentcloud_sdk_python_trtc-3.0.1214.dist-info/RECORD,,

tencentcloud_sdk_python_trtc-3.0.1204.dist-info/RECORD

@@ -1,10 +0,0 @@
-tencentcloud/__init__.py,sha256=kLM3NO7-Mkz1cnPd9oUESHYoGsCAbSqB36knQazfZwU,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=WMezBcAepQjZzhCyO1Ri32Q3BypMlitAdpnWyCnH11U,389664
-tencentcloud/trtc/v20190722/trtc_client.py,sha256=7LEm9-06cMUwXOEpm-ueDS7tx9hln3zcZxexC1Fc6Ak,77573
-tencentcloud_sdk_python_trtc-3.0.1204.dist-info/METADATA,sha256=6KiJKqAyR5F6G5UG5S0ugrNzAiS5mgxzFTuoEZvUaJ0,1497
-tencentcloud_sdk_python_trtc-3.0.1204.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
-tencentcloud_sdk_python_trtc-3.0.1204.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
-tencentcloud_sdk_python_trtc-3.0.1204.dist-info/RECORD,,