tencentcloud-sdk-python-trtc 3.0.1196__tar.gz → 3.0.1208__tar.gz

{tencentcloud-sdk-python-trtc-3.0.1196 → tencentcloud-sdk-python-trtc-3.0.1208}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-trtc
-Version: 3.0.1196
+Version: 3.0.1208
 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.1196 → tencentcloud-sdk-python-trtc-3.0.1208}/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.1196"],
+    install_requires=["tencentcloud-sdk-python-common==3.0.1208"],
     version=tencentcloud.__version__,
     description='Tencent Cloud Trtc SDK for Python',
     long_description=open('README.rst').read(),

{tencentcloud-sdk-python-trtc-3.0.1196 → tencentcloud-sdk-python-trtc-3.0.1208}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1196'
+__version__ = '3.0.1208'

{tencentcloud-sdk-python-trtc-3.0.1196 → tencentcloud-sdk-python-trtc-3.0.1208}/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.1196 → tencentcloud-sdk-python-trtc-3.0.1208}/tencentcloud/trtc/v20190722/models.py

@@ -166,14 +166,18 @@ 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
         """
         self._UserId = None
         self._UserSig = None
         self._TargetUserId = None
         self._MaxIdleTime = None
+        self._WelcomeMessage = None
 
     @property
     def UserId(self):
@@ -207,12 +211,21 @@ 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
+
 
     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")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -621,6 +634,92 @@ class CloudVod(AbstractModel):
         
 
 
+class ControlAIConversationRequest(AbstractModel):
+    """ControlAIConversation请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _TaskId: 任务唯一标识
+        :type TaskId: str
+        :param _Command: 控制命令，目前支持命令如下：
+
+- ServerPushText，服务端发送文本给AI机器人，AI机器人会播报该文本
+        :type Command: str
+        :param _ServerPushText: 服务端发送播报文本命令，当Command为ServerPushText时必填
+        :type ServerPushText: :class:`tencentcloud.trtc.v20190722.models.ServerPushText`
+        """
+        self._TaskId = None
+        self._Command = None
+        self._ServerPushText = None
+
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
+    @property
+    def Command(self):
+        return self._Command
+
+    @Command.setter
+    def Command(self, Command):
+        self._Command = Command
+
+    @property
+    def ServerPushText(self):
+        return self._ServerPushText
+
+    @ServerPushText.setter
+    def ServerPushText(self, ServerPushText):
+        self._ServerPushText = ServerPushText
+
+
+    def _deserialize(self, params):
+        self._TaskId = params.get("TaskId")
+        self._Command = params.get("Command")
+        if params.get("ServerPushText") is not None:
+            self._ServerPushText = ServerPushText()
+            self._ServerPushText._deserialize(params.get("ServerPushText"))
+        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 ControlAIConversationResponse(AbstractModel):
+    """ControlAIConversation返回参数结构体
+
+    """
+
+    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 CreateCloudRecordingRequest(AbstractModel):
     """CreateCloudRecording请求参数结构体
 
@@ -631,6 +730,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在房间内唯一。
@@ -1185,7 +1286,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
@@ -5830,8 +5931,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):
@@ -5841,11 +5946,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:]
@@ -7452,39 +7566,48 @@ 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" # 俄语
 
 注意：
 如果缺少满足您需求的语言，请联系我们技术人员。
+示例值：zh
         :type Language: str
-        :param _AlternativeLanguage: 额外的可能替代语言，最多3个，仅高级版支持。Language指定中文方言时，不能设置该字段。
+        :param _AlternativeLanguage: 发起模糊识别额外可能替代语言类型,最多填写3种语言类型。
+注：Language指定为"zh-dialect" # 中国方言 时，不支持模糊识别，该字段无效
         :type AlternativeLanguage: list of str
         :param _Model: 使用的模型，目前支持tencent和google，默认是tencent。
         :type Model: str
         :param _TranslationLanguage: 翻译功能支持的语言，如果填写，则会启用翻译，不填则只会使用语音识别。
+注：文本翻译功能需要购买「语音转文本时长包」解锁或领取包月套餐-体验版解。
 目前全量支持的语言如下，等号左面是语言英文名，右面是Language字段需要填写的值，该值遵循[ISO639](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes)：
 Chinese = "zh"
-Chinese_TW = "zh-TW" 
+Chinese_TW = "zh-TW"
 English = "en"
 Vietnamese = "vi"
 Japanese = "ja"
