tencentcloud-sdk-nodejs 4.0.458 → 4.0.460

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.
Files changed (66) hide show
  1. package/CHANGELOG.md +325 -0
  2. package/SERVICE_CHANGELOG.md +383 -56
  3. package/package.json +1 -1
  4. package/products.md +19 -19
  5. package/src/common/sdk_version.ts +1 -1
  6. package/src/services/bma/v20210624/bma_models.ts +92 -92
  7. package/src/services/captcha/v20190722/captcha_models.ts +7 -23
  8. package/src/services/cbs/v20170312/cbs_models.ts +18 -18
  9. package/src/services/ckafka/v20190819/ckafka_client.ts +1 -0
  10. package/src/services/ckafka/v20190819/ckafka_models.ts +64 -0
  11. package/src/services/cls/v20201016/cls_models.ts +1 -1
  12. package/src/services/cpdp/v20190820/cpdp_models.ts +30 -0
  13. package/src/services/cwp/v20180228/cwp_models.ts +2 -2
  14. package/src/services/cynosdb/v20190107/cynosdb_models.ts +5 -0
  15. package/src/services/dc/v20180410/dc_models.ts +6 -0
  16. package/src/services/gaap/v20180529/gaap_models.ts +48 -0
  17. package/src/services/lcic/v20220817/lcic_client.ts +25 -0
  18. package/src/services/lcic/v20220817/lcic_models.ts +121 -0
  19. package/src/services/mariadb/v20170312/mariadb_client.ts +3 -29
  20. package/src/services/mariadb/v20170312/mariadb_models.ts +16 -168
  21. package/src/services/redis/v20180412/redis_models.ts +92 -56
  22. package/src/services/sqlserver/v20180328/sqlserver_models.ts +1 -1
  23. package/src/services/ssl/v20191205/ssl_models.ts +5 -0
  24. package/src/services/tdcpg/v20211118/tdcpg_models.ts +22 -1
  25. package/src/services/trp/v20210515/trp_client.ts +4 -3
  26. package/src/services/trp/v20210515/trp_models.ts +136 -67
  27. package/src/services/trtc/v20190722/trtc_client.ts +128 -59
  28. package/src/services/trtc/v20190722/trtc_models.ts +189 -0
  29. package/src/services/vod/v20180717/vod_models.ts +7 -2
  30. package/tencentcloud/common/abstract_client.js +2 -2
  31. package/tencentcloud/common/http/fetch.d.ts +1 -1
  32. package/tencentcloud/common/http/http_connection.d.ts +2 -2
  33. package/tencentcloud/common/http/http_connection.js +4 -4
  34. package/tencentcloud/common/interface.d.ts +1 -1
  35. package/tencentcloud/common/sdk_version.d.ts +1 -1
  36. package/tencentcloud/common/sdk_version.js +1 -1
  37. package/tencentcloud/services/bma/v20210624/bma_models.d.ts +92 -92
  38. package/tencentcloud/services/captcha/v20190722/captcha_models.d.ts +7 -23
  39. package/tencentcloud/services/cbs/v20170312/cbs_models.d.ts +17 -17
  40. package/tencentcloud/services/ckafka/v20190819/ckafka_models.d.ts +54 -0
  41. package/tencentcloud/services/cls/v20201016/cls_models.d.ts +1 -1
  42. package/tencentcloud/services/cpdp/v20190820/cpdp_models.d.ts +25 -0
  43. package/tencentcloud/services/cwp/v20180228/cwp_models.d.ts +2 -2
  44. package/tencentcloud/services/cynosdb/v20190107/cynosdb_models.d.ts +4 -0
  45. package/tencentcloud/services/dc/v20180410/dc_models.d.ts +5 -0
  46. package/tencentcloud/services/gaap/v20180529/gaap_models.d.ts +40 -0
  47. package/tencentcloud/services/lcic/v20220817/lcic_client.d.ts +9 -1
  48. package/tencentcloud/services/lcic/v20220817/lcic_client.js +12 -0
  49. package/tencentcloud/services/lcic/v20220817/lcic_models.d.ts +103 -0
  50. package/tencentcloud/services/mariadb/v20170312/mariadb_client.d.ts +1 -9
  51. package/tencentcloud/services/mariadb/v20170312/mariadb_client.js +0 -12
  52. package/tencentcloud/services/mariadb/v20170312/mariadb_models.d.ts +16 -144
  53. package/tencentcloud/services/redis/v20180412/redis_models.d.ts +86 -56
  54. package/tencentcloud/services/sqlserver/v20180328/sqlserver_models.d.ts +1 -1
  55. package/tencentcloud/services/ssl/v20191205/ssl_models.d.ts +4 -0
  56. package/tencentcloud/services/tdcpg/v20211118/tdcpg_models.d.ts +19 -1
  57. package/tencentcloud/services/trp/v20210515/trp_client.d.ts +2 -2
  58. package/tencentcloud/services/trp/v20210515/trp_client.js +1 -1
  59. package/tencentcloud/services/trp/v20210515/trp_models.d.ts +115 -58
  60. package/tencentcloud/services/trtc/v20190722/trtc_client.d.ts +75 -39
  61. package/tencentcloud/services/trtc/v20190722/trtc_client.js +89 -45
  62. package/tencentcloud/services/trtc/v20190722/trtc_models.d.ts +161 -0
  63. package/tencentcloud/services/vod/v20180717/vod_models.d.ts +6 -2
  64. package/test/lcic.v20220817.test.js +20 -0
  65. package/test/mariadb.v20170312.test.js +0 -20
  66. package/test/trtc.v20190722.test.js +46 -6
