tencentcloud-sdk-nodejs-trtc 4.0.458 → 4.0.460

package/tencentcloud/services/trtc/v20190722/trtc_client.d.ts

@@ -1,5 +1,5 @@
 import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
-import { CreatePictureRequest, RemoveUserByStrRoomIdResponse, StartMCUMixTranscodeRequest, DescribeUserEventRequest, StartMCUMixTranscodeByStrRoomIdRequest, DescribeUserEventResponse, StopMCUMixTranscodeByStrRoomIdResponse, DescribeCallDetailInfoRequest, DescribeUserInfoRequest, DescribeRecordStatisticResponse, StartMCUMixTranscodeByStrRoomIdResponse, DismissRoomByStrRoomIdRequest, DescribeRecordStatisticRequest, DescribeRoomInfoRequest, DescribeCallDetailInfoResponse, ModifyPictureRequest, DescribeRoomInfoResponse, DescribeUserInfoResponse, ModifyPictureResponse, DescribeScaleInfoResponse, StopMCUMixTranscodeResponse, RemoveUserRequest, DismissRoomRequest, DescribeUnusualEventRequest, DescribeCloudRecordingRequest, StopMCUMixTranscodeRequest, CreateCloudRecordingRequest, DeleteCloudRecordingResponse, StopMCUMixTranscodeByStrRoomIdRequest, DeletePictureResponse, ModifyCloudRecordingRequest, CreateCloudRecordingResponse, StartMCUMixTranscodeResponse, DescribeTrtcMcuTranscodeTimeResponse, DeleteCloudRecordingRequest, DescribePictureRequest, DescribeExternalTrtcMeasureResponse, DescribePictureResponse, DescribeTrtcMcuTranscodeTimeRequest, DescribeScaleInfoRequest, DismissRoomByStrRoomIdResponse, DescribeUnusualEventResponse, ModifyCloudRecordingResponse, DescribeCloudRecordingResponse, DismissRoomResponse, DeletePictureRequest, DescribeExternalTrtcMeasureRequest, RemoveUserByStrRoomIdRequest, CreatePictureResponse, RemoveUserResponse } from "./trtc_models";
+import { CreatePictureRequest, DescribeRelayUsageRequest, RemoveUserByStrRoomIdResponse, StartMCUMixTranscodeRequest, DescribeUserEventRequest, StartMCUMixTranscodeByStrRoomIdRequest, DescribeUserEventResponse, StopMCUMixTranscodeByStrRoomIdResponse, DescribeCallDetailInfoRequest, DescribeUserInfoRequest, DescribeRecordStatisticResponse, StartMCUMixTranscodeByStrRoomIdResponse, DescribeTrtcUsageResponse, DismissRoomByStrRoomIdRequest, DescribeRecordStatisticRequest, DescribeRoomInfoRequest, DescribeCallDetailInfoResponse, DescribeMixTranscodingUsageRequest, ModifyPictureRequest, DescribeTrtcUsageRequest, DescribeRoomInfoResponse, DescribeUserInfoResponse, DescribeRelayUsageResponse, DescribeRecordingUsageResponse, ModifyPictureResponse, DescribeRecordingUsageRequest, DescribeScaleInfoResponse, StopMCUMixTranscodeResponse, DescribeMixTranscodingUsageResponse, RemoveUserRequest, DismissRoomRequest, DescribeUnusualEventRequest, DescribeCloudRecordingRequest, StopMCUMixTranscodeRequest, CreateCloudRecordingRequest, DeleteCloudRecordingResponse, StopMCUMixTranscodeByStrRoomIdRequest, DeletePictureResponse, ModifyCloudRecordingRequest, CreateCloudRecordingResponse, StartMCUMixTranscodeResponse, DescribeTrtcMcuTranscodeTimeResponse, DeleteCloudRecordingRequest, DescribePictureRequest, DescribeExternalTrtcMeasureResponse, DescribePictureResponse, DescribeTrtcMcuTranscodeTimeRequest, DescribeScaleInfoRequest, DismissRoomByStrRoomIdResponse, DescribeUnusualEventResponse, ModifyCloudRecordingResponse, DescribeCloudRecordingResponse, DismissRoomResponse, DeletePictureRequest, DescribeExternalTrtcMeasureRequest, RemoveUserByStrRoomIdRequest, CreatePictureResponse, RemoveUserResponse } from "./trtc_models";
 /**
  * trtc client
  * @class
@@ -13,10 +13,30 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
   2.该接口目前免费提供中，监控仪表盘商业化计费后该接口需要订阅付费版后方可调用，仪表盘商业化说明请见：https://cloud.tencent.com/document/product/647/77735
        */
     DescribeRoomInfo(req: DescribeRoomInfoRequest, cb?: (error: string, rep: DescribeRoomInfoResponse) => void): Promise<DescribeRoomInfoResponse>;