@@ -7505,6 +7628,7 @@ Russian = "ru"
 
 注意：
 如果缺少满足您需求的语言，请联系我们技术人员。
+示例值：en
         :type TranslationLanguage: str
         """
         self._Language = None
@@ -8109,7 +8233,8 @@ class STTConfig(AbstractModel):
 如果缺少满足您需求的语言，请联系我们技术人员。
 注意：此字段可能返回 null，表示取不到有效值。
         :type Language: str
-        :param _AlternativeLanguage: 额外识别可能替代语言,最多3个, 需高级版支持,Language指定方言时，不允许设置该字段
+        :param _AlternativeLanguage: 发起模糊识别额外可能替代语言类型,最多填写3种语言类型, 
+注：Language指定为"zh-dialect" # 中国方言 时，不支持模糊识别，该字段无效
 
 注意：此字段可能返回 null，表示取不到有效值。
         :type AlternativeLanguage: list of str
@@ -8462,6 +8587,63 @@ class SeriesInfos(AbstractModel):
         
 
 
+class ServerPushText(AbstractModel):
+    """服务端控制AI对话机器人播报指定文本
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Text: 服务端推送播报文本
+        :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):
+        return self._Text
+
+    @Text.setter
+    def Text(self, Text):
+        self._Text = Text
+
+    @property
+    def Interrupt(self):
+        return self._Interrupt
+
+    @Interrupt.setter
+    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:]
+            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 SingleSubscribeParams(AbstractModel):
     """单流旁路转推的用户上行信息。
 
@@ -8603,18 +8785,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
@@ -9384,6 +9566,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
@@ -9396,6 +9587,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):
@@ -9497,6 +9691,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")
@@ -9514,6 +9732,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:]
@@ -10896,7 +11117,7 @@ class UpdatePublishCdnStreamRequest(AbstractModel):
         :type SequenceNumber: int
         :param _WithTranscoding: 是否转码，0表示无需转码，1表示需要转码。
         :type WithTranscoding: int
-        :param _AudioParams: 更新相关参数，只支持更新参与混音的主播列表参数。不填表示不更新此参数。
+        :param _AudioParams: 更新相关参数，只支持更新参与混音的主播列表参数，不支持更新Codec、采样率、码率和声道数。不填表示不更新此参数。
         :type AudioParams: :class:`tencentcloud.trtc.v20190722.models.McuAudioParams`
         :param _VideoParams: 更新视频相关参数，转码时支持更新除编码类型之外的编码参数，视频布局参数，背景图片和背景颜色参数，水印参数。不填表示不更新此参数。
         :type VideoParams: :class:`tencentcloud.trtc.v20190722.models.McuVideoParams`

{tencentcloud-sdk-python-trtc-3.0.1196 → tencentcloud-sdk-python-trtc-3.0.1208}/tencentcloud/trtc/v20190722/trtc_client.py

@@ -26,6 +26,29 @@ class TrtcClient(AbstractClient):
     _service = 'trtc'
 
 
+    def ControlAIConversation(self, request):
+        """提供服务端控制机器人的功能
+
+        :param request: Request instance for ControlAIConversation.
+        :type request: :class:`tencentcloud.trtc.v20190722.models.ControlAIConversationRequest`
+        :rtype: :class:`tencentcloud.trtc.v20190722.models.ControlAIConversationResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("ControlAIConversation", params, headers=headers)
+            response = json.loads(body)
+            model = models.ControlAIConversationResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CreateCloudRecording(self, request):
         """接口说明：
         启动云端录制功能，完成房间内的音视频录制，并上传到指定的云存储。您可以通过此 API 接口把TRTC 房间中的每一路音视频流做单独的录制又或者多路视频画面合流混成一路。
@@ -992,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`
@@ -1165,102 +1190,14 @@ class TrtcClient(AbstractClient):
 
 
     def StartPublishCdnStream(self, request):
