tencentcloud-sdk-python-trtc 3.0.1203__tar.gz → 3.0.1214__tar.gz

{tencentcloud-sdk-python-trtc-3.0.1203 → tencentcloud-sdk-python-trtc-3.0.1214}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-trtc
-Version: 3.0.1203
+Version: 3.0.1214
 Summary: Tencent Cloud Trtc SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

{tencentcloud-sdk-python-trtc-3.0.1203 → tencentcloud-sdk-python-trtc-3.0.1214}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-trtc',
-    install_requires=["tencentcloud-sdk-python-common==3.0.1203"],
+    install_requires=["tencentcloud-sdk-python-common==3.0.1214"],
     version=tencentcloud.__version__,
     description='Tencent Cloud Trtc SDK for Python',
     long_description=open('README.rst').read(),

{tencentcloud-sdk-python-trtc-3.0.1203 → tencentcloud-sdk-python-trtc-3.0.1214}/tencentcloud/__init__.py

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

{tencentcloud-sdk-python-trtc-3.0.1203 → tencentcloud-sdk-python-trtc-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-sdk-python-trtc-3.0.1203 → tencentcloud-sdk-python-trtc-3.0.1214}/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,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
@@ -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-sdk-python-trtc-3.0.1203 → tencentcloud-sdk-python-trtc-3.0.1214}/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.1203 → tencentcloud-sdk-python-trtc-3.0.1214}/tencentcloud_sdk_python_trtc.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-trtc
-Version: 3.0.1203
+Version: 3.0.1214
 Summary: Tencent Cloud Trtc SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

tencentcloud-sdk-python-trtc-3.0.1214/tencentcloud_sdk_python_trtc.egg-info/requires.txt

@@ -0,0 +1 @@
+tencentcloud-sdk-python-common==3.0.1214

tencentcloud-sdk-python-trtc-3.0.1203/tencentcloud_sdk_python_trtc.egg-info/requires.txt

@@ -1 +0,0 @@
-tencentcloud-sdk-python-common==3.0.1203