@@ -332,7 +332,7 @@ export interface CreateClusterRequest {
332
332
  SubnetId: string
333
333
 
334
334
  /**
335
- * 集群付费模式
335
+ * 实例付费模式
336
336
  - PREPAID:预付费,即包年包月
337
337
  - POSTPAID_BY_HOUR:按小时后付费
338
338
  */
@@ -389,6 +389,19 @@ export interface CreateClusterRequest {
389
389
  注:该参数和DBVersion、DBMajorVersion只能传递一个,且需要传递一个。
390
390
  */
391
391
  DBKernelVersion?: string
392
+
393
+ /**
394
+ * 存储付费模式
395
+ - PREPAID:预付费,即包年包月
396
+ - POSTPAID_BY_HOUR:按小时后付费
397
+ 默认为POSTPAID_BY_HOUR,实例付费模式为按小时付费时,存储付费模式不支持包年包月
398
+ */
399
+ StoragePayMode?: string
400
+
401
+ /**
402
+ * 存储最大使用量,单位GB。取值参考文档【购买指南】。存储使用预付费模式时必须设置,存储使用按小时后付费时不可设置
403
+ */
404
+ Storage?: number
392
405
  }
393
406
 
394
407
  /**
@@ -1210,6 +1223,14 @@ export interface Cluster {
1210
1223
  * TDSQL-C PostgreSQL 内核版本号
1211
1224
  */
1212
1225
  DBKernelVersion: string
1226
+
1227
+ /**
1228
+ * 存储付费模式
1229
+ - PREPAID:预付费,即包年包月
1230
+ - POSTPAID_BY_HOUR:按小时后付费
1231
+ 注意:此字段可能返回 null,表示取不到有效值。
1232
+ */
1233
+ StoragePayMode: string
1213
1234
  }
1214
1235
 
1215
1236
  /**
@@ -39,9 +39,9 @@ import {
39
39
  DescribeCodeBatchsRequest,
40
40
  DescribeProductsRequest,
41
41
  DescribeCodeBatchByIdResponse,
42
- TraceCode,
43
- DeleteTraceDataResponse,
44
42
  ModifyProductRequest,
43
+ DeleteTraceDataResponse,
44
+ Job,
45
45
  CreateCodePackResponse,
46
46
  DescribeMerchantsResponse,
47
47
  DescribeTraceDataListRequest,
@@ -80,6 +80,7 @@ import {
80
80
  ModifyCodeBatchResponse,
81
81
  Product,
82
82
  DescribeTraceCodesRequest,
83
+ TraceCode,
83
84
  ModifyTraceCodeResponse,
84
85
  ChainData,
85
86
  PhaseData,
@@ -367,7 +368,7 @@ export class Client extends AbstractClient {
367
368
  }
368
369
 
369
370
  /**
370
- * 生成码包
371
+ * 生成普通码包
371
372
  */
372
373
  async CreateCodePack(
373
374
  req: CreateCodePackRequest,
@@ -114,6 +114,12 @@ export interface CodeBatch {
114
114
  注意:此字段可能返回 null,表示取不到有效值。
115
115
  */
116
116
  TplName?: string
117
+
118
+ /**
119
+ * 调度任务
120
+ 注意:此字段可能返回 null,表示取不到有效值。
121
+ */
122
+ Job?: Job
117
123
  }
118
124
 
119
125
  /**
@@ -311,6 +317,16 @@ export interface ModifyMerchantRequest {
311
317
  * 企业ID
312
318
  */
313
319
  CorpId?: number
320
+
321
+ /**
322
+ * 码包来源 0:自建, 1:第三码包,暂不支持修改
323
+ */
324
+ CodeType?: number
325
+
326
+ /**
327
+ * 码包前缀地址 第三方码包时必填
328
+ */
329
+ CodeUrl?: string
314
330
  }