+    /**
+       * 获取TRTC音视频互动的用量明细。
+  - 查询时间小于等于1天时，返回每5分钟粒度的数据；查询时间大于1天时，返回按天汇总的数据。
+  - 单次查询统计区间最多不能超过31天。
+  - 若查询当天用量，由于统计延迟等原因，返回数据可能不够准确。
+  - 该接口只用于历史用量数据统计或核对数据使用，关键业务逻辑不能使用。
+  - 默认接口请求频率限制：5次/秒。
+       */
+    DescribeTrtcUsage(req: DescribeTrtcUsageRequest, cb?: (error: string, rep: DescribeTrtcUsageResponse) => void): Promise<DescribeTrtcUsageResponse>;
+    /**
+       * 查询指定时间内的用户列表及用户通话质量数据，可查询14天内数据。DataType 不为null，查询起止时间不超过1个小时，查询用户不超过6个，支持跨天查询。DataType为null时，查询起止时间不超过4个小时， 默认查询6个用户，同时支持每页查询100以内用户个数（PageSize不超过100）。接口用于查询质量问题，不推荐作为计费使用。（同老接口DescribeCallDetail）
+  **注意**：
+  1.该接口只用于历史数据统计或核对数据使用，实时类关键业务逻辑不能使用。
+  2.该接口目前免费提供中，监控仪表盘商业化计费后该接口需要订阅付费版后方可调用，仪表盘商业化说明请见：https://cloud.tencent.com/document/product/647/77735
+       */
+    DescribeCallDetailInfo(req: DescribeCallDetailInfoRequest, cb?: (error: string, rep: DescribeCallDetailInfoResponse) => void): Promise<DescribeCallDetailInfoResponse>;
+    /**
+     * 接口说明：结束云端混流
+     */
+    StopMCUMixTranscode(req: StopMCUMixTranscodeRequest, cb?: (error: string, rep: StopMCUMixTranscodeResponse) => void): Promise<StopMCUMixTranscodeResponse>;
     /**
        * 接口说明：启动云端混流，并指定混流画面中各路画面的布局位置。
   
-  TRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。房间销毁后混流自动结束。
+  TRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。
   
   您可以通过此接口实现如下目标：
   - 设置最终直播流的画质和音质，包括视频分辨率、视频码率、视频帧率、以及声音质量等。
@@ -28,7 +48,7 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
   - 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频，仍然会占用画面位置。
   - 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，仍然会占用画面位置。
   - 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。
-  - 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置，最多支持2个画面。
+  - 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置。
   - 自定义模板：适用于在混流中指定用户的画面位置，或者预设视频画面位置的场景。当预设位置指定用户时，排版引擎会该用户预留位置；当预设位置未指定用户时，排版引擎会根据进房间顺序自动填充。预设位置填满时，不再混合其他用户的画面和声音。自定义模板启用占位图功能时（LayoutParams中的PlaceHolderMode设置成1），在预设位置的用户没有上行视频时可显示对应的占位图（PlaceImageId）。
   
   注意：
@@ -36,18 +56,7 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
   2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流，如需切换至MCU混流，请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。
   3、客户端混流和服务端混流不能混用。
        */
-    StartMCUMixTranscode(req: StartMCUMixTranscodeRequest, cb?: (error: string, rep: StartMCUMixTranscodeResponse) => void): Promise<StartMCUMixTranscodeResponse>;
-    /**
-       * 查询指定时间内的用户列表及用户通话质量数据，可查询14天内数据。DataType 不为null，查询起止时间不超过1个小时，查询用户不超过6个，支持跨天查询。DataType为null时，查询起止时间不超过4个小时， 默认查询6个用户，同时支持每页查询100以内用户个数（PageSize不超过100）。接口用于查询质量问题，不推荐作为计费使用。（同老接口DescribeCallDetail）
-  **注意**：
-  1.该接口只用于历史数据统计或核对数据使用，实时类关键业务逻辑不能使用。
-  2.该接口目前免费提供中，监控仪表盘商业化计费后该接口需要订阅付费版后方可调用，仪表盘商业化说明请见：https://cloud.tencent.com/document/product/647/77735
-       */
-    DescribeCallDetailInfo(req: DescribeCallDetailInfoRequest, cb?: (error: string, rep: DescribeCallDetailInfoResponse) => void): Promise<DescribeCallDetailInfoResponse>;
-    /**
-     * 接口说明：结束云端混流
-     */
-    StopMCUMixTranscode(req: StopMCUMixTranscodeRequest, cb?: (error: string, rep: StopMCUMixTranscodeResponse) => void): Promise<StopMCUMixTranscodeResponse>;
+    StartMCUMixTranscodeByStrRoomId(req: StartMCUMixTranscodeByStrRoomIdRequest, cb?: (error: string, rep: StartMCUMixTranscodeByStrRoomIdResponse) => void): Promise<StartMCUMixTranscodeByStrRoomIdResponse>;
     /**
      * 如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁删除自定义背景图或水印，可通过此接口删除已上传的图片。无需频繁删除图片的场景，建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
      */
