tencentcloud-sdk-nodejs-trtc 4.1.250 → 4.1.257

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tencentcloud-sdk-nodejs-trtc",
3
- "version": "4.1.250",
3
+ "version": "4.1.257",
4
4
  "description": "腾讯云 API NODEJS SDK",
5
5
  "main": "./tencentcloud/index.js",
6
6
  "module": "./es/index.js",
@@ -2290,65 +2290,68 @@ export interface DescribeRoomInfoResponse {
2290
2290
  */
2291
2291
  export interface McuLayoutParams {
2292
2292
  /**
2293
- * 布局模式:动态布局(1:悬浮布局(默认),2:屏幕分享布局,3:九宫格布局),静态布局(4:自定义布局)。最多支持混入16路音视频流,如果用户只上行音频,也会被算作一路;自定义布局中,如果子画面只设置占位图,也被算作一路。
2293
+ * <p>布局模式:动态布局(1:悬浮布局(默认),2:屏幕分享布局,3:九宫格布局),静态布局(4:自定义布局)。最多支持混入16路音视频流,如果用户只上行音频,也会被算作一路;自定义布局中,如果子画面只设置占位图,也被算作一路。</p>
2294
2294
  */
2295
2295
  MixLayoutMode?: number;
2296
2296
  /**
2297
- * 纯音频上行是否占布局位置,只在动态布局中有效。0表示纯音频不占布局位置,1表示纯音频占布局位置,不填默认为0
2297
+ * <p>纯音频上行是否占布局位置,只在动态布局中有效。0表示纯音频不占布局位置,1表示纯音频占布局位置,不填默认为0。</p>
2298
2298
  */
2299
2299
  PureAudioHoldPlaceMode?: number;
2300
2300
  /**
2301
- * 自定义模板中有效,指定用户视频在混合画面中的位置,最多支持设置16个输入流。
2301
+ * <p>自定义模板中有效,指定用户视频在混合画面中的位置,最多支持设置16个输入流。</p>
2302
2302
  */
2303
2303
  MixLayoutList?: Array<McuLayout>;
2304
2304
  /**
2305
- * 指定动态布局中悬浮布局和屏幕分享布局的大画面信息,只在悬浮布局和屏幕分享布局有效。
2305
+ * <p>指定动态布局中悬浮布局和屏幕分享布局的大画面信息,只在悬浮布局和屏幕分享布局有效。</p>
2306
2306
  */
2307
2307
  MaxVideoUser?: MaxVideoUser;
2308
2308
  /**
2309
- * 屏幕分享模板、悬浮模板、九宫格模版有效,画面在输出时的显示模式:0为裁剪,1为缩放,2为缩放并显示黑底
2309
+ * <p>屏幕分享模板、悬浮模板、九宫格模版有效,画面在输出时的显示模式:0为裁剪,1为缩放,2为缩放并显示黑底</p>
2310
2310
  */
2311
2311
  RenderMode?: number;
2312
+ /**
2313
+ * <p>是否保留上行sei,1:保留 0:不保留,只对动态布局生效,自定义布局不生效</p><p>取值范围:[0, 1]</p><p>默认值:1</p>
2314
+ */
2315
+ EnableStreamSEI?: number;
2312
2316
  }
2313
2317
  /**
2314
2318
  * StartWebRecord请求参数结构体
2315
2319
  */
2316
2320
  export interface StartWebRecordRequest {
2317
2321
  /**
2318
- * 【必填】需要录制的网页URL
2322
+ * <p>【必填】需要录制的网页URL</p>
2319
2323
  */
2320
2324
  RecordUrl: string;
2321
2325
  /**
2322
- * 【必填】云存储相关的参数,目前支持腾讯云对象存储以及腾讯云云点播VOD,不支持第三方云存储;输出文件的存储格式仅支持hls或mp4
2326
+ * <p>【必填】云存储相关的参数,目前支持腾讯云对象存储以及腾讯云云点播VOD,不支持第三方云存储;输出文件的存储格式仅支持hls或mp4</p>
2323
2327
  */
2324
2328
  StorageParams: StorageParams;
2325
2329
  /**
2326
- * 【必填】TRTC的SdkAppId
2330
+ * <p>【必填】TRTC的SdkAppId</p>
2327
2331
  */
2328
2332
  SdkAppId: number;
2329
2333
  /**
2330
- * 录制最大时长限制, 单位 s, 合法取值范围[1800, 86400], 默认 86400s(24 小时)
2334
+ * <p>录制最大时长限制, 单位 s, 合法取值范围[1800, 86400], 默认 86400s(24 小时)</p>
2331
2335
  */
2332
2336
  MaxDurationLimit?: number;
2333
2337
  /**
2334
- * 页面录制视频参数
2338
+ * <p>页面录制视频参数</p>
2335
2339
  */
2336
2340
  WebRecordVideoParams?: WebRecordVideoParams;
2337
2341
  /**
2338
- * 当对重复任务敏感时,请关注此值: 为了避免任务在短时间内重复发起,导致任务重复
2339
- 传入录制RecordId来标识此次任务, 小于32字节,若携带RecordId发起两次以上的开始录制请求,任务只会启动一个,第二个报错FailedOperation.TaskExist。注意StartWebRecord调用失败时而非FailedOperation.TaskExist错误,请更换RecordId重新发起。
2342
+ * <p>当对重复任务敏感时,请关注此值: 为了避免任务在短时间内重复发起,导致任务重复<br>传入录制RecordId来标识此次任务, 小于32字节,若携带RecordId发起两次以上的开始录制请求,任务只会启动一个,第二个报错FailedOperation.TaskExist。注意StartWebRecord调用失败时而非FailedOperation.TaskExist错误,请更换RecordId重新发起。</p>
2340
2343
  */
2341
2344
  RecordId?: string;
2342
2345
  /**
2343
- * 若您想要推流到CDN,可以使用PublishCdnParams.N参数设置,支持最多同时推流到10个CDN地址。若转推地址是腾讯云CDN时,请将IsTencentCdn明确设置为1
2346
+ * <p>若您想要推流到CDN,可以使用PublishCdnParams.N参数设置,支持最多同时推流到10个CDN地址。若转推地址是腾讯云CDN时,请将IsTencentCdn明确设置为1</p>
2344
2347
  */
2345
2348
  PublishCdnParams?: Array<McuPublishCdnParam>;
2346
2349
  /**
2347
- * 录制页面资源加载的超时时间,单位:秒。默认值为 0 秒,该值需大于等于 0秒,且小于等于 60秒。录制页面未启用页面加载超时检测时,请勿设置此参数。
2350
+ * <p>录制页面资源加载的超时时间,单位:秒。默认值为 0 秒,该值需大于等于 0秒,且小于等于 60秒。录制页面未启用页面加载超时检测时,请勿设置此参数。</p>
2348
2351
  */
2349
2352
  ReadyTimeout?: number;
2350
2353
  /**
2351
- * 渲染移动模式参数;不准备渲染移动模式页面时,请勿设置此参数。
2354
+ * <p>渲染移动模式参数;不准备渲染移动模式页面时,请勿设置此参数。</p>
2352
2355
  */
2353
2356
  EmulateMobileParams?: EmulateMobileParams;
2354
2357
  }
@@ -2528,82 +2531,65 @@ export interface DeleteCloudTranscriptionResponse {
2528
2531
  */
2529
2532
  export interface McuLayout {
2530
2533
  /**
2531
- * 用户媒体流参数。不填时腾讯云后台按照上行主播的进房顺序自动填充。
2534
+ * <p>用户媒体流参数。不填时腾讯云后台按照上行主播的进房顺序自动填充。</p>
2532
2535
  */
2533
2536
  UserMediaStream?: UserMediaStream;
2534
2537
  /**
2535
- * 子画面在输出时的宽度,单位为像素值,不填默认为0
2538
+ * <p>子画面在输出时的宽度,单位为像素值,不填默认为0。</p>
2536
2539
  */
2537
2540
  ImageWidth?: number;
2538
2541
  /**
2539
- * 子画面在输出时的高度,单位为像素值,不填默认为0
2542
+ * <p>子画面在输出时的高度,单位为像素值,不填默认为0。</p>
2540
2543
  */
2541
2544
  ImageHeight?: number;
2542
2545
  /**
2543
- * 子画面在输出时的X偏移,单位为像素值,LocationX与ImageWidth之和不能超过混流输出的总宽度,不填默认为0
2546
+ * <p>子画面在输出时的X偏移,单位为像素值,LocationX与ImageWidth之和不能超过混流输出的总宽度,不填默认为0。</p>
2544
2547
  */
2545
2548
  LocationX?: number;
2546
2549
  /**
2547
- * 子画面在输出时的Y偏移,单位为像素值,LocationY与ImageHeight之和不能超过混流输出的总高度,不填默认为0
2550
+ * <p>子画面在输出时的Y偏移,单位为像素值,LocationY与ImageHeight之和不能超过混流输出的总高度,不填默认为0。</p>
2548
2551
  */
2549
2552
  LocationY?: number;
2550
2553
  /**
2551
- * 子画面在输出时的层级,不填默认为0
2554
+ * <p>子画面在输出时的层级,不填默认为0。</p>
2552
2555
  */
2553
2556
  ZOrder?: number;
2554
2557
  /**
2555
- * 子画面在输出时的显示模式:0为裁剪,1为缩放并显示背景,2为缩放并显示黑底。不填默认为0
2558
+ * <p>子画面在输出时的显示模式:0为裁剪,1为缩放并显示背景,2为缩放并显示黑底。不填默认为0。</p>
2556
2559
  */
2557
2560
  RenderMode?: number;
2558
2561
  /**
2559
- * 【此参数配置无效,暂不支持】子画面的背景颜色,常用的颜色有:
2560
- 红色:0xcc0033。
2561
- 黄色:0xcc9900。
2562
- 绿色:0xcccc33。
2563
- 蓝色:0x99CCFF。
2564
- 黑色:0x000000。
2565
- 白色:0xFFFFFF。
2566
- 灰色:0x999999。
2562
+ * <p>【此参数配置无效,暂不支持】子画面的背景颜色,常用的颜色有:<br>红色:0xcc0033。<br>黄色:0xcc9900。<br>绿色:0xcccc33。<br>蓝色:0x99CCFF。<br>黑色:0x000000。<br>白色:0xFFFFFF。<br>灰色:0x999999。</p>
2567
2563
  */
2568
2564
  BackGroundColor?: string;
2569
2565
  /**
2570
- * 子画面的占位图片url,填写该参数,当用户关闭摄像头或未进入TRTC房间时,会在布局位置填充为指定图片。若指定图片与布局位置尺寸比例不一致,则会对图片进行拉伸处理,优先级高于BackGroundColor。支持png、jpg、jpeg、bmp、gif、webm格式。图片分辨率限制不超过2K,图片大小限制不超过5MB
2571
- 注:
2572
- 1,您需要确保图片链接的可访问性,后台单次下载超时时间为10秒,最多重试3次,若最终图片下载失败,占位图片将不会生效。
2573
- 2,url可支持字符集:【'0-9','a-z','A-Z','-', '.', '_', '~', ':', '/', '?', '#', '[', ']','@', '!', '&', '(', ')', '*', '+', ',', '%', '=', ';', '|'】,您需要确保url字符在可支持字符集内,若存在可支持字符集外的字符,占位图片将不会生效。
2566
+ * <p>子画面的占位图片url,填写该参数,当用户关闭摄像头或未进入TRTC房间时,会在布局位置填充为指定图片。若指定图片与布局位置尺寸比例不一致,则会对图片进行拉伸处理,优先级高于BackGroundColor。支持png、jpg、jpeg、bmp、gif、webm格式。图片分辨率限制不超过2K,图片大小限制不超过5MB。<br>注:<br>1,您需要确保图片链接的可访问性,后台单次下载超时时间为10秒,最多重试3次,若最终图片下载失败,占位图片将不会生效。<br>2,url可支持字符集:【&#39;0-9&#39;,&#39;a-z&#39;,&#39;A-Z&#39;,&#39;-&#39;, &#39;.&#39;, &#39;_&#39;, &#39;~&#39;, &#39;:&#39;, &#39;/&#39;, &#39;?&#39;, &#39;#&#39;, &#39;[&#39;, &#39;]&#39;,&#39;@&#39;, &#39;!&#39;, &#39;&amp;&#39;, &#39;(&#39;, &#39;)&#39;, &#39;*&#39;, &#39;+&#39;, &#39;,&#39;, &#39;%&#39;, &#39;=&#39;, &#39;;&#39;, &#39;|&#39;】,您需要确保url字符在可支持字符集内,若存在可支持字符集外的字符,占位图片将不会生效。</p>
2574
2567
  */
2575
2568
  BackgroundImageUrl?: string;
2576
2569
  /**
2577
- * 客户自定义裁剪,针对原始输入流裁剪
2570
+ * <p>客户自定义裁剪,针对原始输入流裁剪</p>
2578
2571
  */
2579
2572
  CustomCrop?: McuCustomCrop;
2580
2573
  /**
2581
- * 子背景图在输出时的显示模式:0为裁剪,1为缩放并显示背景,2为缩放并显示黑底,3为变比例伸缩,4为自定义渲染。不填默认为3
2574
+ * <p>子背景图在输出时的显示模式:0为裁剪,1为缩放并显示背景,2为缩放并显示黑底,3为变比例伸缩,4为自定义渲染。不填默认为3。</p>
2582
2575
  */
2583
2576
  BackgroundRenderMode?: number;
2584
2577
  /**
2585
- * 子画面的透明模版url,指向一张包含透明通道的模板图片。填写该参数,后台混流时会提取该模板图片的透明通道,将其缩放作为目标画面的透明通道,再和其他画面进行混合。您可以通过透明模版实现目标画面的半透明效果和任意形状裁剪(如圆角、星形、心形等)。 支持png格式。图片分辨率限制不超过2K,图片大小限制不超过5MB
2586
- 注:
2587
- 1,模板图片宽高比应接近目标画面宽高比,以避免缩放适配目标画面时出现模板效果变形;2,透明模版只有RenderMode为0(裁剪)时才生效;3,您需要确保图片链接的可访问性,后台单次下载超时时间为10秒,最多重试3次,若最终图片下载失败,透明模板将不会生效。
2588
- 2,url可支持字符集:【'0-9','a-z','A-Z','-', '.', '_', '~', ':', '/', '?', '#', '[', ']','@', '!', '&', '(', ')', '*', '+', ',', '%', '=', ';', '|'】,您需要确保url字符在可支持字符集内,若存在可支持字符集外的字符,透明模版将不会生效。
2578
+ * <p>子画面的透明模版url,指向一张包含透明通道的模板图片。填写该参数,后台混流时会提取该模板图片的透明通道,将其缩放作为目标画面的透明通道,再和其他画面进行混合。您可以通过透明模版实现目标画面的半透明效果和任意形状裁剪(如圆角、星形、心形等)。 支持png格式。图片分辨率限制不超过2K,图片大小限制不超过5MB。<br>注:<br>1,模板图片宽高比应接近目标画面宽高比,以避免缩放适配目标画面时出现模板效果变形;2,透明模版只有RenderMode为0(裁剪)时才生效;3,您需要确保图片链接的可访问性,后台单次下载超时时间为10秒,最多重试3次,若最终图片下载失败,透明模板将不会生效。<br>2,url可支持字符集:【&#39;0-9&#39;,&#39;a-z&#39;,&#39;A-Z&#39;,&#39;-&#39;, &#39;.&#39;, &#39;_&#39;, &#39;~&#39;, &#39;:&#39;, &#39;/&#39;, &#39;?&#39;, &#39;#&#39;, &#39;[&#39;, &#39;]&#39;,&#39;@&#39;, &#39;!&#39;, &#39;&amp;&#39;, &#39;(&#39;, &#39;)&#39;, &#39;*&#39;, &#39;+&#39;, &#39;,&#39;, &#39;%&#39;, &#39;=&#39;, &#39;;&#39;, &#39;|&#39;】,您需要确保url字符在可支持字符集内,若存在可支持字符集外的字符,透明模版将不会生效。</p>
2589
2579
  */
2590
2580
  TransparentUrl?: string;
2591
2581
  /**
2592
- * 子背景图的自定义渲染参数,当BackgroundRenderMode为4时必须配置。
2582
+ * <p>子背景图的自定义渲染参数,当BackgroundRenderMode为4时必须配置。</p>
2593
2583
  */
2594
2584
  BackgroundCustomRender?: McuBackgroundCustomRender;
2595
2585
  /**
2596
- * 子背景色生效模式,默认值为0表示均不生效。
2597
- bit0:占位图缩放是否生效。
2598
- bit1:上行流缩放是否生效。
2599
- 您可以将相应bit位置1启动生效,例如:
2600
- 0(00)表示子背景色不生效。
2601
- 1(01)表示子背景色只在占位图缩放时生效。
2602
- 2(10)表示子背景色只在上行流缩放时生效。
2603
- 3(11)表示子背景色在占位图缩放和上行流缩放时均生效。
2604
-
2586
+ * <p>子背景色生效模式,默认值为0表示均不生效。<br>bit0:占位图缩放是否生效。<br>bit1:上行流缩放是否生效。<br>您可以将相应bit位置1启动生效,例如:<br>0(00)表示子背景色不生效。<br>1(01)表示子背景色只在占位图缩放时生效。<br>2(10)表示子背景色只在上行流缩放时生效。<br>3(11)表示子背景色在占位图缩放和上行流缩放时均生效。</p>
2605
2587
  */
2606
2588
  BackGroundColorMode?: number;
2589
+ /**
2590
+ * <p>是否保留上行SEI,1:保留 0:不保留</p><p>取值范围:[0, 1]</p><p>默认值:1</p>
2591
+ */
2592
+ EnableStreamSEI?: number;
2607
2593
  }
2608
2594
  /**
2609
2595
  * DescribeUserInfo返回参数结构体
@@ -3117,6 +3103,31 @@ export interface DescribeScaleInfoResponse {
3117
3103
  */
3118
3104
  RequestId?: string;
3119
3105
  }
3106
+ /**
3107
+ * 词级别对齐信息
3108
+ */
3109
+ export interface WordItem {
3110
+ /**
3111
+ * <p>词对应的文本</p>
3112
+ */
3113
+ Word?: string;
3114
+ /**
3115
+ * <p>词对应的时间起点</p>
3116
+ */
3117
+ TimeBeginMs?: number;
3118
+ /**
3119
+ * <p>词对应的时间尾点</p>
3120
+ */
3121
+ TimeEndMs?: number;
3122
+ /**
3123
+ * <p>词的索引起点</p>
3124
+ */
3125
+ WordBegin?: number;
3126
+ /**
3127
+ * <p>词的索引尾点</p>
3128
+ */
3129
+ WordEnd?: number;
3130
+ }
3120
3131
  /**
3121
3132
  * 录制的混流布局参数。
3122
3133
  */
@@ -3529,7 +3540,7 @@ export interface UsageList {
3529
3540
  */
3530
3541
  export interface StartWebRecordResponse {
3531
3542
  /**
3532
- * 录制任务的唯一Id
3543
+ * <p>录制任务的唯一Id</p>
3533
3544
  */
3534
3545
  TaskId?: string;
3535
3546
  /**
@@ -5148,7 +5159,7 @@ export interface TextToSpeechSSERequest {
5148
5159
  */
5149
5160
  PronunciationDict?: Array<PronunciationDict>;
5150
5161
  /**
5151
- * <p>默认为0,0表示不生成字幕,1表示生成字幕</p>
5162
+ * <p>字幕级别</p><p>枚举值:</p><ul><li>0: 无字幕</li><li>1: 句子级别字幕</li><li>2: 词级别字幕,目前只有flow_01_ex支持</li></ul><p>默认值:0</p>
5152
5163
  */
5153
5164
  AlignmentMode?: number;
5154
5165
  /**
@@ -5499,7 +5510,7 @@ export interface TextToSpeechRequest {
5499
5510
  */
5500
5511
  PronunciationDict?: Array<PronunciationDict>;
5501
5512
  /**
5502
- * <p>默认为0,0表示不生成字幕,1表示生成字幕</p>
5513
+ * <p>字幕级别</p><p>枚举值:</p><ul><li>0: 无字幕</li><li>1: 句子级别字幕</li><li>2: 词级别字幕,目前只有flow_01_ex支持词级别字幕</li></ul><p>默认值:0</p>
5503
5514
  */
5504
5515
  AlignmentMode?: number;
5505
5516
  /**
@@ -5957,19 +5968,27 @@ export interface RemoveUserResponse {
5957
5968
  */
5958
5969
  export interface AlignmentItem {
5959
5970
  /**
5960
- * 字幕对应的时间起点
5971
+ * <p>字幕文本</p>
5972
+ */
5973
+ Text?: string;
5974
+ /**
5975
+ * <p>字幕对应的时间起点</p>
5961
5976
  */
5962
5977
  TimeBeginMs?: number;
5963
5978
  /**
5964
- * 字幕对应的时间尾点
5979
+ * <p>字幕对应的时间尾点</p>
5965
5980
  */
5966
5981
  TimeEndMs?: number;
5967
5982
  /**
5968
- * 字幕对应的文本索引起点
5983
+ * <p>字幕对应的文本索引起点</p>
5969
5984
  */
5970
5985
  TextBegin?: number;
5971
5986
  /**
5972
- * 字幕对应的文本索引尾点
5987
+ * <p>字幕对应的文本索引尾点</p>
5973
5988
  */
5974
5989
  TextEnd?: number;
5990
+ /**
5991
+ * <p>词级别时间戳</p>
5992
+ */
5993
+ Words?: Array<WordItem>;
5975
5994
  }