315
331
 
316
332
  /**
@@ -505,6 +521,17 @@ export interface Merchant {
505
521
  * 商户码规则
506
522
  */
507
523
  CodeRule: string
524
+
525
+ /**
526
+ * 码来源类型 0: 安心平台 1: 第三方码
527
+ */
528
+ CodeType: number
529
+
530
+ /**
531
+ * 第三方码域名前缀
532
+ 注意:此字段可能返回 null,表示取不到有效值。
533
+ */
534
+ CodeUrl: string
508
535
  }
509
536
 
510
537
  /**
@@ -629,63 +656,43 @@ export interface DescribeCodeBatchByIdResponse {
629
656
  }
630
657
 
631
658
  /**
632
- * 溯源码
659
+ * ModifyProduct请求参数结构体
633
660
  */
634
- export interface TraceCode {
635
- /**
636
- * 码
637
- */
638
- Code: string
639
-
640
- /**
641
- * 企业ID
642
- */
643
- CorpId: number
644
-
645
- /**
646
- * 包ID
647
- */
648
- PackId: string
649
-
650
- /**
651
- * 批次ID
652
- */
653
- BatchId: string
654
-
661
+ export interface ModifyProductRequest {
655
662
  /**
656
- * 所属商户ID
663
+ * 商品名称
657
664
  */
658
- MerchantId: string
665
+ Name: string
659
666
 
660
667
  /**
661
- * 产品ID
668
+ * 商品ID
662
669
  */
663
670
  ProductId: string
664
671
 
665
672
  /**
666
- * 状态
673
+ * 备注
667
674
  */
668
- Status: number
675
+ Remark?: string
669
676
 
670
677
  /**
671
- * 创建时间
678
+ * 商品规格
672
679
  */
673
- CreateTime: string
680
+ Specification?: string
674
681
 
675
682
  /**
676
- * 修改时间
683
+ * 商品图片
677
684
  */
678
- UpdateTime: string
685
+ Logo?: Array<string>
679
686
 
680
687
  /**
681
- * 商户名称
688
+ * 企业ID
682
689
  */
683
- MerchantName: string
690
+ CorpId?: number
684
691
 
685
692
  /**
686
- * 产品名称
693
+ * 预留字段
687
694
  */
688
- ProductName: string
695
+ Ext?: Ext
689
696
  }
690
697
 
691
698
  /**
@@ -705,43 +712,18 @@ export interface DeleteTraceDataResponse {
705
712
  }
706
713
 
707
714
  /**
708
- * ModifyProduct请求参数结构体
715
+ * 通用调度任务
709
716
  */
710
- export interface ModifyProductRequest {
711
- /**
712
- * 商品名称
713
- */
714
- Name: string
715
-
716
- /**
717
- * 商品ID
718
- */
719
- ProductId: string
720
-
717
+ export interface Job {
721
718
  /**
722
- * 备注
719
+ * 调度ID
723
720
  */
724
- Remark?: string
721
+ JobId: number
725
722
 
726
723
  /**
727
- * 商品规格
724
+ * 执行状态 init:初始化, pending: 执行中, done: 执行成功, error: 执行失败
728
725
  */
729
- Specification?: string
730
-
731
- /**
732
- * 商品图片
733
- */
734
- Logo?: Array<string>
735
-
736
- /**
737
- * 企业ID
738
- */
739
- CorpId?: number
740
-
741
- /**
742
- * 预留字段
743
- */
744
- Ext?: Ext
726
+ Status: string
745
727
  }
746
728
 
747
729
  /**
@@ -980,6 +962,12 @@ export interface TraceItem {
980
962
  注意:此字段可能返回 null,表示取不到有效值。
981
963
  */
982
964
  Key: string
965
+
966
+ /**
967
+ * 扩展字段
968
+ 注意:此字段可能返回 null,表示取不到有效值。
969
+ */
970
+ Ext: string
983
971
  }
984
972
 
985
973
  /**
@@ -1025,6 +1013,11 @@ export interface DescribeMerchantsRequest {
1025
1013
  * 企业ID
1026
1014
  */
1027
1015
  CorpId?: number
1016
+
1017
+ /**
1018
+ * 码来源类型 0:自建, 1:第三方
1019
+ */
1020
+ CodeType?: number
1028
1021
  }
1029
1022
 