-        """TRTC房间中可能会同时存在多路音视频流，您可以通过混流转推API，通知腾讯云服务端将同个房间或者多个房间的多路视频画面混合到一起，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看，同时可以支持将这一路音视频的混流回推到TRTC房间内部。
-
-        云api混流转推功能包含三个接口：
-        1、StartPublishCdnStream：启动一个混流转推任务，此接口会发起一个新的混流转推任务，启动成功后会返回一个sdkappid维度唯一的任务id（TaskId）。您需要保存该TaskId，后续需要依赖此TaskId更新任务和结束任务。
-        2、UpdatePublishCdnStream：更新指定的混流转推任务，包括：更新视频画面的布局、更新混音列表、更新转推cdn的地址列表以及更新回推房间列表。
-        3、StopPublishCdnStream：停止指定的混流转推任务。
-
-        您可以通过此套接口实现目标：
-        1、设置最终混流的画质和音质，包括视频分辨率、视频帧率、视频码率，和音频质量。
-        2、设置每一路画面的布局位置，您只需要设置一次，后续您指定的混流用户进房上行音视频时，排版引擎会自动将该用户的画面混合到您指定的布局位置。同时您可以使用更新接口调整画面的布局位置。
-        3、设置多个cdn转推的目的地址，一个转推任务最多可以同时设置10个cdn转推地址，如果您需要转推非腾讯云的cdn地址时，需要联系腾讯云开通能力。
-        4、设置多个回推房间列表，一个转推任务最多可以同时将混流回推到10个TRTC房间。
-
-        目前已经支持如下几种布局模版，其中动态布局模版（悬浮模板、九宫格模板、屏幕分享模板）只支持单个TRTC房间，自定义模版支持混合多个TRTC房间内的音视频流。具体说明如下：
-        1、悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频默认不占布局配置，也支持设置。每个子画面默认采用居中裁剪的方式进行渲染，也支持统一设置子画面的渲染方式。
-        2、九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，默认不占布局配置，也支持设置。每个子画面默认采用居中裁剪的方式进行渲染，也支持统一设置子画面的渲染方式。
-        3、屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，需要您明确设置占据大画面的混流用户信息。其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理，也支持统一设置子画面的渲染方式。
-        4、自定义布局模版：支持您主动根据业务需要设置布局位置，每个预设的布局位置支持具名设置（具名设置需要明确指定房间号和用户名）和不具名设置。当一个子画面具名设置时，该位置就为该用户预留，用户进房且上行音视频数据时会自动占据该位置，其它用户不会占据该位置。当预设的布局位置未具名时，排版引擎会根据进房间顺序自动填充，预设位置填满时，不再混合其它用户的画面和声音。每个子画面位置支持设置占位图（BackgroundImageUrl），当用户未进房或者只上行音频数据时，该位置画面可显示对应的占位图画面。
-
-        您可以控制台开通旁路转推回调功能实现转推cdn状态的事件监控，具体说明请参考官网文档：[旁路转推回调说明](https://cloud.tencent.com/document/product/647/88552)
-        您使用转推api时根据使用特性可能会产生如下费用：
-        MCU混流转码费用请参考文档：[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)
-        转推非腾讯云CDN费用请参考文档：[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)
-
-        参数的使用说明：
-        1、AgentParams：每个转推任务会拉起一个机器人用户进入TRTC房间进行拉流，您需要通过AgentParams.UserId参数进行设置，这个机器人id不能和房间中的普通用户id冲突，否则会导致转推任务由于机器人用户被踢出TRTC房间而异常结束，您可以通过增加特殊前缀的方式规避。您可以通过设置AgentParams.MaxIdleTime控制转推任务的自动结束，当设置此参数时，所有参与混流转推的主播持续离开TRTC房间超过MaxIdleTime的时长，自动停止转推任务。注意：参与混流转推的主播仅是停止音视频上行，转推任务不会自动停止。
-        2、WithTranscoding：如果需要将多路音视频流混合到一路时，WithTranscoding必须设置为1。
-        3、AudioParams：转推任务音频参数和视频参数是分开设置的，若您想要将指定的用户音频进行混音时，需要明确设置AudioParams.SubscribeAudioList。若您不设置AudioParams.SubscribeAudioList，混音引擎会自动将TRTC房间中所有用户的音频混合。若您想要混合TRTC房间除指定用户之外的所有用户的声音，可以通过AudioParams.UnSubscribeAudioList设置音频黑名单列表。
-        4、VideoParams：若您想要将用户的视频混合，可以通过VideoParams设置，若只想要混纯音频，则不用设置VideoParams参数。您可以通过VideoParams.LayoutParams.MixLayoutMode设置画面的布局模式，包括：动态布局（1：悬浮布局（默认），2：屏幕分享布局，3：九宫格布局）和自定义布局。动态布局模式由排版引擎按照固定的布局自动混合，不需要设置VideoParams.LayoutParams.MixLayoutList。当使用悬浮布局和屏幕分享布局时，您可以通过设置VideoParams.LayoutParams.MaxVideoUser参数指定大画面用户。自定义布局模式提供给您自主布局画面的能力，可以通过VideoParams.LayoutParams.MixLayoutList参数指定每个用户所在的布局位置。在每个布局参数中，您可以通过用户媒体流参数（UserMediaStream）指定这个布局位置为指定的用户预留，也可以不设置UserMediaStream，由排版引擎按照用户进入TRTC房间的顺序自动填充，另外您也可以设置每个布局位置的渲染方式（RenderMode）和裁剪方式（CustomCrop）。
-        5、VideoParams.WaterMarkList：若您想要混流画面中叠加水印，可以通过VideoParams.WaterMarkList参数设置，支持图片水印和文字水印，支持透明通道。
-        6、SingleSubscribeParams：若您想要将TRTC房间中的一路单流推到CDN，可以使用SingleSubscribeParams参数设置，此时需要将WithTranscoding参数设置为0。
-        7、PublishCdnParams.N：若您想要推流到CDN，可以使用PublishCdnParams.N参数设置，支持最多同时推流到10个CDN地址。若转推地址是腾讯云CDN时，请将IsTencentCdn明确设置为1；若您有转推非腾讯云CDN的需求时，请联系腾讯云技术支持开通，转推非腾讯云会产生转推费用，费用说明请参考官网文档：[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)。
-        8、FeedBackRoomParams.N：若您想要将混合的音视频流回推到TRTC房间，可以使用FeedBackRoomParams.N参数设置，支持最多同时推10路流回TRTC房间。您需要指定回推的TRTC房间号和机器人ID（UserId），机器人ID不能与普通用户ID冲突，否则会导致转推任务由于机器人用户被踢出TRTC房间而异常结束，您可以通过增加特殊前缀的方式规避。
-        9、SeiParams：若您想要混合的音视频流中增加SEI信息时，可以使用SeiParams参数设置，支持音量布局SEI和叠加转推请求中的SEI，其中音量布局SEI的内容是固定的json结构，具体请看本章节后续的SEI说明。您可以通过FollowIdr参数设置SEI跟随关键帧一起发送。音量布局sei的说明如下：
-        如果您的CDN观众端需要识别到参与混流的主播位置，以及需要识别到参与混流的主播的音量信息，可以通过音量布局sei实现。音量布局sei的payload内容及参数说明如下：
-
-        ```
-        {
-            "app_data":"",
-            "canvas":{
-                "w":1080,
-                "h":960
-            },
-            "regions":[
-                {
-                    "uid":"65949987242835883c",
-                    "zorder":2,
-                    "volume":45,
-                    "x":270,
-                    "y":480,
-                    "w":540,
-                    "h":480
-                },
-                {
-                    "uid":"659c9d8d242b328d31",
-                    "zorder":2,
-                    "volume":0,
-                    "x":0,
-                    "y":0,
-                    "w":540,
-                    "h":480
-                },
-                {
-                    "uid":"64989a82272b308c",
-                    "zorder":2,
-                    "volume":91,
-                    "x":540,
-                    "y":0,
-                    "w":540,
-                    "h":480
-                }
-            ],
-            "ver":"1.0",
-            "ts":1648544726
-        }
-        ```
-        canvas：这个是混流信令中VideoEncode设置的宽高，即：混流输出的整个画布宽高。
-        regions：里面是真实混入的用户id和对应的子画面位置，若参与混流的用户未进入TRTC房间或者未开启视频上行，regions中不会包含该用户。
-        uid：代表参与混流的用户ID。
-        zorder：参与混流userid在混流输出的层级。
-        x/y：参与混流userid的子画面在画布的坐标。
-        w/h：参与混流userid的子画面的大小。
-        volume：代表混流用户的音量，取值范围为0-100，值越大，代表该用户参与混流时的音量越大。
-        ts：是输出sei的服务器本地秒级时戳。
-        ver：可以忽略。
-
-        其它使用注意事项：
-        1、使用混流转推接口时，您需要先调用启动转推任务接口（StartPublishCdnStream），获取启动转推任务响应中的任务ID标识（TaskId）。后续传入任务ID标识（TaskId）来更新转推任务（UpdatePublishCdnStream）和停止转推任务（StopPublishCdnStream）。
-        2、转推API不支持发起到TRTC控制台配置的自动旁路任务，以及通过TRTC SDK进房接口中设置的自定义流ID的旁路任务。
-        3、为了确保转推链接的稳定，同一个转推任务不支持纯音频、音视频、纯视频之间的切换。
-        4、为了确保转推链接的稳定，不支持update时更新视频参数（codec）和音频参数（codec、采样率、码率、声道数）。
-        5、发起单流旁路任务时，AudioParams和VideoParams都填写表示音视频旁路，如果仅填写AudioParams表示纯音频旁路，任务进行过程中不支持纯音频到音视频的切换。音视频旁路时，VideoParams中的Width、Height、Fps、BitRate、Gop需要按照真实上行参数填写。
-        6、更新请求中必须携带SequenceNumber参数，用于防止请求乱序。客户保证对同一个任务更新时的SequenceNumber参数递增，否则会导致混流任务更新失败。
-        7、调用api时region选择说明：如果应用id是1400xxx时，region可填北京、上海、广州、香港，如果您的cdn观众主要在海外，请选择香港；如果应用id是200xxx或400xxx时，region请选择新加坡。
-        8、回推到TRTC房间的流不会参与其他回推房间任务的混流，满足下面条件之一时，可以参与其他转推cdn任务的混流: (1) 转推cdn任务在视频参数中通过具名方式指定推流机器人参与混流；(2) 转推cdn任务在音频参数中通过白名单方式指定推流机器人参与混流；(3) 转推cdn任务参与混流用户的房间号与回推机器人对应混流用户的房间号完全不同。
-        9、您可以在主播进房前，提前创建转推任务，结束转推任务时需要主动调用停止接口。如果您没有调用停止转推任务接口时，腾讯云后台会按照所有参与混流的用户没有任何数据上行的时间算起，直到超过启动转推任务时设置的超时时间（AgentParams.MaxIdleTime）为止，自动停止混流转推任务。
+        """接口说明：
+        启动一个混流转推任务，将  TRTC 房间的多路音视频流混成一路音视频流，编码后推到直播 CDN 或者回推到 TRTC 房间。也支持不转码直接转推 TRTC 房间的单路流。启动成功后，会返回一个 SdkAppid 维度唯一的任务 Id（TaskId）。您需要保存该 TaskId，后续需要依赖此 TaskId 更新和结束任务。可以参考文档： [功能说明](https://cloud.tencent.com/document/product/647/84721#b9a855f4-e38c-4616-9b07-fc44e0e8282a) 和 [常见问题](https://cloud.tencent.com/document/product/647/62620)
+
+        注意：
+        您可以在控制台开通旁路转推回调功能，对转推 CDN 状态的事件进行监控，回调请参考文档：[旁路转推回调说明](https://cloud.tencent.com/document/product/647/88552)
+        您发起混流转推任务时，可能会产生如下费用：
+        MCU 混流转码费用，请参考文档：[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)
+        转推非腾讯云 CDN 费用，请参考文档：[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)
 
         :param request: Request instance for StartPublishCdnStream.
         :type request: :class:`tencentcloud.trtc.v20190722.models.StartPublishCdnStreamRequest`
@@ -1423,7 +1360,8 @@ class TrtcClient(AbstractClient):
 
 
     def StopPublishCdnStream(self, request):
-        """停止转推任务。
+        """接口说明：
+        停止指定的混流转推任务。如果没有调用 Stop 接口停止任务，所有参与混流转推的主播离开 TRTC 房间超过 AgentParams.MaxIdleTime 设置的时间后，任务也会自动停止。
 
         :param request: Request instance for StopPublishCdnStream.
         :type request: :class:`tencentcloud.trtc.v20190722.models.StopPublishCdnStreamRequest`
@@ -1517,8 +1455,9 @@ class TrtcClient(AbstractClient):
 
 
     def UpdatePublishCdnStream(self, request):
-        """更新转推任务。
-        注：请参见启动转推任务的接口说明和使用说明。
+        """接口说明：
+        成功发起混流转推后，可以使用此接口来更新任务。仅在任务进行时有效，任务退出后更新将会返回错误。更新操作为增量更新模式。
+        注意：为了保障推流的稳定性，更新不支持任务在纯音频、音视频、纯视频之间进行切换。
 
         :param request: Request instance for UpdatePublishCdnStream.
         :type request: :class:`tencentcloud.trtc.v20190722.models.UpdatePublishCdnStreamRequest`

{tencentcloud-sdk-python-trtc-3.0.1196 → tencentcloud-sdk-python-trtc-3.0.1208}/tencentcloud_sdk_python_trtc.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-trtc
-Version: 3.0.1196
+Version: 3.0.1208
 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.1208/tencentcloud_sdk_python_trtc.egg-info/requires.txt

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

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

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