tencentcloud-sdk-nodejs-trtc 4.0.905 → 4.0.908

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

@@ -84,102 +84,14 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("DescribeWebRecord", req, cb);
     }
     /**
-       * TRTC房间中可能会同时存在多路音视频流，您可以通过混流转推API，通知腾讯云服务端将同个房间或者多个房间的多路视频画面混合到一起，并指定每一路画面的位置，同时将多路声音进行混音，最终形成一路音视频流，以便用于录制和直播观看，同时可以支持将这一路音视频的混流回推到TRTC房间内部。
-  
-  云api混流转推功能包含三个接口：
-  1、StartPublishCdnStream：启动一个混流转推任务，此接口会发起一个新的混流转推任务，启动成功后会返回一个sdkappid维度唯一的任务id（TaskId）。您需要保存该TaskId，后续需要依赖此TaskId更新任务和结束任务。
-  2、UpdatePublishCdnStream：更新指定的混流转推任务，包括：更新视频画面的布局、更新混音列表、更新转推cdn的地址列表以及更新回推房间列表。
-  3、StopPublishCdnStream：停止指定的混流转推任务。
-  
-  您可以通过此套接口实现目标：
-  1、设置最终混流的画质和音质，包括视频分辨率、视频帧率、视频码率，和音频质量。
-  2、设置每一路画面的布局位置，您只需要设置一次，后续您指定的混流用户进房上行音视频时，排版引擎会自动将该用户的画面混合到您指定的布局位置。同时您可以使用更新接口调整画面的布局位置。
-  3、设置多个cdn转推的目的地址，一个转推任务最多可以同时设置10个cdn转推地址，如果您需要转推非腾讯云的cdn地址时，需要联系腾讯云开通能力。
-  4、设置多个回推房间列表，一个转推任务最多可以同时将混流回推到10个TRTC房间。
-  
-  目前已经支持如下几种布局模版，其中动态布局模版（悬浮模板、九宫格模板、屏幕分享模板）只支持单个TRTC房间，自定义模版支持混合多个TRTC房间内的音视频流。具体说明如下：
-  1、悬浮模板：第一个进入房间的用户的视频画面会铺满整个屏幕，其他用户的视频画面从左下角依次水平排列，显示为小画面，最多4行，每行4个，小画面悬浮于大画面之上。最多支持1个大画面和15个小画面，如果用户只发送音频默认不占布局配置，也支持设置。每个子画面默认采用居中裁剪的方式进行渲染，也支持统一设置子画面的渲染方式。
-  2、九宫格模板：所有用户的视频画面大小一致，平分整个屏幕，人数越多，每个画面的尺寸越小。最多支持16个画面，如果用户只发送音频，默认不占布局配置，也支持设置。每个子画面默认采用居中裁剪的方式进行渲染，也支持统一设置子画面的渲染方式。
-  3、屏幕分享模板：适合视频会议和在线教育场景的布局，屏幕分享（或者主讲的摄像头）始终占据屏幕左侧的大画面位置，需要您明确设置占据大画面的混流用户信息。其他用户依次垂直排列于右侧，最多两列，每列最多8个小画面。最多支持1个大画面和15个小画面。若上行分辨率宽高比与画面输出宽高比不一致时，左侧大画面为了保持内容的完整性采用缩放方式处理，右侧小画面采用裁剪方式处理，也支持统一设置子画面的渲染方式。
-  4、自定义布局模版：支持您主动根据业务需要设置布局位置，每个预设的布局位置支持具名设置（具名设置需要明确指定房间号和用户名）和不具名设置。当一个子画面具名设置时，该位置就为该用户预留，用户进房且上行音视频数据时会自动占据该位置，其它用户不会占据该位置。当预设的布局位置未具名时，排版引擎会根据进房间顺序自动填充，预设位置填满时，不再混合其它用户的画面和声音。每个子画面位置支持设置占位图（BackgroundImageUrl），当用户未进房或者只上行音频数据时，该位置画面可显示对应的占位图画面。
-  
-  您可以控制台开通旁路转推回调功能实现转推cdn状态的事件监控，具体说明请参考官网文档：[旁路转推回调说明](https://cloud.tencent.com/document/product/647/88552)
-  您使用转推api时根据使用特性可能会产生如下费用：
-  MCU混流转码费用请参考文档：[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)
-  转推非腾讯云CDN费用请参考文档：[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)
-  
-  参数的使用说明：
-  1、AgentParams：每个转推任务会拉起一个机器人用户进入TRTC房间进行拉流，您需要通过AgentParams.UserId参数进行设置，这个机器人id不能和房间中的普通用户id冲突，否则会导致转推任务由于机器人用户被踢出TRTC房间而异常结束，您可以通过增加特殊前缀的方式规避。您可以通过设置AgentParams.MaxIdleTime控制转推任务的自动结束，当设置此参数时，所有参与混流转推的主播持续离开TRTC房间超过MaxIdleTime的时长，自动停止转推任务。注意：参与混流转推的主播仅是停止音视频上行，转推任务不会自动停止。
-  2、WithTranscoding：如果需要将多路音视频流混合到一路时，WithTranscoding必须设置为1。
-  3、AudioParams：转推任务音频参数和视频参数是分开设置的，若您想要将指定的用户音频进行混音时，需要明确设置AudioParams.SubscribeAudioList。若您不设置AudioParams.SubscribeAudioList，混音引擎会自动将TRTC房间中所有用户的音频混合。若您想要混合TRTC房间除指定用户之外的所有用户的声音，可以通过AudioParams.UnSubscribeAudioList设置音频黑名单列表。
-  4、VideoParams：若您想要将用户的视频混合，可以通过VideoParams设置，若只想要混纯音频，则不用设置VideoParams参数。您可以通过VideoParams.LayoutParams.MixLayoutMode设置画面的布局模式，包括：动态布局（1：悬浮布局（默认），2：屏幕分享布局，3：九宫格布局）和自定义布局。动态布局模式由排版引擎按照固定的布局自动混合，不需要设置VideoParams.LayoutParams.MixLayoutList。当使用悬浮布局和屏幕分享布局时，您可以通过设置VideoParams.LayoutParams.MaxVideoUser参数指定大画面用户。自定义布局模式提供给您自主布局画面的能力，可以通过VideoParams.LayoutParams.MixLayoutList参数指定每个用户所在的布局位置。在每个布局参数中，您可以通过用户媒体流参数（UserMediaStream）指定这个布局位置为指定的用户预留，也可以不设置UserMediaStream，由排版引擎按照用户进入TRTC房间的顺序自动填充，另外您也可以设置每个布局位置的渲染方式（RenderMode）和裁剪方式（CustomCrop）。
-  5、VideoParams.WaterMarkList：若您想要混流画面中叠加水印，可以通过VideoParams.WaterMarkList参数设置，支持图片水印和文字水印，支持透明通道。
-  6、SingleSubscribeParams：若您想要将TRTC房间中的一路单流推到CDN，可以使用SingleSubscribeParams参数设置，此时需要将WithTranscoding参数设置为0。
-  7、PublishCdnParams.N：若您想要推流到CDN，可以使用PublishCdnParams.N参数设置，支持最多同时推流到10个CDN地址。若转推地址是腾讯云CDN时，请将IsTencentCdn明确设置为1；若您有转推非腾讯云CDN的需求时，请联系腾讯云技术支持开通，转推非腾讯云会产生转推费用，费用说明请参考官网文档：[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)。
-  8、FeedBackRoomParams.N：若您想要将混合的音视频流回推到TRTC房间，可以使用FeedBackRoomParams.N参数设置，支持最多同时推10路流回TRTC房间。您需要指定回推的TRTC房间号和机器人ID（UserId），机器人ID不能与普通用户ID冲突，否则会导致转推任务由于机器人用户被踢出TRTC房间而异常结束，您可以通过增加特殊前缀的方式规避。
-  9、SeiParams：若您想要混合的音视频流中增加SEI信息时，可以使用SeiParams参数设置，支持音量布局SEI和叠加转推请求中的SEI，其中音量布局SEI的内容是固定的json结构，具体请看本章节后续的SEI说明。您可以通过FollowIdr参数设置SEI跟随关键帧一起发送。音量布局sei的说明如下：
-  如果您的CDN观众端需要识别到参与混流的主播位置，以及需要识别到参与混流的主播的音量信息，可以通过音量布局sei实现。音量布局sei的payload内容及参数说明如下：
-  
-  ```
-  {
-      "app_data":"",
-      "canvas":{
-          "w":1080,
-          "h":960
-      },
-      "regions":[
-          {
-              "uid":"65949987242835883c",
-              "zorder":2,
-              "volume":45,
-              "x":270,
-              "y":480,
-              "w":540,
-              "h":480
-          },
-          {
-              "uid":"659c9d8d242b328d31",
-              "zorder":2,
-              "volume":0,
-              "x":0,
-              "y":0,
-              "w":540,
-              "h":480
-          },
-          {
-              "uid":"64989a82272b308c",
-              "zorder":2,
-              "volume":91,
-              "x":540,
-              "y":0,
-              "w":540,
-              "h":480
-          }
-      ],
-      "ver":"1.0",
-      "ts":1648544726
-  }
-  ```
-  canvas：这个是混流信令中VideoEncode设置的宽高，即：混流输出的整个画布宽高。
-  regions：里面是真实混入的用户id和对应的子画面位置，若参与混流的用户未进入TRTC房间或者未开启视频上行，regions中不会包含该用户。
-  uid：代表参与混流的用户ID。
-  zorder：参与混流userid在混流输出的层级。
-  x/y：参与混流userid的子画面在画布的坐标。
-  w/h：参与混流userid的子画面的大小。
-  volume：代表混流用户的音量，取值范围为0-100，值越大，代表该用户参与混流时的音量越大。
-  ts：是输出sei的服务器本地秒级时戳。
-  ver：可以忽略。
+       * 接口说明：
+  启动一个混流转推任务，将  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)
   
-  其它使用注意事项：
-  1、使用混流转推接口时，您需要先调用启动转推任务接口（StartPublishCdnStream），获取启动转推任务响应中的任务ID标识（TaskId）。后续传入任务ID标识（TaskId）来更新转推任务（UpdatePublishCdnStream）和停止转推任务（StopPublishCdnStream）。
-  2、转推API不支持发起到TRTC控制台配置的自动旁路任务，以及通过TRTC SDK进房接口中设置的自定义流ID的旁路任务。
-  3、为了确保转推链接的稳定，同一个转推任务不支持纯音频、音视频、纯视频之间的切换。
-  4、为了确保转推链接的稳定，不支持update时更新视频参数（codec）和音频参数（codec、采样率、码率、声道数）。
-  5、发起单流旁路任务时，AudioParams和VideoParams都填写表示音视频旁路，如果仅填写AudioParams表示纯音频旁路，任务进行过程中不支持纯音频到音视频的切换。音视频旁路时，VideoParams中的Width、Height、Fps、BitRate、Gop需要按照真实上行参数填写。
-  6、更新请求中必须携带SequenceNumber参数，用于防止请求乱序。客户保证对同一个任务更新时的SequenceNumber参数递增，否则会导致混流任务更新失败。
-  7、调用api时region选择说明：如果应用id是1400xxx时，region可填北京、上海、广州、香港，如果您的cdn观众主要在海外，请选择香港；如果应用id是200xxx或400xxx时，region请选择新加坡。
-  8、回推到TRTC房间的流不会参与其他回推房间任务的混流，满足下面条件之一时，可以参与其他转推cdn任务的混流: (1) 转推cdn任务在视频参数中通过具名方式指定推流机器人参与混流；(2) 转推cdn任务在音频参数中通过白名单方式指定推流机器人参与混流；(3) 转推cdn任务参与混流用户的房间号与回推机器人对应混流用户的房间号完全不同。
-  9、您可以在主播进房前，提前创建转推任务，结束转推任务时需要主动调用停止接口。如果您没有调用停止转推任务接口时，腾讯云后台会按照所有参与混流的用户没有任何数据上行的时间算起，直到超过启动转推任务时设置的超时时间（AgentParams.MaxIdleTime）为止，自动停止混流转推任务。
+  注意：
+  您可以在控制台开通旁路转推回调功能，对转推 CDN 状态的事件进行监控，回调请参考文档：[旁路转推回调说明](https://cloud.tencent.com/document/product/647/88552)
+  您发起混流转推任务时，可能会产生如下费用：
+  MCU 混流转码费用，请参考文档：[云端混流转码计费说明](https://cloud.tencent.com/document/product/647/49446)
+  转推非腾讯云 CDN 费用，请参考文档：[云端转推计费说明](https://cloud.tencent.com/document/product/647/82155)
        */
     async StartPublishCdnStream(req, cb) {
         return this.request("StartPublishCdnStream", req, cb);
@@ -418,8 +330,9 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("StopWebRecord", req, cb);
     }
     /**
-     * 停止转推任务。
-     */
+       * 接口说明：
+  停止指定的混流转推任务。如果没有调用 Stop 接口停止任务，所有参与混流转推的主播离开 TRTC 房间超过 AgentParams.MaxIdleTime 设置的时间后，任务也会自动停止。
+       */
     async StopPublishCdnStream(req, cb) {
         return this.request("StopPublishCdnStream", req, cb);
     }