@@ -68,6 +77,30 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
      * 查询用户某次通话内的进退房，视频开关等详细事件。可查询14天内数据。（同接口DescribeDetailEvent）
      */
     DescribeUserEvent(req: DescribeUserEventRequest, cb?: (error: string, rep: DescribeUserEventResponse) => void): Promise<DescribeUserEventResponse>;
+    /**
+       * 接口说明：启动云端混流，并指定混流画面中各路画面的布局位置。
+  
+  TRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。房间销毁后混流自动结束。
+  
+  您可以通过此接口实现如下目标：
+  - 设置最终直播流的画质和音质，包括视频分辨率、视频码率、视频帧率、以及声音质量等。
+  - 设置各路画面的位置和布局，您只需要在启动时设置一次，排版引擎会自动完成后续的画面排布。
+  - 设置录制文件名，用于二次回放。
+  - 设置 CDN 直播流 ID，用于在 CDN 进行直播观看。
+  
+  目前已经支持了如下几种布局模板：
+  - 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频，仍然会占用画面位置。
+  - 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，仍然会占用画面位置。
+  - 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。
+  - 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置，最多支持2个画面。
+  - 自定义模板：适用于在混流中指定用户的画面位置，或者预设视频画面位置的场景。当预设位置指定用户时，排版引擎会该用户预留位置；当预设位置未指定用户时，排版引擎会根据进房间顺序自动填充。预设位置填满时，不再混合其他用户的画面和声音。自定义模板启用占位图功能时（LayoutParams中的PlaceHolderMode设置成1），在预设位置的用户没有上行视频时可显示对应的占位图（PlaceImageId）。
+  
+  注意：
+  1、**混流转码为收费功能，调用接口将产生云端混流转码费用，详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**
+  2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流，如需切换至MCU混流，请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。
+  3、客户端混流和服务端混流不能混用。
+       */
+    StartMCUMixTranscode(req: StartMCUMixTranscodeRequest, cb?: (error: string, rep: StartMCUMixTranscodeResponse) => void): Promise<StartMCUMixTranscodeResponse>;
     /**
        * 接口说明：
   启动云端录制功能，完成房间内的音视频录制，并上传到指定的云存储。您可以通过此 API 接口把TRTC 房间中的每一路音视频流做单独的录制有或者多路视频画面混流一路。
@@ -92,9 +125,14 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
      */
     DescribeScaleInfo(req: DescribeScaleInfoRequest, cb?: (error: string, rep: DescribeScaleInfoResponse) => void): Promise<DescribeScaleInfoResponse>;
     /**
-     * 如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁修改自定义背景图或水印素材，可通过此接口修改已上传的图片。无需频繁修改图片素材的场景，建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
-     */
-    ModifyPicture(req: ModifyPictureRequest, cb?: (error: string, rep: ModifyPictureResponse) => void): Promise<ModifyPictureResponse>;
+       * 获取TRTC旁路转推的用量明细。
+  - 查询时间小于等于1天时，返回每5分钟粒度的数据；查询时间大于1天时，返回按天汇总的数据。
+  - 单次查询统计区间最多不能超过31天。
+  - 若查询当天用量，由于统计延迟等原因，返回数据可能不够准确。
+  - 该接口只用于历史用量数据统计或核对数据使用，关键业务逻辑不能使用。
+  - 默认接口请求频率限制：5次/秒。
+       */
+    DescribeRelayUsage(req: DescribeRelayUsageRequest, cb?: (error: string, rep: DescribeRelayUsageResponse) => void): Promise<DescribeRelayUsageResponse>;
     /**
        * 查询指定时间内的用户列表，可查询14天内数据，查询起止时间不超过4小时。默认每页查询6个用户，支持每页最大查询100个用户PageSize不超过100）。（同老接口DescribeUserInformation）
   **注意**：
@@ -111,33 +149,27 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
      */
     StopMCUMixTranscodeByStrRoomId(req: StopMCUMixTranscodeByStrRoomIdRequest, cb?: (error: string, rep: StopMCUMixTranscodeByStrRoomIdResponse) => void): Promise<StopMCUMixTranscodeByStrRoomIdResponse>;
     /**
-       * 接口说明：启动云端混流，并指定混流画面中各路画面的布局位置。
-  
-  TRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。
-  
-  您可以通过此接口实现如下目标：
-  - 设置最终直播流的画质和音质，包括视频分辨率、视频码率、视频帧率、以及声音质量等。
-  - 设置各路画面的位置和布局，您只需要在启动时设置一次，排版引擎会自动完成后续的画面排布。
-  - 设置录制文件名，用于二次回放。
-  - 设置 CDN 直播流 ID，用于在 CDN 进行直播观看。
-  
-  目前已经支持了如下几种布局模板：
-  - 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频，仍然会占用画面位置。
-  - 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，仍然会占用画面位置。
-  - 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。
-  - 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置。
-  - 自定义模板：适用于在混流中指定用户的画面位置，或者预设视频画面位置的场景。当预设位置指定用户时，排版引擎会该用户预留位置；当预设位置未指定用户时，排版引擎会根据进房间顺序自动填充。预设位置填满时，不再混合其他用户的画面和声音。自定义模板启用占位图功能时（LayoutParams中的PlaceHolderMode设置成1），在预设位置的用户没有上行视频时可显示对应的占位图（PlaceImageId）。
-  
-  注意：
-  1、**混流转码为收费功能，调用接口将产生云端混流转码费用，详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**
-  2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流，如需切换至MCU混流，请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。
-  3、客户端混流和服务端混流不能混用。
+       * 获取TRTC录制的用量明细。
+  - 查询时间小于等于1天时，返回每5分钟粒度的数据；查询时间大于1天时，返回按天汇总的数据。
+  - 单次查询统计区间最多不能超过31天。
+  - 若查询当天用量，由于统计延迟等原因，返回数据可能不够准确。
+  - 该接口只用于历史用量数据统计或核对数据使用，关键业务逻辑不能使用。
+  - 默认接口请求频率限制：5次/秒。
        */
