tencentcloud-sdk-python-trtc 3.0.1169__tar.gz → 3.0.1177__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of tencentcloud-sdk-python-trtc might be problematic. Click here for more details.

Files changed (16) hide show
  1. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/PKG-INFO +1 -1
  2. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/setup.py +1 -1
  3. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/tencentcloud/__init__.py +1 -1
  4. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/tencentcloud/trtc/v20190722/errorcodes.py +2 -5
  5. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/tencentcloud/trtc/v20190722/models.py +47 -7
  6. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/tencentcloud/trtc/v20190722/trtc_client.py +1 -3
  7. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/tencentcloud_sdk_python_trtc.egg-info/PKG-INFO +1 -1
  8. tencentcloud-sdk-python-trtc-3.0.1177/tencentcloud_sdk_python_trtc.egg-info/requires.txt +1 -0
  9. tencentcloud-sdk-python-trtc-3.0.1169/tencentcloud_sdk_python_trtc.egg-info/requires.txt +0 -1
  10. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/README.rst +0 -0
  11. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/setup.cfg +0 -0
  12. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/tencentcloud/trtc/__init__.py +0 -0
  13. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/tencentcloud/trtc/v20190722/__init__.py +0 -0
  14. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/tencentcloud_sdk_python_trtc.egg-info/SOURCES.txt +0 -0
  15. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/tencentcloud_sdk_python_trtc.egg-info/dependency_links.txt +0 -0
  16. {tencentcloud-sdk-python-trtc-3.0.1169 → tencentcloud-sdk-python-trtc-3.0.1177}/tencentcloud_sdk_python_trtc.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 1.1
2
2
  Name: tencentcloud-sdk-python-trtc
3
- Version: 3.0.1169
3
+ Version: 3.0.1177
4
4
  Summary: Tencent Cloud Trtc SDK for Python
5
5
  Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
6
6
  Author: Tencent Cloud
@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
8
8
 
