tencentcloud-sdk-python-trtc 3.0.1173__py2.py3-none-any.whl → 3.0.1194__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1173'
+__version__ = '3.0.1194'

tencentcloud/trtc/v20190722/errorcodes.py

@@ -38,8 +38,8 @@ FAILEDOPERATION_MIXSESSIONNOTEXIST = 'FailedOperation.MixSessionNotExist'
 # 需要解锁所需能力位
 FAILEDOPERATION_NOTABILITY = 'FailedOperation.NotAbility'
 
-# 未开通RTMP
-FAILEDOPERATION_NOTRTMPFUNCTION = 'FailedOperation.NotRtmpFunction'
+# 不允许此操作，请提交工单联系我们
+FAILEDOPERATION_NOTALLOWED = 'FailedOperation.NotAllowed'
 
 # 查询任务失败
 FAILEDOPERATION_QUERYTASKINFOFAILED = 'FailedOperation.QueryTaskInfoFailed'
@@ -62,9 +62,6 @@ FAILEDOPERATION_SDKAPPIDNOTEXIST = 'FailedOperation.SdkAppIdNotExist'
 # AppId下没有此SdkAppId的资源
 FAILEDOPERATION_SDKAPPIDNOTUNDERAPPID = 'FailedOperation.SdkAppIdNotUnderAppId'
 
-# SdkAppId未开通页面录制能力，请检查。
-FAILEDOPERATION_SDKAPPIDNOTWEBRECORDABILITY = 'FailedOperation.SdkAppIdNotWebRecordAbility'
-
 # 任务已存在
 FAILEDOPERATION_TASKEXIST = 'FailedOperation.TaskExist'
 

tencentcloud/trtc/v20190722/models.py

@@ -150,6 +150,79 @@ class AbnormalExperience(AbstractModel):
         
 
 