-    StartMCUMixTranscodeByStrRoomId(req: StartMCUMixTranscodeByStrRoomIdRequest, cb?: (error: string, rep: StartMCUMixTranscodeByStrRoomIdResponse) => void): Promise<StartMCUMixTranscodeByStrRoomIdResponse>;
+    DescribeRecordingUsage(req: DescribeRecordingUsageRequest, cb?: (error: string, rep: DescribeRecordingUsageResponse) => void): Promise<DescribeRecordingUsageResponse>;
     /**
      * 接口说明：将用户从房间移出，适用于主播/房主/管理员踢人等场景。支持所有平台，Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
      */
     RemoveUserByStrRoomId(req: RemoveUserByStrRoomIdRequest, cb?: (error: string, rep: RemoveUserByStrRoomIdResponse) => void): Promise<RemoveUserByStrRoomIdResponse>;
+    /**
+       * 获取TRTC混流转码的用量明细。
+  - 查询时间小于等于1天时，返回每5分钟粒度的数据；查询时间大于1天时，返回按天汇总的数据。
+  - 单次查询统计区间最多不能超过31天。
+  - 若查询当天用量，由于统计延迟等原因，返回数据可能不够准确。
+  - 该接口只用于历史用量数据统计或核对数据使用，关键业务逻辑不能使用。
+  - 默认接口请求频率限制：5次/秒。
+       */
+    DescribeMixTranscodingUsage(req: DescribeMixTranscodingUsageRequest, cb?: (error: string, rep: DescribeMixTranscodingUsageResponse) => void): Promise<DescribeMixTranscodingUsageResponse>;
     /**
      * 接口说明：把房间所有用户从房间移出，解散房间。支持所有平台，Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
      */
@@ -164,6 +196,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
   录制文件上传到云点播VOD时，StorageFileList中不会返回录制文件信息，请订阅相关录制文件回调事件，获取录制文件信息。
        */
     DescribeCloudRecording(req: DescribeCloudRecordingRequest, cb?: (error: string, rep: DescribeCloudRecordingResponse) => void): Promise<DescribeCloudRecordingResponse>;
+    /**
+     * 如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁修改自定义背景图或水印素材，可通过此接口修改已上传的图片。无需频繁修改图片素材的场景，建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
+     */
+    ModifyPicture(req: ModifyPictureRequest, cb?: (error: string, rep: ModifyPictureResponse) => void): Promise<ModifyPictureResponse>;
     /**
      * 成功开启录制后，可以使用此接口来停止录制任务。停止录制成功后不代表文件全部传输完成，如果未完成后台将会继续上传文件，成功后通过事件回调通知客户文件全部传输完成状态。
      */

package/tencentcloud/services/trtc/v20190722/trtc_client.js