9
9
  setup(
10
10
  name='tencentcloud-sdk-python-trtc',
11
- install_requires=["tencentcloud-sdk-python-common==3.0.1169"],
11
+ install_requires=["tencentcloud-sdk-python-common==3.0.1177"],
12
12
  version=tencentcloud.__version__,
13
13
  description='Tencent Cloud Trtc SDK for Python',
14
14
  long_description=open('README.rst').read(),
@@ -14,4 +14,4 @@
14
14
  # limitations under the License.
15
15
 
16
16
 
17
- __version__ = '3.0.1169'
17
+ __version__ = '3.0.1177'
@@ -38,8 +38,8 @@ FAILEDOPERATION_MIXSESSIONNOTEXIST = 'FailedOperation.MixSessionNotExist'
38
38
  # 需要解锁所需能力位
39
39
  FAILEDOPERATION_NOTABILITY = 'FailedOperation.NotAbility'
40
40
 
41
- # 未开通RTMP
42
- FAILEDOPERATION_NOTRTMPFUNCTION = 'FailedOperation.NotRtmpFunction'
41
+ # 不允许此操作,请提交工单联系我们
42
+ FAILEDOPERATION_NOTALLOWED = 'FailedOperation.NotAllowed'
43
43
 
44
44
  # 查询任务失败
45
45
  FAILEDOPERATION_QUERYTASKINFOFAILED = 'FailedOperation.QueryTaskInfoFailed'
@@ -62,9 +62,6 @@ FAILEDOPERATION_SDKAPPIDNOTEXIST = 'FailedOperation.SdkAppIdNotExist'
62
62
  # AppId下没有此SdkAppId的资源
63
63
  FAILEDOPERATION_SDKAPPIDNOTUNDERAPPID = 'FailedOperation.SdkAppIdNotUnderAppId'
64
64
 
65
- # SdkAppId未开通页面录制能力,请检查。
66
- FAILEDOPERATION_SDKAPPIDNOTWEBRECORDABILITY = 'FailedOperation.SdkAppIdNotWebRecordAbility'
67
-
68
65
  # 任务已存在
69
66
  FAILEDOPERATION_TASKEXIST = 'FailedOperation.TaskExist'
70
67
 
@@ -5114,6 +5114,16 @@ class McuLayout(AbstractModel):
5114
5114
  :type TransparentUrl: str
5115
5115
  :param _BackgroundCustomRender: 子背景图的自定义渲染参数,当BackgroundRenderMode为4时必须配置。
5116
5116
  :type BackgroundCustomRender: :class:`tencentcloud.trtc.v20190722.models.McuBackgroundCustomRender`
5117
+ :param _BackGroundColorMode: 子背景色生效模式,默认值为0表示均不生效。
5118
+ bit0:占位图缩放是否生效。
5119
+ bit1:上行流缩放是否生效。
5120
+ 您可以将相应bit位置1启动生效,例如:
5121
+ 0(00)表示子背景色不生效。
5122
+ 1(01)表示子背景色只在占位图缩放时生效。
5123
+ 2(10)表示子背景色只在上行流缩放时生效。
5124
+ 3(11)表示子背景色在占位图缩放和上行流缩放时均生效。
5125
+
5126
+ :type BackGroundColorMode: int
5117
5127
  """
5118
5128
  self._UserMediaStream = None
5119
5129
  self._ImageWidth = None
@@ -5128,6 +5138,7 @@ class McuLayout(AbstractModel):
5128
5138
  self._BackgroundRenderMode = None
5129
5139
  self._TransparentUrl = None
5130
5140
  self._BackgroundCustomRender = None
5141
+ self._BackGroundColorMode = None
5131
5142
 
5132
5143
  @property
5133
5144
  def UserMediaStream(self):
@@ -5233,6 +5244,14 @@ class McuLayout(AbstractModel):
5233
5244
  def BackgroundCustomRender(self, BackgroundCustomRender):
5234
5245
  self._BackgroundCustomRender = BackgroundCustomRender
5235
5246
 
5247
+ @property
5248
+ def BackGroundColorMode(self):
5249
+ return self._BackGroundColorMode
5250
+
5251
+ @BackGroundColorMode.setter
5252
+ def BackGroundColorMode(self, BackGroundColorMode):
5253
+ self._BackGroundColorMode = BackGroundColorMode
5254
+
5236
5255
 
5237
5256
  def _deserialize(self, params):
5238
5257
  if params.get("UserMediaStream") is not None:
@@ -5254,6 +5273,7 @@ class McuLayout(AbstractModel):
5254
5273
  if params.get("BackgroundCustomRender") is not None:
5255
5274
  self._BackgroundCustomRender = McuBackgroundCustomRender()
5256
5275
  self._BackgroundCustomRender._deserialize(params.get("BackgroundCustomRender"))
5276
+ self._BackGroundColorMode = params.get("BackGroundColorMode")
5257
5277
  memeber_set = set(params.keys())
5258
5278
  for name, value in vars(self).items():
5259
5279
  property_name = name[1:]
@@ -6096,7 +6116,7 @@ class MixLayout(AbstractModel):
6096
6116
  :type MediaId: int
6097
6117
  :param _ImageLayer: 该画布的图层顺序, 这个值越小表示图层越靠后。默认值为0。
6098
6118
  :type ImageLayer: int
6099
- :param _SubBackgroundImage: 图片的url地址, 只支持jpg png,大小限制不超过5M,宽高比不一致的处理方案同 RenderMode。
6119
+ :param _SubBackgroundImage: 图片的url地址, 只支持jpg, png, jpeg,大小限制不超过5M。注意,url必须携带格式后缀,url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
6100
6120
  :type SubBackgroundImage: str
6101
6121
  """
6102
6122
  self._Top = None
@@ -6222,7 +6242,7 @@ class MixLayoutParams(AbstractModel):
6222
6242
  :param _MixLayoutMode: 布局模式:
6223
6243
  1:悬浮布局;
6224
6244
  2:屏幕分享布局;
6225
- 3:九宫格布局(默认);
6245
+ 3:九宫格布局;
6226
6246
  4:自定义布局;
6227
6247
 
6228
6248
  悬浮布局:默认第一个进入房间的主播(也可以指定一个主播)的视频画面会铺满整个屏幕。其他主播的视频画面从左下角开始依次按照进房顺序水平排列,显示为小画面,小画面悬浮于大画面之上。当画面数量小于等于17个时,每行4个(4 x 4排列)。当画面数量大于17个时,重新布局小画面为每行5个(5 x 5)排列。最多支持25个画面,如果用户只发送音频,仍然会占用画面位置。
@@ -6244,13 +6264,13 @@ class MixLayoutParams(AbstractModel):
6244
6264
  1:辅流(屏幕分享);
6245
6265
  这个位置的MediaId代表的是对应MaxResolutionUserId的主辅路,MixLayoutList内代表的是自定义用户的主辅路。
6246
6266
  :type MediaId: int
6247
- :param _BackgroundImageUrl: 图片的url地址, 只支持jpg png,大小限制不超过5Murl不可包含中文。
6267
+ :param _BackgroundImageUrl: 图片的url地址,只支持jpg, png, jpeg,大小限制不超过5M。注意,url必须携带格式后缀,url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
6248
6268
  :type BackgroundImageUrl: str
6249
6269
  :param _PlaceHolderMode: 设置为1时代表启用占位图功能,0时代表不启用占位图功能,默认为0。启用占位图功能时,在预设位置的用户没有上行视频时可显示对应的占位图。
6250
6270
  :type PlaceHolderMode: int
6251
6271
  :param _BackgroundImageRenderMode: 背景画面宽高比不一致的时候处理方案,与MixLayoufList定义的RenderMode一致。
6252
6272
  :type BackgroundImageRenderMode: int
6253
- :param _DefaultSubBackgroundImage: 子画面占位图url地址, 只支持jpg png,大小限制不超过5M,宽高比不一致的处理方案同 RenderMode。
6273
+ :param _DefaultSubBackgroundImage: 子画面占位图url地址,只支持jpg, png, jpeg,大小限制不超过5M。注意,url必须携带格式后缀,url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
6254
6274
  :type DefaultSubBackgroundImage: str
6255
6275
  :param _WaterMarkList: 水印布局参数, 最多支持25个。
6256
6276
  :type WaterMarkList: list of WaterMark
@@ -9004,26 +9024,38 @@ class StartStreamIngestRequest(AbstractModel):
9004
9024
 
9005
9025
  @property
9006
9026
  def VideoEncodeParams(self):
9027
+ warnings.warn("parameter `VideoEncodeParams` is deprecated", DeprecationWarning)
9028
+
9007
9029
  return self._VideoEncodeParams
9008
9030
 
9009
9031
  @VideoEncodeParams.setter
9010
9032
  def VideoEncodeParams(self, VideoEncodeParams):
9033
+ warnings.warn("parameter `VideoEncodeParams` is deprecated", DeprecationWarning)
9034
+
9011
9035
  self._VideoEncodeParams = VideoEncodeParams
9012
9036
 
9013
9037
  @property
9014
9038
  def AudioEncodeParams(self):
9039
+ warnings.warn("parameter `AudioEncodeParams` is deprecated", DeprecationWarning)
9040
+
9015
9041
  return self._AudioEncodeParams
9016
9042
 
9017
9043
  @AudioEncodeParams.setter
9018
9044
  def AudioEncodeParams(self, AudioEncodeParams):
9045
+ warnings.warn("parameter `AudioEncodeParams` is deprecated", DeprecationWarning)
9046
+
9019
9047
  self._AudioEncodeParams = AudioEncodeParams
9020
9048
 
9021
9049
  @property
9022
9050
  def SourceUrl(self):
9051
+ warnings.warn("parameter `SourceUrl` is deprecated", DeprecationWarning)
9052
+
9023
9053
  return self._SourceUrl
9024
9054
 
9025
9055
  @SourceUrl.setter
9026
9056
  def SourceUrl(self, SourceUrl):
9057
+ warnings.warn("parameter `SourceUrl` is deprecated", DeprecationWarning)
9058
+
9027
9059
  self._SourceUrl = SourceUrl
9028
9060
 
9029
9061
  @property
@@ -9111,7 +9143,7 @@ class StartWebRecordRequest(AbstractModel):
9111
9143
  :param _MaxDurationLimit: 录制最大时长限制, 单位 s, 合法取值范围[1800, 36000], 默认 36000s(10 小时)
9112
9144
 
9113
9145
  :type MaxDurationLimit: int
9114
- :param _StorageParams: 【必填】云存储相关的参数,目前支持腾讯云对象存储以及腾讯云云点播VOD,不支持第三方云存储
9146
+ :param _StorageParams: 【必填】云存储相关的参数,目前支持腾讯云对象存储以及腾讯云云点播VOD,不支持第三方云存储;输出文件的存储格式仅支持hls或mp4
9115
9147
  :type StorageParams: :class:`tencentcloud.trtc.v20190722.models.StorageParams`
9116
9148
  :param _WebRecordVideoParams: 页面录制视频参数
9117
9149
  :type WebRecordVideoParams: :class:`tencentcloud.trtc.v20190722.models.WebRecordVideoParams`
@@ -10238,18 +10270,26 @@ https://cloud.tencent.com/document/product/269/31999#app-.E7.AE.A1.E7.90.86.E5.9
10238
10270
 
10239
10271
  @property
10240
10272
  def IMAdminUserId(self):
10273
+ warnings.warn("parameter `IMAdminUserId` is deprecated", DeprecationWarning)
10274
+
10241
10275
  return self._IMAdminUserId
10242
10276
 
10243
10277
  @IMAdminUserId.setter
10244
10278
  def IMAdminUserId(self, IMAdminUserId):
10279
+ warnings.warn("parameter `IMAdminUserId` is deprecated", DeprecationWarning)
10280
+
10245
10281
  self._IMAdminUserId = IMAdminUserId
10246
10282
 
10247
10283
  @property
10248
10284
  def IMAdminUserSig(self):
10285
+ warnings.warn("parameter `IMAdminUserSig` is deprecated", DeprecationWarning)
10286
+
10249
10287
  return self._IMAdminUserSig
10250
10288
 
10251
10289
  @IMAdminUserSig.setter
10252
10290
  def IMAdminUserSig(self, IMAdminUserSig):
10291
+ warnings.warn("parameter `IMAdminUserSig` is deprecated", DeprecationWarning)
10292
+
10253
10293
  self._IMAdminUserSig = IMAdminUserSig
10254
10294
 
10255
10295
  @property
@@ -11156,7 +11196,7 @@ class WaterMarkImage(AbstractModel):
11156
11196
 
11157
11197
  def __init__(self):
11158
11198
  r"""
11159
- :param _WaterMarkUrl: 下载的url地址, 只支持jpg png,大小限制不超过5M
11199
+ :param _WaterMarkUrl: 下载的url地址, 只支持jpg, png, jpeg,大小限制不超过5M。注意,url必须携带格式后缀,url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '='
11160
11200
  :type WaterMarkUrl: str
11161
11201
  :param _Top: 画布上该画面左上角的 y 轴坐标,取值范围 [0, 2560],不能超过画布的高。
11162
11202
  :type Top: int
@@ -11393,7 +11433,7 @@ class WebRecordVideoParams(AbstractModel):
11393
11433
  :type Width: int
11394
11434
  :param _Height: 录制画面高度,默认为720,取值范围[0, 1080]
11395
11435
  :type Height: int
11396
- :param _Format: 指定输出格式,可选hls,mp4
11436
+ :param _Format: 指定输出格式,可选hls,mp4。存储到云点播VOD时此参数无效,存储到VOD时请通过TencentVod(https://cloud.tencent.com/document/api/647/44055#TencentVod)内的MediaType设置。
11397
11437
 
11398
11438
  :type Format: str
11399
11439
  :param _MaxMediaFileDuration: 如果是aac或者mp4文件格式,超过长度限制后,系统会自动拆分视频文件。单位:分钟。默认为1440min(24h),取值范围为1-1440。【单文件限制最大为2G,满足文件大小 >2G 或录制时长度 > 24h任意一个条件,文件都会自动切分】
@@ -974,9 +974,7 @@ class TrtcClient(AbstractClient):
974
974
  - 拉取全房间的流。
975
975
  - 拉取特定用户的流。
976
976
 
977
- 服务端实时下发字幕和会议记录有两种方式,通过IMAdminUserId和IMAdminUserSig字段控制:
978
- - 如果填写IMAdminUserId和IMAdminUserSig,服务端会调用IM的[发送群组消息](https://cloud.tencent.com/document/product/269/1629)API来向端上实时下发消息。客户端只需监听群组消息的回调即可,比如[web端回调](https://cloud.tencent.com/document/product/269/75319)。
979
- - 如果不填写IMAdminUserId和IMAdminUserSig,服务端使用TRTC自定义消息通道下发消息,CmdId固定是1。客户端只需监听自定义消息的回调即可,比如[c++回调](https://cloud.tencent.com/document/product/647/79637#4cd82f4edb24992a15a25187089e1565)。
977
+ 服务端通过TRTC的自定义消息实时下发字幕和会议记录,CmdId固定是1。客户端只需监听自定义消息的回调即可,比如[c++回调](https://cloud.tencent.com/document/product/647/79637#4cd82f4edb24992a15a25187089e1565)。其他客户端比如安卓、Web等同样可在该链接处找到。
980
978
 
981
979
  服务端实时下发的消息是JSON字符串,实时字幕具体格式如下:
982
980
  `{
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 1.1
2
2
  Name: tencentcloud-sdk-python-trtc
3
- Version: 3.0.1169
3
+ Version: 3.0.1177
4
4
  Summary: Tencent Cloud Trtc SDK for Python
5
5
  Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
6
6
  Author: Tencent Cloud
@@ -0,0 +1 @@
1
+ tencentcloud-sdk-python-common==3.0.1177
@@ -1 +0,0 @@
1
- tencentcloud-sdk-python-common==3.0.1169