+class AgentConfig(AbstractModel):
+    """机器人参数
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _UserId: 机器人的UserId，用于进房发起任务。【注意】这个UserId不能与当前房间内的主播观众[UserId](https://cloud.tencent.com/document/product/647/46351#userid)重复。如果一个房间发起多个任务时，机器人的UserId也不能相互重复，否则会中断前一个任务。需要保证机器人UserId在房间内唯一。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type UserId: str
+        :param _UserSig: 机器人UserId对应的校验签名，即UserId和UserSig相当于机器人进房的登录密码，具体计算方法请参考TRTC计算[UserSig](https://cloud.tencent.com/document/product/647/45910#UserSig)的方案。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type UserSig: str
+        :param _TargetUserId: 机器人拉流的UserId, 填写后，机器人会拉取该UserId的流进行实时处理
+注意：此字段可能返回 null，表示取不到有效值。
+        :type TargetUserId: str
+        :param _MaxIdleTime: 房间内推流用户全部退出后超过MaxIdleTime秒，后台自动关闭任务，默认值是60s。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type MaxIdleTime: int
+        """
+        self._UserId = None
+        self._UserSig = None
+        self._TargetUserId = None
+        self._MaxIdleTime = None
+
+    @property
+    def UserId(self):
+        return self._UserId
+
+    @UserId.setter
+    def UserId(self, UserId):
+        self._UserId = UserId
+
+    @property
+    def UserSig(self):
+        return self._UserSig
+
+    @UserSig.setter
+    def UserSig(self, UserSig):
+        self._UserSig = UserSig
+
+    @property
+    def TargetUserId(self):
+        return self._TargetUserId
+
+    @TargetUserId.setter
+    def TargetUserId(self, TargetUserId):
+        self._TargetUserId = TargetUserId
+
+    @property
+    def MaxIdleTime(self):
+        return self._MaxIdleTime
+
+    @MaxIdleTime.setter
+    def MaxIdleTime(self, MaxIdleTime):
+        self._MaxIdleTime = MaxIdleTime
+
+
+    def _deserialize(self, params):
+        self._UserId = params.get("UserId")
+        self._UserSig = params.get("UserSig")
+        self._TargetUserId = params.get("TargetUserId")
+        self._MaxIdleTime = params.get("MaxIdleTime")
+        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 AgentParams(AbstractModel):
     """转推服务加入TRTC房间的机器人参数。
 
@@ -1044,6 +1117,136 @@ class DeletePictureResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class DescribeAIConversationRequest(AbstractModel):
+    """DescribeAIConversation请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _SdkAppId: TRTC的[SdkAppId](https://cloud.tencent.com/document/product/647/46351#sdkappid)，和开启转录任务的房间使用的SdkAppId相同。
+        :type SdkAppId: int
+        :param _TaskId: 唯一标识一次任务。
+        :type TaskId: str
+        :param _SessionId: 开启任务时填写的SessionId，如果没写则不返回。
+        :type SessionId: str
+        """
+        self._SdkAppId = None
+        self._TaskId = None
+        self._SessionId = 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 SessionId(self):
+        return self._SessionId
+
+    @SessionId.setter
+    def SessionId(self, SessionId):
+        self._SessionId = SessionId
+
+
+    def _deserialize(self, params):
+        self._SdkAppId = params.get("SdkAppId")
+        self._TaskId = params.get("TaskId")
+        self._SessionId = params.get("SessionId")
+        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 DescribeAIConversationResponse(AbstractModel):
+    """DescribeAIConversation返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _StartTime: 任务开始时间。
+        :type StartTime: str
+        :param _Status: 任务状态。有4个值：1、Idle表示任务未开始2、Preparing表示任务准备中3、InProgress表示任务正在运行4、Stopped表示任务已停止，正在清理资源中
+        :type Status: str
+        :param _TaskId: 唯一标识一次任务。
+        :type TaskId: str
+        :param _SessionId: 开启对话任务时填写的SessionId，如果没写则不返回。
+        :type SessionId: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._StartTime = None
+        self._Status = None
+        self._TaskId = None
+        self._SessionId = None
+        self._RequestId = None
+
+    @property
+    def StartTime(self):
+        return self._StartTime
+
+    @StartTime.setter
+    def StartTime(self, StartTime):
+        self._StartTime = StartTime
+
+    @property
+    def Status(self):
+        return self._Status
+
+    @Status.setter
+    def Status(self, Status):
+        self._Status = Status
+
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
+    @property
+    def SessionId(self):
+        return self._SessionId
+
+    @SessionId.setter
+    def SessionId(self, SessionId):
+        self._SessionId = SessionId
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._StartTime = params.get("StartTime")
+        self._Status = params.get("Status")
+        self._TaskId = params.get("TaskId")
+        self._SessionId = params.get("SessionId")
+        self._RequestId = params.get("RequestId")
+
+
 class DescribeAITranscriptionRequest(AbstractModel):
     """DescribeAITranscription请求参数结构体
 
@@ -3570,7 +3773,7 @@ class DescribeTrtcUsageResponse(AbstractModel):
         r"""
         :param _UsageKey: 用量类型，与UsageValue中各个位置的值对应。
         :type UsageKey: list of str
-        :param _UsageList: 各个时间点用量明细。
+        :param _UsageList: 各个时间点用量明细，单位:分钟
         :type UsageList: list of TrtcUsage
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -5114,6 +5317,16 @@ class McuLayout(AbstractModel):
         :type TransparentUrl: str
         :param _BackgroundCustomRender: 子背景图的自定义渲染参数，当BackgroundRenderMode为4时必须配置。
         :type BackgroundCustomRender: :class:`tencentcloud.trtc.v20190722.models.McuBackgroundCustomRender`
+        :param _BackGroundColorMode: 子背景色生效模式，默认值为0表示均不生效。
+bit0:占位图缩放是否生效。
+bit1:上行流缩放是否生效。
+您可以将相应bit位置1启动生效，例如：
+0(00)表示子背景色不生效。
+1(01)表示子背景色只在占位图缩放时生效。
+2(10)表示子背景色只在上行流缩放时生效。
+3(11)表示子背景色在占位图缩放和上行流缩放时均生效。
+
+        :type BackGroundColorMode: int
         """
         self._UserMediaStream = None
         self._ImageWidth = None
@@ -5128,6 +5341,7 @@ class McuLayout(AbstractModel):
         self._BackgroundRenderMode = None
         self._TransparentUrl = None
         self._BackgroundCustomRender = None
+        self._BackGroundColorMode = None
 
     @property
     def UserMediaStream(self):
@@ -5233,6 +5447,14 @@ class McuLayout(AbstractModel):
     def BackgroundCustomRender(self, BackgroundCustomRender):
         self._BackgroundCustomRender = BackgroundCustomRender
 
+    @property
+    def BackGroundColorMode(self):
+        return self._BackGroundColorMode
+
+    @BackGroundColorMode.setter
+    def BackGroundColorMode(self, BackGroundColorMode):
+        self._BackGroundColorMode = BackGroundColorMode
+
 
     def _deserialize(self, params):
         if params.get("UserMediaStream") is not None:
@@ -5254,6 +5476,7 @@ class McuLayout(AbstractModel):
         if params.get("BackgroundCustomRender") is not None:
             self._BackgroundCustomRender = McuBackgroundCustomRender()
             self._BackgroundCustomRender._deserialize(params.get("BackgroundCustomRender"))
+        self._BackGroundColorMode = params.get("BackGroundColorMode")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -6096,7 +6319,7 @@ class MixLayout(AbstractModel):
         :type MediaId: int
         :param _ImageLayer: 该画布的图层顺序, 这个值越小表示图层越靠后。默认值为0。
         :type ImageLayer: int
-        :param _SubBackgroundImage: 图片的url地址， 只支持jpg， png，大小限制不超过5M，宽高比不一致的处理方案同 RenderMode。
+        :param _SubBackgroundImage: 图片的url地址， 只支持jpg, png, jpeg，大小限制不超过5M。注意，url必须携带格式后缀，url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
         :type SubBackgroundImage: str
         """
         self._Top = None
@@ -6222,7 +6445,7 @@ class MixLayoutParams(AbstractModel):
         :param _MixLayoutMode: 布局模式:
 1：悬浮布局；
 2：屏幕分享布局；
-3：九宫格布局（默认）；
+3：九宫格布局；
 4：自定义布局；
 
 悬浮布局：默认第一个进入房间的主播（也可以指定一个主播）的视频画面会铺满整个屏幕。其他主播的视频画面从左下角开始依次按照进房顺序水平排列，显示为小画面，小画面悬浮于大画面之上。当画面数量小于等于17个时，每行4个（4 x 4排列）。当画面数量大于17个时，重新布局小画面为每行5个（5 x 5）排列。最多支持25个画面，如果用户只发送音频，仍然会占用画面位置。
@@ -6244,13 +6467,13 @@ class MixLayoutParams(AbstractModel):
 1：辅流（屏幕分享）；
 这个位置的MediaId代表的是对应MaxResolutionUserId的主辅路，MixLayoutList内代表的是自定义用户的主辅路。
         :type MediaId: int
-        :param _BackgroundImageUrl: 图片的url地址， 只支持jpg， png，大小限制不超过5M，url不可包含中文。
+        :param _BackgroundImageUrl: 图片的url地址，只支持jpg, png, jpeg，大小限制不超过5M。注意，url必须携带格式后缀，url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
         :type BackgroundImageUrl: str
         :param _PlaceHolderMode: 设置为1时代表启用占位图功能，0时代表不启用占位图功能，默认为0。启用占位图功能时，在预设位置的用户没有上行视频时可显示对应的占位图。
         :type PlaceHolderMode: int
         :param _BackgroundImageRenderMode: 背景画面宽高比不一致的时候处理方案，与MixLayoufList定义的RenderMode一致。
         :type BackgroundImageRenderMode: int
-        :param _DefaultSubBackgroundImage: 子画面占位图url地址， 只支持jpg， png，大小限制不超过5M，宽高比不一致的处理方案同 RenderMode。
+        :param _DefaultSubBackgroundImage: 子画面占位图url地址，只支持jpg, png, jpeg，大小限制不超过5M。注意，url必须携带格式后缀，url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
         :type DefaultSubBackgroundImage: str
         :param _WaterMarkList: 水印布局参数， 最多支持25个。
         :type WaterMarkList: list of WaterMark
@@ -7230,8 +7453,9 @@ 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 = "zh"
+中文繁体 Chinese_TW = "zh-TW" 
+中文方言 Chinese_DIALECT = "zh-dialect"
 English = "en"
 Vietnamese = "vi"
 Japanese = "ja"
@@ -7252,8 +7476,9 @@ Russian = "ru"
 
 注意：
 如果缺少满足您需求的语言，请联系我们技术人员。
-tencent asr不支持"it"和"ru"，google asr全都支持。
         :type Language: str
+        :param _AlternativeLanguage: 额外的可能替代语言，最多3个，仅高级版支持。Language指定中文方言时，不能设置该字段。
+        :type AlternativeLanguage: list of str
         :param _Model: 使用的模型，目前支持tencent和google，默认是tencent。
         :type Model: str
         :param _TranslationLanguage: 翻译功能支持的语言，如果填写，则会启用翻译，不填则只会使用语音识别。
@@ -7280,30 +7505,10 @@ Russian = "ru"
 
 注意：
 如果缺少满足您需求的语言，请联系我们技术人员。
-google支持上述语言两两之间翻译，tencent只支持部分语言之间翻译。
-
-tencnet目标语言，各源语言的目标语言支持列表如下，冒号左侧是目标语言，右侧是源语言：
-- zh（简体中文）：zh-TW（繁体中文）、en（英语）、ja（日语）、ko（韩语）、fr（法语）、es（西班牙语）、it（意大利语）、de（德语）、tr（土耳其语）、ru（俄语）、pt（葡萄牙语）、vi（越南语）、id（印尼语）、th（泰语）、ms（马来语）
-- zh-TW（繁体中文）：zh（简体中文）、en（英语）、ja（日语）、ko（韩语）、fr（法语）、es（西班牙语）、it（意大利语）、de（德语）、tr（土耳其语）、ru（俄语）、pt（葡萄牙语）、vi（越南语）、id（印尼语）、th（泰语）、ms（马来语）
-- en（英语）：zh（中文）、zh-TW（繁体中文）、ja（日语）、ko（韩语）、fr（法语）、es（西班牙语）、it（意大利语）、de（德语）、tr（土耳其语）、ru（俄语）、pt（葡萄牙语）、vi（越南语）、id（印尼语）、th（泰语）、ms（马来语）、ar（阿拉伯语）、hi（印地语）
-- ja（日语）：zh（中文）、zh-TW（繁体中文）、en（英语）、ko（韩语）
-- ko（韩语）：zh（中文）、zh-TW（繁体中文）、en（英语）、ja（日语）
-- fr（法语）：zh（中文）、zh-TW（繁体中文）、en（英语）、es（西班牙语）、it（意大利语）、de（德语）、tr（土耳其语）、ru（俄语）、pt（葡萄牙语）
-- es（西班牙语）：zh（中文）、zh-TW（繁体中文）、en（英语）、fr（法语）、it（意大利语）、de（德语）、tr（土耳其语）、ru（俄语）、pt（葡萄牙语）
-- it（意大利语）：zh（中文）、zh-TW（繁体中文）、en（英语）、fr（法语）、es（西班牙语）、de（德语）、tr（土耳其语）、ru（俄语）、pt（葡萄牙语）
-- de（德语）：zh（中文）、zh-TW（繁体中文）、en（英语）、fr（法语）、es（西班牙语）、it（意大利语）、tr（土耳其语）、ru（俄语）、pt（葡萄牙语）
-- tr（土耳其语）：zh（中文）、zh-TW（繁体中文）、en（英语）、fr（法语）、es（西班牙语）、it（意大利语）、de（德语）、ru（俄语）、pt（葡萄牙语）
-- ru（俄语）：zh（中文）、zh-TW（繁体中文）、en（英语）、fr（法语）、es（西班牙语）、it（意大利语）、de（德语）、tr（土耳其语）、pt（葡萄牙语）
-- pt（葡萄牙语）：zh（中文）、zh-TW（繁体中文）、en（英语）、fr（法语）、es（西班牙语）、it（意大利语）、de（德语）、tr（土耳其语）、ru（俄语）
-- vi（越南语）：zh（中文）、zh-TW（繁体中文）、en（英语）
-- id（印尼语）：zh（中文）、zh-TW（繁体中文）、en（英语）
-- th（泰语）：zh（中文）、zh-TW（繁体中文）、en（英语）
-- ms（马来语）：zh（中文）、zh-TW（繁体中文）、en（英语）
-- ar（阿拉伯语）：en（英语）
-- hi（印地语）：en（英语）
         :type TranslationLanguage: str
         """
         self._Language = None
+        self._AlternativeLanguage = None
         self._Model = None
         self._TranslationLanguage = None
 
@@ -7315,12 +7520,24 @@ tencnet目标语言，各源语言的目标语言支持列表如下，冒号左
     def Language(self, Language):
         self._Language = Language
 
+    @property
+    def AlternativeLanguage(self):
+        return self._AlternativeLanguage
+
+    @AlternativeLanguage.setter
+    def AlternativeLanguage(self, AlternativeLanguage):
+        self._AlternativeLanguage = AlternativeLanguage
+
     @property
     def Model(self):
+        warnings.warn("parameter `Model` is deprecated", DeprecationWarning) 
+
         return self._Model
 
     @Model.setter
     def Model(self, Model):
+        warnings.warn("parameter `Model` is deprecated", DeprecationWarning) 
+
         self._Model = Model
 
     @property
@@ -7334,6 +7551,7 @@ tencnet目标语言，各源语言的目标语言支持列表如下，冒号左
 
     def _deserialize(self, params):
         self._Language = params.get("Language")
+        self._AlternativeLanguage = params.get("AlternativeLanguage")
         self._Model = params.get("Model")
         self._TranslationLanguage = params.get("TranslationLanguage")
         memeber_set = set(params.keys())
@@ -7857,6 +8075,78 @@ class RowValues(AbstractModel):
         
 
 
+class STTConfig(AbstractModel):
+    """语音转文字参数
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Language: 语音识别支持的语言，默认是"zh" 中文
+目前全量支持的语言如下，等号左面是语言英文名，右面是Language字段需要填写的值，该值遵循[ISO639](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes)：
+1.     Chinese = "zh" # 中文
+2.     Chinese_TW = "zh-TW" # 中国台湾
+3.     Chinese_DIALECT = "zh-dialect" # 中国方言
+4.     English = "en" # 英语
+5.     Vietnamese = "vi" # 越南语
+6.     Japanese = "ja" # 日语
+7.     Korean = "ko" # 汉语
+8.     Indonesia = "id" # 印度尼西亚语
+9.     Thai = "th" # 泰语
+10.     Portuguese = "pt" # 葡萄牙语
+11.     Turkish = "tr" # 土耳其语
+12.     Arabic = "ar" # 阿拉伯语
+13.     Spanish = "es" # 西班牙语
+14.     Hindi = "hi" # 印地语
+15.     French = "fr" # 法语
+16.     Malay = "ms" # 马来语
+17.     Filipino = "fil" # 菲律宾语
+18.     German = "de" # 德语
+19.     Italian = "it" # 意大利语
+20.     Russian = "ru" # 俄语
+
+注意：
+如果缺少满足您需求的语言，请联系我们技术人员。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type Language: str
+        :param _AlternativeLanguage: 额外识别可能替代语言,最多3个, 需高级版支持,Language指定方言时，不允许设置该字段
+
+注意：此字段可能返回 null，表示取不到有效值。
+        :type AlternativeLanguage: list of str
+        """
+        self._Language = None
+        self._AlternativeLanguage = None
+
+    @property
+    def Language(self):
+        return self._Language
+
+    @Language.setter
+    def Language(self, Language):
+        self._Language = Language
+
+    @property
+    def AlternativeLanguage(self):
+        return self._AlternativeLanguage
+
+    @AlternativeLanguage.setter
+    def AlternativeLanguage(self, AlternativeLanguage):
+        self._AlternativeLanguage = AlternativeLanguage
+
+
+    def _deserialize(self, params):
+        self._Language = params.get("Language")
+        self._AlternativeLanguage = params.get("AlternativeLanguage")
+        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 ScaleInfomation(AbstractModel):
     """历史规模信息
 
@@ -8300,6 +8590,167 @@ class SmallVideoLayoutParams(AbstractModel):
         
 
 
+class StartAIConversationRequest(AbstractModel):
+    """StartAIConversation请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :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)，表示开启对话任务的房间号。
+        :type RoomId: str
+        :param _AgentConfig: 机器人参数
+        :type AgentConfig: :class:`tencentcloud.trtc.v20190722.models.AgentConfig`
+        :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>
+
+        :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>
+        :type TTSConfig: str
+        """
+        self._SdkAppId = None
+        self._RoomId = None
+        self._AgentConfig = None
+        self._SessionId = None
+        self._RoomIdType = None
+        self._STTConfig = None
+        self._LLMConfig = None
+        self._TTSConfig = None
+
+    @property
+    def SdkAppId(self):
+        return self._SdkAppId
+
+    @SdkAppId.setter
+    def SdkAppId(self, SdkAppId):
+        self._SdkAppId = SdkAppId
+
+    @property
+    def RoomId(self):
+        return self._RoomId
+
+    @RoomId.setter
+    def RoomId(self, RoomId):
+        self._RoomId = RoomId
+
+    @property
+    def AgentConfig(self):
+        return self._AgentConfig
+
+    @AgentConfig.setter
+    def AgentConfig(self, AgentConfig):
+        self._AgentConfig = AgentConfig
+
+    @property
+    def SessionId(self):
+        return self._SessionId
+
+    @SessionId.setter
+    def SessionId(self, SessionId):
+        self._SessionId = SessionId
+
+    @property
+    def RoomIdType(self):
+        return self._RoomIdType
+
+    @RoomIdType.setter
+    def RoomIdType(self, RoomIdType):
+        self._RoomIdType = RoomIdType
+
+    @property
+    def STTConfig(self):
+        return self._STTConfig
+
+    @STTConfig.setter
+    def STTConfig(self, STTConfig):
+        self._STTConfig = STTConfig
+
+    @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._SdkAppId = params.get("SdkAppId")
+        self._RoomId = params.get("RoomId")
+        if params.get("AgentConfig") is not None:
+            self._AgentConfig = AgentConfig()
+            self._AgentConfig._deserialize(params.get("AgentConfig"))
+        self._SessionId = params.get("SessionId")
+        self._RoomIdType = params.get("RoomIdType")
+        if params.get("STTConfig") is not None:
+            self._STTConfig = STTConfig()
+            self._STTConfig._deserialize(params.get("STTConfig"))
+        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 StartAIConversationResponse(AbstractModel):
+    """StartAIConversation返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _TaskId: 用于唯一标识对话任务。
+        :type TaskId: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._TaskId = None
+        self._RequestId = None
+
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._TaskId = params.get("TaskId")
+        self._RequestId = params.get("RequestId")
+
+
 class StartAITranscriptionRequest(AbstractModel):
     """StartAITranscription请求参数结构体
 
@@ -8921,7 +9372,7 @@ class StartStreamIngestRequest(AbstractModel):
         :type UserId: str
         :param _UserSig: 输入在线媒体流机器人UserId对应的校验签名，即UserId和UserSig相当于机器人进房的登录密码，具体计算方法请参考TRTC计算[UserSig](https://cloud.tencent.com/document/product/647/45910#UserSig)的方案。
         :type UserSig: str
-        :param _StreamUrl: 源流URL。历史原因本字段【必填】。如果是视频流，分辨率请保持不变。
+        :param _StreamUrl: 源流URL【必填】。如果是视频流，分辨率请保持不变。
         :type StreamUrl: str
         :param _PrivateMapKey: TRTC房间权限加密串，只有在TRTC控制台启用了高级权限控制的时候需要携带，在TRTC控制台如果开启高级权限控制后，TRTC 的后台服务系统会校验一个叫做 [PrivateMapKey] 的“权限票据”，权限票据中包含了一个加密后的 RoomId 和一个加密后的“权限位列表”。由于 PrivateMapKey 中包含 RoomId，所以只提供了 UserSig 没有提供 PrivateMapKey 时，并不能进入指定的房间。
         :type PrivateMapKey: str
@@ -9004,26 +9455,38 @@ class StartStreamIngestRequest(AbstractModel):
 
     @property
     def VideoEncodeParams(self):
+        warnings.warn("parameter `VideoEncodeParams` is deprecated", DeprecationWarning) 
+
         return self._VideoEncodeParams
 
     @VideoEncodeParams.setter
     def VideoEncodeParams(self, VideoEncodeParams):
+        warnings.warn("parameter `VideoEncodeParams` is deprecated", DeprecationWarning) 
+
         self._VideoEncodeParams = VideoEncodeParams
 
     @property
     def AudioEncodeParams(self):
+        warnings.warn("parameter `AudioEncodeParams` is deprecated", DeprecationWarning) 
+
         return self._AudioEncodeParams
 
     @AudioEncodeParams.setter
     def AudioEncodeParams(self, AudioEncodeParams):
+        warnings.warn("parameter `AudioEncodeParams` is deprecated", DeprecationWarning) 
+
         self._AudioEncodeParams = AudioEncodeParams
 
     @property
     def SourceUrl(self):
+        warnings.warn("parameter `SourceUrl` is deprecated", DeprecationWarning) 
+
         return self._SourceUrl
 
     @SourceUrl.setter
     def SourceUrl(self, SourceUrl):
+        warnings.warn("parameter `SourceUrl` is deprecated", DeprecationWarning) 
+
         self._SourceUrl = SourceUrl
 
     @property
@@ -9111,7 +9574,7 @@ class StartWebRecordRequest(AbstractModel):
         :param _MaxDurationLimit: 录制最大时长限制， 单位 s, 合法取值范围[1800, 36000], 默认 36000s(10 小时)
 
         :type MaxDurationLimit: int
-        :param _StorageParams: 【必填】云存储相关的参数，目前支持腾讯云对象存储以及腾讯云云点播VOD，不支持第三方云存储
+        :param _StorageParams: 【必填】云存储相关的参数，目前支持腾讯云对象存储以及腾讯云云点播VOD，不支持第三方云存储；输出文件的存储格式仅支持hls或mp4
         :type StorageParams: :class:`tencentcloud.trtc.v20190722.models.StorageParams`
         :param _WebRecordVideoParams: 页面录制视频参数
         :type WebRecordVideoParams: :class:`tencentcloud.trtc.v20190722.models.WebRecordVideoParams`
@@ -9252,6 +9715,64 @@ class StartWebRecordResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class StopAIConversationRequest(AbstractModel):
+    """StopAIConversation请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _TaskId: 唯一标识任务。
+        :type TaskId: str
+        """
+        self._TaskId = None
+
+    @property
+    def TaskId(self):
+        return self._TaskId
+
+    @TaskId.setter
+    def TaskId(self, TaskId):
+        self._TaskId = TaskId
+
+
+    def _deserialize(self, params):
+        self._TaskId = params.get("TaskId")
+        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 StopAIConversationResponse(AbstractModel):
+    """StopAIConversation返回参数结构体
+
+    """
+
+    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 StopAITranscriptionRequest(AbstractModel):
     """StopAITranscription请求参数结构体
 
@@ -10312,10 +10833,13 @@ class TrtcUsage(AbstractModel):
         r"""
         :param _TimeKey: 时间点，格式为YYYY-MM-DD HH:mm:ss。多天查询时，HH:mm:ss为00:00:00。
         :type TimeKey: str
-        :param _UsageValue: 用量数组。每个数值含义与UsageKey对应。单位：分钟。
+        :param _TimeStampKey: 时间点时间戳
+        :type TimeStampKey: int
+        :param _UsageValue: 用量数组。每个数值含义与UsageKey对应。单位:分钟。
         :type UsageValue: list of float
         """
         self._TimeKey = None
+        self._TimeStampKey = None
         self._UsageValue = None
 
     @property
@@ -10326,6 +10850,14 @@ class TrtcUsage(AbstractModel):
     def TimeKey(self, TimeKey):
         self._TimeKey = TimeKey
 
+    @property
+    def TimeStampKey(self):
+        return self._TimeStampKey
+
+    @TimeStampKey.setter
+    def TimeStampKey(self, TimeStampKey):
+        self._TimeStampKey = TimeStampKey
+
     @property
     def UsageValue(self):
         return self._UsageValue
@@ -10337,6 +10869,7 @@ class TrtcUsage(AbstractModel):
 
     def _deserialize(self, params):
         self._TimeKey = params.get("TimeKey")
+        self._TimeStampKey = params.get("TimeStampKey")
         self._UsageValue = params.get("UsageValue")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
@@ -11164,7 +11697,7 @@ class WaterMarkImage(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _WaterMarkUrl: 下载的url地址， 只支持jpg， png，大小限制不超过5M。
+        :param _WaterMarkUrl: 下载的url地址， 只支持jpg, png, jpeg，大小限制不超过5M。注意，url必须携带格式后缀，url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
         :type WaterMarkUrl: str
         :param _Top: 画布上该画面左上角的 y 轴坐标，取值范围 [0, 2560]，不能超过画布的高。
         :type Top: int

tencentcloud/trtc/v20190722/trtc_client.py

@@ -129,6 +129,29 @@ class TrtcClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeAIConversation(self, request):
+        """查询AI对话任务状态。
+
+        :param request: Request instance for DescribeAIConversation.
+        :type request: :class:`tencentcloud.trtc.v20190722.models.DescribeAIConversationRequest`
+        :rtype: :class:`tencentcloud.trtc.v20190722.models.DescribeAIConversationResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeAIConversation", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeAIConversationResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DescribeAITranscription(self, request):
         """查询AI转录任务状态。
 
@@ -705,7 +728,7 @@ class TrtcClient(AbstractClient):
 
 
     def DescribeTrtcUsage(self, request):
-        """获取TRTC音视频互动的用量明细。
+        """获取TRTC音视频互动的用量明细，单位:分钟。
         - 查询时间小于等于1天时，返回每5分钟粒度的数据；查询时间大于1天时，返回按天汇总的数据。
         - 单次查询统计区间最多不能超过31天。
         - 若查询当天用量，由于统计延迟等原因，返回数据可能不够准确。
@@ -968,6 +991,29 @@ class TrtcClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def StartAIConversation(self, request):
+        """启动一个任务，机器人将进入TRTC房间，与指定成员进行AI对话
+
+        :param request: Request instance for StartAIConversation.
+        :type request: :class:`tencentcloud.trtc.v20190722.models.StartAIConversationRequest`
+        :rtype: :class:`tencentcloud.trtc.v20190722.models.StartAIConversationResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("StartAIConversation", params, headers=headers)
+            response = json.loads(body)
+            model = models.StartAIConversationResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def StartAITranscription(self, request):
         """这个接口调用后，后台会启动转录机器人，实时进行语音识别并下发字幕和转录消息。
         转录机器人支持两种拉流方式，通过TranscriptionMode字段控制：
@@ -1237,9 +1283,8 @@ class TrtcClient(AbstractClient):
 
 
     def StartStreamIngest(self, request):
-        """将一个在线媒体流推到TRTC房间。
-        使用此接口的前提条件：需要购买 [尊享版或旗舰版套餐包](https://cloud.tencent.com/document/product/647/85386
-        )
+        """将一个在线媒体流推到TRTC房间，更多功能说明见[输入媒体流进房](https://cloud.tencent.com/document/product/647/102957#50940aad-d90f-4473-9f46-d5dd46917653)。
+        使用输入在线媒体流功能需先订阅 [尊享版或旗舰版套餐包](https://cloud.tencent.com/document/product/647/85386) 解锁能力位。
 
         :param request: Request instance for StartStreamIngest.
         :type request: :class:`tencentcloud.trtc.v20190722.models.StartStreamIngestRequest`
@@ -1285,6 +1330,29 @@ class TrtcClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def StopAIConversation(self, request):
+        """停止AI对话任务
+
+        :param request: Request instance for StopAIConversation.
+        :type request: :class:`tencentcloud.trtc.v20190722.models.StopAIConversationRequest`
+        :rtype: :class:`tencentcloud.trtc.v20190722.models.StopAIConversationResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("StopAIConversation", params, headers=headers)
+            response = json.loads(body)
+            model = models.StopAIConversationResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def StopAITranscription(self, request):
         """停止AI转录任务。
 
@@ -1424,7 +1492,9 @@ class TrtcClient(AbstractClient):
 
 
     def SummarizeTranscription(self, request):
-        """对转录的文本进行总结。
+        """接口不再支持
+
+        对转录的文本进行总结。
 
         :param request: Request instance for SummarizeTranscription.
         :type request: :class:`tencentcloud.trtc.v20190722.models.SummarizeTranscriptionRequest`

{tencentcloud_sdk_python_trtc-3.0.1173.dist-info → tencentcloud_sdk_python_trtc-3.0.1194.dist-info}/METADATA

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

tencentcloud_sdk_python_trtc-3.0.1194.dist-info/RECORD

@@ -0,0 +1,10 @@
+tencentcloud/__init__.py,sha256=F7_UQmf01p5Of0ObNxg9OjJNvlw8iF5kgvthsDv1vw0,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=FmIDZpKXHZ0A1MGHEKMSMw5AhS8kFVYygYRIYwdCH-M,385436
+tencentcloud/trtc/v20190722/trtc_client.py,sha256=ZQTZDqcrIEAvi2AxxnciId-HHZQ595o3NmMGbZQ2HlE,88258
+tencentcloud_sdk_python_trtc-3.0.1194.dist-info/METADATA,sha256=NW4DRf8IsAOfV-7PqcvvHps4OlfzP6uaQev7TKMSZjU,1497
+tencentcloud_sdk_python_trtc-3.0.1194.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
+tencentcloud_sdk_python_trtc-3.0.1194.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
+tencentcloud_sdk_python_trtc-3.0.1194.dist-info/RECORD,,

tencentcloud_sdk_python_trtc-3.0.1173.dist-info/RECORD

@@ -1,10 +0,0 @@
-tencentcloud/__init__.py,sha256=Ocpjt10RdSSUojyk1tnXPSr1qGEMH56jdaIL3-lBFho,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=pj8liwEqi-6N8RLQ9nBjYPmOueQHif8WlwzVOLR5RYc,11019
-tencentcloud/trtc/v20190722/models.py,sha256=Xgmn9I-8yzD4Dgi7lKApEnAxKDUrXwJaOT70grC7_3o,368171
-tencentcloud/trtc/v20190722/trtc_client.py,sha256=Ejkxfigb4LDQnNh2Pn5O8tGF_NIDzN0GnVIND0GGNzQ,85328
-tencentcloud_sdk_python_trtc-3.0.1173.dist-info/METADATA,sha256=jkmB6aw41XIAnvvgLEV5GlBZXwZ64ImizfiYYMDOTuM,1497
-tencentcloud_sdk_python_trtc-3.0.1173.dist-info/WHEEL,sha256=z9j0xAa_JmUKMpmz72K0ZGALSM_n-wQVmGbleXx2VHg,110
-tencentcloud_sdk_python_trtc-3.0.1173.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
-tencentcloud_sdk_python_trtc-3.0.1173.dist-info/RECORD,,