1030
1023
  /**
@@ -1166,6 +1159,16 @@ export interface CreateMerchantRequest {
1166
1159
  * 企业ID
1167
1160
  */
1168
1161
  CorpId?: number
1162
+
1163
+ /**
1164
+ * 码包来源 0:自建, 1:第三发
1165
+ */
1166
+ CodeType?: number
1167
+
1168
+ /**
1169
+ * 码包前缀地址 第三方码包时必填
1170
+ */
1171
+ CodeUrl?: string
1169
1172
  }
1170
1173
 
1171
1174
  /**
@@ -1330,7 +1333,7 @@ export interface DescribeProductByIdResponse {
1330
1333
  }
1331
1334
 
1332
1335
  /**
1333
- * 数组
1336
+ * 层级码配置
1334
1337
  */
1335
1338
  export interface PackSpec {
1336
1339
  /**
@@ -1347,6 +1350,12 @@ export interface PackSpec {
1347
1350
  * 数量
1348
1351
  */
1349
1352
  Amount: number
1353
+
1354
+ /**
1355
+ * 码规则ID
1356
+ 注意:此字段可能返回 null,表示取不到有效值。
1357
+ */
1358
+ CustomId?: string
1350
1359
  }
1351
1360
 
1352
1361
  /**
@@ -1690,6 +1699,66 @@ export interface DescribeTraceCodesRequest {
1690
1699
  CorpId?: number
1691
1700
  }
1692
1701
 
1702
+ /**
1703
+ * 溯源码
1704
+ */
1705
+ export interface TraceCode {
1706
+ /**
1707
+ * 码
1708
+ */
1709
+ Code: string
1710
+
1711
+ /**
1712
+ * 企业ID
1713
+ */
1714
+ CorpId: number
1715
+
1716
+ /**
1717
+ * 包ID
1718
+ */
1719
+ PackId: string
1720
+
1721
+ /**
1722
+ * 批次ID
1723
+ */
1724
+ BatchId: string
1725
+
1726
+ /**
1727
+ * 所属商户ID
1728
+ */
1729
+ MerchantId: string
1730
+
1731
+ /**
1732
+ * 产品ID
1733
+ */
1734
+ ProductId: string
1735
+
1736
+ /**
1737
+ * 状态
1738
+ */
1739
+ Status: number
1740
+
1741
+ /**
1742
+ * 创建时间
1743
+ */
1744
+ CreateTime: string
1745
+
1746
+ /**
1747
+ * 修改时间
1748
+ */
1749
+ UpdateTime: string
1750
+
1751
+ /**
1752
+ * 商户名称
1753
+ */
1754
+ MerchantName: string
1755
+
1756
+ /**
1757
+ * 产品名称
1758
+ */
1759
+ ProductName: string
1760
+ }
1761
+
1693
1762
  /**
1694
1763
  * ModifyTraceCode返回参数结构体
1695
1764
  */
@@ -19,6 +19,7 @@ import { AbstractClient } from "../../../common/abstract_client"
19
19
  import { ClientConfig } from "../../../common/interface"