@@ -571,8 +484,9 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("DescribeAITranscription", req, cb);
     }
     /**
-       * 更新转推任务。
-  注：请参见启动转推任务的接口说明和使用说明。
+       * 接口说明：
+  成功发起混流转推后，可以使用此接口来更新任务。仅在任务进行时有效，任务退出后更新将会返回错误。更新操作为增量更新模式。
+  注意：为了保障推流的稳定性，更新不支持任务在纯音频、音视频、纯视频之间进行切换。
        */
     async UpdatePublishCdnStream(req, cb) {
         return this.request("UpdatePublishCdnStream", req, cb);
@@ -614,6 +528,12 @@ class Client extends TencentCloudCommon.AbstractClient {
     async DescribeTRTCMarketQualityData(req, cb) {
         return this.request("DescribeTRTCMarketQualityData", req, cb);
     }
+    /**
+     * 提供服务端控制机器人的功能
+     */
+    async ControlAIConversation(req, cb) {
+        return this.request("ControlAIConversation", req, cb);
+    }
     /**
      * 停止AI转录任务。
      */

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

@@ -77,6 +77,19 @@ export interface AudioEncodeParams {
      */
     Volume?: number;
 }
+/**
+ * 服务端控制AI对话机器人播报指定文本
+ */
+export interface ServerPushText {
+    /**
+     * 服务端推送播报文本
+     */
+    Text?: string;
+    /**
+     * 是否允许该文本打断机器人说话
+     */
+    Interrupt?: boolean;
+}
 /**
  * DescribeTRTCMarketQualityMetricData返回参数结构体
  */
@@ -145,21 +158,41 @@ export interface MixLayout {
     SubBackgroundImage?: string;
 }
 /**
- * DescribeRecordingUsage返回参数结构体
+ * 混流转推的视频相关参数。
  */
-export interface DescribeRecordingUsageResponse {
+export interface McuVideoParams {
     /**
-     * 用量类型，与UsageValue中各个位置的值对应。
+     * 输出流视频编码参数。
      */
-    UsageKey?: Array<string>;
+    VideoEncode?: VideoEncode;
     /**
-     * 各个时间点用量明细。
+     * 混流布局参数。
      */
-    UsageList?: Array<TrtcUsage>;
+    LayoutParams?: McuLayoutParams;
     /**
-     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     * 整个画布背景颜色，常用的颜色有：
+  红色：0xcc0033。
+  黄色：0xcc9900。
+  绿色：0xcccc33。
+  蓝色：0x99CCFF。
+  黑色：0x000000。
+  白色：0xFFFFFF。
+  灰色：0x999999。
      */
-    RequestId?: string;
+    BackGroundColor?: string;
+    /**
+     * 整个画布的背景图url，优先级高于BackGroundColor。支持png、jpg、jpeg格式。图片大小限制不超过5MB。
+  注：您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，背景图将不会生效。
+     */
+    BackgroundImageUrl?: string;
+    /**
+     * 混流布局的水印参数。
+     */
+    WaterMarkList?: Array<McuWaterMarkParams>;
+    /**
+     * 背景图在输出时的显示模式：0为裁剪，1为缩放并显示黑底，2为变比例伸缩。后台默认为变比例伸缩。
+     */
+    BackgroundRenderMode?: number;
 }
 /**
  * DescribeTRTCRealTimeScaleData请求参数结构体
@@ -457,13 +490,13 @@ export interface DescribeTRTCRealTimeScaleMetricDataRequest {
     RoomId?: string;
 }
 /**
- * StopWebRecord请求参数结构体
+ * ControlAIConversation返回参数结构体
  */
-export interface StopWebRecordRequest {
+export interface ControlAIConversationResponse {
     /**
-     * 需要停止的任务Id
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
      */
-    TaskId: string;
+    RequestId?: string;
 }
 /**
  * StopAITranscription请求参数结构体
@@ -978,43 +1011,6 @@ export interface DescribeRecordStatisticRequest {
      */
     SdkAppId?: number;
 }
-/**
- * 混流转推的视频相关参数。
- */
-export interface McuVideoParams {
-    /**
-     * 输出流视频编码参数。
-     */
-    VideoEncode?: VideoEncode;
-    /**
-     * 混流布局参数。
-     */
-    LayoutParams?: McuLayoutParams;
-    /**
-     * 整个画布背景颜色，常用的颜色有：
-  红色：0xcc0033。
-  黄色：0xcc9900。
-  绿色：0xcccc33。
-  蓝色：0x99CCFF。
-  黑色：0x000000。
-  白色：0xFFFFFF。
-  灰色：0x999999。
-     */
-    BackGroundColor?: string;
-    /**
-     * 整个画布的背景图url，优先级高于BackGroundColor。支持png、jpg、jpeg格式。图片大小限制不超过5MB。
-  注：您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，背景图将不会生效。
-     */
-    BackgroundImageUrl?: string;
-    /**
-     * 混流布局的水印参数。
-     */
-    WaterMarkList?: Array<McuWaterMarkParams>;
-    /**
-     * 背景图在输出时的显示模式：0为裁剪，1为缩放并显示黑底，2为变比例伸缩。后台默认为变比例伸缩。
-     */
-    BackgroundRenderMode?: number;
-}
 /**
  * DescribeRoomInfo请求参数结构体
  */
@@ -1414,17 +1410,29 @@ export interface DescribeRoomInfoResponse {
     RequestId?: string;
 }
 /**
- * DismissRoom请求参数结构体
+ * 混流布局参数。
  */
-export interface DismissRoomRequest {
+export interface McuLayoutParams {
     /**
-     * TRTC的SDKAppId。
+     * 布局模式：动态布局（1：悬浮布局（默认），2：屏幕分享布局，3：九宫格布局），静态布局（4：自定义布局）。
      */
-    SdkAppId: number;
+    MixLayoutMode?: number;
     /**
-     * 数字房间号。本接口仅支持解散数字类型房间号，如需解散字符串类型房间号，请使用DismissRoomByStrRoomId。
+     * 纯音频上行是否占布局位置，只在动态布局中有效。0表示纯音频不占布局位置，1表示纯音频占布局位置，不填默认为0。
      */
-    RoomId: number;
+    PureAudioHoldPlaceMode?: number;
+    /**
+     * 自定义模板中有效，指定用户视频在混合画面中的位置。
+     */
+    MixLayoutList?: Array<McuLayout>;
+    /**
+     * 指定动态布局中悬浮布局和屏幕分享布局的大画面信息，只在悬浮布局和屏幕分享布局有效。
+     */
+    MaxVideoUser?: MaxVideoUser;
+    /**
+     * 屏幕分享模板、悬浮模板、九宫格模版有效，画面在输出时的显示模式：0为裁剪，1为缩放，2为缩放并显示黑底
+     */
+    RenderMode?: number;
 }
 /**
  * DescribeTRTCRealTimeQualityMetricData请求参数结构体
@@ -1522,6 +1530,84 @@ export interface DescribeAIConversationResponse {
      */
     RequestId?: string;
 }
+/**
+ * 混流布局参数。
+ */
+export interface McuLayout {
+    /**
+     * 用户媒体流参数。不填时腾讯云后台按照上行主播的进房顺序自动填充。
+     */
+    UserMediaStream?: UserMediaStream;
+    /**
+     * 子画面在输出时的宽度，单位为像素值，不填默认为0。
+     */
+    ImageWidth?: number;
+    /**
+     * 子画面在输出时的高度，单位为像素值，不填默认为0。
+     */
+    ImageHeight?: number;
+    /**
+     * 子画面在输出时的X偏移，单位为像素值，LocationX与ImageWidth之和不能超过混流输出的总宽度，不填默认为0。
+     */
+    LocationX?: number;
+    /**
+     * 子画面在输出时的Y偏移，单位为像素值，LocationY与ImageHeight之和不能超过混流输出的总高度，不填默认为0。
+     */
+    LocationY?: number;
+    /**
+     * 子画面在输出时的层级，不填默认为0。
+     */
+    ZOrder?: number;
+    /**
+     * 子画面在输出时的显示模式：0为裁剪，1为缩放并显示背景，2为缩放并显示黑底。不填默认为0。
+     */
+    RenderMode?: number;
+    /**
+     * 【此参数配置无效，暂不支持】子画面的背景颜色，常用的颜色有：
+  红色：0xcc0033。
+  黄色：0xcc9900。
+  绿色：0xcccc33。
+  蓝色：0x99CCFF。
+  黑色：0x000000。
+  白色：0xFFFFFF。
+  灰色：0x999999。
+     */
+    BackGroundColor?: string;
+    /**
+     * 子画面的背景图url，填写该参数，当用户关闭摄像头或未进入TRTC房间时，会在布局位置填充为指定图片。若指定图片与布局位置尺寸比例不一致，则会对图片进行拉伸处理，优先级高于BackGroundColor。支持png、jpg、jpeg、bmp、gif、webm格式。图片大小限制不超过5MB。
+  注：您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，子画面的背景图将不会生效。
+     */
+    BackgroundImageUrl?: string;
+    /**
+     * 客户自定义裁剪，针对原始输入流裁剪
+     */
+    CustomCrop?: McuCustomCrop;
+    /**
+     * 子背景图在输出时的显示模式：0为裁剪，1为缩放并显示背景，2为缩放并显示黑底，3为变比例伸缩，4为自定义渲染。不填默认为3。
+     */
+    BackgroundRenderMode?: number;
+    /**
+     * 子画面的透明模版url，指向一张包含透明通道的模板图片。填写该参数，后台混流时会提取该模板图片的透明通道，将其缩放作为目标画面的透明通道，再和其他画面进行混合。您可以通过透明模版实现目标画面的半透明效果和任意形状裁剪（如圆角、星形、心形等）。 支持png格式。图片大小限制不超过5MB。
+  注：1，模板图片宽高比应接近目标画面宽高比，以避免缩放适配目标画面时出现模板效果变形；2，透明模版只有RenderMode为0（裁剪）时才生效；3，您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，透明模版将不会生效。
+     */
+    TransparentUrl?: string;
+    /**
+     * 子背景图的自定义渲染参数，当BackgroundRenderMode为4时必须配置。
+     */
+    BackgroundCustomRender?: McuBackgroundCustomRender;
+    /**
+     * 子背景色生效模式，默认值为0表示均不生效。
+  bit0:占位图缩放是否生效。
+  bit1:上行流缩放是否生效。
+  您可以将相应bit位置1启动生效，例如：
+  0(00)表示子背景色不生效。
+  1(01)表示子背景色只在占位图缩放时生效。
+  2(10)表示子背景色只在上行流缩放时生效。
+  3(11)表示子背景色在占位图缩放和上行流缩放时均生效。
+  
+     */
+    BackGroundColorMode?: number;
+}
 /**
  * DescribeUserInfo返回参数结构体
  */
@@ -1776,82 +1862,21 @@ export interface StartStreamIngestRequest {
     SeekSecond?: number;
 }
 /**
- * 混流布局参数。
+ * DescribeRecordingUsage返回参数结构体
  */
-export interface McuLayout {
-    /**
-     * 用户媒体流参数。不填时腾讯云后台按照上行主播的进房顺序自动填充。
-     */
-    UserMediaStream?: UserMediaStream;
-    /**
-     * 子画面在输出时的宽度，单位为像素值，不填默认为0。
-     */
-    ImageWidth?: number;
-    /**
-     * 子画面在输出时的高度，单位为像素值，不填默认为0。
-     */
-    ImageHeight?: number;
-    /**
-     * 子画面在输出时的X偏移，单位为像素值，LocationX与ImageWidth之和不能超过混流输出的总宽度，不填默认为0。
-     */
-    LocationX?: number;
-    /**
-     * 子画面在输出时的Y偏移，单位为像素值，LocationY与ImageHeight之和不能超过混流输出的总高度，不填默认为0。
-     */
-    LocationY?: number;
-    /**
-     * 子画面在输出时的层级，不填默认为0。
-     */
-    ZOrder?: number;
-    /**
-     * 子画面在输出时的显示模式：0为裁剪，1为缩放并显示背景，2为缩放并显示黑底。不填默认为0。
-     */
-    RenderMode?: number;
-    /**
-     * 【此参数配置无效，暂不支持】子画面的背景颜色，常用的颜色有：
-  红色：0xcc0033。
-  黄色：0xcc9900。
-  绿色：0xcccc33。
-  蓝色：0x99CCFF。
-  黑色：0x000000。
-  白色：0xFFFFFF。
-  灰色：0x999999。
-     */
-    BackGroundColor?: string;
-    /**
-     * 子画面的背景图url，填写该参数，当用户关闭摄像头或未进入TRTC房间时，会在布局位置填充为指定图片。若指定图片与布局位置尺寸比例不一致，则会对图片进行拉伸处理，优先级高于BackGroundColor。支持png、jpg、jpeg、bmp、gif、webm格式。图片大小限制不超过5MB。
-  注：您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，子画面的背景图将不会生效。
-     */
-    BackgroundImageUrl?: string;
-    /**
-     * 客户自定义裁剪，针对原始输入流裁剪
-     */
-    CustomCrop?: McuCustomCrop;
-    /**
-     * 子背景图在输出时的显示模式：0为裁剪，1为缩放并显示背景，2为缩放并显示黑底，3为变比例伸缩，4为自定义渲染。不填默认为3。
-     */
-    BackgroundRenderMode?: number;
+export interface DescribeRecordingUsageResponse {
     /**
-     * 子画面的透明模版url，指向一张包含透明通道的模板图片。填写该参数，后台混流时会提取该模板图片的透明通道，将其缩放作为目标画面的透明通道，再和其他画面进行混合。您可以通过透明模版实现目标画面的半透明效果和任意形状裁剪（如圆角、星形、心形等）。 支持png格式。图片大小限制不超过5MB。
-  注：1，模板图片宽高比应接近目标画面宽高比，以避免缩放适配目标画面时出现模板效果变形；2，透明模版只有RenderMode为0（裁剪）时才生效；3，您需要确保图片链接的可访问性，后台单次下载超时时间为10秒，最多重试3次，若最终图片下载失败，透明模版将不会生效。
+     * 用量类型，与UsageValue中各个位置的值对应。
      */
-    TransparentUrl?: string;
+    UsageKey?: Array<string>;
     /**
-     * 子背景图的自定义渲染参数，当BackgroundRenderMode为4时必须配置。
+     * 各个时间点用量明细。
      */
-    BackgroundCustomRender?: McuBackgroundCustomRender;
+    UsageList?: Array<TrtcUsage>;
     /**
-     * 子背景色生效模式，默认值为0表示均不生效。
-  bit0:占位图缩放是否生效。
-  bit1:上行流缩放是否生效。
-  您可以将相应bit位置1启动生效，例如：
-  0(00)表示子背景色不生效。
-  1(01)表示子背景色只在占位图缩放时生效。
-  2(10)表示子背景色只在上行流缩放时生效。
-  3(11)表示子背景色在占位图缩放和上行流缩放时均生效。
-  
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
      */
-    BackGroundColorMode?: number;
+    RequestId?: string;
 }
 /**
  * StopMCUMixTranscode请求参数结构体
@@ -2149,29 +2174,17 @@ export interface TRTCDataResult {
     Total?: number;
 }
 /**
- * 混流布局参数。
+ * DismissRoom请求参数结构体
  */
-export interface McuLayoutParams {
-    /**
-     * 布局模式：动态布局（1：悬浮布局（默认），2：屏幕分享布局，3：九宫格布局），静态布局（4：自定义布局）。
-     */
-    MixLayoutMode?: number;
-    /**
-     * 纯音频上行是否占布局位置，只在动态布局中有效。0表示纯音频不占布局位置，1表示纯音频占布局位置，不填默认为0。
-     */
-    PureAudioHoldPlaceMode?: number;
-    /**
-     * 自定义模板中有效，指定用户视频在混合画面中的位置。
-     */
-    MixLayoutList?: Array<McuLayout>;
+export interface DismissRoomRequest {
     /**
-     * 指定动态布局中悬浮布局和屏幕分享布局的大画面信息，只在悬浮布局和屏幕分享布局有效。
+     * TRTC的SDKAppId。
      */
-    MaxVideoUser?: MaxVideoUser;
+    SdkAppId: number;
     /**
-     * 屏幕分享模板、悬浮模板、九宫格模版有效，画面在输出时的显示模式：0为裁剪，1为缩放，2为缩放并显示黑底
+     * 数字房间号。本接口仅支持解散数字类型房间号，如需解散字符串类型房间号，请使用DismissRoomByStrRoomId。
      */
-    RenderMode?: number;
+    RoomId: number;
 }
 /**
  * DescribeUnusualEvent请求参数结构体
@@ -2855,6 +2868,31 @@ export interface TRTCDataResp {
      */
     Total: number;
 }
+/**
+ * 录制视频转码参数。
+ */
+export interface VideoParams {
+    /**
+     * 视频的宽度值，单位为像素，默认值360。不能超过1920，与height的乘积不能超过1920*1080。
+     */
+    Width: number;
+    /**
+     * 视频的高度值，单位为像素，默认值640。不能超过1920，与width的乘积不能超过1920*1080。
+     */
+    Height: number;
+    /**
+     * 视频的帧率，范围[1, 60]，默认15。
+     */
+    Fps: number;
+    /**
+     * 视频的码率,单位是bps，范围[64000, 8192000]，默认550000bps。
+     */
+    BitRate: number;
+    /**
+     * 视频关键帧时间间隔，单位秒，默认值10秒。
+     */
+    Gop: number;
+}
 /**
  * DescribePicture返回参数结构体
  */
@@ -2963,6 +3001,25 @@ export interface DescribeScaleInfoRequest {
      */
     EndTime: number;
 }
+/**
+ * ControlAIConversation请求参数结构体
+ */
+export interface ControlAIConversationRequest {
+    /**
+     * 任务唯一标识
+     */
+    TaskId: string;
+    /**
+     * 控制命令，目前支持命令如下：
+  
+  - ServerPushText，服务端发送文本给AI机器人，AI机器人会播报该文本
+     */
+    Command: string;
+    /**
+     * 服务端发送播报文本命令，当Command为ServerPushText时必填
+     */
+    ServerPushText?: ServerPushText;
+}
 /**
  * DismissRoomByStrRoomId返回参数结构体
  */
@@ -3203,7 +3260,7 @@ export interface UpdatePublishCdnStreamRequest {
      */
     WithTranscoding: number;
     /**
-     * 更新相关参数，只支持更新参与混音的主播列表参数。不填表示不更新此参数。
+     * 更新相关参数，只支持更新参与混音的主播列表参数，不支持更新Codec、采样率、码率和声道数。不填表示不更新此参数。
      */
     AudioParams?: McuAudioParams;
     /**
@@ -3321,29 +3378,13 @@ export interface DeletePictureRequest {
     SdkAppId: number;
 }
 /**
- * 录制视频转码参数。
+ * StopWebRecord请求参数结构体
  */
-export interface VideoParams {
-    /**
-     * 视频的宽度值，单位为像素，默认值360。不能超过1920，与height的乘积不能超过1920*1080。
-     */
-    Width: number;
-    /**
-     * 视频的高度值，单位为像素，默认值640。不能超过1920，与width的乘积不能超过1920*1080。
-     */
-    Height: number;
-    /**
-     * 视频的帧率，范围[1, 60]，默认15。
-     */
-    Fps: number;
-    /**
-     * 视频的码率,单位是bps，范围[64000, 8192000]，默认550000bps。
-     */
-    BitRate: number;
+export interface StopWebRecordRequest {
     /**
-     * 视频关键帧时间间隔，单位秒，默认值10秒。
+     * 需要停止的任务Id
      */
-    Gop: number;
+    TaskId: string;
 }
 /**
  * 混流SEI参数