tencentcloud-sdk-python-trtc 3.0.1068__tar.gz → 3.0.1073__tar.gz

{tencentcloud-sdk-python-trtc-3.0.1068 → tencentcloud-sdk-python-trtc-3.0.1073}/PKG-INFO

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

{tencentcloud-sdk-python-trtc-3.0.1068 → tencentcloud-sdk-python-trtc-3.0.1073}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1068'
+__version__ = '3.0.1073'

{tencentcloud-sdk-python-trtc-3.0.1068 → tencentcloud-sdk-python-trtc-3.0.1073}/tencentcloud/trtc/v20190722/errorcodes.py

@@ -35,6 +35,9 @@ FAILEDOPERATION_CRUNSUPPORTMETHOD = 'FailedOperation.CRUnsupportMethod'
 # 房间中没有设置混流模板。
 FAILEDOPERATION_MIXSESSIONNOTEXIST = 'FailedOperation.MixSessionNotExist'
 
+# 未开通RTMP
+FAILEDOPERATION_NOTRTMPFUNCTION = 'FailedOperation.NotRtmpFunction'
+
 # 查询任务失败
 FAILEDOPERATION_QUERYTASKINFOFAILED = 'FailedOperation.QueryTaskInfoFailed'
 
@@ -203,6 +206,9 @@ INVALIDPARAMETER_USERIDS = 'InvalidParameter.UserIds'
 # 用户数超过6个。
 INVALIDPARAMETER_USERIDSMORETHANSIX = 'InvalidParameter.UserIdsMorethanSix'
 
+# UserSig过期或错误。
+INVALIDPARAMETER_USERSIG = 'InvalidParameter.UserSig'
+
 # 视频分辨率参数错误。
 INVALIDPARAMETER_VIDEORESOLUTION = 'InvalidParameter.VideoResolution'
 

{tencentcloud-sdk-python-trtc-3.0.1068 → tencentcloud-sdk-python-trtc-3.0.1073}/tencentcloud/trtc/v20190722/models.py

@@ -4765,12 +4765,16 @@ class McuLayout(AbstractModel):
 白色：0xFFFFFF。
 灰色：0x999999。
         :type BackGroundColor: str
-        :param _BackgroundImageUrl: 子画面的背景图url，填写该参数，当用户关闭摄像头或未进入TRTC房间时，会在布局位置填充为指定图片。若指定图片与布局位置尺寸比例不一致，则会对图片进行拉伸处理，优先级高于BackGroundColor。
+        :param _BackgroundImageUrl: 子画面的背景图url，填写该参数，当用户关闭摄像头或未进入TRTC房间时，会在布局位置填充为指定图片。若指定图片与布局位置尺寸比例不一致，则会对图片进行拉伸处理，优先级高于BackGroundColor。支持png、jpg、jpeg、bmp、gif、webm格式。图片大小限制不超过5MB。
+注：您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，子画面的背景图将不会生效。
         :type BackgroundImageUrl: str
         :param _CustomCrop: 客户自定义裁剪，针对原始输入流裁剪
         :type CustomCrop: :class:`tencentcloud.trtc.v20190722.models.McuCustomCrop`
         :param _BackgroundRenderMode: 子背景图在输出时的显示模式：0为裁剪，1为缩放并显示背景，2为缩放并显示黑底，3为变比例伸缩。不填默认为3。
         :type BackgroundRenderMode: int
+        :param _TransparentUrl: 子画面的透明模版url，指向一张包含透明通道的模板图片。填写该参数，后台混流时会提取该模板图片的透明通道，将其缩放作为目标画面的透明通道，再和其他画面进行混合。您可以通过透明模版实现目标画面的半透明效果和任意形状裁剪（如圆角、星形、心形等）。 支持png格式。图片大小限制不超过5MB。
+注：1，模板图片宽高比应接近目标画面宽高比，以避免缩放适配目标画面时出现模板效果变形；2，透明模版只有RenderMode为0（裁剪）时才生效；3，您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，透明模版将不会生效。
+        :type TransparentUrl: str
         """
         self._UserMediaStream = None
         self._ImageWidth = None
@@ -4783,6 +4787,7 @@ class McuLayout(AbstractModel):
         self._BackgroundImageUrl = None
         self._CustomCrop = None
         self._BackgroundRenderMode = None
+        self._TransparentUrl = None
 
     @property
     def UserMediaStream(self):
@@ -4872,6 +4877,14 @@ class McuLayout(AbstractModel):
     def BackgroundRenderMode(self, BackgroundRenderMode):
         self._BackgroundRenderMode = BackgroundRenderMode
 
+    @property
+    def TransparentUrl(self):
+        return self._TransparentUrl
+
+    @TransparentUrl.setter
+    def TransparentUrl(self, TransparentUrl):
+        self._TransparentUrl = TransparentUrl
+
 
     def _deserialize(self, params):
         if params.get("UserMediaStream") is not None:
@@ -4889,6 +4902,7 @@ class McuLayout(AbstractModel):
             self._CustomCrop = McuCustomCrop()
             self._CustomCrop._deserialize(params.get("CustomCrop"))
         self._BackgroundRenderMode = params.get("BackgroundRenderMode")
+        self._TransparentUrl = params.get("TransparentUrl")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -5145,7 +5159,8 @@ class McuPublishCdnParam(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _PublishCdnUrl: CDN转推URL。注：若更新转推时，URL有任何变化，都会断流重推。
+        :param _PublishCdnUrl: CDN转推URL，只支持rtmp链接。
+注：若更新转推时，URL有任何变化，都会断流重推。
         :type PublishCdnUrl: str
         :param _IsTencentCdn: 是否是腾讯云CDN，0为转推非腾讯云CDN，1为转推腾讯CDN，不携带该参数默认为1。注意：1，为避免误产生转推费用，该参数建议明确填写，转推非腾讯云CDN时会产生转推费用，详情参见接口文档说明；2，国内站默认只支持转推腾讯云CDN，如您有转推第三方CDN需求，请联系腾讯云技术支持。
         :type IsTencentCdn: int
@@ -5287,7 +5302,8 @@ class McuVideoParams(AbstractModel):
 白色：0xFFFFFF。
 灰色：0x999999。
         :type BackGroundColor: str
-        :param _BackgroundImageUrl: 整个画布的背景图url，优先级高于BackGroundColor。
+        :param _BackgroundImageUrl: 整个画布的背景图url，优先级高于BackGroundColor。支持png、jpg、jpeg格式。图片大小限制不超过5MB。
+注：您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，背景图将不会生效。
         :type BackgroundImageUrl: str
         :param _WaterMarkList: 混流布局的水印参数。
         :type WaterMarkList: list of McuWaterMarkParams
@@ -5384,6 +5400,7 @@ class McuWaterMarkImage(AbstractModel):
     def __init__(self):
         r"""
         :param _WaterMarkUrl: 水印图片URL地址，支持png、jpg、jpeg格式。图片大小限制不超过5MB。