@@ -36,10 +36,36 @@ class Client extends TencentCloudCommon.AbstractClient {
     async DescribeRoomInfo(req, cb) {
         return this.request("DescribeRoomInfo", req, cb);
     }
+    /**
+       * 获取TRTC音视频互动的用量明细。
+  - 查询时间小于等于1天时，返回每5分钟粒度的数据；查询时间大于1天时，返回按天汇总的数据。
+  - 单次查询统计区间最多不能超过31天。
+  - 若查询当天用量，由于统计延迟等原因，返回数据可能不够准确。
+  - 该接口只用于历史用量数据统计或核对数据使用，关键业务逻辑不能使用。
+  - 默认接口请求频率限制：5次/秒。
+       */
+    async DescribeTrtcUsage(req, cb) {
+        return this.request("DescribeTrtcUsage", req, cb);
+    }
+    /**
+       * 查询指定时间内的用户列表及用户通话质量数据，可查询14天内数据。DataType 不为null，查询起止时间不超过1个小时，查询用户不超过6个，支持跨天查询。DataType为null时，查询起止时间不超过4个小时， 默认查询6个用户，同时支持每页查询100以内用户个数（PageSize不超过100）。接口用于查询质量问题，不推荐作为计费使用。（同老接口DescribeCallDetail）
+  **注意**：
+  1.该接口只用于历史数据统计或核对数据使用，实时类关键业务逻辑不能使用。
+  2.该接口目前免费提供中，监控仪表盘商业化计费后该接口需要订阅付费版后方可调用，仪表盘商业化说明请见：https://cloud.tencent.com/document/product/647/77735
+       */
+    async DescribeCallDetailInfo(req, cb) {
+        return this.request("DescribeCallDetailInfo", req, cb);
+    }
+    /**
+     * 接口说明：结束云端混流
+     */
+    async StopMCUMixTranscode(req, cb) {
+        return this.request("StopMCUMixTranscode", req, cb);
+    }
     /**
        * 接口说明：启动云端混流，并指定混流画面中各路画面的布局位置。
   
-  TRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。房间销毁后混流自动结束。
+  TRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。
   
   您可以通过此接口实现如下目标：
   - 设置最终直播流的画质和音质，包括视频分辨率、视频码率、视频帧率、以及声音质量等。
@@ -51,7 +77,7 @@ class Client extends TencentCloudCommon.AbstractClient {
   - 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频，仍然会占用画面位置。
   - 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，仍然会占用画面位置。
   - 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。
-  - 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置，最多支持2个画面。
+  - 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置。
   - 自定义模板：适用于在混流中指定用户的画面位置，或者预设视频画面位置的场景。当预设位置指定用户时，排版引擎会该用户预留位置；当预设位置未指定用户时，排版引擎会根据进房间顺序自动填充。预设位置填满时，不再混合其他用户的画面和声音。自定义模板启用占位图功能时（LayoutParams中的PlaceHolderMode设置成1），在预设位置的用户没有上行视频时可显示对应的占位图（PlaceImageId）。
   
   注意：
@@ -59,23 +85,8 @@ class Client extends TencentCloudCommon.AbstractClient {
   2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流，如需切换至MCU混流，请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。
   3、客户端混流和服务端混流不能混用。
        */
-    async StartMCUMixTranscode(req, cb) {
-        return this.request("StartMCUMixTranscode", req, cb);
-    }
-    /**
-       * 查询指定时间内的用户列表及用户通话质量数据，可查询14天内数据。DataType 不为null，查询起止时间不超过1个小时，查询用户不超过6个，支持跨天查询。DataType为null时，查询起止时间不超过4个小时， 默认查询6个用户，同时支持每页查询100以内用户个数（PageSize不超过100）。接口用于查询质量问题，不推荐作为计费使用。（同老接口DescribeCallDetail）
-  **注意**：
-  1.该接口只用于历史数据统计或核对数据使用，实时类关键业务逻辑不能使用。
-  2.该接口目前免费提供中，监控仪表盘商业化计费后该接口需要订阅付费版后方可调用，仪表盘商业化说明请见：https://cloud.tencent.com/document/product/647/77735
-       */
-    async DescribeCallDetailInfo(req, cb) {
-        return this.request("DescribeCallDetailInfo", req, cb);
-    }
-    /**
-     * 接口说明：结束云端混流
-     */
-    async StopMCUMixTranscode(req, cb) {
-        return this.request("StopMCUMixTranscode", req, cb);
+    async StartMCUMixTranscodeByStrRoomId(req, cb) {
+        return this.request("StartMCUMixTranscodeByStrRoomId", req, cb);
     }
     /**
      * 如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁删除自定义背景图或水印，可通过此接口删除已上传的图片。无需频繁删除图片的场景，建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
@@ -107,6 +118,32 @@ class Client extends TencentCloudCommon.AbstractClient {
     async DescribeUserEvent(req, cb) {
         return this.request("DescribeUserEvent", req, cb);
     }
+    /**
+       * 接口说明：启动云端混流，并指定混流画面中各路画面的布局位置。
+  
+  TRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。房间销毁后混流自动结束。
+  
+  您可以通过此接口实现如下目标：
+  - 设置最终直播流的画质和音质，包括视频分辨率、视频码率、视频帧率、以及声音质量等。
+  - 设置各路画面的位置和布局，您只需要在启动时设置一次，排版引擎会自动完成后续的画面排布。
+  - 设置录制文件名，用于二次回放。
+  - 设置 CDN 直播流 ID，用于在 CDN 进行直播观看。
+  
+  目前已经支持了如下几种布局模板：
+  - 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频，仍然会占用画面位置。
+  - 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，仍然会占用画面位置。
+  - 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。
+  - 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置，最多支持2个画面。
+  - 自定义模板：适用于在混流中指定用户的画面位置，或者预设视频画面位置的场景。当预设位置指定用户时，排版引擎会该用户预留位置；当预设位置未指定用户时，排版引擎会根据进房间顺序自动填充。预设位置填满时，不再混合其他用户的画面和声音。自定义模板启用占位图功能时（LayoutParams中的PlaceHolderMode设置成1），在预设位置的用户没有上行视频时可显示对应的占位图（PlaceImageId）。
+  
+  注意：
+  1、**混流转码为收费功能，调用接口将产生云端混流转码费用，详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**
+  2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流，如需切换至MCU混流，请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。
+  3、客户端混流和服务端混流不能混用。
+       */
+    async StartMCUMixTranscode(req, cb) {
+        return this.request("StartMCUMixTranscode", req, cb);
+    }
     /**
        * 接口说明：
   启动云端录制功能，完成房间内的音视频录制，并上传到指定的云存储。您可以通过此 API 接口把TRTC 房间中的每一路音视频流做单独的录制有或者多路视频画面混流一路。
@@ -137,10 +174,15 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("DescribeScaleInfo", req, cb);
     }
     /**
-     * 如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁修改自定义背景图或水印素材，可通过此接口修改已上传的图片。无需频繁修改图片素材的场景，建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
-     */
-    async ModifyPicture(req, cb) {
-        return this.request("ModifyPicture", req, cb);
+       * 获取TRTC旁路转推的用量明细。
+  - 查询时间小于等于1天时，返回每5分钟粒度的数据；查询时间大于1天时，返回按天汇总的数据。
+  - 单次查询统计区间最多不能超过31天。
+  - 若查询当天用量，由于统计延迟等原因，返回数据可能不够准确。
+  - 该接口只用于历史用量数据统计或核对数据使用，关键业务逻辑不能使用。
+  - 默认接口请求频率限制：5次/秒。
+       */
+    async DescribeRelayUsage(req, cb) {
+        return this.request("DescribeRelayUsage", req, cb);
     }
     /**
        * 查询指定时间内的用户列表，可查询14天内数据，查询起止时间不超过4小时。默认每页查询6个用户，支持每页最大查询100个用户PageSize不超过100）。（同老接口DescribeUserInformation）
@@ -164,30 +206,15 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("StopMCUMixTranscodeByStrRoomId", req, cb);
     }
     /**
-       * 接口说明：启动云端混流，并指定混流画面中各路画面的布局位置。
-  
-  TRTC 的一个房间中可能会同时存在多路音视频流，您可以通过此 API 接口，通知腾讯云服务端将多路视频画面合成一路，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看。
-  
-  您可以通过此接口实现如下目标：
-  - 设置最终直播流的画质和音质，包括视频分辨率、视频码率、视频帧率、以及声音质量等。
-  - 设置各路画面的位置和布局，您只需要在启动时设置一次，排版引擎会自动完成后续的画面排布。
-  - 设置录制文件名，用于二次回放。
-  - 设置 CDN 直播流 ID，用于在 CDN 进行直播观看。
-  
-  目前已经支持了如下几种布局模板：
-  - 悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频，仍然会占用画面位置。
-  - 九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，仍然会占用画面位置。
-  - 屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理。
-  - 画中画模板：适用于混合大小两路视频画面和其他用户混音，或者混合一路大画面和其他用户混音的场景。小画面悬浮于大画面之上，可以指定大小画面的用户以及小画面的显示位置。
-  - 自定义模板：适用于在混流中指定用户的画面位置，或者预设视频画面位置的场景。当预设位置指定用户时，排版引擎会该用户预留位置；当预设位置未指定用户时，排版引擎会根据进房间顺序自动填充。预设位置填满时，不再混合其他用户的画面和声音。自定义模板启用占位图功能时（LayoutParams中的PlaceHolderMode设置成1），在预设位置的用户没有上行视频时可显示对应的占位图（PlaceImageId）。
-  
-  注意：
-  1、**混流转码为收费功能，调用接口将产生云端混流转码费用，详见[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)。**
-  2、2020年1月9号及以后创建的应用才能直接调用此接口。2020年1月9日之前创建的应用默认使用云直播的云端混流，如需切换至MCU混流，请[提交工单](https://console.cloud.tencent.com/workorder/category)寻求帮助。
-  3、客户端混流和服务端混流不能混用。
+       * 获取TRTC录制的用量明细。
+  - 查询时间小于等于1天时，返回每5分钟粒度的数据；查询时间大于1天时，返回按天汇总的数据。
+  - 单次查询统计区间最多不能超过31天。
+  - 若查询当天用量，由于统计延迟等原因，返回数据可能不够准确。
+  - 该接口只用于历史用量数据统计或核对数据使用，关键业务逻辑不能使用。
+  - 默认接口请求频率限制：5次/秒。
        */
-    async StartMCUMixTranscodeByStrRoomId(req, cb) {
-        return this.request("StartMCUMixTranscodeByStrRoomId", req, cb);
+    async DescribeRecordingUsage(req, cb) {
+        return this.request("DescribeRecordingUsage", req, cb);
     }
     /**
      * 接口说明：将用户从房间移出，适用于主播/房主/管理员踢人等场景。支持所有平台，Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
@@ -195,6 +222,17 @@ class Client extends TencentCloudCommon.AbstractClient {
     async RemoveUserByStrRoomId(req, cb) {
         return this.request("RemoveUserByStrRoomId", req, cb);
     }
+    /**
+       * 获取TRTC混流转码的用量明细。
+  - 查询时间小于等于1天时，返回每5分钟粒度的数据；查询时间大于1天时，返回按天汇总的数据。
+  - 单次查询统计区间最多不能超过31天。
+  - 若查询当天用量，由于统计延迟等原因，返回数据可能不够准确。
+  - 该接口只用于历史用量数据统计或核对数据使用，关键业务逻辑不能使用。
+  - 默认接口请求频率限制：5次/秒。
+       */
+    async DescribeMixTranscodingUsage(req, cb) {
+        return this.request("DescribeMixTranscodingUsage", req, cb);
+    }
     /**
      * 接口说明：把房间所有用户从房间移出，解散房间。支持所有平台，Android、iOS、Windows 和 macOS 需升级到 TRTC SDK 6.6及以上版本。
      */
@@ -229,6 +267,12 @@ class Client extends TencentCloudCommon.AbstractClient {
     async DescribeCloudRecording(req, cb) {
         return this.request("DescribeCloudRecording", req, cb);
     }
+    /**
+     * 如果您需要在 [云端混流转码](https://cloud.tencent.com/document/product/647/16827) 时频繁修改自定义背景图或水印素材，可通过此接口修改已上传的图片。无需频繁修改图片素材的场景，建议直接在 [控制台 > 应用管理 > 素材管理](https://cloud.tencent.com/document/product/647/50769) 中操作。
+     */
+    async ModifyPicture(req, cb) {
+        return this.request("ModifyPicture", req, cb);
+    }
     /**
      * 成功开启录制后，可以使用此接口来停止录制任务。停止录制成功后不代表文件全部传输完成，如果未完成后台将会继续上传文件，成功后通过事件回调通知客户文件全部传输完成状态。
      */

package/tencentcloud/services/trtc/v20190722/trtc_models.d.ts

@@ -31,6 +31,24 @@ export interface CreatePictureRequest {
      */
     YPosition: number;
 }
+/**
+ * DescribeRelayUsage请求参数结构体
+ */
+export interface DescribeRelayUsageRequest {
+    /**
+     * 查询开始时间，格式为YYYY-MM-DD。
+     */
+    StartTime: string;
+    /**
+        * 查询结束时间，格式为YYYY-MM-DD。
+  单次查询统计区间最多不能超过31天。
+        */
+    EndTime: string;
+    /**
+     * TRTC的SdkAppId，和房间所对应的SdkAppId相同。如果没有这个参数，返回用户下全部实时音视频应用的汇总。
+     */
+    SdkAppId?: number;
+}
 /**
  * 用户自定义混流布局参数列表。
  */
@@ -445,6 +463,23 @@ export interface CloudStorage {
      */
     FileNamePrefix?: Array<string>;
 }
+/**
+ * DescribeTrtcUsage返回参数结构体
+ */
+export interface DescribeTrtcUsageResponse {
+    /**
+     * 用量类型，与UsageValue中各个位置的值对应。
+     */
+    UsageKey: Array<string>;
+    /**
+     * 各个时间点用量明细。
+     */
+    UsageList: Array<TrtcUsage>;
+    /**
+     * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
 /**
  * 返回的质量数据，时间:值
  */
@@ -701,6 +736,24 @@ export interface TrtcTimeNewUsage {
      */
     Video4KTime: number;
 }
+/**
+ * DescribeMixTranscodingUsage请求参数结构体
+ */
+export interface DescribeMixTranscodingUsageRequest {
+    /**
+     * 查询开始时间，格式为YYYY-MM-DD。
+     */
+    StartTime: string;
+    /**
+        * 查询结束时间，格式为YYYY-MM-DD。
+  单次查询统计区间最多不能超过31天。
+        */
+    EndTime: string;
+    /**
+     * TRTC的SdkAppId，和房间所对应的SdkAppId相同。如果没有这个参数，返回用户下全部实时音视频应用的汇总。
+     */
+    SdkAppId?: number;
+}
 /**
  * ModifyPicture请求参数结构体
  */
@@ -818,6 +871,24 @@ export interface EventList {
      */
     PeerId: string;
 }
+/**
+ * DescribeTrtcUsage请求参数结构体
+ */
+export interface DescribeTrtcUsageRequest {
+    /**
+     * 查询开始时间，格式为YYYY-MM-DD。
+     */
+    StartTime: string;
+    /**
+        * 查询结束时间，格式为YYYY-MM-DD。
+  单次查询统计区间最多不能超过31天。
+        */
+    EndTime: string;
+    /**
+     * TRTC的SdkAppId，和房间所对应的SdkAppId相同。如果没有这个参数，返回用户下全部实时音视频应用的汇总。
+     */
+    SdkAppId?: number;
+}
 /**
  * DescribeRoomInfo返回参数结构体
  */
@@ -860,6 +931,10 @@ export interface SdkAppIdTrtcMcuTranscodeTimeUsage {
      * 视频时长-全高清FHD，单位：秒。
      */
     VideoTimeFhd: number;
+    /**
+     * 带宽，单位：Mbps。
+     */
+    Flux: number;
 }
 /**
  * DescribeUserInfo返回参数结构体
@@ -879,6 +954,53 @@ export interface DescribeUserInfoResponse {
      */
     RequestId?: string;
 }
+/**
+ * 实时音视频用量在某一时间段的统计信息。
+ */
+export interface TrtcUsage {
+    /**
+     * 时间点，格式为YYYY-MM-DD HH:mm:ss。多天查询时，HH:mm:ss为00:00:00。
+     */
+    TimeKey: string;
+    /**
+     * 用量数组。每个数值含义与UsageKey对应。单位：分钟。
+     */
+    UsageValue: Array<number>;
+}
+/**
+ * DescribeRelayUsage返回参数结构体
+ */
+export interface DescribeRelayUsageResponse {
+    /**
+     * 用量类型，与UsageValue中各个位置的值对应。
+     */
+    UsageKey: Array<string>;
+    /**
+     * 各个时间点用量明细。
+     */
+    UsageList: Array<TrtcUsage>;
+    /**
+     * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
+/**
+ * DescribeRecordingUsage返回参数结构体
+ */
+export interface DescribeRecordingUsageResponse {
+    /**
+     * 用量类型，与UsageValue中各个位置的值对应。
+     */
+    UsageKey: Array<string>;
+    /**
+     * 各个时间点用量明细。
+     */
+    UsageList: Array<TrtcUsage>;
+    /**
+     * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
 /**
  * ModifyPicture返回参数结构体
  */
@@ -888,6 +1010,28 @@ export interface ModifyPictureResponse {
      */
     RequestId?: string;
 }
+/**
+ * DescribeRecordingUsage请求参数结构体
+ */
+export interface DescribeRecordingUsageRequest {
+    /**
+     * 查询开始时间，格式为YYYY-MM-DD。
+     */
+    StartTime: string;
+    /**
+        * 查询结束时间，格式为YYYY-MM-DD。
+  单次查询统计区间最多不能超过31天。
+        */
+    EndTime: string;
+    /**
+     * 查询单流录制或合流录制，值为"single"或"multi"。
+     */
+    MixType: string;
+    /**
+     * TRTC的SdkAppId，和房间所对应的SdkAppId相同。如果没有这个参数，返回用户下全部实时音视频应用的汇总。
+     */
+    SdkAppId?: number;
+}
 /**
  * 云端录制查询接口，录制文件的信息
  */
@@ -1015,6 +1159,23 @@ export interface StopMCUMixTranscodeResponse {
      */
     RequestId?: string;
 }
+/**
+ * DescribeMixTranscodingUsage返回参数结构体
+ */
+export interface DescribeMixTranscodingUsageResponse {
+    /**
+     * 用量类型，与UsageValue中各个位置的值对应。
+     */
+    UsageKey: Array<string>;
+    /**
+     * 各个时间点用量明细。
+     */
+    UsageList: Array<TrtcUsage>;
+    /**
+     * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
 /**
  * SdkAppId级别实时音视频的用量数据
  */