tencentcloud-sdk-python-trtc 3.0.1152__py2.py3-none-any.whl → 3.1.13__py2.py3-none-any.whl
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.
- tencentcloud/__init__.py +1 -1
- tencentcloud/trtc/v20190722/errorcodes.py +99 -9
- tencentcloud/trtc/v20190722/models.py +14588 -5983
- tencentcloud/trtc/v20190722/trtc_client.py +600 -158
- tencentcloud/trtc/v20190722/trtc_client_async.py +1516 -0
- {tencentcloud_sdk_python_trtc-3.0.1152.dist-info → tencentcloud_sdk_python_trtc-3.1.13.dist-info}/METADATA +3 -5
- tencentcloud_sdk_python_trtc-3.1.13.dist-info/RECORD +11 -0
- {tencentcloud_sdk_python_trtc-3.0.1152.dist-info → tencentcloud_sdk_python_trtc-3.1.13.dist-info}/WHEEL +1 -1
- tencentcloud_sdk_python_trtc-3.0.1152.dist-info/RECORD +0 -10
- {tencentcloud_sdk_python_trtc-3.0.1152.dist-info → tencentcloud_sdk_python_trtc-3.1.13.dist-info}/top_level.txt +0 -0
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
# -*- coding: utf8 -*-
|
|
2
|
-
# Copyright (c) 2017-
|
|
2
|
+
# Copyright (c) 2017-2025 Tencent. All Rights Reserved.
|
|
3
3
|
#
|
|
4
4
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
5
|
# you may not use this file except in compliance with the License.
|
|
@@ -26,9 +26,85 @@ class TrtcClient(AbstractClient):
|
|
|
26
26
|
_service = 'trtc'
|
|
27
27
|
|
|
28
28
|
|
|
29
|
+
def ControlAIConversation(self, request):
|
|
30
|
+
r"""提供服务端控制机器人的功能
|
|
31
|
+
|
|
32
|
+
:param request: Request instance for ControlAIConversation.
|
|
33
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.ControlAIConversationRequest`
|
|
34
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.ControlAIConversationResponse`
|
|
35
|
+
|
|
36
|
+
"""
|
|
37
|
+
try:
|
|
38
|
+
params = request._serialize()
|
|
39
|
+
headers = request.headers
|
|
40
|
+
body = self.call("ControlAIConversation", params, headers=headers)
|
|
41
|
+
response = json.loads(body)
|
|
42
|
+
model = models.ControlAIConversationResponse()
|
|
43
|
+
model._deserialize(response["Response"])
|
|
44
|
+
return model
|
|
45
|
+
except Exception as e:
|
|
46
|
+
if isinstance(e, TencentCloudSDKException):
|
|
47
|
+
raise
|
|
48
|
+
else:
|
|
49
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
def CreateBasicModeration(self, request):
|
|
53
|
+
r"""接口说明:
|
|
54
|
+
启动终端审核功能,完成房间内的音频审核。
|
|
55
|
+
|
|
56
|
+
:param request: Request instance for CreateBasicModeration.
|
|
57
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.CreateBasicModerationRequest`
|
|
58
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.CreateBasicModerationResponse`
|
|
59
|
+
|
|
60
|
+
"""
|
|
61
|
+
try:
|
|
62
|
+
params = request._serialize()
|
|
63
|
+
headers = request.headers
|
|
64
|
+
body = self.call("CreateBasicModeration", params, headers=headers)
|
|
65
|
+
response = json.loads(body)
|
|
66
|
+
model = models.CreateBasicModerationResponse()
|
|
67
|
+
model._deserialize(response["Response"])
|
|
68
|
+
return model
|
|
69
|
+
except Exception as e:
|
|
70
|
+
if isinstance(e, TencentCloudSDKException):
|
|
71
|
+
raise
|
|
72
|
+
else:
|
|
73
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
def CreateCloudModeration(self, request):
|
|
77
|
+
r"""接口说明:
|
|
78
|
+
启动云端审核功能,完成房间内的音视频切片,视频截帧,或者录制音频流,送审到指定的审核商,完成审核。
|
|
79
|
+
|
|
80
|
+
您可以通过此接口实现如下目标:
|
|
81
|
+
* 指定审核参数(ModerationParams)来指定审核需要的详细参数。
|
|
82
|
+
* 指定存储参数(ModerationStorageParams)将命中的审核文件指定上传到您希望的云存储,目前支持腾讯云(对象存储COS)和第三方AWS
|
|
83
|
+
|
|
84
|
+
:param request: Request instance for CreateCloudModeration.
|
|
85
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.CreateCloudModerationRequest`
|
|
86
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.CreateCloudModerationResponse`
|
|
87
|
+
|
|
88
|
+
"""
|
|
89
|
+
try:
|
|
90
|
+
params = request._serialize()
|
|
91
|
+
headers = request.headers
|
|
92
|
+
body = self.call("CreateCloudModeration", params, headers=headers)
|
|
93
|
+
response = json.loads(body)
|
|
94
|
+
model = models.CreateCloudModerationResponse()
|
|
95
|
+
model._deserialize(response["Response"])
|
|
96
|
+
return model
|
|
97
|
+
except Exception as e:
|
|
98
|
+
if isinstance(e, TencentCloudSDKException):
|
|
99
|
+
raise
|
|
100
|
+
else:
|
|
101
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
102
|
+
|
|
103
|
+
|
|
29
104
|
def CreateCloudRecording(self, request):
|
|
30
|
-
"""接口说明:
|
|
105
|
+
r"""接口说明:
|
|
31
106
|
启动云端录制功能,完成房间内的音视频录制,并上传到指定的云存储。您可以通过此 API 接口把TRTC 房间中的每一路音视频流做单独的录制又或者多路视频画面合流混成一路。
|
|
107
|
+
在线上正式运营之前,请关注录制的最佳实践 [录制最佳实践](https://cloud.tencent.com/document/product/647/76497#e7e2f04c-6cde-43c9-9cd0-0f8d22dee68c),配合最佳实践,可大大提高接口录制的可用性。
|
|
32
108
|
|
|
33
109
|
您可以通过此接口实现如下目标:
|
|
34
110
|
* 指定订阅流参数(RecordParams)来指定需要录制的主播的黑名单或者白名单。
|
|
@@ -60,8 +136,36 @@ class TrtcClient(AbstractClient):
|
|
|
60
136
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
61
137
|
|
|
62
138
|
|
|
139
|
+
def CreateCloudSliceTask(self, request):
|
|
140
|
+
r"""接口说明:
|
|
141
|
+
启动云端切片功能,完成房间内的音视频切片,并上传到指定的云存储。
|
|
142
|
+
|
|
143
|
+
您可以通过此接口实现如下目标:
|
|
144
|
+
* 指定切片参数(SliceParams)来指定需要切片的主播的黑名单或者白名单。
|
|
145
|
+
* 指定存储参数(SliceStorageParams)来指定上传到您希望的云存储,目前支持腾讯云(对象存储COS)和第三方AWS
|
|
146
|
+
|
|
147
|
+
:param request: Request instance for CreateCloudSliceTask.
|
|
148
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.CreateCloudSliceTaskRequest`
|
|
149
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.CreateCloudSliceTaskResponse`
|
|
150
|
+
|
|
151
|
+
"""
|
|
152
|
+
try:
|
|
153
|
+
params = request._serialize()
|
|
154
|
+
headers = request.headers
|
|
155
|
+
body = self.call("CreateCloudSliceTask", params, headers=headers)
|
|
156
|
+
response = json.loads(body)
|
|
157
|
+
model = models.CreateCloudSliceTaskResponse()
|
|
158
|
+
model._deserialize(response["Response"])
|
|
159
|
+
return model
|
|
160
|
+
except Exception as e:
|
|
161
|
+
if isinstance(e, TencentCloudSDKException):
|
|
162
|
+
raise
|
|
163
|
+
else:
|
|
164
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
165
|
+
|
|
166
|
+
|
|
63
167
|
def CreatePicture(self, request):
|
|
64
|
-
"""如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁新增自定义背景图或水印,可通过此接口上传新的图片素材。无需频繁新增图片的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
|
|
168
|
+
r"""如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁新增自定义背景图或水印,可通过此接口上传新的图片素材。无需频繁新增图片的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
|
|
65
169
|
|
|
66
170
|
:param request: Request instance for CreatePicture.
|
|
67
171
|
:type request: :class:`tencentcloud.trtc.v20190722.models.CreatePictureRequest`
|
|
@@ -83,8 +187,54 @@ class TrtcClient(AbstractClient):
|
|
|
83
187
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
84
188
|
|
|
85
189
|
|
|
190
|
+
def DeleteBasicModeration(self, request):
|
|
191
|
+
r"""成功开启审核任务后,可以使用此接口来停止任务。
|
|
192
|
+
|
|
193
|
+
:param request: Request instance for DeleteBasicModeration.
|
|
194
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.DeleteBasicModerationRequest`
|
|
195
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.DeleteBasicModerationResponse`
|
|
196
|
+
|
|
197
|
+
"""
|
|
198
|
+
try:
|
|
199
|
+
params = request._serialize()
|
|
200
|
+
headers = request.headers
|
|
201
|
+
body = self.call("DeleteBasicModeration", params, headers=headers)
|
|
202
|
+
response = json.loads(body)
|
|
203
|
+
model = models.DeleteBasicModerationResponse()
|
|
204
|
+
model._deserialize(response["Response"])
|
|
205
|
+
return model
|
|
206
|
+
except Exception as e:
|
|
207
|
+
if isinstance(e, TencentCloudSDKException):
|
|
208
|
+
raise
|
|
209
|
+
else:
|
|
210
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
211
|
+
|
|
212
|
+
|
|
213
|
+
def DeleteCloudModeration(self, request):
|
|
214
|
+
r"""成功开启云端审核任务后,可以使用此接口来停止送审。
|
|
215
|
+
|
|
216
|
+
:param request: Request instance for DeleteCloudModeration.
|
|
217
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.DeleteCloudModerationRequest`
|
|
218
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.DeleteCloudModerationResponse`
|
|
219
|
+
|
|
220
|
+
"""
|
|
221
|
+
try:
|
|
222
|
+
params = request._serialize()
|
|
223
|
+
headers = request.headers
|
|
224
|
+
body = self.call("DeleteCloudModeration", params, headers=headers)
|
|
225
|
+
response = json.loads(body)
|
|
226
|
+
model = models.DeleteCloudModerationResponse()
|
|
227
|
+
model._deserialize(response["Response"])
|
|
228
|
+
return model
|
|
229
|
+
except Exception as e:
|
|
230
|
+
if isinstance(e, TencentCloudSDKException):
|
|
231
|
+
raise
|
|
232
|
+
else:
|
|
233
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
234
|
+
|
|
235
|
+
|
|
86
236
|
def DeleteCloudRecording(self, request):
|
|
87
|
-
"""成功开启录制后,可以使用此接口来停止录制任务。停止录制成功后不代表文件全部传输完成,如果未完成后台将会继续上传文件,成功后通过事件回调通知客户文件全部传输完成状态。
|
|
237
|
+
r"""成功开启录制后,可以使用此接口来停止录制任务。停止录制成功后不代表文件全部传输完成,如果未完成后台将会继续上传文件,成功后通过事件回调通知客户文件全部传输完成状态。
|
|
88
238
|
|
|
89
239
|
:param request: Request instance for DeleteCloudRecording.
|
|
90
240
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DeleteCloudRecordingRequest`
|
|
@@ -106,8 +256,31 @@ class TrtcClient(AbstractClient):
|
|
|
106
256
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
107
257
|
|
|
108
258
|
|
|
259
|
+
def DeleteCloudSliceTask(self, request):
|
|
260
|
+
r"""成功开启切片任务后,可以使用此接口来停止任务。停止切片成功后不代表文件全部传输完成,如果未完成后台将会继续上传文件,成功后通过事件回调通知客户文件全部传输完成状态。
|
|
261
|
+
|
|
262
|
+
:param request: Request instance for DeleteCloudSliceTask.
|
|
263
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.DeleteCloudSliceTaskRequest`
|
|
264
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.DeleteCloudSliceTaskResponse`
|
|
265
|
+
|
|
266
|
+
"""
|
|
267
|
+
try:
|
|
268
|
+
params = request._serialize()
|
|
269
|
+
headers = request.headers
|
|
270
|
+
body = self.call("DeleteCloudSliceTask", params, headers=headers)
|
|
271
|
+
response = json.loads(body)
|
|
272
|
+
model = models.DeleteCloudSliceTaskResponse()
|
|
273
|
+
model._deserialize(response["Response"])
|
|
274
|
+
return model
|
|
275
|
+
except Exception as e:
|
|
276
|
+
if isinstance(e, TencentCloudSDKException):
|
|
277
|
+
raise
|
|
278
|
+
else:
|
|
279
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
280
|
+
|
|
281
|
+
|
|
109
282
|
def DeletePicture(self, request):
|
|
110
|
-
"""如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁删除自定义背景图或水印,可通过此接口删除已上传的图片。无需频繁删除图片的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
|
|
283
|
+
r"""如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁删除自定义背景图或水印,可通过此接口删除已上传的图片。无需频繁删除图片的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
|
|
111
284
|
|
|
112
285
|
:param request: Request instance for DeletePicture.
|
|
113
286
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DeletePictureRequest`
|
|
@@ -129,8 +302,54 @@ class TrtcClient(AbstractClient):
|
|
|
129
302
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
130
303
|
|
|
131
304
|
|
|
305
|
+
def DeleteVoicePrint(self, request):
|
|
306
|
+
r"""传入声纹ID,删除之前注册的声纹信息
|
|
307
|
+
|
|
308
|
+
:param request: Request instance for DeleteVoicePrint.
|
|
309
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.DeleteVoicePrintRequest`
|
|
310
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.DeleteVoicePrintResponse`
|
|
311
|
+
|
|
312
|
+
"""
|
|
313
|
+
try:
|
|
314
|
+
params = request._serialize()
|
|
315
|
+
headers = request.headers
|
|
316
|
+
body = self.call("DeleteVoicePrint", params, headers=headers)
|
|
317
|
+
response = json.loads(body)
|
|
318
|
+
model = models.DeleteVoicePrintResponse()
|
|
319
|
+
model._deserialize(response["Response"])
|
|
320
|
+
return model
|
|
321
|
+
except Exception as e:
|
|
322
|
+
if isinstance(e, TencentCloudSDKException):
|
|
323
|
+
raise
|
|
324
|
+
else:
|
|
325
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
326
|
+
|
|
327
|
+
|
|
328
|
+
def DescribeAIConversation(self, request):
|
|
329
|
+
r"""查询AI对话任务状态。
|
|
330
|
+
|
|
331
|
+
:param request: Request instance for DescribeAIConversation.
|
|
332
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribeAIConversationRequest`
|
|
333
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.DescribeAIConversationResponse`
|
|
334
|
+
|
|
335
|
+
"""
|
|
336
|
+
try:
|
|
337
|
+
params = request._serialize()
|
|
338
|
+
headers = request.headers
|
|
339
|
+
body = self.call("DescribeAIConversation", params, headers=headers)
|
|
340
|
+
response = json.loads(body)
|
|
341
|
+
model = models.DescribeAIConversationResponse()
|
|
342
|
+
model._deserialize(response["Response"])
|
|
343
|
+
return model
|
|
344
|
+
except Exception as e:
|
|
345
|
+
if isinstance(e, TencentCloudSDKException):
|
|
346
|
+
raise
|
|
347
|
+
else:
|
|
348
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
349
|
+
|
|
350
|
+
|
|
132
351
|
def DescribeAITranscription(self, request):
|
|
133
|
-
"""查询AI
|
|
352
|
+
r"""查询AI转录任务状态。
|
|
134
353
|
|
|
135
354
|
:param request: Request instance for DescribeAITranscription.
|
|
136
355
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribeAITranscriptionRequest`
|
|
@@ -153,7 +372,7 @@ class TrtcClient(AbstractClient):
|
|
|
153
372
|
|
|
154
373
|
|
|
155
374
|
def DescribeCallDetailInfo(self, request):
|
|
156
|
-
"""查询指定时间内的用户列表及用户通话质量数据,最大可查询14天内数据。DataType 不为null,查询起止时间不超过1个小时,查询用户不超过6个,支持跨天查询。DataType为null时,查询起止时间不超过4个小时, 默认查询6个用户,同时支持每页查询100以内用户个数(PageSize不超过100)。接口用于查询质量问题,不推荐作为计费使用。(同老接口DescribeCallDetail)
|
|
375
|
+
r"""查询指定时间内的用户列表及用户通话质量数据,最大可查询14天内数据。DataType 不为null,查询起止时间不超过1个小时,查询用户不超过6个,支持跨天查询。DataType为null时,查询起止时间不超过4个小时, 默认查询6个用户,同时支持每页查询100以内用户个数(PageSize不超过100)。接口用于查询质量问题,不推荐作为计费使用。(同老接口DescribeCallDetail)
|
|
157
376
|
**注意**:
|
|
158
377
|
1.该接口只用于历史数据统计或核对数据使用,实时类关键业务逻辑不能使用。
|
|
159
378
|
2.该接口自2024年4月1日起正式商业化,需订阅套餐解锁调用能力,提供以下两种解锁方式,可任选其一解锁:
|
|
@@ -180,8 +399,31 @@ class TrtcClient(AbstractClient):
|
|
|
180
399
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
181
400
|
|
|
182
401
|
|
|
402
|
+
def DescribeCloudModeration(self, request):
|
|
403
|
+
r"""成功开启审核任务后,可以使用此接口来查询审核任务状态和订阅的黑白名单信息。仅在任务进行时有效,任务退出后查询将会返回错误。
|
|
404
|
+
|
|
405
|
+
:param request: Request instance for DescribeCloudModeration.
|
|
406
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribeCloudModerationRequest`
|
|
407
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.DescribeCloudModerationResponse`
|
|
408
|
+
|
|
409
|
+
"""
|
|
410
|
+
try:
|
|
411
|
+
params = request._serialize()
|
|
412
|
+
headers = request.headers
|
|
413
|
+
body = self.call("DescribeCloudModeration", params, headers=headers)
|
|
414
|
+
response = json.loads(body)
|
|
415
|
+
model = models.DescribeCloudModerationResponse()
|
|
416
|
+
model._deserialize(response["Response"])
|
|
417
|
+
return model
|
|
418
|
+
except Exception as e:
|
|
419
|
+
if isinstance(e, TencentCloudSDKException):
|
|
420
|
+
raise
|
|
421
|
+
else:
|
|
422
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
423
|
+
|
|
424
|
+
|
|
183
425
|
def DescribeCloudRecording(self, request):
|
|
184
|
-
"""成功开启录制后,可以使用此接口来查询录制状态。仅在录制任务进行时有效,录制退出后查询将会返回错误。
|
|
426
|
+
r"""成功开启录制后,可以使用此接口来查询录制状态。仅在录制任务进行时有效,录制退出后查询将会返回错误。
|
|
185
427
|
录制文件上传到云点播VOD时,StorageFileList中不会返回录制文件信息,请订阅相关录制文件回调事件,获取录制文件信息。
|
|
186
428
|
|
|
187
429
|
:param request: Request instance for DescribeCloudRecording.
|
|
@@ -204,8 +446,31 @@ class TrtcClient(AbstractClient):
|
|
|
204
446
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
205
447
|
|
|
206
448
|
|
|
449
|
+
def DescribeCloudSliceTask(self, request):
|
|
450
|
+
r"""成功开启切片后,可以使用此接口来查询切片任务状态。仅在任务进行时有效,任务退出后查询将会返回错误。
|
|
451
|
+
|
|
452
|
+
:param request: Request instance for DescribeCloudSliceTask.
|
|
453
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribeCloudSliceTaskRequest`
|
|
454
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.DescribeCloudSliceTaskResponse`
|
|
455
|
+
|
|
456
|
+
"""
|
|
457
|
+
try:
|
|
458
|
+
params = request._serialize()
|
|
459
|
+
headers = request.headers
|
|
460
|
+
body = self.call("DescribeCloudSliceTask", params, headers=headers)
|
|
461
|
+
response = json.loads(body)
|
|
462
|
+
model = models.DescribeCloudSliceTaskResponse()
|
|
463
|
+
model._deserialize(response["Response"])
|
|
464
|
+
return model
|
|
465
|
+
except Exception as e:
|
|
466
|
+
if isinstance(e, TencentCloudSDKException):
|
|
467
|
+
raise
|
|
468
|
+
else:
|
|
469
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
470
|
+
|
|
471
|
+
|
|
207
472
|
def DescribeMixTranscodingUsage(self, request):
|
|
208
|
-
"""获取TRTC混流转码的用量明细。
|
|
473
|
+
r"""获取TRTC混流转码的用量明细。
|
|
209
474
|
- 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。
|
|
210
475
|
- 单次查询统计区间最多不能超过31天。
|
|
211
476
|
- 若查询当天用量,由于统计延迟等原因,返回数据可能不够准确。
|
|
@@ -233,7 +498,7 @@ class TrtcClient(AbstractClient):
|
|
|
233
498
|
|
|
234
499
|
|
|
235
500
|
def DescribePicture(self, request):
|
|
236
|
-
"""如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁查找自定义背景图或水印信息,可通过此接口查找已上传的图片信息。无需频繁查找图片信息的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中查看。
|
|
501
|
+
r"""如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁查找自定义背景图或水印信息,可通过此接口查找已上传的图片信息。无需频繁查找图片信息的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中查看。
|
|
237
502
|
|
|
238
503
|
:param request: Request instance for DescribePicture.
|
|
239
504
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribePictureRequest`
|
|
@@ -256,7 +521,7 @@ class TrtcClient(AbstractClient):
|
|
|
256
521
|
|
|
257
522
|
|
|
258
523
|
def DescribeRecordStatistic(self, request):
|
|
259
|
-
"""查询云端录制计费时长。
|
|
524
|
+
r"""查询云端录制计费时长。
|
|
260
525
|
|
|
261
526
|
- 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。
|
|
262
527
|
- 单次查询统计区间最多不能超过31天。
|
|
@@ -284,7 +549,7 @@ class TrtcClient(AbstractClient):
|
|
|
284
549
|
|
|
285
550
|
|
|
286
551
|
def DescribeRecordingUsage(self, request):
|
|
287
|
-
"""获取TRTC录制的用量明细。
|
|
552
|
+
r"""获取TRTC录制的用量明细。
|
|
288
553
|
- 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。
|
|
289
554
|
- 单次查询统计区间最多不能超过31天。
|
|
290
555
|
- 若查询当天用量,由于统计延迟等原因,返回数据可能不够准确。
|
|
@@ -312,7 +577,7 @@ class TrtcClient(AbstractClient):
|
|
|
312
577
|
|
|
313
578
|
|
|
314
579
|
def DescribeRelayUsage(self, request):
|
|
315
|
-
"""获取TRTC旁路转推的用量明细。
|
|
580
|
+
r"""获取TRTC旁路转推的用量明细。
|
|
316
581
|
- 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。
|
|
317
582
|
- 单次查询统计区间最多不能超过31天。
|
|
318
583
|
- 若查询当天用量,由于统计延迟等原因,返回数据可能不够准确。
|
|
@@ -340,7 +605,7 @@ class TrtcClient(AbstractClient):
|
|
|
340
605
|
|
|
341
606
|
|
|
342
607
|
def DescribeRoomInfo(self, request):
|
|
343
|
-
"""查询SdkAppId下的房间列表。默认返回10条通话,一次最多返回100条通话。最大可查询14天内的数据。(同老接口DescribeRoomInformation)
|
|
608
|
+
r"""查询SdkAppId下的房间列表。默认返回10条通话,一次最多返回100条通话。最大可查询14天内的数据。(同老接口DescribeRoomInformation)
|
|
344
609
|
**注意**:
|
|
345
610
|
1.该接口只用于历史数据统计或核对数据使用,实时类关键业务逻辑不能使用。
|
|
346
611
|
2.该接口自2024年4月1日起正式商业化,需订阅套餐解锁调用能力,提供以下两种解锁方式,可任意其一解锁:
|
|
@@ -368,7 +633,7 @@ class TrtcClient(AbstractClient):
|
|
|
368
633
|
|
|
369
634
|
|
|
370
635
|
def DescribeScaleInfo(self, request):
|
|
371
|
-
"""可查询SdkAppId每天的房间数和用户数,按天统计,可查询最近14天的数据。当天未结束,数据未统计完成,无法查到当天的房间数与用户数。(同老接口DescribeHistoryScale)
|
|
636
|
+
r"""可查询SdkAppId每天的房间数和用户数,按天统计,可查询最近14天的数据。当天未结束,数据未统计完成,无法查到当天的房间数与用户数。(同老接口DescribeHistoryScale)
|
|
372
637
|
|
|
373
638
|
:param request: Request instance for DescribeScaleInfo.
|
|
374
639
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribeScaleInfoRequest`
|
|
@@ -391,7 +656,7 @@ class TrtcClient(AbstractClient):
|
|
|
391
656
|
|
|
392
657
|
|
|
393
658
|
def DescribeStreamIngest(self, request):
|
|
394
|
-
"""您可以查询输入在线媒体流任务的状态。
|
|
659
|
+
r"""您可以查询输入在线媒体流任务的状态。
|
|
395
660
|
|
|
396
661
|
:param request: Request instance for DescribeStreamIngest.
|
|
397
662
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribeStreamIngestRequest`
|
|
@@ -414,7 +679,7 @@ class TrtcClient(AbstractClient):
|
|
|
414
679
|
|
|
415
680
|
|
|
416
681
|
def DescribeTRTCMarketQualityData(self, request):
|
|
417
|
-
"""查询TRTC监控仪表盘-数据大盘质量指标(包括下列指标)
|
|
682
|
+
r"""查询TRTC监控仪表盘-数据大盘质量指标(包括下列指标)
|
|
418
683
|
joinSuccessRate:加入频道成功率。
|
|
419
684
|
joinSuccessIn5sRate:5s内加入频道成功率。
|
|
420
685
|
audioFreezeRate:音频卡顿率。
|
|
@@ -445,7 +710,9 @@ class TrtcClient(AbstractClient):
|
|
|
445
710
|
|
|
446
711
|
|
|
447
712
|
def DescribeTRTCMarketQualityMetricData(self, request):
|
|
448
|
-
"""
|
|
713
|
+
r"""云监控monitor接口已下线,trtc同步下线接口
|
|
714
|
+
|
|
715
|
+
查询TRTC监控仪表盘-数据大盘质量指标(包括下列指标)
|
|
449
716
|
joinSuccessRate:加入频道成功率。
|
|
450
717
|
joinSuccessIn5sRate:5s内加入频道成功率。
|
|
451
718
|
audioFreezeRate:音频卡顿率。
|
|
@@ -476,7 +743,7 @@ class TrtcClient(AbstractClient):
|
|
|
476
743
|
|
|
477
744
|
|
|
478
745
|
def DescribeTRTCMarketScaleData(self, request):
|
|
479
|
-
"""查询TRTC监控仪表盘-数据大盘规模指标(会返回通话人数,通话房间数,峰值同时在线人数,峰值同时在线频道数)
|
|
746
|
+
r"""查询TRTC监控仪表盘-数据大盘规模指标(会返回通话人数,通话房间数,峰值同时在线人数,峰值同时在线频道数)
|
|
480
747
|
userCount:通话人数,
|
|
481
748
|
roomCount:通话房间数,从有用户加入频道到所有用户离开频道计为一个通话频道。
|
|
482
749
|
peakCurrentChannels:峰值同时在线频道数。
|
|
@@ -506,7 +773,9 @@ class TrtcClient(AbstractClient):
|
|
|
506
773
|
|
|
507
774
|
|
|
508
775
|
def DescribeTRTCMarketScaleMetricData(self, request):
|
|
509
|
-
"""
|
|
776
|
+
r"""云监控monitor接口已下线,trtc同步下线接口
|
|
777
|
+
|
|
778
|
+
查询TRTC监控仪表盘-数据大盘规模指标(会返回通话人数,通话房间数,峰值同时在线人数,峰值同时在线频道数)
|
|
510
779
|
userCount:通话人数,
|
|
511
780
|
roomCount:通话房间数,从有用户加入频道到所有用户离开频道计为一个通话频道。
|
|
512
781
|
peakCurrentChannels:峰值同时在线频道数。
|
|
@@ -536,11 +805,11 @@ class TrtcClient(AbstractClient):
|
|
|
536
805
|
|
|
537
806
|
|
|
538
807
|
def DescribeTRTCRealTimeQualityData(self, request):
|
|
539
|
-
"""查询TRTC监控仪表盘-实时监控质量指标(会返回下列指标)
|
|
808
|
+
r"""查询TRTC监控仪表盘-实时监控质量指标(会返回下列指标)
|
|
540
809
|
-视频卡顿率
|
|
541
810
|
-音频卡顿率
|
|
542
811
|
注意:
|
|
543
|
-
1
|
|
812
|
+
1.调用接口需开通监控仪表盘【基础版】和【进阶版】,监控仪表盘【免费版】不支持调用,详情参考[监控仪表盘](https://cloud.tencent.com/document/product/647/81331)。
|
|
544
813
|
2.查询时间范围根据监控仪表盘功能版本而定,基础版可查近3小时,进阶版可查近12小时。
|
|
545
814
|
|
|
546
815
|
:param request: Request instance for DescribeTRTCRealTimeQualityData.
|
|
@@ -564,7 +833,9 @@ class TrtcClient(AbstractClient):
|
|
|
564
833
|
|
|
565
834
|
|
|
566
835
|
def DescribeTRTCRealTimeQualityMetricData(self, request):
|
|
567
|
-
"""
|
|
836
|
+
r"""云监控monitor接口已下线,trtc同步下线接口
|
|
837
|
+
|
|
838
|
+
查询TRTC监控仪表盘-实时监控质量指标(会返回下列指标)
|
|
568
839
|
-视频卡顿率
|
|
569
840
|
-音频卡顿率
|
|
570
841
|
注意:
|
|
@@ -592,13 +863,12 @@ class TrtcClient(AbstractClient):
|
|
|
592
863
|
|
|
593
864
|
|
|
594
865
|
def DescribeTRTCRealTimeScaleData(self, request):
|
|
595
|
-
"""查询TRTC监控仪表盘-实时监控规模指标(会返回下列指标)
|
|
866
|
+
r"""查询TRTC监控仪表盘-实时监控规模指标(会返回下列指标)
|
|
596
867
|
-userCount(在线用户数)
|
|
597
868
|
-roomCount(在线房间数)
|
|
598
869
|
注意:
|
|
599
|
-
1
|
|
870
|
+
1.调用接口需开通监控仪表盘【基础版】和【进阶版】,监控仪表盘【免费版】不支持调用,详情参考[监控仪表盘](https://cloud.tencent.com/document/product/647/81331)。
|
|
600
871
|
2.查询时间范围根据监控仪表盘功能版本而定,基础版可查近3小时,进阶版可查近12小时。
|
|
601
|
-
3.除此之外您也可以通过[订阅TRTC包月套餐](https://buy.cloud.tencent.com/trtc)尊享版或旗舰版解锁此接口的调用能力,请在开通包月套餐后,请[提交工单](https://console.cloud.tencent.com/workorder/category)联系售后解锁调用能力
|
|
602
872
|
|
|
603
873
|
:param request: Request instance for DescribeTRTCRealTimeScaleData.
|
|
604
874
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribeTRTCRealTimeScaleDataRequest`
|
|
@@ -621,7 +891,7 @@ class TrtcClient(AbstractClient):
|
|
|
621
891
|
|
|
622
892
|
|
|
623
893
|
def DescribeTRTCRealTimeScaleMetricData(self, request):
|
|
624
|
-
"""查询TRTC监控仪表盘-实时监控规模指标(会返回下列指标)
|
|
894
|
+
r"""查询TRTC监控仪表盘-实时监控规模指标(会返回下列指标)
|
|
625
895
|
-userCount(在线用户数)
|
|
626
896
|
-roomCount(在线房间数)
|
|
627
897
|
注意:
|
|
@@ -651,7 +921,7 @@ class TrtcClient(AbstractClient):
|
|
|
651
921
|
|
|
652
922
|
|
|
653
923
|
def DescribeTrtcMcuTranscodeTime(self, request):
|
|
654
|
-
"""查询旁路转码计费时长。
|
|
924
|
+
r"""查询旁路转码计费时长。
|
|
655
925
|
- 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。
|
|
656
926
|
- 单次查询统计区间最多不能超过31天。
|
|
657
927
|
- 若查询当天用量,由于统计延迟等原因,返回数据可能不够准确。
|
|
@@ -678,7 +948,7 @@ class TrtcClient(AbstractClient):
|
|
|
678
948
|
|
|
679
949
|
|
|
680
950
|
def DescribeTrtcRoomUsage(self, request):
|
|
681
|
-
"""查询TRTC音视频房间维度用量。
|
|
951
|
+
r"""查询TRTC音视频房间维度用量。
|
|
682
952
|
- 单次只能查询一天数据,返回查询时间段内的汇总数据;通过多次查询可以查不同天数据。若查询跨天用量,由于统计延迟等原因,返回数据可能不够准确。
|
|
683
953
|
- 该接口只用于历史用量数据统计或核对数据使用,关键业务逻辑不能使用,不可用于账单核对,如需对账请使用账号/应用维度用量API:DescribeTrtcUsage。
|
|
684
954
|
- 默认接口请求频率限制:1次/15秒。
|
|
@@ -705,7 +975,7 @@ class TrtcClient(AbstractClient):
|
|
|
705
975
|
|
|
706
976
|
|
|
707
977
|
def DescribeTrtcUsage(self, request):
|
|
708
|
-
"""获取TRTC
|
|
978
|
+
r"""获取TRTC音视频互动的用量明细,单位:分钟。
|
|
709
979
|
- 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。
|
|
710
980
|
- 单次查询统计区间最多不能超过31天。
|
|
711
981
|
- 若查询当天用量,由于统计延迟等原因,返回数据可能不够准确。
|
|
@@ -733,7 +1003,7 @@ class TrtcClient(AbstractClient):
|
|
|
733
1003
|
|
|
734
1004
|
|
|
735
1005
|
def DescribeUnusualEvent(self, request):
|
|
736
|
-
"""查询SdkAppId下任意20条异常体验事件,返回异常体验ID与可能产生异常体验的原因。可查询14天内数据,查询起止时间不超过1个小时。支持跨天查询。(同老接口DescribeAbnormalEvent)
|
|
1006
|
+
r"""查询SdkAppId下任意20条异常体验事件,返回异常体验ID与可能产生异常体验的原因。可查询14天内数据,查询起止时间不超过1个小时。支持跨天查询。(同老接口DescribeAbnormalEvent)
|
|
737
1007
|
异常体验ID映射见:https://cloud.tencent.com/document/product/647/44916
|
|
738
1008
|
|
|
739
1009
|
:param request: Request instance for DescribeUnusualEvent.
|
|
@@ -757,7 +1027,7 @@ class TrtcClient(AbstractClient):
|
|
|
757
1027
|
|
|
758
1028
|
|
|
759
1029
|
def DescribeUserEvent(self, request):
|
|
760
|
-
"""查询用户某次通话内的进退房,视频开关等详细事件。可查询14天内数据。(同接口DescribeDetailEvent)
|
|
1030
|
+
r"""查询用户某次通话内的进退房,视频开关等详细事件。可查询14天内数据。(同接口DescribeDetailEvent)
|
|
761
1031
|
|
|
762
1032
|
:param request: Request instance for DescribeUserEvent.
|
|
763
1033
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribeUserEventRequest`
|
|
@@ -780,7 +1050,7 @@ class TrtcClient(AbstractClient):
|
|
|
780
1050
|
|
|
781
1051
|
|
|
782
1052
|
def DescribeUserInfo(self, request):
|
|
783
|
-
"""查询指定时间内的用户列表,最大可查询14天内数据,查询起止时间不超过4小时。默认每页查询6个用户,支持每页最大查询100个用户PageSize不超过100)。(同老接口DescribeUserInformation)
|
|
1053
|
+
r"""查询指定时间内的用户列表,最大可查询14天内数据,查询起止时间不超过4小时。默认每页查询6个用户,支持每页最大查询100个用户PageSize不超过100)。(同老接口DescribeUserInformation)
|
|
784
1054
|
**注意**:
|
|
785
1055
|
1.该接口只用于历史数据统计或核对数据使用,实时类关键业务逻辑不能使用。
|
|
786
1056
|
2.该接口自2024年4月1日起正式商业化,需订阅套餐解锁调用能力,提供以下两种解锁方式,可任选其一解锁:
|
|
@@ -807,8 +1077,31 @@ class TrtcClient(AbstractClient):
|
|
|
807
1077
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
808
1078
|
|
|
809
1079
|
|
|
1080
|
+
def DescribeVoicePrint(self, request):
|
|
1081
|
+
r"""查询先前注册的声纹信息
|
|
1082
|
+
|
|
1083
|
+
:param request: Request instance for DescribeVoicePrint.
|
|
1084
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribeVoicePrintRequest`
|
|
1085
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.DescribeVoicePrintResponse`
|
|
1086
|
+
|
|
1087
|
+
"""
|
|
1088
|
+
try:
|
|
1089
|
+
params = request._serialize()
|
|
1090
|
+
headers = request.headers
|
|
1091
|
+
body = self.call("DescribeVoicePrint", params, headers=headers)
|
|
1092
|
+
response = json.loads(body)
|
|
1093
|
+
model = models.DescribeVoicePrintResponse()
|
|
1094
|
+
model._deserialize(response["Response"])
|
|
1095
|
+
return model
|
|
1096
|
+
except Exception as e:
|
|
1097
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1098
|
+
raise
|
|
1099
|
+
else:
|
|
1100
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1101
|
+
|
|
1102
|
+
|
|
810
1103
|
def DescribeWebRecord(self, request):
|
|
811
|
-
"""查询页面录制任务
|
|
1104
|
+
r"""查询页面录制任务
|
|
812
1105
|
|
|
813
1106
|
:param request: Request instance for DescribeWebRecord.
|
|
814
1107
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DescribeWebRecordRequest`
|
|
@@ -831,7 +1124,7 @@ class TrtcClient(AbstractClient):
|
|
|
831
1124
|
|
|
832
1125
|
|
|
833
1126
|
def DismissRoom(self, request):
|
|
834
|
-
"""接口说明:把房间所有用户从房间移出,解散房间。支持所有平台,Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
|
|
1127
|
+
r"""接口说明:把房间所有用户从房间移出,解散房间。支持所有平台,Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
|
|
835
1128
|
|
|
836
1129
|
:param request: Request instance for DismissRoom.
|
|
837
1130
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DismissRoomRequest`
|
|
@@ -854,7 +1147,7 @@ class TrtcClient(AbstractClient):
|
|
|
854
1147
|
|
|
855
1148
|
|
|
856
1149
|
def DismissRoomByStrRoomId(self, request):
|
|
857
|
-
"""接口说明:把房间所有用户从房间移出,解散房间。支持所有平台,Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
|
|
1150
|
+
r"""接口说明:把房间所有用户从房间移出,解散房间。支持所有平台,Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
|
|
858
1151
|
|
|
859
1152
|
:param request: Request instance for DismissRoomByStrRoomId.
|
|
860
1153
|
:type request: :class:`tencentcloud.trtc.v20190722.models.DismissRoomByStrRoomIdRequest`
|
|
@@ -876,8 +1169,31 @@ class TrtcClient(AbstractClient):
|
|
|
876
1169
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
877
1170
|
|
|
878
1171
|
|
|
1172
|
+
def ModifyCloudModeration(self, request):
|
|
1173
|
+
r"""成功开启云端审核任务后,可以使用此接口来更新订阅黑白名单。
|
|
1174
|
+
|
|
1175
|
+
:param request: Request instance for ModifyCloudModeration.
|
|
1176
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.ModifyCloudModerationRequest`
|
|
1177
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.ModifyCloudModerationResponse`
|
|
1178
|
+
|
|
1179
|
+
"""
|
|
1180
|
+
try:
|
|
1181
|
+
params = request._serialize()
|
|
1182
|
+
headers = request.headers
|
|
1183
|
+
body = self.call("ModifyCloudModeration", params, headers=headers)
|
|
1184
|
+
response = json.loads(body)
|
|
1185
|
+
model = models.ModifyCloudModerationResponse()
|
|
1186
|
+
model._deserialize(response["Response"])
|
|
1187
|
+
return model
|
|
1188
|
+
except Exception as e:
|
|
1189
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1190
|
+
raise
|
|
1191
|
+
else:
|
|
1192
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1193
|
+
|
|
1194
|
+
|
|
879
1195
|
def ModifyCloudRecording(self, request):
|
|
880
|
-
"""成功开启录制后,可以使用此接口来更新录制任务。仅在录制任务进行时有效,录制退出后更新将会返回错误。更新操作是全量覆盖,并不是增量更新的模式,也就是说每次更新都需要携带全量的信息。
|
|
1196
|
+
r"""成功开启录制后,可以使用此接口来更新录制任务。仅在录制任务进行时有效,录制退出后更新将会返回错误。更新操作是全量覆盖,并不是增量更新的模式,也就是说每次更新都需要携带全量的信息。
|
|
881
1197
|
|
|
882
1198
|
:param request: Request instance for ModifyCloudRecording.
|
|
883
1199
|
:type request: :class:`tencentcloud.trtc.v20190722.models.ModifyCloudRecordingRequest`
|
|
@@ -899,8 +1215,31 @@ class TrtcClient(AbstractClient):
|
|
|
899
1215
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
900
1216
|
|
|
901
1217
|
|
|
1218
|
+
def ModifyCloudSliceTask(self, request):
|
|
1219
|
+
r"""成功开启切片任务后,可以使用此接口来更新任务。用于更新指定订阅流白名单或者黑名单。
|
|
1220
|
+
|
|
1221
|
+
:param request: Request instance for ModifyCloudSliceTask.
|
|
1222
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.ModifyCloudSliceTaskRequest`
|
|
1223
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.ModifyCloudSliceTaskResponse`
|
|
1224
|
+
|
|
1225
|
+
"""
|
|
1226
|
+
try:
|
|
1227
|
+
params = request._serialize()
|
|
1228
|
+
headers = request.headers
|
|
1229
|
+
body = self.call("ModifyCloudSliceTask", params, headers=headers)
|
|
1230
|
+
response = json.loads(body)
|
|
1231
|
+
model = models.ModifyCloudSliceTaskResponse()
|
|
1232
|
+
model._deserialize(response["Response"])
|
|
1233
|
+
return model
|
|
1234
|
+
except Exception as e:
|
|
1235
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1236
|
+
raise
|
|
1237
|
+
else:
|
|
1238
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1239
|
+
|
|
1240
|
+
|
|
902
1241
|
def ModifyPicture(self, request):
|
|
903
|
-
"""如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁修改自定义背景图或水印素材,可通过此接口修改已上传的图片。无需频繁修改图片素材的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
|
|
1242
|
+
r"""如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁修改自定义背景图或水印素材,可通过此接口修改已上传的图片。无需频繁修改图片素材的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
|
|
904
1243
|
|
|
905
1244
|
:param request: Request instance for ModifyPicture.
|
|
906
1245
|
:type request: :class:`tencentcloud.trtc.v20190722.models.ModifyPictureRequest`
|
|
@@ -922,8 +1261,31 @@ class TrtcClient(AbstractClient):
|
|
|
922
1261
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
923
1262
|
|
|
924
1263
|
|
|
1264
|
+
def RegisterVoicePrint(self, request):
|
|
1265
|
+
r"""传入音频base64串,注册声纹信息,返回声纹ID
|
|
1266
|
+
|
|
1267
|
+
:param request: Request instance for RegisterVoicePrint.
|
|
1268
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.RegisterVoicePrintRequest`
|
|
1269
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.RegisterVoicePrintResponse`
|
|
1270
|
+
|
|
1271
|
+
"""
|
|
1272
|
+
try:
|
|
1273
|
+
params = request._serialize()
|
|
1274
|
+
headers = request.headers
|
|
1275
|
+
body = self.call("RegisterVoicePrint", params, headers=headers)
|
|
1276
|
+
response = json.loads(body)
|
|
1277
|
+
model = models.RegisterVoicePrintResponse()
|
|
1278
|
+
model._deserialize(response["Response"])
|
|
1279
|
+
return model
|
|
1280
|
+
except Exception as e:
|
|
1281
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1282
|
+
raise
|
|
1283
|
+
else:
|
|
1284
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1285
|
+
|
|
1286
|
+
|
|
925
1287
|
def RemoveUser(self, request):
|
|
926
|
-
"""接口说明:将用户从房间移出,适用于主播/房主/管理员踢人等场景。支持所有平台,Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
|
|
1288
|
+
r"""接口说明:将用户从房间移出,适用于主播/房主/管理员踢人等场景。支持所有平台,Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
|
|
927
1289
|
|
|
928
1290
|
:param request: Request instance for RemoveUser.
|
|
929
1291
|
:type request: :class:`tencentcloud.trtc.v20190722.models.RemoveUserRequest`
|
|
@@ -946,7 +1308,7 @@ class TrtcClient(AbstractClient):
|
|
|
946
1308
|
|
|
947
1309
|
|
|
948
1310
|
def RemoveUserByStrRoomId(self, request):
|
|
949
|
-
"""接口说明:将用户从房间移出,适用于主播/房主/管理员踢人等场景。支持所有平台,Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
|
|
1311
|
+
r"""接口说明:将用户从房间移出,适用于主播/房主/管理员踢人等场景。支持所有平台,Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
|
|
950
1312
|
|
|
951
1313
|
:param request: Request instance for RemoveUserByStrRoomId.
|
|
952
1314
|
:type request: :class:`tencentcloud.trtc.v20190722.models.RemoveUserByStrRoomIdRequest`
|
|
@@ -968,8 +1330,42 @@ class TrtcClient(AbstractClient):
|
|
|
968
1330
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
969
1331
|
|
|
970
1332
|
|
|
1333
|
+
def StartAIConversation(self, request):
|
|
1334
|
+
r"""启动AI对话任务,AI通道机器人进入TRTC房间,与房间内指定的成员进行AI对话,适用于智能客服,AI口语教师等场景
|
|
1335
|
+
|
|
1336
|
+
TRTC AI对话功能内置语音转文本能力,同时提供通道服务,即客户可灵活指定第三方AI模型(LLM)服务和文本转音频(TTS)服务,更多[功能说明](https://cloud.tencent.com/document/product/647/108901)。
|
|
1337
|
+
|
|
1338
|
+
:param request: Request instance for StartAIConversation.
|
|
1339
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.StartAIConversationRequest`
|
|
1340
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.StartAIConversationResponse`
|
|
1341
|
+
|
|
1342
|
+
"""
|
|
1343
|
+
try:
|
|
1344
|
+
params = request._serialize()
|
|
1345
|
+
headers = request.headers
|
|
1346
|
+
body = self.call("StartAIConversation", params, headers=headers)
|
|
1347
|
+
response = json.loads(body)
|
|
1348
|
+
model = models.StartAIConversationResponse()
|
|
1349
|
+
model._deserialize(response["Response"])
|
|
1350
|
+
return model
|
|
1351
|
+
except Exception as e:
|
|
1352
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1353
|
+
raise
|
|
1354
|
+
else:
|
|
1355
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1356
|
+
|
|
1357
|
+
|
|
971
1358
|
def StartAITranscription(self, request):
|
|
972
|
-
"""
|
|
1359
|
+
r"""启动转录机器人,后台会通过机器人拉流进行实时进行语音识别并下发字幕和转录消息。
|
|
1360
|
+
转录机器人支持两种拉流方式,通过TranscriptionMode字段控制:
|
|
1361
|
+
- 拉取全房间的流。
|
|
1362
|
+
- 拉取特定用户的流。
|
|
1363
|
+
|
|
1364
|
+
服务端通过TRTC的自定义消息实时下发字幕以及转录消息,CmdId固定是1。客户端只需监听自定义消息的回调即可,比如[c++回调](https://cloud.tencent.com/document/product/647/79637#4cd82f4edb24992a15a25187089e1565)。其他客户端比如安卓、Web等同样可在该链接处找到。
|
|
1365
|
+
|
|
1366
|
+
|
|
1367
|
+
**注意:**
|
|
1368
|
+
TranscriptionMode为0时,需要保证一个房间内只发起一个任务,如果发起多个任务,则机器人之间会相互订阅,除非主动停止任务,否则只有10小时后任务才会超时退出,这种情况下建议填写SessionId,保证后续重复发起的任务失败。
|
|
973
1369
|
|
|
974
1370
|
:param request: Request instance for StartAITranscription.
|
|
975
1371
|
:type request: :class:`tencentcloud.trtc.v20190722.models.StartAITranscriptionRequest`
|
|
@@ -992,7 +1388,7 @@ class TrtcClient(AbstractClient):
|
|
|
992
1388
|
|
|
993
1389
|
|
|
994
1390
|
def StartMCUMixTranscode(self, request):
|
|
995
|
-
"""接口说明:启动云端混流,并指定混流画面中各路画面的布局位置。
|
|
1391
|
+
r"""接口说明:启动云端混流,并指定混流画面中各路画面的布局位置。
|
|
996
1392
|
|
|
997
1393
|
TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过此 API 接口,通知腾讯云服务端将多路视频画面合成一路,并指定每一路画面的位置,同时将多路声音进行混音,最终形成一路音视频流,以便用于录制和直播观看。房间销毁后混流自动结束。
|
|
998
1394
|
|
|
@@ -1035,7 +1431,7 @@ class TrtcClient(AbstractClient):
|
|
|
1035
1431
|
|
|
1036
1432
|
|
|
1037
1433
|
def StartMCUMixTranscodeByStrRoomId(self, request):
|
|
1038
|
-
"""接口说明:启动云端混流,并指定混流画面中各路画面的布局位置。
|
|
1434
|
+
r"""接口说明:启动云端混流,并指定混流画面中各路画面的布局位置。
|
|
1039
1435
|
|
|
1040
1436
|
TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过此 API 接口,通知腾讯云服务端将多路视频画面合成一路,并指定每一路画面的位置,同时将多路声音进行混音,最终形成一路音视频流,以便用于录制和直播观看。
|
|
1041
1437
|
|
|
@@ -1078,102 +1474,14 @@ class TrtcClient(AbstractClient):
|
|
|
1078
1474
|
|
|
1079
1475
|
|
|
1080
1476
|
def StartPublishCdnStream(self, request):
|
|
1081
|
-
"""
|
|
1082
|
-
|
|
1083
|
-
|
|
1084
|
-
|
|
1085
|
-
|
|
1086
|
-
|
|
1087
|
-
|
|
1088
|
-
|
|
1089
|
-
1、设置最终混流的画质和音质,包括视频分辨率、视频帧率、视频码率,和音频质量。
|
|
1090
|
-
2、设置每一路画面的布局位置,您只需要设置一次,后续您指定的混流用户进房上行音视频时,排版引擎会自动将该用户的画面混合到您指定的布局位置。同时您可以使用更新接口调整画面的布局位置。
|
|
1091
|
-
3、设置多个cdn转推的目的地址,一个转推任务最多可以同时设置10个cdn转推地址,如果您需要转推非腾讯云的cdn地址时,需要联系腾讯云开通能力。
|
|
1092
|
-
4、设置多个回推房间列表,一个转推任务最多可以同时将混流回推到10个TRTC房间。
|
|
1093
|
-
|
|
1094
|
-
目前已经支持如下几种布局模版,其中动态布局模版(悬浮模板、九宫格模板、屏幕分享模板)只支持单个TRTC房间,自定义模版支持混合多个TRTC房间内的音视频流。具体说明如下:
|
|
1095
|
-
1、悬浮模板:第一个进入房间的用户的视频画面会铺满整个屏幕,其他用户的视频画面从左下角依次水平排列,显示为小画面,最多4行,每行4个,小画面悬浮于大画面之上。最多支持1个大画面和15个小画面,如果用户只发送音频默认不占布局配置,也支持设置。每个子画面默认采用居中裁剪的方式进行渲染,也支持统一设置子画面的渲染方式。
|
|
1096
|
-
2、九宫格模板:所有用户的视频画面大小一致,平分整个屏幕,人数越多,每个画面的尺寸越小。最多支持16个画面,如果用户只发送音频,默认不占布局配置,也支持设置。每个子画面默认采用居中裁剪的方式进行渲染,也支持统一设置子画面的渲染方式。
|
|
1097
|
-
3、屏幕分享模板:适合视频会议和在线教育场景的布局,屏幕分享(或者主讲的摄像头)始终占据屏幕左侧的大画面位置,需要您明确设置占据大画面的混流用户信息。其他用户依次垂直排列于右侧,最多两列,每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时,左侧大画面为了保持内容的完整性采用缩放方式处理,右侧小画面采用裁剪方式处理,也支持统一设置子画面的渲染方式。
|
|
1098
|
-
4、自定义布局模版:支持您主动根据业务需要设置布局位置,每个预设的布局位置支持具名设置(具名设置需要明确指定房间号和用户名)和不具名设置。当一个子画面具名设置时,该位置就为该用户预留,用户进房且上行音视频数据时会自动占据该位置,其它用户不会占据该位置。当预设的布局位置未具名时,排版引擎会根据进房间顺序自动填充,预设位置填满时,不再混合其它用户的画面和声音。每个子画面位置支持设置占位图(BackgroundImageUrl),当用户未进房或者只上行音频数据时,该位置画面可显示对应的占位图画面。
|
|
1099
|
-
|
|
1100
|
-
您可以控制台开通旁路转推回调功能实现转推cdn状态的事件监控,具体说明请参考官网文档:[旁路转推回调说明](https://cloud.tencent.com/document/product/647/88552)
|
|
1101
|
-
您使用转推api时根据使用特性可能会产生如下费用:
|
|
1102
|
-
MCU混流转码费用请参考文档:[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)
|
|
1103
|
-
转推非腾讯云CDN费用请参考文档:[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)
|
|
1104
|
-
|
|
1105
|
-
参数的使用说明:
|
|
1106
|
-
1、AgentParams:每个转推任务会拉起一个机器人用户进入TRTC房间进行拉流,您需要通过AgentParams.UserId参数进行设置,这个机器人id不能和房间中的普通用户id冲突,否则会导致转推任务由于机器人用户被踢出TRTC房间而异常结束,您可以通过增加特殊前缀的方式规避。您可以通过设置AgentParams.MaxIdleTime控制转推任务的自动结束,当设置此参数时,所有参与混流转推的主播持续离开TRTC房间超过MaxIdleTime的时长,自动停止转推任务。注意:参与混流转推的主播仅是停止音视频上行,转推任务不会自动停止。
|
|
1107
|
-
2、WithTranscoding:如果需要将多路音视频流混合到一路时,WithTranscoding必须设置为1。
|
|
1108
|
-
3、AudioParams:转推任务音频参数和视频参数是分开设置的,若您想要将指定的用户音频进行混音时,需要明确设置AudioParams.SubscribeAudioList。若您不设置AudioParams.SubscribeAudioList,混音引擎会自动将TRTC房间中所有用户的音频混合。若您想要混合TRTC房间除指定用户之外的所有用户的声音,可以通过AudioParams.UnSubscribeAudioList设置音频黑名单列表。
|
|
1109
|
-
4、VideoParams:若您想要将用户的视频混合,可以通过VideoParams设置,若只想要混纯音频,则不用设置VideoParams参数。您可以通过VideoParams.LayoutParams.MixLayoutMode设置画面的布局模式,包括:动态布局(1:悬浮布局(默认),2:屏幕分享布局,3:九宫格布局)和自定义布局。动态布局模式由排版引擎按照固定的布局自动混合,不需要设置VideoParams.LayoutParams.MixLayoutList。当使用悬浮布局和屏幕分享布局时,您可以通过设置VideoParams.LayoutParams.MaxVideoUser参数指定大画面用户。自定义布局模式提供给您自主布局画面的能力,可以通过VideoParams.LayoutParams.MixLayoutList参数指定每个用户所在的布局位置。在每个布局参数中,您可以通过用户媒体流参数(UserMediaStream)指定这个布局位置为指定的用户预留,也可以不设置UserMediaStream,由排版引擎按照用户进入TRTC房间的顺序自动填充,另外您也可以设置每个布局位置的渲染方式(RenderMode)和裁剪方式(CustomCrop)。
|
|
1110
|
-
5、VideoParams.WaterMarkList:若您想要混流画面中叠加水印,可以通过VideoParams.WaterMarkList参数设置,支持图片水印和文字水印,支持透明通道。
|
|
1111
|
-
6、SingleSubscribeParams:若您想要将TRTC房间中的一路单流推到CDN,可以使用SingleSubscribeParams参数设置,此时需要将WithTranscoding参数设置为0。
|
|
1112
|
-
7、PublishCdnParams.N:若您想要推流到CDN,可以使用PublishCdnParams.N参数设置,支持最多同时推流到10个CDN地址。若转推地址是腾讯云CDN时,请将IsTencentCdn明确设置为1;若您有转推非腾讯云CDN的需求时,请联系腾讯云技术支持开通,转推非腾讯云会产生转推费用,费用说明请参考官网文档:[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)。
|
|
1113
|
-
8、FeedBackRoomParams.N:若您想要将混合的音视频流回推到TRTC房间,可以使用FeedBackRoomParams.N参数设置,支持最多同时推10路流回TRTC房间。您需要指定回推的TRTC房间号和机器人ID(UserId),机器人ID不能与普通用户ID冲突,否则会导致转推任务由于机器人用户被踢出TRTC房间而异常结束,您可以通过增加特殊前缀的方式规避。
|
|
1114
|
-
9、SeiParams:若您想要混合的音视频流中增加SEI信息时,可以使用SeiParams参数设置,支持音量布局SEI和叠加转推请求中的SEI,其中音量布局SEI的内容是固定的json结构,具体请看本章节后续的SEI说明。您可以通过FollowIdr参数设置SEI跟随关键帧一起发送。音量布局sei的说明如下:
|
|
1115
|
-
如果您的CDN观众端需要识别到参与混流的主播位置,以及需要识别到参与混流的主播的音量信息,可以通过音量布局sei实现。音量布局sei的payload内容及参数说明如下:
|
|
1116
|
-
|
|
1117
|
-
```
|
|
1118
|
-
{
|
|
1119
|
-
"app_data":"",
|
|
1120
|
-
"canvas":{
|
|
1121
|
-
"w":1080,
|
|
1122
|
-
"h":960
|
|
1123
|
-
},
|
|
1124
|
-
"regions":[
|
|
1125
|
-
{
|
|
1126
|
-
"uid":"65949987242835883c",
|
|
1127
|
-
"zorder":2,
|
|
1128
|
-
"volume":45,
|
|
1129
|
-
"x":270,
|
|
1130
|
-
"y":480,
|
|
1131
|
-
"w":540,
|
|
1132
|
-
"h":480
|
|
1133
|
-
},
|
|
1134
|
-
{
|
|
1135
|
-
"uid":"659c9d8d242b328d31",
|
|
1136
|
-
"zorder":2,
|
|
1137
|
-
"volume":0,
|
|
1138
|
-
"x":0,
|
|
1139
|
-
"y":0,
|
|
1140
|
-
"w":540,
|
|
1141
|
-
"h":480
|
|
1142
|
-
},
|
|
1143
|
-
{
|
|
1144
|
-
"uid":"64989a82272b308c",
|
|
1145
|
-
"zorder":2,
|
|
1146
|
-
"volume":91,
|
|
1147
|
-
"x":540,
|
|
1148
|
-
"y":0,
|
|
1149
|
-
"w":540,
|
|
1150
|
-
"h":480
|
|
1151
|
-
}
|
|
1152
|
-
],
|
|
1153
|
-
"ver":"1.0",
|
|
1154
|
-
"ts":1648544726
|
|
1155
|
-
}
|
|
1156
|
-
```
|
|
1157
|
-
canvas:这个是混流信令中VideoEncode设置的宽高,即:混流输出的整个画布宽高。
|
|
1158
|
-
regions:里面是真实混入的用户id和对应的子画面位置,若参与混流的用户未进入TRTC房间或者未开启视频上行,regions中不会包含该用户。
|
|
1159
|
-
uid:代表参与混流的用户ID。
|
|
1160
|
-
zorder:参与混流userid在混流输出的层级。
|
|
1161
|
-
x/y:参与混流userid的子画面在画布的坐标。
|
|
1162
|
-
w/h:参与混流userid的子画面的大小。
|
|
1163
|
-
volume:代表混流用户的音量,取值范围为0-100,值越大,代表该用户参与混流时的音量越大。
|
|
1164
|
-
ts:是输出sei的服务器本地秒级时戳。
|
|
1165
|
-
ver:可以忽略。
|
|
1166
|
-
|
|
1167
|
-
其它使用注意事项:
|
|
1168
|
-
1、使用混流转推接口时,您需要先调用启动转推任务接口(StartPublishCdnStream),获取启动转推任务响应中的任务ID标识(TaskId)。后续传入任务ID标识(TaskId)来更新转推任务(UpdatePublishCdnStream)和停止转推任务(StopPublishCdnStream)。
|
|
1169
|
-
2、转推API不支持发起到TRTC控制台配置的自动旁路任务,以及通过TRTC SDK进房接口中设置的自定义流ID的旁路任务。
|
|
1170
|
-
3、为了确保转推链接的稳定,同一个转推任务不支持纯音频、音视频、纯视频之间的切换。
|
|
1171
|
-
4、为了确保转推链接的稳定,不支持update时更新视频参数(codec)和音频参数(codec、采样率、码率、声道数)。
|
|
1172
|
-
5、发起单流旁路任务时,AudioParams和VideoParams都填写表示音视频旁路,如果仅填写AudioParams表示纯音频旁路,任务进行过程中不支持纯音频到音视频的切换。音视频旁路时,VideoParams中的Width、Height、Fps、BitRate、Gop需要按照真实上行参数填写。
|
|
1173
|
-
6、更新请求中必须携带SequenceNumber参数,用于防止请求乱序。客户保证对同一个任务更新时的SequenceNumber参数递增,否则会导致混流任务更新失败。
|
|
1174
|
-
7、调用api时region选择说明:如果应用id是1400xxx时,region可填北京、上海、广州、香港,如果您的cdn观众主要在海外,请选择香港;如果应用id是200xxx或400xxx时,region请选择新加坡。
|
|
1175
|
-
8、回推到TRTC房间的流不会参与其他回推房间任务的混流,满足下面条件之一时,可以参与其他转推cdn任务的混流: (1) 转推cdn任务在视频参数中通过具名方式指定推流机器人参与混流;(2) 转推cdn任务在音频参数中通过白名单方式指定推流机器人参与混流;(3) 转推cdn任务参与混流用户的房间号与回推机器人对应混流用户的房间号完全不同。
|
|
1176
|
-
9、您可以在主播进房前,提前创建转推任务,结束转推任务时需要主动调用停止接口。如果您没有调用停止转推任务接口时,腾讯云后台会按照所有参与混流的用户没有任何数据上行的时间算起,直到超过启动转推任务时设置的超时时间(AgentParams.MaxIdleTime)为止,自动停止混流转推任务。
|
|
1477
|
+
r"""接口说明:
|
|
1478
|
+
启动一个混流转推任务,将 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)
|
|
1479
|
+
|
|
1480
|
+
注意:
|
|
1481
|
+
您可以在控制台开通旁路转推回调功能,对转推 CDN 状态的事件进行监控,回调请参考文档:[旁路转推回调说明](https://cloud.tencent.com/document/product/647/88552)
|
|
1482
|
+
您发起混流转推任务时,可能会产生如下费用:
|
|
1483
|
+
MCU 混流转码费用,请参考文档:[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)
|
|
1484
|
+
转推非腾讯云 CDN 费用,请参考文档:[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)
|
|
1177
1485
|
|
|
1178
1486
|
:param request: Request instance for StartPublishCdnStream.
|
|
1179
1487
|
:type request: :class:`tencentcloud.trtc.v20190722.models.StartPublishCdnStreamRequest`
|
|
@@ -1196,9 +1504,8 @@ class TrtcClient(AbstractClient):
|
|
|
1196
1504
|
|
|
1197
1505
|
|
|
1198
1506
|
def StartStreamIngest(self, request):
|
|
1199
|
-
"""将一个在线媒体流推到TRTC
|
|
1200
|
-
|
|
1201
|
-
)
|
|
1507
|
+
r"""将一个在线媒体流推到TRTC房间,更多功能说明见[输入媒体流进房](https://cloud.tencent.com/document/product/647/102957#50940aad-d90f-4473-9f46-d5dd46917653)。
|
|
1508
|
+
使用输入在线媒体流功能需先订阅 [尊享版或旗舰版套餐包](https://cloud.tencent.com/document/product/647/85386) 解锁能力位。
|
|
1202
1509
|
|
|
1203
1510
|
:param request: Request instance for StartStreamIngest.
|
|
1204
1511
|
:type request: :class:`tencentcloud.trtc.v20190722.models.StartStreamIngestRequest`
|
|
@@ -1221,7 +1528,7 @@ class TrtcClient(AbstractClient):
|
|
|
1221
1528
|
|
|
1222
1529
|
|
|
1223
1530
|
def StartWebRecord(self, request):
|
|
1224
|
-
"""通过此接口可以发起 WEB 页面录制任务,在接口参数中指定录制 URL,录制分辨率,录制结果存储等参数。
|
|
1531
|
+
r"""通过此接口可以发起 WEB 页面录制任务,在接口参数中指定录制 URL,录制分辨率,录制结果存储等参数。
|
|
1225
1532
|
因为参数或API逻辑问题会立即返回结果。而因为页面问题,如页面无法访问,会在回调中返回结果,请关注。
|
|
1226
1533
|
|
|
1227
1534
|
:param request: Request instance for StartWebRecord.
|
|
@@ -1244,8 +1551,31 @@ class TrtcClient(AbstractClient):
|
|
|
1244
1551
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1245
1552
|
|
|
1246
1553
|
|
|
1554
|
+
def StopAIConversation(self, request):
|
|
1555
|
+
r"""停止AI对话任务
|
|
1556
|
+
|
|
1557
|
+
:param request: Request instance for StopAIConversation.
|
|
1558
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.StopAIConversationRequest`
|
|
1559
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.StopAIConversationResponse`
|
|
1560
|
+
|
|
1561
|
+
"""
|
|
1562
|
+
try:
|
|
1563
|
+
params = request._serialize()
|
|
1564
|
+
headers = request.headers
|
|
1565
|
+
body = self.call("StopAIConversation", params, headers=headers)
|
|
1566
|
+
response = json.loads(body)
|
|
1567
|
+
model = models.StopAIConversationResponse()
|
|
1568
|
+
model._deserialize(response["Response"])
|
|
1569
|
+
return model
|
|
1570
|
+
except Exception as e:
|
|
1571
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1572
|
+
raise
|
|
1573
|
+
else:
|
|
1574
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1575
|
+
|
|
1576
|
+
|
|
1247
1577
|
def StopAITranscription(self, request):
|
|
1248
|
-
"""停止AI
|
|
1578
|
+
r"""停止AI转录任务。
|
|
1249
1579
|
|
|
1250
1580
|
:param request: Request instance for StopAITranscription.
|
|
1251
1581
|
:type request: :class:`tencentcloud.trtc.v20190722.models.StopAITranscriptionRequest`
|
|
@@ -1268,7 +1598,7 @@ class TrtcClient(AbstractClient):
|
|
|
1268
1598
|
|
|
1269
1599
|
|
|
1270
1600
|
def StopMCUMixTranscode(self, request):
|
|
1271
|
-
"""接口说明:结束云端混流
|
|
1601
|
+
r"""接口说明:结束云端混流
|
|
1272
1602
|
|
|
1273
1603
|
:param request: Request instance for StopMCUMixTranscode.
|
|
1274
1604
|
:type request: :class:`tencentcloud.trtc.v20190722.models.StopMCUMixTranscodeRequest`
|
|
@@ -1291,7 +1621,7 @@ class TrtcClient(AbstractClient):
|
|
|
1291
1621
|
|
|
1292
1622
|
|
|
1293
1623
|
def StopMCUMixTranscodeByStrRoomId(self, request):
|
|
1294
|
-
"""接口说明:结束云端混流
|
|
1624
|
+
r"""接口说明:结束云端混流
|
|
1295
1625
|
|
|
1296
1626
|
:param request: Request instance for StopMCUMixTranscodeByStrRoomId.
|
|
1297
1627
|
:type request: :class:`tencentcloud.trtc.v20190722.models.StopMCUMixTranscodeByStrRoomIdRequest`
|
|
@@ -1314,7 +1644,8 @@ class TrtcClient(AbstractClient):
|
|
|
1314
1644
|
|
|
1315
1645
|
|
|
1316
1646
|
def StopPublishCdnStream(self, request):
|
|
1317
|
-
"""
|
|
1647
|
+
r"""接口说明:
|
|
1648
|
+
停止指定的混流转推任务。如果没有调用 Stop 接口停止任务,所有参与混流转推的主播离开 TRTC 房间超过 AgentParams.MaxIdleTime 设置的时间后,任务也会自动停止。
|
|
1318
1649
|
|
|
1319
1650
|
:param request: Request instance for StopPublishCdnStream.
|
|
1320
1651
|
:type request: :class:`tencentcloud.trtc.v20190722.models.StopPublishCdnStreamRequest`
|
|
@@ -1337,7 +1668,7 @@ class TrtcClient(AbstractClient):
|
|
|
1337
1668
|
|
|
1338
1669
|
|
|
1339
1670
|
def StopStreamIngest(self, request):
|
|
1340
|
-
"""停止一个输入在线媒体流任务。
|
|
1671
|
+
r"""停止一个输入在线媒体流任务。
|
|
1341
1672
|
|
|
1342
1673
|
:param request: Request instance for StopStreamIngest.
|
|
1343
1674
|
:type request: :class:`tencentcloud.trtc.v20190722.models.StopStreamIngestRequest`
|
|
@@ -1360,7 +1691,7 @@ class TrtcClient(AbstractClient):
|
|
|
1360
1691
|
|
|
1361
1692
|
|
|
1362
1693
|
def StopWebRecord(self, request):
|
|
1363
|
-
"""停止页面录制任务
|
|
1694
|
+
r"""停止页面录制任务
|
|
1364
1695
|
|
|
1365
1696
|
:param request: Request instance for StopWebRecord.
|
|
1366
1697
|
:type request: :class:`tencentcloud.trtc.v20190722.models.StopWebRecordRequest`
|
|
@@ -1382,20 +1713,61 @@ class TrtcClient(AbstractClient):
|
|
|
1382
1713
|
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1383
1714
|
|
|
1384
1715
|
|
|
1385
|
-
def
|
|
1386
|
-
"""
|
|
1716
|
+
def TextToSpeech(self, request):
|
|
1717
|
+
r"""语音合成接口
|
|
1387
1718
|
|
|
1388
|
-
:param request: Request instance for
|
|
1389
|
-
:type request: :class:`tencentcloud.trtc.v20190722.models.
|
|
1390
|
-
:rtype: :class:`tencentcloud.trtc.v20190722.models.
|
|
1719
|
+
:param request: Request instance for TextToSpeech.
|
|
1720
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.TextToSpeechRequest`
|
|
1721
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.TextToSpeechResponse`
|
|
1391
1722
|
|
|
1392
1723
|
"""
|
|
1393
1724
|
try:
|
|
1394
1725
|
params = request._serialize()
|
|
1395
1726
|
headers = request.headers
|
|
1396
|
-
body = self.call("
|
|
1727
|
+
body = self.call("TextToSpeech", params, headers=headers)
|
|
1397
1728
|
response = json.loads(body)
|
|
1398
|
-
model = models.
|
|
1729
|
+
model = models.TextToSpeechResponse()
|
|
1730
|
+
model._deserialize(response["Response"])
|
|
1731
|
+
return model
|
|
1732
|
+
except Exception as e:
|
|
1733
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1734
|
+
raise
|
|
1735
|
+
else:
|
|
1736
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1737
|
+
|
|
1738
|
+
|
|
1739
|
+
def TextToSpeechSSE(self, request):
|
|
1740
|
+
r"""SSE流式文本转语音
|
|
1741
|
+
|
|
1742
|
+
:param request: Request instance for TextToSpeechSSE.
|
|
1743
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.TextToSpeechSSERequest`
|
|
1744
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.TextToSpeechSSEResponse`
|
|
1745
|
+
|
|
1746
|
+
"""
|
|
1747
|
+
try:
|
|
1748
|
+
params = request._serialize()
|
|
1749
|
+
return self._call_and_deserialize("TextToSpeechSSE", params, models.TextToSpeechSSEResponse, headers=request.headers)
|
|
1750
|
+
except Exception as e:
|
|
1751
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1752
|
+
raise
|
|
1753
|
+
else:
|
|
1754
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1755
|
+
|
|
1756
|
+
|
|
1757
|
+
def UpdateAIConversation(self, request):
|
|
1758
|
+
r"""更新AIConversation参数
|
|
1759
|
+
|
|
1760
|
+
:param request: Request instance for UpdateAIConversation.
|
|
1761
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.UpdateAIConversationRequest`
|
|
1762
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.UpdateAIConversationResponse`
|
|
1763
|
+
|
|
1764
|
+
"""
|
|
1765
|
+
try:
|
|
1766
|
+
params = request._serialize()
|
|
1767
|
+
headers = request.headers
|
|
1768
|
+
body = self.call("UpdateAIConversation", params, headers=headers)
|
|
1769
|
+
response = json.loads(body)
|
|
1770
|
+
model = models.UpdateAIConversationResponse()
|
|
1399
1771
|
model._deserialize(response["Response"])
|
|
1400
1772
|
return model
|
|
1401
1773
|
except Exception as e:
|
|
@@ -1406,8 +1778,9 @@ class TrtcClient(AbstractClient):
|
|
|
1406
1778
|
|
|
1407
1779
|
|
|
1408
1780
|
def UpdatePublishCdnStream(self, request):
|
|
1409
|
-
"""
|
|
1410
|
-
|
|
1781
|
+
r"""接口说明:
|
|
1782
|
+
成功发起混流转推后,可以使用此接口来更新任务。仅在任务进行时有效,任务退出后更新将会返回错误。更新操作为增量更新模式。
|
|
1783
|
+
注意:为了保障推流的稳定性,更新不支持任务在纯音频、音视频、纯视频之间进行切换。
|
|
1411
1784
|
|
|
1412
1785
|
:param request: Request instance for UpdatePublishCdnStream.
|
|
1413
1786
|
:type request: :class:`tencentcloud.trtc.v20190722.models.UpdatePublishCdnStreamRequest`
|
|
@@ -1422,6 +1795,75 @@ class TrtcClient(AbstractClient):
|
|
|
1422
1795
|
model = models.UpdatePublishCdnStreamResponse()
|
|
1423
1796
|
model._deserialize(response["Response"])
|
|
1424
1797
|
return model
|
|
1798
|
+
except Exception as e:
|
|
1799
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1800
|
+
raise
|
|
1801
|
+
else:
|
|
1802
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1803
|
+
|
|
1804
|
+
|
|
1805
|
+
def UpdateStreamIngest(self, request):
|
|
1806
|
+
r"""更新输入在线媒体流任务的StreamUrl
|
|
1807
|
+
|
|
1808
|
+
:param request: Request instance for UpdateStreamIngest.
|
|
1809
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.UpdateStreamIngestRequest`
|
|
1810
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.UpdateStreamIngestResponse`
|
|
1811
|
+
|
|
1812
|
+
"""
|
|
1813
|
+
try:
|
|
1814
|
+
params = request._serialize()
|
|
1815
|
+
headers = request.headers
|
|
1816
|
+
body = self.call("UpdateStreamIngest", params, headers=headers)
|
|
1817
|
+
response = json.loads(body)
|
|
1818
|
+
model = models.UpdateStreamIngestResponse()
|
|
1819
|
+
model._deserialize(response["Response"])
|
|
1820
|
+
return model
|
|
1821
|
+
except Exception as e:
|
|
1822
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1823
|
+
raise
|
|
1824
|
+
else:
|
|
1825
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1826
|
+
|
|
1827
|
+
|
|
1828
|
+
def UpdateVoicePrint(self, request):
|
|
1829
|
+
r"""传入声纹ID以及对应音频信息,更新对应声纹信息
|
|
1830
|
+
|
|
1831
|
+
:param request: Request instance for UpdateVoicePrint.
|
|
1832
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.UpdateVoicePrintRequest`
|
|
1833
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.UpdateVoicePrintResponse`
|
|
1834
|
+
|
|
1835
|
+
"""
|
|
1836
|
+
try:
|
|
1837
|
+
params = request._serialize()
|
|
1838
|
+
headers = request.headers
|
|
1839
|
+
body = self.call("UpdateVoicePrint", params, headers=headers)
|
|
1840
|
+
response = json.loads(body)
|
|
1841
|
+
model = models.UpdateVoicePrintResponse()
|
|
1842
|
+
model._deserialize(response["Response"])
|
|
1843
|
+
return model
|
|
1844
|
+
except Exception as e:
|
|
1845
|
+
if isinstance(e, TencentCloudSDKException):
|
|
1846
|
+
raise
|
|
1847
|
+
else:
|
|
1848
|
+
raise TencentCloudSDKException(type(e).__name__, str(e))
|
|
1849
|
+
|
|
1850
|
+
|
|
1851
|
+
def VoiceClone(self, request):
|
|
1852
|
+
r"""声音克隆
|
|
1853
|
+
|
|
1854
|
+
:param request: Request instance for VoiceClone.
|
|
1855
|
+
:type request: :class:`tencentcloud.trtc.v20190722.models.VoiceCloneRequest`
|
|
1856
|
+
:rtype: :class:`tencentcloud.trtc.v20190722.models.VoiceCloneResponse`
|
|
1857
|
+
|
|
1858
|
+
"""
|
|
1859
|
+
try:
|
|
1860
|
+
params = request._serialize()
|
|
1861
|
+
headers = request.headers
|
|
1862
|
+
body = self.call("VoiceClone", params, headers=headers)
|
|
1863
|
+
response = json.loads(body)
|
|
1864
|
+
model = models.VoiceCloneResponse()
|
|
1865
|
+
model._deserialize(response["Response"])
|
|
1866
|
+
return model
|
|
1425
1867
|
except Exception as e:
|
|
1426
1868
|
if isinstance(e, TencentCloudSDKException):
|
|
1427
1869
|
raise
|