20
20
  import {
21
21
  CreatePictureRequest,
22
+ DescribeRelayUsageRequest,
22
23
  MixLayout,
23
24
  RemoveUserByStrRoomIdResponse,
24
25
  StartMCUMixTranscodeRequest,
@@ -35,6 +36,7 @@ import {
35
36
  DescribeRecordStatisticResponse,
36
37
  StartMCUMixTranscodeByStrRoomIdResponse,
37
38
  CloudStorage,
39
+ DescribeTrtcUsageResponse,
38
40
  TimeValue,
39
41
  DismissRoomByStrRoomIdRequest,
40
42
  EventMessage,
@@ -45,20 +47,27 @@ import {
45
47
  EncodeParams,
46
48
  DescribeCallDetailInfoResponse,
47
49
  TrtcTimeNewUsage,
50
+ DescribeMixTranscodingUsageRequest,
48
51
  ModifyPictureRequest,
49
52
  SmallVideoLayoutParams,
50
53
  SubscribeStreamUserIds,
51
54
  WaterMarkImage,
52
55
  EventList,
56
+ DescribeTrtcUsageRequest,
53
57
  DescribeRoomInfoResponse,
54
58
  SdkAppIdTrtcMcuTranscodeTimeUsage,
55
59
  DescribeUserInfoResponse,
60
+ TrtcUsage,
61
+ DescribeRelayUsageResponse,
62
+ DescribeRecordingUsageResponse,
56
63
  ModifyPictureResponse,
64
+ DescribeRecordingUsageRequest,
57
65
  StorageFile,
58
66
  WaterMark,
59
67
  DescribeScaleInfoResponse,
60
68
  MixLayoutParams,
61
69
  StopMCUMixTranscodeResponse,
70
+ DescribeMixTranscodingUsageResponse,
62
71
  SdkAppIdNewTrtcTimeUsage,
63
72
  RemoveUserRequest,
64
73
  DismissRoomRequest,
@@ -130,33 +139,18 @@ export class Client extends AbstractClient {
130
139
  }
131
140
 
132
141
  /**
133
- * 接口说明:启动云端混流,并指定混流画面中各路画面的布局位置。
134
-
135
- TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过此 API 接口,通知腾讯云服务端将多路视频画面合成一路,并指定每一路画面的位置,同时将多路声音进行混音,最终形成一路音视频流,以便用于录制和直播观看。房间销毁后混流自动结束。
136
-
137
- 您可以通过此接口实现如下目标:
138
- - 设置最终直播流的画质和音质,包括视频分辨率、视频码率、视频帧率、以及声音质量等。
139
- - 设置各路画面的位置和布局,您只需要在启动时设置一次,排版引擎会自动完成后续的画面排布。
140
- - 设置录制文件名,用于二次回放。
141
- - 设置 CDN 直播流 ID,用于在 CDN 进行直播观看。
142
-
143
- 目前已经支持了如下几种布局模板:
144
- - 悬浮模板:第一个进入房间的用户的视频画面会铺满整个屏幕,其他用户的视频画面从左下角依次水平排列,显示为小画面,最多4行,每行4个,小画面悬浮于大画面之上。最多支持1个大画面和15个小画面,如果用户只发送音频,仍然会占用画面位置。
145
- - 九宫格模板:所有用户的视频画面大小一致,平分整个屏幕,人数越多,每个画面的尺寸越小。最多支持16个画面,如果用户只发送音频,仍然会占用画面位置。
146
- - 屏幕分享模板:适合视频会议和在线教育场景的布局,屏幕分享(或者主讲的摄像头)始终占据屏幕左侧的大画面位置,其他用户依次垂直排列于右侧,最多两列,每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时,左侧大画面为了保持内容的完整性采用缩放方式处理,右侧小画面采用裁剪方式处理。
147
- - 画中画模板:适用于混合大小两路视频画面和其他用户混音,或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上,可以指定大小画面的用户以及小画面的显示位置,最多支持2个画面。
148
- - 自定义模板:适用于在混流中指定用户的画面位置,或者预设视频画面位置的场景。当预设位置指定用户时,排版引擎会该用户预留位置;当预设位置未指定用户时,排版引擎会根据进房间顺序自动填充。预设位置填满时,不再混合其他用户的画面和声音。自定义模板启用占位图功能时(LayoutParams中的PlaceHolderMode设置成1),在预设位置的用户没有上行视频时可显示对应的占位图(PlaceImageId)。
149
-
150
- 注意:
151
- 1、**混流转码为收费功能,调用接口将产生云端混流转码费用,详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**
152
- 2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流,如需切换至MCU混流,请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。
153
- 3、客户端混流和服务端混流不能混用。
142
+ * 获取TRTC音视频互动的用量明细。
143
+ - 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。
144
+ - 单次查询统计区间最多不能超过31天。
145
+ - 若查询当天用量,由于统计延迟等原因,返回数据可能不够准确。
146
+ - 该接口只用于历史用量数据统计或核对数据使用,关键业务逻辑不能使用。
147
+ - 默认接口请求频率限制:5次/秒。
154
148
  */
155
- async StartMCUMixTranscode(
156
- req: StartMCUMixTranscodeRequest,
157
- cb?: (error: string, rep: StartMCUMixTranscodeResponse) => void
158
- ): Promise<StartMCUMixTranscodeResponse> {
159
- return this.request("StartMCUMixTranscode", req, cb)
149
+ async DescribeTrtcUsage(
150
+ req: DescribeTrtcUsageRequest,
151
+ cb?: (error: string, rep: DescribeTrtcUsageResponse) => void
152
+ ): Promise<DescribeTrtcUsageResponse> {
153
+ return this.request("DescribeTrtcUsage", req, cb)
160
154
  }
161
155
 
162
156
  /**
@@ -182,6 +176,36 @@ TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过
182
176
  return this.request("StopMCUMixTranscode", req, cb)
183
177
  }
184
178
 
179
+ /**
180
+ * 接口说明:启动云端混流,并指定混流画面中各路画面的布局位置。
181
+
182
+ TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过此 API 接口,通知腾讯云服务端将多路视频画面合成一路,并指定每一路画面的位置,同时将多路声音进行混音,最终形成一路音视频流,以便用于录制和直播观看。
183
+
184
+ 您可以通过此接口实现如下目标:
185
+ - 设置最终直播流的画质和音质,包括视频分辨率、视频码率、视频帧率、以及声音质量等。
186
+ - 设置各路画面的位置和布局,您只需要在启动时设置一次,排版引擎会自动完成后续的画面排布。
187
+ - 设置录制文件名,用于二次回放。
188
+ - 设置 CDN 直播流 ID,用于在 CDN 进行直播观看。
189
+
190
+ 目前已经支持了如下几种布局模板:
191
+ - 悬浮模板:第一个进入房间的用户的视频画面会铺满整个屏幕,其他用户的视频画面从左下角依次水平排列,显示为小画面,最多4行,每行4个,小画面悬浮于大画面之上。最多支持1个大画面和15个小画面,如果用户只发送音频,仍然会占用画面位置。
192
+ - 九宫格模板:所有用户的视频画面大小一致,平分整个屏幕,人数越多,每个画面的尺寸越小。最多支持16个画面,如果用户只发送音频,仍然会占用画面位置。
193
+ - 屏幕分享模板:适合视频会议和在线教育场景的布局,屏幕分享(或者主讲的摄像头)始终占据屏幕左侧的大画面位置,其他用户依次垂直排列于右侧,最多两列,每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时,左侧大画面为了保持内容的完整性采用缩放方式处理,右侧小画面采用裁剪方式处理。
194
+ - 画中画模板:适用于混合大小两路视频画面和其他用户混音,或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上,可以指定大小画面的用户以及小画面的显示位置。
195
+ - 自定义模板:适用于在混流中指定用户的画面位置,或者预设视频画面位置的场景。当预设位置指定用户时,排版引擎会该用户预留位置;当预设位置未指定用户时,排版引擎会根据进房间顺序自动填充。预设位置填满时,不再混合其他用户的画面和声音。自定义模板启用占位图功能时(LayoutParams中的PlaceHolderMode设置成1),在预设位置的用户没有上行视频时可显示对应的占位图(PlaceImageId)。
196
+
197
+ 注意:
198
+ 1、**混流转码为收费功能,调用接口将产生云端混流转码费用,详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**
199
+ 2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流,如需切换至MCU混流,请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。
200
+ 3、客户端混流和服务端混流不能混用。
201
+ */
202
+ async StartMCUMixTranscodeByStrRoomId(
203
+ req: StartMCUMixTranscodeByStrRoomIdRequest,
204
+ cb?: (error: string, rep: StartMCUMixTranscodeByStrRoomIdResponse) => void
205
+ ): Promise<StartMCUMixTranscodeByStrRoomIdResponse> {
206
+ return this.request("StartMCUMixTranscodeByStrRoomId", req, cb)
207
+ }
208
+
185
209
  /**
186
210
  * 如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁删除自定义背景图或水印,可通过此接口删除已上传的图片。无需频繁删除图片的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
187
211
  */
@@ -232,6 +256,36 @@ TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过
232
256
  return this.request("DescribeUserEvent", req, cb)
233
257
  }
234
258
 
259
+ /**
260
+ * 接口说明:启动云端混流,并指定混流画面中各路画面的布局位置。
261
+
262
+ TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过此 API 接口,通知腾讯云服务端将多路视频画面合成一路,并指定每一路画面的位置,同时将多路声音进行混音,最终形成一路音视频流,以便用于录制和直播观看。房间销毁后混流自动结束。
263
+
264
+ 您可以通过此接口实现如下目标:
265
+ - 设置最终直播流的画质和音质,包括视频分辨率、视频码率、视频帧率、以及声音质量等。
266
+ - 设置各路画面的位置和布局,您只需要在启动时设置一次,排版引擎会自动完成后续的画面排布。
267
+ - 设置录制文件名,用于二次回放。
268
+ - 设置 CDN 直播流 ID,用于在 CDN 进行直播观看。
269
+
270
+ 目前已经支持了如下几种布局模板:
271
+ - 悬浮模板:第一个进入房间的用户的视频画面会铺满整个屏幕,其他用户的视频画面从左下角依次水平排列,显示为小画面,最多4行,每行4个,小画面悬浮于大画面之上。最多支持1个大画面和15个小画面,如果用户只发送音频,仍然会占用画面位置。
272
+ - 九宫格模板:所有用户的视频画面大小一致,平分整个屏幕,人数越多,每个画面的尺寸越小。最多支持16个画面,如果用户只发送音频,仍然会占用画面位置。
273
+ - 屏幕分享模板:适合视频会议和在线教育场景的布局,屏幕分享(或者主讲的摄像头)始终占据屏幕左侧的大画面位置,其他用户依次垂直排列于右侧,最多两列,每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时,左侧大画面为了保持内容的完整性采用缩放方式处理,右侧小画面采用裁剪方式处理。
274
+ - 画中画模板:适用于混合大小两路视频画面和其他用户混音,或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上,可以指定大小画面的用户以及小画面的显示位置,最多支持2个画面。
275
+ - 自定义模板:适用于在混流中指定用户的画面位置,或者预设视频画面位置的场景。当预设位置指定用户时,排版引擎会该用户预留位置;当预设位置未指定用户时,排版引擎会根据进房间顺序自动填充。预设位置填满时,不再混合其他用户的画面和声音。自定义模板启用占位图功能时(LayoutParams中的PlaceHolderMode设置成1),在预设位置的用户没有上行视频时可显示对应的占位图(PlaceImageId)。
276
+
277
+ 注意:
278
+ 1、**混流转码为收费功能,调用接口将产生云端混流转码费用,详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**
279
+ 2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流,如需切换至MCU混流,请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。
280
+ 3、客户端混流和服务端混流不能混用。
281
+ */
282
+ async StartMCUMixTranscode(
283
+ req: StartMCUMixTranscodeRequest,
284
+ cb?: (error: string, rep: StartMCUMixTranscodeResponse) => void
285
+ ): Promise<StartMCUMixTranscodeResponse> {
286
+ return this.request("StartMCUMixTranscode", req, cb)
287
+ }
288
+
235
289
  /**
236
290
  * 接口说明:
237
291
  启动云端录制功能,完成房间内的音视频录制,并上传到指定的云存储。您可以通过此 API 接口把TRTC 房间中的每一路音视频流做单独的录制有或者多路视频画面混流一路。
@@ -274,13 +328,18 @@ TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过
274
328
  }
275
329
 
276
330
  /**
277
- * 如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁修改自定义背景图或水印素材,可通过此接口修改已上传的图片。无需频繁修改图片素材的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
278
- */
279
- async ModifyPicture(
280
- req: ModifyPictureRequest,
281
- cb?: (error: string, rep: ModifyPictureResponse) => void
282
- ): Promise<ModifyPictureResponse> {
283
- return this.request("ModifyPicture", req, cb)
331
+ * 获取TRTC旁路转推的用量明细。
332
+ - 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。
333
+ - 单次查询统计区间最多不能超过31天。
334
+ - 若查询当天用量,由于统计延迟等原因,返回数据可能不够准确。
335
+ - 该接口只用于历史用量数据统计或核对数据使用,关键业务逻辑不能使用。
336
+ - 默认接口请求频率限制:5次/秒。
337
+ */
338
+ async DescribeRelayUsage(
339
+ req: DescribeRelayUsageRequest,
340
+ cb?: (error: string, rep: DescribeRelayUsageResponse) => void
341
+ ): Promise<DescribeRelayUsageResponse> {
342
+ return this.request("DescribeRelayUsage", req, cb)
284
343
  }
285
344
 
286
345
  /**
@@ -317,33 +376,18 @@ TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过
317
376
  }
318
377
 
319
378
  /**
320
- * 接口说明:启动云端混流,并指定混流画面中各路画面的布局位置。
321
-
322
- TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过此 API 接口,通知腾讯云服务端将多路视频画面合成一路,并指定每一路画面的位置,同时将多路声音进行混音,最终形成一路音视频流,以便用于录制和直播观看。
323
-
324
- 您可以通过此接口实现如下目标:
325
- - 设置最终直播流的画质和音质,包括视频分辨率、视频码率、视频帧率、以及声音质量等。
326
- - 设置各路画面的位置和布局,您只需要在启动时设置一次,排版引擎会自动完成后续的画面排布。
327
- - 设置录制文件名,用于二次回放。
328
- - 设置 CDN 直播流 ID,用于在 CDN 进行直播观看。
329
-
330
- 目前已经支持了如下几种布局模板:
331
- - 悬浮模板:第一个进入房间的用户的视频画面会铺满整个屏幕,其他用户的视频画面从左下角依次水平排列,显示为小画面,最多4行,每行4个,小画面悬浮于大画面之上。最多支持1个大画面和15个小画面,如果用户只发送音频,仍然会占用画面位置。
332
- - 九宫格模板:所有用户的视频画面大小一致,平分整个屏幕,人数越多,每个画面的尺寸越小。最多支持16个画面,如果用户只发送音频,仍然会占用画面位置。
333
- - 屏幕分享模板:适合视频会议和在线教育场景的布局,屏幕分享(或者主讲的摄像头)始终占据屏幕左侧的大画面位置,其他用户依次垂直排列于右侧,最多两列,每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时,左侧大画面为了保持内容的完整性采用缩放方式处理,右侧小画面采用裁剪方式处理。
334
- - 画中画模板:适用于混合大小两路视频画面和其他用户混音,或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上,可以指定大小画面的用户以及小画面的显示位置。
335
- - 自定义模板:适用于在混流中指定用户的画面位置,或者预设视频画面位置的场景。当预设位置指定用户时,排版引擎会该用户预留位置;当预设位置未指定用户时,排版引擎会根据进房间顺序自动填充。预设位置填满时,不再混合其他用户的画面和声音。自定义模板启用占位图功能时(LayoutParams中的PlaceHolderMode设置成1),在预设位置的用户没有上行视频时可显示对应的占位图(PlaceImageId)。
336
-
337
- 注意:
338
- 1、**混流转码为收费功能,调用接口将产生云端混流转码费用,详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**
339
- 2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流,如需切换至MCU混流,请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。
340
- 3、客户端混流和服务端混流不能混用。
379
+ * 获取TRTC录制的用量明细。
380
+ - 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。
381
+ - 单次查询统计区间最多不能超过31天。
382
+ - 若查询当天用量,由于统计延迟等原因,返回数据可能不够准确。
383
+ - 该接口只用于历史用量数据统计或核对数据使用,关键业务逻辑不能使用。
384
+ - 默认接口请求频率限制:5次/秒。
341
385
  */
342
- async StartMCUMixTranscodeByStrRoomId(
343
- req: StartMCUMixTranscodeByStrRoomIdRequest,
344
- cb?: (error: string, rep: StartMCUMixTranscodeByStrRoomIdResponse) => void
345
- ): Promise<StartMCUMixTranscodeByStrRoomIdResponse> {
346
- return this.request("StartMCUMixTranscodeByStrRoomId", req, cb)
386
+ async DescribeRecordingUsage(
387
+ req: DescribeRecordingUsageRequest,
388
+ cb?: (error: string, rep: DescribeRecordingUsageResponse) => void
389
+ ): Promise<DescribeRecordingUsageResponse> {
390
+ return this.request("DescribeRecordingUsage", req, cb)
347
391
  }
348
392
 
349
393
  /**
@@ -356,6 +400,21 @@ TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过
356
400
  return this.request("RemoveUserByStrRoomId", req, cb)
357
401
  }
358
402
 
403
+ /**
404
+ * 获取TRTC混流转码的用量明细。
405
+ - 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。
406
+ - 单次查询统计区间最多不能超过31天。
407
+ - 若查询当天用量,由于统计延迟等原因,返回数据可能不够准确。
408
+ - 该接口只用于历史用量数据统计或核对数据使用,关键业务逻辑不能使用。
409
+ - 默认接口请求频率限制:5次/秒。
410
+ */
411
+ async DescribeMixTranscodingUsage(
412
+ req: DescribeMixTranscodingUsageRequest,
413
+ cb?: (error: string, rep: DescribeMixTranscodingUsageResponse) => void
414
+ ): Promise<DescribeMixTranscodingUsageResponse> {
415
+ return this.request("DescribeMixTranscodingUsage", req, cb)
416
+ }
417
+
359
418
  /**
360
419
  * 接口说明:把房间所有用户从房间移出,解散房间。支持所有平台,Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
361
420
  */
@@ -406,6 +465,16 @@ TRTC 的一个房间中可能会同时存在多路音视频流,您可以通过
406
465
  return this.request("DescribeCloudRecording", req, cb)
407
466
  }
408
467
 
468
+ /**
469
+ * 如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁修改自定义背景图或水印素材,可通过此接口修改已上传的图片。无需频繁修改图片素材的场景,建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
470
+ */
471
+ async ModifyPicture(
472
+ req: ModifyPictureRequest,
473
+ cb?: (error: string, rep: ModifyPictureResponse) => void
474
+ ): Promise<ModifyPictureResponse> {
475
+ return this.request("ModifyPicture", req, cb)
476
+ }
477
+
409
478
  /**
410
479
  * 成功开启录制后,可以使用此接口来停止录制任务。停止录制成功后不代表文件全部传输完成,如果未完成后台将会继续上传文件,成功后通过事件回调通知客户文件全部传输完成状态。
411
480
  */