+注：您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，水印图片将不会生效。
         :type WaterMarkUrl: str
         :param _WaterMarkWidth: 水印在输出时的宽。单位为像素值。
         :type WaterMarkWidth: int
@@ -8241,7 +8258,7 @@ class StartStreamIngestRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _SdkAppId: TRTC的[SdkAppId](https://cloud.tencent.com/document/product/647/46351#sdkappid)，和录制的房间所对应的SdkAppId相同。
+        :param _SdkAppId: TRTC的[SdkAppId](https://cloud.tencent.com/document/product/647/46351#sdkappid)，和TRTC的房间所对应的SdkAppId相同。
         :type SdkAppId: int
         :param _RoomId: TRTC的[RoomId](https://cloud.tencent.com/document/product/647/46351#roomid)，录制的TRTC房间所对应的RoomId。
         :type RoomId: str
@@ -8254,7 +8271,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 _SourceUrl: 源流URL。示例值：https://a.b/test.mp4
+        :param _SourceUrl: 【本字段已废弃，请使用 StreamUrl 字段】源流URL，支持一个地址。
         :type SourceUrl: list of str
         :param _PrivateMapKey: TRTC房间权限加密串，只有在TRTC控制台启用了高级权限控制的时候需要携带，在TRTC控制台如果开启高级权限控制后，TRTC 的后台服务系统会校验一个叫做 [PrivateMapKey] 的“权限票据”，权限票据中包含了一个加密后的 RoomId 和一个加密后的“权限位列表”。由于 PrivateMapKey 中包含 RoomId，所以只提供了 UserSig 没有提供 PrivateMapKey 时，并不能进入指定的房间。
         :type PrivateMapKey: str
@@ -8262,6 +8279,8 @@ class StartStreamIngestRequest(AbstractModel):
         :type VideoEncodeParams: :class:`tencentcloud.trtc.v20190722.models.VideoEncodeParams`
         :param _AudioEncodeParams: 音频编码参数。可选，如果不填，保持原始流的参数。
         :type AudioEncodeParams: :class:`tencentcloud.trtc.v20190722.models.AudioEncodeParams`
+        :param _StreamUrl: 源流URL。历史原因本字段【必填】。
+        :type StreamUrl: str
         """
         self._SdkAppId = None
         self._RoomId = None
@@ -8272,6 +8291,7 @@ class StartStreamIngestRequest(AbstractModel):
         self._PrivateMapKey = None
         self._VideoEncodeParams = None
         self._AudioEncodeParams = None
+        self._StreamUrl = None
 
     @property
     def SdkAppId(self):
@@ -8345,6 +8365,14 @@ class StartStreamIngestRequest(AbstractModel):
     def AudioEncodeParams(self, AudioEncodeParams):
         self._AudioEncodeParams = AudioEncodeParams
 
+    @property
+    def StreamUrl(self):
+        return self._StreamUrl
+
+    @StreamUrl.setter
+    def StreamUrl(self, StreamUrl):
+        self._StreamUrl = StreamUrl
+
 
     def _deserialize(self, params):
         self._SdkAppId = params.get("SdkAppId")
@@ -8360,6 +8388,7 @@ class StartStreamIngestRequest(AbstractModel):
         if params.get("AudioEncodeParams") is not None:
             self._AudioEncodeParams = AudioEncodeParams()
             self._AudioEncodeParams._deserialize(params.get("AudioEncodeParams"))
+        self._StreamUrl = params.get("StreamUrl")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]

{tencentcloud-sdk-python-trtc-3.0.1068 → tencentcloud-sdk-python-trtc-3.0.1073}/tencentcloud/trtc/v20190722/trtc_client.py

@@ -1123,6 +1123,8 @@ class TrtcClient(AbstractClient):
 
     def StartStreamIngest(self, request):
         """将一个在线媒体流推到TRTC房间。
+        使用此接口的前提条件：需要购买 [尊享版或旗舰版套餐包](https://cloud.tencent.com/document/product/647/85386
+        )
 
         :param request: Request instance for StartStreamIngest.
         :type request: :class:`tencentcloud.trtc.v20190722.models.StartStreamIngestRequest`

{tencentcloud-sdk-python-trtc-3.0.1068 → tencentcloud-sdk-python-trtc-3.0.1073}/tencentcloud_sdk_python_trtc.egg-info/PKG-INFO

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

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

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

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