UNPKG

tencentcloud-sdk-nodejs

Version:
2,298 lines (2,280 loc) 151 kB
/** * 返回的质量数据,时间:值 */ export interface TimeValue { /** * 时间,unix时间戳(1590065877s) */ Time?: number; /** * 当前时间返回参数取值,如(bigvCapFps在1590065877取值为0,则Value:0 ) */ Value?: number; } /** * 机器人参数 */ export interface AgentConfig { /** * 机器人的UserId,用于进房发起任务。【注意】这个UserId不能与当前房间内的主播观众[UserId](https://cloud.tencent.com/document/product/647/46351#userid)重复。如果一个房间发起多个任务时,机器人的UserId也不能相互重复,否则会中断前一个任务。需要保证机器人UserId在房间内唯一。 */ UserId: string; /** * 机器人UserId对应的校验签名,即UserId和UserSig相当于机器人进房的登录密码,具体计算方法请参考TRTC计算[UserSig](https://cloud.tencent.com/document/product/647/45910#UserSig)的方案。 */ UserSig: string; /** * 机器人拉流的UserId, 填写后,机器人会拉取该UserId的流进行实时处理 */ TargetUserId: string; /** * 房间内超过MaxIdleTime 没有推流,后台自动关闭任务,默认值是60s。 */ MaxIdleTime?: number; /** * 机器人的欢迎语 */ WelcomeMessage?: string; /** * 智能打断模式,默认为0,0表示服务端自动打断,1表示服务端不打断,由端上发送打断信令进行打断 */ InterruptMode?: number; /** * InterruptMode为0时使用,单位为毫秒,默认为500ms。表示服务端检测到持续InterruptSpeechDuration毫秒的人声则进行打断。 */ InterruptSpeechDuration?: number; /** * 控制新一轮对话的触发方式,默认为0。 - 0表示当服务端语音识别检测出的完整一句话后,自动触发一轮新的对话。 - 1表示客户端在收到字幕消息后,自行决定是否手动发送聊天信令触发一轮新的对话。 */ TurnDetectionMode?: number; /** * 是否过滤掉用户只说了一个字的句子,true表示过滤,false表示不过滤,默认值为true */ FilterOneWord?: boolean; /** * 欢迎消息优先级,0默认,1高优,高优不能被打断。 */ WelcomeMessagePriority?: number; /** * 用于过滤LLM返回内容,不播放括号中的内容。 1:中文括号() 2:英文括号() 3:中文方括号【】 4:英文方括号[] 5:英文花括号{} 默认值为空,表示不进行过滤。 */ FilterBracketsContent?: number; } /** * CreatePicture请求参数结构体 */ export interface CreatePictureRequest { /** * 应用id */ SdkAppId: number; /** * 图片内容经base64编码后的string格式,最大长度为2M */ Content: string; /** * 图片后缀名 */ Suffix: string; /** * 图片长度 */ Height: number; /** * 图片宽度 */ Width: number; /** * 显示位置x轴方向 */ XPosition: number; /** * 显示位置y轴方向 */ YPosition: number; } /** * 音频转码参数 */ export interface AudioEncodeParams { /** * 音频采样率,取值为[48000, 44100],单位是Hz。 */ SampleRate?: number; /** * 音频声道数,取值范围[1,2],1表示音频为单声道,2表示音频为双声道。 */ Channel?: number; /** * 音频码率,取值范围[8,500],单位为kbps。 */ BitRate?: number; /** * 音量,取值范围[0,300]。默认100,表示原始音量;0表示静音。 */ Volume?: number; } /** * 服务端控制AI对话机器人播报指定文本 */ export interface ServerPushText { /** * 服务端推送播报文本 */ Text?: string; /** * 是否允许该文本打断机器人说话 */ Interrupt?: boolean; /** * 播报完文本后,是否自动关闭对话任务 */ StopAfterPlay?: boolean; /** * 服务端推送播报音频 格式说明:音频以16KHz采样率的单声道格式提供,编码为Base64字符串。 输入规则:当提供Audio字段时,将不接受Text字段的输入。系统将直接播放Audio字段中的音频内容。 */ Audio?: string; } /** * DescribeTRTCMarketQualityMetricData返回参数结构体 */ export interface DescribeTRTCMarketQualityMetricDataResponse { /** * TRTC监控数据出参 注意:此字段可能返回 null,表示取不到有效值。 */ Data: TRTCDataResp; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 用户自定义混流布局参数列表。 */ export interface MixLayout { /** * 画布上该画面左上角的 y 轴坐标,取值范围 [0, 1920],不能超过画布的高。 */ Top: number; /** * 画布上该画面左上角的 x 轴坐标,取值范围 [0, 1920],不能超过画布的宽。 */ Left: number; /** * 画布上该画面宽度的相对值,取值范围 [0, 1920],与Left相加不应超过画布的宽。 */ Width: number; /** * 画布上该画面高度的相对值,取值范围 [0, 1920],与Top相加不应超过画布的高。 */ Height: number; /** * 字符串内容为待显示在该画面的主播对应的UserId,如果不指定,会按照主播加入房间的顺序匹配。 */ UserId?: string; /** * 画布的透明度值,取值范围[0, 255]。0表示不透明,255表示全透明。默认值为0。 */ Alpha?: number; /** * 0 :拉伸模式,这个模式下整个视频内容会全部显示,并填满子画面,在源视频和目的视频宽高比不一致的时候,画面不会缺少内容,但是画面可能产生形变; 1 :剪裁模式(默认),这个模式下会严格按照目的视频的宽高比对源视频剪裁之后再拉伸,并填满子画面画布,在源视频和目的视频宽高比不一致的时候,画面保持不变形,但是会被剪裁; 2 :填黑模式,这个模式下会严格保持源视频的宽高比进行等比缩放,在源视频和目的视频宽高比不一致的时候,画面的上下侧边缘或者左右侧边缘会露出子画面画布的背景; 3 :智能拉伸模式,这个模式类似剪裁模式,区别是在源视频和目的视频宽高比不一致的时候,限制了最大剪裁比例为画面的宽度或者高度的20%; */ RenderMode?: number; /** * 对应订阅流的主辅路标识: 0:主流(默认); 1:辅流; */ MediaId?: number; /** * 该画布的图层顺序, 这个值越小表示图层越靠后。默认值为0。 */ ImageLayer?: number; /** * 图片的url地址, 只支持jpg, png, jpeg,大小限制不超过5M。注意,url必须携带格式后缀,url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '=' */ SubBackgroundImage?: string; } /** * 混流转推的视频相关参数。 */ 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; } /** * DescribeTRTCRealTimeScaleData请求参数结构体 */ export interface DescribeTRTCRealTimeScaleDataRequest { /** * 用户SdkAppId(如:1400xxxxxx) */ SdkAppId: string; /** * 开始时间,unix时间戳,单位:秒(查询时间范围根据监控仪表盘功能版本而定,基础版可查近3小时,进阶版可查近12小时) */ StartTime: number; /** * 结束时间,unix时间戳,单位:秒 */ EndTime: number; /** * 房间ID */ RoomId?: string; } /** * StartAIConversation返回参数结构体 */ export interface StartAIConversationResponse { /** * 用于唯一标识对话任务。 */ TaskId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 语音转文字参数 */ export interface STTConfig { /** * 语音转文字支持识别的语言,默认是"zh" 中文 可通过购买「AI智能识别时长包」解锁或领取包月套餐体验版解锁不同语言. 详细说明参考:[AI智能识别计费说明](https://cloud.tencent.com/document/product/647/111976) 语音转文本不同套餐版本支持的语言如下: **基础版**: - "zh": 中文(简体) - "zh-TW": 中文(繁体) - "en": 英语 **标准版:** - "8k_zh_large": 普方大模型引擎. 当前模型同时支持中文等语言的识别,模型参数量极大,语言模型性能增强,针对电话音频中各类场景、各类中文方言的识别准确率极大提升. - "16k_zh_large": 普方英大模型引擎. 当前模型同时支持中文、英文、多种中文方言等语言的识别,模型参数量极大,语言模型性能增强,针对噪声大、回音大、人声小、人声远等低质量音频的识别准确率极大提升. - "16k_multi_lang": 多语种大模型引擎. 当前模型同时支持英语、日语、韩语、阿拉伯语、菲律宾语、法语、印地语、印尼语、马来语、葡萄牙语、西班牙语、泰语、土耳其语、越南语、德语的识别,可实现15个语种的自动识别(句子/段落级别). - "16k_zh_en": 中英大模型引擎. 当前模型同时支持中文、英语识别,模型参数量极大,语言模型性能增强,针对噪声大、回音大、人声小、人声远等低质量音频的识别准确率极大提升. **高级版:** - "zh-dialect": 中国方言 - "zh-yue": 中国粤语 - "vi": 越南语 - "ja": 日语 - "ko": 韩语 - "id": 印度尼西亚语 - "th": 泰语 - "pt": 葡萄牙语 - "tr": 土耳其语 - "ar": 阿拉伯语 - "es": 西班牙语 - "hi": 印地语 - "fr": 法语 - "ms": 马来语 - "fil": 菲律宾语 - "de": 德语 - "it": 意大利语 - "ru": 俄语 - "sv": 瑞典语 - "da": 丹麦语 - "no": 挪威语 **注意:** 如果缺少满足您需求的语言,请联系我们技术人员。 */ Language?: string; /** * **发起模糊识别为高级版能力,默认按照高级版收费,仅支持填写基础版和高级版语言.** 注意:不支持填写"zh-dialect" */ AlternativeLanguage?: Array<string>; /** * 自定义参数,联系后台使用 */ CustomParam?: string; /** * 语音识别vad的时间,范围为240-2000,默认为1000,单位为ms。更小的值会让语音识别分句更快。 */ VadSilenceTime?: number; /** * 热词表:该参数用于提升识别准确率。 单个热词限制:"热词|权重",单个热词不超过30个字符(最多10个汉字),权重[1-11]或者100,如:“腾讯云|5” 或 “ASR|11”; 热词表限制:多个热词用英文逗号分割,最多支持128个热词,如:“腾讯云|10,语音识别|5,ASR|11”; */ HotWordList?: string; } /** * DescribeTRTCMarketScaleData请求参数结构体 */ export interface DescribeTRTCMarketScaleDataRequest { /** * 用户SdkAppId */ SdkAppId: string; /** * 查询开始时间,格式为YYYY-MM-DD。(查询时间范围根据监控仪表盘功能版本而定,【基础版】可查近30天,【进阶版】可查近60天) */ StartTime: string; /** * 查询结束时间,格式为YYYY-MM-DD。 */ EndTime: string; /** * 返回数据的粒度,支持设为以下值: d:按天。此时返回查询时间范围内 UTC 时间为零点的数据。 h:按小时。此时返回查询时间范围内 UTC 时间为整小时的数据。 */ Period: string; } /** * 音量布局SEI参数,可以自定义AppData和PayloadType类型。 该参数内容可以为空,表示携带默认的音量布局SEI。 */ export interface McuLayoutVolume { /** * AppData的内容,会被写入自定义SEI中的app_data字段,长度需小于4096。 */ AppData?: string; /** * SEI消息的payload_type,默认值100,取值范围100-254(244除外,244为我们内部自定义的时间戳SEI) */ PayloadType?: number; /** * SEI发送间隔,单位毫秒,默认值为1000。 */ Interval?: number; /** * 取值范围[0,1],填1:发送关键帧时会确保带SEI;填0:发送关键帧时不确保带SEI。默认值为0。 */ FollowIdr?: number; } /** * DescribeUserEvent请求参数结构体 */ export interface DescribeUserEventRequest { /** * 通话 ID(唯一标识一次通话): SdkAppId_RoomId(房间号)_ CreateTime(房间创建时间,unix时间戳,单位为s)例:1400xxxxxx_218695_1590065777。通过 DescribeRoomInfo(查询历史房间列表)接口获取([查询历史房间列表](https://cloud.tencent.com/document/product/647/44050))。 */ CommId: string; /** * 查询开始时间,本地unix时间戳,单位为秒(如:1590065777) 注意:支持查询14天内的数据 */ StartTime: number; /** * 查询结束时间,本地unix时间戳,单位为秒(如:1590065877) 注意:查询时间大于房间结束时间,以房间结束时间为准。 */ EndTime: number; /** * 用户UserId */ UserId: string; /** * 房间号(如:223) */ RoomId: string; /** * 用户SdkAppId(如:1400xxxxxx) */ SdkAppId: number; } /** * 混流自定义渲染参数 */ export interface McuBackgroundCustomRender { /** * 自定义渲染画面的宽度,单位为像素值,需大于0,且不能超过子布局的宽。 */ Width: number; /** * 自定义渲染画面的高度,单位为像素值,需大于0,且不能超过子布局的高。 */ Height: number; /** * 自定义渲染画面的圆角半径,单位为像素值,不能超过渲染画面Width和Height最小值的一半,不指定默认为0,表示直角。 */ Radius?: number; } /** * 自定义文字水印数据结构 */ export interface WaterMarkChar { /** * 文字水印的起始坐标Y值,从左上角开始 */ Top: number; /** * 文字水印的起始坐标X值,从左上角开始 */ Left: number; /** * 文字水印的宽度,单位像素值 */ Width: number; /** * 文字水印的高度,单位像素值 */ Height: number; /** * 水印文字的内容 */ Chars: string; /** * 水印文字的大小,单位像素,默认14 */ FontSize?: number; /** * 水印文字的颜色,默认白色 */ FontColor?: string; /** * 水印文字的背景色,为空代表背景透明,默认为空 */ BackGroundColor?: string; /** * 文字水印的字体,支持设置以下值: 1. Tencent (默认) 2. SourceHanSans */ Font?: string; } /** * DescribeTrtcRoomUsage返回参数结构体 */ export interface DescribeTrtcRoomUsageResponse { /** * 房间维度用量数据,csv文件格式,单位:秒。 */ Data?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * StopPublishCdnStream返回参数结构体 */ export interface StopPublishCdnStreamResponse { /** * 转推任务唯一的String Id */ TaskId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 造成异常体验可能的异常事件类型 */ export interface AbnormalEvent { /** * 异常事件ID,具体值查看附录:异常体验ID映射表:https://cloud.tencent.com/document/product/647/44916 */ AbnormalEventId?: number; /** * 远端用户ID,"":表示异常事件不是由远端用户产生 */ PeerId?: string; } /** * 历史规模信息 */ export interface ScaleInfomation { /** * 每天开始的时间 */ Time?: number; /** * 房间人数,用户重复进入同一个房间为1次 */ UserNumber?: number; /** * 房间人次,用户每次进入房间为一次 */ UserCount?: number; /** * sdkappid下一天内的房间数 */ RoomNumbers?: number; } /** * DescribeTRTCRealTimeScaleMetricData请求参数结构体 */ export interface DescribeTRTCRealTimeScaleMetricDataRequest { /** * 用户SdkAppId(如:1400xxxxxx) */ SdkAppId: string; /** * 开始时间,unix时间戳,单位:秒(查询时间范围根据监控仪表盘功能版本而定,基础版可查近3小时,进阶版可查近12小时) */ StartTime: number; /** * 结束时间,unix时间戳,单位:秒 */ EndTime: number; /** * 房间ID */ RoomId?: string; } /** * ControlAIConversation返回参数结构体 */ export interface ControlAIConversationResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * StopAITranscription请求参数结构体 */ export interface StopAITranscriptionRequest { /** * 唯一标识转录任务。 */ TaskId: string; } /** * 视频转码参数 */ export interface VideoEncodeParams { /** * 宽。取值范围[0,1920],单位为像素值。 */ Width?: number; /** * 高。取值范围[0,1080],单位为像素值。 */ Height?: number; /** * 帧率。取值范围[1,60],表示帧率可选范围为1到60fps。 */ Fps?: number; /** * 码率。取值范围[1,10000],单位为kbps。 */ BitRate?: number; /** * gop。取值范围[1,2],单位为秒。 */ Gop?: number; } /** * UpdateAIConversation返回参数结构体 */ export interface UpdateAIConversationResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeUserEvent返回参数结构体 */ export interface DescribeUserEventResponse { /** * 返回的事件列表,若没有数据,会返回空数组。 */ Data: Array<EventList>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 视频编码参数。 */ export interface VideoEncode { /** * 输出流宽,音视频输出时必填。取值范围[0,1920],单位为像素值。 */ Width: number; /** * 输出流高,音视频输出时必填。取值范围[0,1920],单位为像素值。 */ Height: number; /** * 输出流帧率,音视频输出时必填。取值范围[1,60],表示混流的输出帧率可选范围为1到60fps。 */ Fps: number; /** * 输出流码率,音视频输出时必填。取值范围[1,10000],单位为kbps。 */ BitRate: number; /** * 输出流gop,音视频输出时必填。取值范围[1,5],单位为秒。 */ Gop: number; } /** * MCU混流布局参数 */ export interface LayoutParams { /** * 混流布局模板ID,0为悬浮模板(默认);1为九宫格模板;2为屏幕分享模板;3为画中画模板;4为自定义模板。 */ Template?: number; /** * 屏幕分享模板、悬浮模板、画中画模板中有效,代表大画面对应的用户ID。 */ MainVideoUserId?: string; /** * 屏幕分享模板、悬浮模板、画中画模板中有效,代表大画面对应的流类型,0为摄像头,1为屏幕分享。左侧大画面为web用户时此值填0。 */ MainVideoStreamType?: number; /** * 画中画模板中有效,代表小画面的布局参数。 */ SmallVideoLayoutParams?: SmallVideoLayoutParams; /** * 屏幕分享模板有效。设置为1时代表大画面居右,小画面居左布局。默认为0。 */ MainVideoRightAlign?: number; /** * 指定混视频的用户ID列表。设置此参数后,输出流混合此参数中包含用户的音视频,以及其他用户的纯音频。悬浮模板、九宫格、屏幕分享模板有效,最多可设置16个用户。 */ MixVideoUids?: Array<string>; /** * 自定义模板中有效,指定用户视频在混合画面中的位置。 */ PresetLayoutConfig?: Array<PresetLayoutConfig>; /** * 自定义模板中有效,设置为1时代表启用占位图功能,0时代表不启用占位图功能,默认为0。启用占位图功能时,在预设位置的用户没有上行视频时可显示对应的占位图。 */ PlaceHolderMode?: number; /** * 悬浮模板、九宫格、屏幕分享模板生效,用于控制纯音频上行是否占用画面布局位置。设置为0是代表后台默认处理方式,悬浮小画面占布局位置,九宫格画面占布局位置、屏幕分享小画面不占布局位置;设置为1时代表纯音频上行占布局位置;设置为2时代表纯音频上行不占布局位置。默认为0。 */ PureAudioHoldPlaceMode?: number; /** * 水印参数。 */ WaterMarkParams?: WaterMarkParams; /** * 屏幕分享模板、悬浮模板、九宫格模板、画中画模版有效,画面在输出时的显示模式:0为裁剪,1为缩放,2为缩放并显示黑底,不填采用后台的默认渲染方式(屏幕分享大画面为缩放,其他为裁剪)。若此参数不生效,请提交工单寻求帮助。 */ RenderMode?: number; } /** * StopMCUMixTranscodeByStrRoomId返回参数结构体 */ export interface StopMCUMixTranscodeByStrRoomIdResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 图片列表信息 */ export interface PictureInfo { /** * 图片长度 */ Height?: number; /** * 图片宽度 */ Width?: number; /** * 显示位置x轴方向 */ XPosition?: number; /** * 显示位置y轴方向 */ YPosition?: number; /** * 应用id */ SdkAppId?: number; /** * 图片id */ PictureId?: number; } /** * DescribeCallDetailInfo请求参数结构体 */ export interface DescribeCallDetailInfoRequest { /** * 通话 ID(唯一标识一次通话): SdkAppId_RoomId(房间号)_ CreateTime(房间创建时间,unix时间戳,单位为s)例:1400xxxxxx_218695_1590065777。通过 DescribeRoomInfo(查询历史房间列表)接口获取([查询历史房间列表](https://cloud.tencent.com/document/product/647/44050))。 */ CommId: string; /** * 查询开始时间,本地unix时间戳,单位为秒(如:1590065777), 注意:支持查询14天内的数据。 */ StartTime: number; /** * 查询结束时间,本地unix时间戳,单位为秒(如:1590065877) 注意:查询起止时间需小于1小时,超过则返回null,即与StartTime间隔时间不超过1小时。 */ EndTime: number; /** * 用户SdkAppId(如:1400xxxxxx)。 */ SdkAppId: number; /** * 需查询的用户数组,默认不填返回6个用户。 */ UserIds?: Array<string>; /** * 需查询的指标,不填则只返回用户列表,填all则返回所有指标。 appCpu:APP CPU使用率; sysCpu:系统 CPU使用率; aBit:上/下行音频码率;单位:bps aBlock:音频卡顿时长;单位:ms bigvBit:上/下行视频码率;单位:bps bigvCapFps:视频采集帧率; bigvEncFps:视频发送帧率; bigvDecFps:渲染帧率; bigvBlock:视频卡顿时长;单位:ms aLoss:上/下行音频丢包率; bigvLoss:上/下行视频丢包率; bigvWidth:上/下行分辨率宽; bigvHeight:上/下行分辨率高; aCapEnergy:音频采集能量; aPlayEnergy:音频播放能量; rtt:SDK到云端的往返延时;单位: ms */ DataType?: Array<string>; /** * 当前页数,默认为0, 注意:PageNumber和PageSize 其中一个不填均默认返回6条数据。 */ PageNumber?: number; /** * 每页个数,默认为6, 范围:[1,100] 注意:DataType不为null,UserIds长度不能超过6,PageSize最大值不超过6; DataType 为null,UserIds长度不超过100,PageSize最大不超过100。 */ PageSize?: number; } /** * DescribeTRTCMarketScaleData返回参数结构体 */ export interface DescribeTRTCMarketScaleDataResponse { /** * TRTC监控数据出参 注意:此字段可能返回 null,表示取不到有效值。 */ Data?: TRTCDataResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * Mcu转推录制,腾讯云点播相关参数。 */ export interface McuTencentVod { /** * 媒体后续任务处理操作,即完成媒体上传后,可自动发起任务流操作。参数值为任务流模板名,云点播支持 创建任务流模板 并为模板命名。 */ Procedure?: string; /** * 媒体文件过期时间,为当前时间的绝对过期时间;保存一天,就填"86400",永久保存就填"0",默认永久保存。 */ ExpireTime?: number; /** * 指定上传园区,仅适用于对上传地域有特殊需求的用户。 */ StorageRegion?: string; /** * 分类ID,用于对媒体进行分类管理,可通过 创建分类 接口,创建分类,获得分类 ID。 默认值:0,表示其他分类。 */ ClassId?: number; /** * 点播 子应用 ID。如果要访问子应用中的资源,则将该字段填写为子应用 ID;否则无需填写该字段。 */ SubAppId?: number; /** * 任务流上下文,任务完成回调时透传。 */ SessionContext?: string; /** * 上传上下文,上传完成回调时透传。 */ SourceContext?: string; } /** * ModifyPicture请求参数结构体 */ export interface ModifyPictureRequest { /** * 图片id */ PictureId: number; /** * 应用id */ SdkAppId: number; /** * 图片长度 */ Height?: number; /** * 图片宽度 */ Width?: number; /** * 显示位置x轴方向 */ XPosition?: number; /** * 显示位置y轴方向 */ YPosition?: number; } /** * DescribeWebRecord返回参数结构体 */ export interface DescribeWebRecordResponse { /** * 1: 正在录制中 */ Status?: number; /** * 在使用RecordId查询时返回 */ TaskId?: string; /** * 在使用TaskId查询时返回 */ RecordId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeUserInfo请求参数结构体 */ export interface DescribeUserInfoRequest { /** * 通话 ID(唯一标识一次通话): SdkAppId_RoomId(房间号)_ CreateTime(房间创建时间,unix时间戳,单位为s)例:1400xxxxxx_218695_1590065777。通过 DescribeRoomInfo(查询历史房间列表)接口获取([查询历史房间列表](https://cloud.tencent.com/document/product/647/44050))。 */ CommId: string; /** * 查询开始时间,本地unix时间戳,单位为秒(如:1590065777)注意:最大支持查询14天内的数据 */ StartTime: number; /** * 查询结束时间,本地unix时间戳,单位为秒(如:1590065877) 注意:与StartTime间隔时间不超过4小时。 */ EndTime: number; /** * 用户SdkAppId(如:1400xxxxxx) */ SdkAppId: number; /** * 需查询的用户数组,不填默认返回6个用户 范围:[1,100]。 */ UserIds?: Array<string>; /** * 当前页数,默认为0, 注意:PageNumber和PageSize 其中一个不填均默认返回6条数据。 */ PageNumber?: number; /** * 每页个数,默认为6, 范围:[1,100]。 */ PageSize?: number; } /** * DescribeRelayUsage请求参数结构体 */ export interface DescribeRelayUsageRequest { /** * 查询开始时间,格式为YYYY-MM-DD。 */ StartTime: string; /** * 查询结束时间,格式为YYYY-MM-DD。 单次查询统计区间最多不能超过31天。 */ EndTime: string; /** * TRTC的SdkAppId,和房间所对应的SdkAppId相同。如果没有这个参数,返回用户下全部实时音视频应用的汇总。 */ SdkAppId?: number; } /** * MCU混流水印参数 */ export interface WaterMarkParams { /** * 混流-水印图片ID。取值为实时音视频控制台上传的图片ID。 */ WaterMarkId: number; /** * 混流-水印宽。单位为像素值。水印宽+X偏移不能超过整个画布宽。 */ WaterMarkWidth: number; /** * 混流-水印高。单位为像素值。水印高+Y偏移不能超过整个画布高。 */ WaterMarkHeight: number; /** * 水印在输出时的X偏移。单位为像素值。水印宽+X偏移不能超过整个画布宽。 */ LocationX: number; /** * 水印在输出时的Y偏移。单位为像素值。水印高+Y偏移不能超过整个画布高。 */ LocationY: number; /** * 混流-水印图片URL地址,支持png、jpg、jpeg、bmp格式,暂不支持透明通道。URL链接长度限制为512字节。WaterMarkUrl和WaterMarkId参数都填时,以WaterMarkUrl为准。图片大小限制不超过2MB。 */ WaterMarkUrl?: string; } /** * DescribeRecordStatistic返回参数结构体 */ export interface DescribeRecordStatisticResponse { /** * 应用的用量信息数组。 */ SdkAppIdUsages: Array<SdkAppIdRecordUsage>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * StartMCUMixTranscodeByStrRoomId返回参数结构体 */ export interface StartMCUMixTranscodeByStrRoomIdResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 腾讯云对象存储COS以及第三方云存储的账号信息 */ export interface CloudStorage { /** * 腾讯云对象存储COS以及第三方云存储账号信息 0:腾讯云对象存储 COS 1:AWS 【注意】目前第三方云存储仅支持AWS,更多第三方云存储陆续支持中 */ Vendor: number; /** * 腾讯云对象存储的[地域信息](https://cloud.tencent.com/document/product/436/6224#.E5.9C.B0.E5.9F.9F)。 示例值:cn-shanghai-1 AWS S3[地域信息](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-regions) */ Region: string; /** * 云存储桶名称。 */ Bucket: string; /** * 云存储的access_key账号信息。 若存储至腾讯云对象存储COS,请前往https://console.cloud.tencent.com/cam/capi 查看或创建,对应链接中密钥字段的SecretId值。 */ AccessKey: string; /** * 云存储的secret_key账号信息。 若存储至腾讯云对象存储COS,请前往https://console.cloud.tencent.com/cam/capi 查看或创建,对应链接中密钥字段的SecretKey值。 */ SecretKey: string; /** * 云存储bucket 的指定位置,由字符串数组组成。合法的字符串范围az,AZ,0~9,'_'和'-',举个例子,录制文件xxx.m3u8在 ["prefix1", "prefix2"]作用下,会变成prefix1/prefix2/TaskId/xxx.m3u8。 */ FileNamePrefix?: Array<string>; } /** * DescribeTrtcUsage返回参数结构体 */ export interface DescribeTrtcUsageResponse { /** * 用量类型,与UsageValue中各个位置的值对应。 */ UsageKey?: Array<string>; /** * 各个时间点用量明细,单位:分钟 */ UsageList?: Array<TrtcUsage>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 转推录制参数 */ export interface McuRecordParams { /** * 转推录制模式, 0/不填: 暂不支持,行为未定义; 1: 不开启录制; 2: 开启录制(使用控制台自动录制模板参数,参考:[跳转文档](https://cloud.tencent.com/document/product/647/111748#.E5.BD.95.E5.88.B6.E6.8E.A7.E5.88.B6.E6.96.B9.E6.A1.88)); 3: 开启录制(使用API指定参数)。 */ UniRecord?: number; /** * 录制任务 key,标识一个录制任务;您可以通过该参数,将多个转推任务录制成一个文件。不指定该参数时,只录制当前转推任务。 【限制长度为128字节,只允许包含大小写英文字母(a-zA-Z)、数字(0-9)及下划线(_)和连词符(-)】 */ RecordKey?: string; /** * 【仅当UniRecord=3时此参数有效】 续录等待时间,对应录制模板“续录等待时长”,单位:秒。该值需大于等于 5,且小于等于 86400(24小时),默认值为 30。启用续录时,录制任务空闲超过RecordWaitTime的时长,自动结束。 */ RecordWaitTime?: number; /** * 【仅当UniRecord=3时此参数有效】 录制输出文件格式列表,对应录制模板“文件格式”,支持“hls”、"mp4"、"aac"三种格式,默认值为"mp4"。其中"mp4"和"aac"格式,不能同时指定。 只录制 mp4格式,示例值:["mp4"]。同时录制mp4 和 HLS 格式,示例值:["mp4","hls"]。 */ RecordFormat?: Array<string>; /** * 【仅当UniRecord=3时此参数有效】 单个文件录制时长,对应录制模板“单个录制文件时长”,单位:分钟。该值需大于等于 1,且小于等于 1440(24小时),默认值为 1440。只对"mp4"或"aac"格式生效。实际单文件录制时长还受单文件大小不超过 2G 限制,超过2G则强制拆分。 */ MaxMediaFileDuration?: number; /** * 【仅当UniRecord=3时此参数有效】 录制的音视频类型,对应录制模板“录制格式”,0:音视频,1:纯音频,2:纯视频。最终录制文件内容是录制指定类型和转推内容的交集。 */ StreamType?: number; /** * 录制文件名前缀,不超过64字符。只有存储为vod时生效。 【限制长度为64字节,只允许包含大小写英文字母(a-zA-Z)、数字(0-9)及下划线(_)和连词符(-)】 */ UserDefineRecordPrefix?: string; /** * 【仅当UniRecord=3时此参数有效】 录制文件存储参数,对应控制台“存储位置”及相关参数。目前支持云点播VOD和对象存储COS两种存储方式,只能填写一种。 */ McuStorageParams?: McuStorageParams; } /** * DismissRoomByStrRoomId请求参数结构体 */ export interface DismissRoomByStrRoomIdRequest { /** * TRTC的SDKAppId。 */ SdkAppId: number; /** * 字符串类型房间号。 本接口仅支持解散字符串类型房间号,如需解散数字类型房间号,请使用:DismissRoom */ RoomId: string; } /** * DescribeTRTCMarketQualityMetricData请求参数结构体 */ export interface DescribeTRTCMarketQualityMetricDataRequest { /** * 用户SdkAppId(如:1400xxxxxx) */ SdkAppId: string; /** * 查询开始时间,格式为YYYY-MM-DD。(查询时间范围根据监控仪表盘功能版本而定,【基础版】可查近30天,【进阶版】可查近60天) */ StartTime: string; /** * 查询结束时间,格式为YYYY-MM-DD。 */ EndTime: string; /** * 返回数据的粒度,支持设为以下值: d:按天。此时返回查询时间范围内 UTC 时间为零点的数据。 h:按小时。此时返回查询时间范围内 UTC 时间为整小时的数据。 */ Period: string; } /** * DescribeWebRecord请求参数结构体 */ export interface DescribeWebRecordRequest { /** * 开始页面录制时返回的任务id */ TaskId?: string; /** * 发起页面录制时传递的SdkAppId */ SdkAppId?: number; /** * 发起录制时传递的RecordId, 传入此值时需要传递SdkAppId */ RecordId?: string; } /** * DescribeTRTCRealTimeScaleData返回参数结构体 */ export interface DescribeTRTCRealTimeScaleDataResponse { /** * TRTC监控数据出参 注意:此字段可能返回 null,表示取不到有效值。 */ Data?: TRTCDataResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeRecordStatistic请求参数结构体 */ export interface DescribeRecordStatisticRequest { /** * 查询开始日期,格式为YYYY-MM-DD。 */ StartTime: string; /** * 查询结束日期,格式为YYYY-MM-DD。 单次查询统计区间最多不能超过31天。 */ EndTime: string; /** * 应用ID,可不传。传应用ID时返回的是该应用的用量,不传时返回多个应用的合计值。 */ SdkAppId?: number; } /** * DescribeRoomInfo请求参数结构体 */ export interface DescribeRoomInfoRequest { /** * 用户SdkAppId(如:1400xxxxxx) */ SdkAppId: number; /** * 查询开始时间,本地unix时间戳,单位为秒(如:1590065777)注意:最大支持查询14天内的数据 */ StartTime: number; /** * 查询结束时间,本地unix时间戳,单位为秒(如:1590065877) 注意:与StartTime间隔时间不超过24小时。 */ EndTime: number; /** * 房间号(如:223) */ RoomId?: string; /** * 当前页数,默认为0, 注意:PageNumber和PageSize 其中一个不填均默认返回10条数据。 */ PageNumber?: number; /** * 每页个数,默认为10, 范围:[1,100] */ PageSize?: number; } /** * 录制存储参数 */ export interface StorageParams { /** * 腾讯云对象存储COS以及第三方云存储的账号信息 */ CloudStorage?: CloudStorage; /** * 腾讯云云点播Vod的存储信息 */ CloudVod?: CloudVod; } /** * CreateBasicModeration请求参数结构体 */ export interface CreateBasicModerationRequest { /** * TRTC的[SdkAppId](https://cloud.tencent.com/document/product/647/46351#sdkappid),和TRTC的房间所对应的SdkAppId相同。 */ SdkAppId: number; /** * TRTC的[RoomId](https://cloud.tencent.com/document/product/647/46351#roomid),为TRTC房间所对应的RoomId。 */ RoomId: string; /** * 目标审核用户id */ UserId: string; /** * TRTC房间号的类型。【*注意】必须和TRTC的房间所对应的RoomId类型相同:0: 字符串类型的RoomId1: 32位整型的RoomId(默认) */ RoomIdType?: number; /** * 音频文件上传到云存储的参数 */ AuditStorageParams?: AuditStorageParams; } /** * 点播相关参数。 */ export interface CloudVod { /** * 腾讯云点播相关参数。 */ TencentVod?: TencentVod; } /** * MCU混流输出流编码参数 */ export interface EncodeParams { /** * 混流-输出流音频采样率。取值为[48000, 44100, 32000, 24000, 16000, 8000],单位是Hz。混流任务发起过程中,为了保持CDN链接的稳定,不要修改音频参数(codec、采样率、码率、声道数)。 */ AudioSampleRate: number; /** * 混流-输出流音频码率。取值范围[8,500],单位为kbps。混流任务发起过程中,为了保持CDN链接的稳定,不要修改音频参数(codec、采样率、码率、声道数)。 */ AudioBitrate: number; /** * 混流-输出流音频声道数,取值范围[1,2],1表示混流输出音频为单声道,2表示混流输出音频为双声道。混流任务发起过程中,为了保持CDN链接的稳定,不要修改音频参数(codec、采样率、码率、声道数)。 */ AudioChannels: number; /** * 混流-输出流宽,音视频输出时必填。取值范围[0,1920],单位为像素值。 */ VideoWidth?: number; /** * 混流-输出流高,音视频输出时必填。取值范围[0,1080],单位为像素值。 */ VideoHeight?: number; /** * 混流-输出流码率,音视频输出时必填。取值范围[1,10000],单位为kbps。 */ VideoBitrate?: number; /** * 混流-输出流帧率,音视频输出时必填。取值范围[1,60],表示混流的输出帧率可选范围为1到60fps。 */ VideoFramerate?: number; /** * 混流-输出流gop,音视频输出时必填。取值范围[1,5],单位为秒。 */ VideoGop?: number; /** * 混流-输出流背景色,取值是十进制整数。常用的颜色有: 红色:0xff0000,对应的十进制整数是16724736。 黄色:0xffff00。对应的十进制整数是16776960。 绿色:0x33cc00。对应的十进制整数是3394560。 蓝色:0x0066ff。对应的十进制整数是26367。 黑色:0x000000。对应的十进制整数是0。 白色:0xFFFFFF。对应的十进制整数是16777215。 灰色:0x999999。对应的十进制整数是10066329。 */ BackgroundColor?: number; /** * 混流-输出流背景图片,取值为实时音视频控制台上传的图片ID。 */ BackgroundImageId?: number; /** * 混流-输出流音频编码类型,取值范围[0,1, 2],0为LC-AAC,1为HE-AAC,2为HE-AACv2。默认值为0。当音频编码设置为HE-AACv2时,只支持输出流音频声道数为双声道。HE-AAC和HE-AACv2支持的输出流音频采样率范围为[48000, 44100, 32000, 24000, 16000]。混流任务发起过程中,为了保持CDN链接的稳定,不要修改音频参数(codec、采样率、码率、声道数)。 */ AudioCodec?: number; /** * 混流-输出流背景图片URL地址,支持png、jpg、jpeg、bmp格式,暂不支持透明通道。URL链接长度限制为512字节。BackgroundImageUrl和BackgroundImageId参数都填时,以BackgroundImageUrl为准。图片大小限制不超过2MB。 */ BackgroundImageUrl?: string; } /** * 渲染移动模式参数,不渲染移动模式时,请勿设置此参数。 */ export interface EmulateMobileParams { /** * 移动设备类型, 0: 手机 1: 平板 注意:此字段可能返回 null,表示取不到有效值。 */ MobileDeviceType?: number; /** * 屏幕方向, 0: 竖屏, 1: 横屏 注意:此字段可能返回 null,表示取不到有效值。 */ ScreenOrientation?: number; } /** * DescribeCallDetailInfo返回参数结构体 */ export interface DescribeCallDetailInfoResponse { /** * 返回的用户总条数 */ Total?: number; /** * 用户信息列表 */ UserList?: Array<UserInformation>; /** * 质量数据 */ Data?: Array<QualityData>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeTRTCRealTimeQualityData返回参数结构体 */ export interface DescribeTRTCRealTimeQualityDataResponse { /** * TRTC监控数据出参 注意:此字段可能返回 null,表示取不到有效值。 */ Data?: TRTCDataResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 混流自定义裁剪参数 */ export interface McuCustomCrop { /** * 自定义裁剪起始位置的X偏移,单位为像素值,大于等于0。 */ LocationX: number; /** * 自定义裁剪起始位置的Y偏移,单位为像素值,大于等于0。 */ LocationY: number; /** * 自定义裁剪画面的宽度,单位为像素值,大于0,且LocationX+Width不超过10000 */ Width: number; /** * 自定义裁剪画面的高度,单位为像素值,大于0,且LocationY+Height不超过10000 */ Height: number; } /** * DescribeMixTranscodingUsage请求参数结构体 */ export interface DescribeMixTranscodingUsageRequest { /** * 查询开始时间,格式为YYYY-MM-DD。 */ StartTime: string; /** * 查询结束时间,格式为YYYY-MM-DD。 单次查询统计区间最多不能超过31天。 */ EndTime: string; /** * TRTC的SdkAppId,和房间所对应的SdkAppId相同。如果没有这个参数,返回用户下全部实时音视频应用的汇总。 */ SdkAppId?: number; } /** * DescribeStreamIngest返回参数结构体 */ export interface DescribeStreamIngestResponse { /** * 任务的状态信息。 InProgress:表示当前任务正在进行中。 NotExist:表示当前任务不存在。 示例值:InProgress */ Status?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 录制的音视频转码参数。 */ export interface MixTranscodeParams { /** * 录制视频转码参数,注意如果设置了这个参数,那么里面的字段都是必填的,没有默认值,如果不填这个参数,那么取值为默认值。 */ VideoParams?: VideoParams; /** * 录制音频转码参数,注意如果设置了这个参数,那么里面的字段都是必填的,没有默认值,如果不填这个参数,那么取值为默认值。 */ AudioParams?: AudioParams; } /** * StopStreamIngest请求参数结构体 */ export interface StopStreamIngestRequest { /** * TRTC的SDKAppId,和任务的房间所对应的SDKAppId相同。 */ SdkAppId: number; /** * 任务的唯一Id,在启动任务成功后会返回。 */ TaskId: string; } /** * DescribeTRTCMarketQualityData返回参数结构体 */ export interface DescribeTRTCMarketQualityDataResponse { /** * TRTC监控数据出参 注意:此字段可能返回 null,表示取不到有效值。 */ Data?: TRTCDataResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 画中画模板中有效,代表小画面的布局参数 */ export interface SmallVideoLayoutParams { /** * 代表小画面对应的用户ID。 */ UserId: string; /** * 代表小画面对应的流类型,0为摄像头,1为屏幕分享。小画面为web用户时此值填0。 */ StreamType: number; /** * 小画面在输出时的宽度,单位为像素值,不填默认为0。 */ ImageWidth?: number; /** * 小画面在输出时的高度,单位为像素值,不填默认为0。 */ ImageHeight?: number; /** * 小画面在输出时的X偏移,单位为像素值,LocationX与ImageWidth之和不能超过混流输出的总宽度,不填默认为0。 */ LocationX?: number; /** * 小画面在输出时的Y偏移,单位为像素值,LocationY与ImageHeight之和不能超过混流输出的总高度,不填默认为0。 */ LocationY?: number; } /** * 指定订阅流白名单或者黑名单,音频的白名单和音频黑名单不能同时设置,视频亦然。同时实际并发订阅的媒体流路数最大支持25路流,混流场景下视频的多画面最大支持24画面。支持通过设置".*$"通配符,来前缀匹配黑白名单的UserId,注意房间里不能有和通配符规则相同的用户,否则将视为订阅具体用户,前缀规则会失效。 */ export interface SubscribeStreamUserIds { /** * 订阅音频流白名单,指定订阅哪几个UserId的音频流,例如["1", "2", "3"], 代表订阅UserId 1,2,3的音频流;["1.*$"], 代表订阅UserId前缀为1的音频流。默认不填订阅房间内所有的音频流,订阅列表用户数不超过32。 */ SubscribeAudioUserIds?: Array<string>; /** * 订阅音频流黑名单,指定不订阅哪几个UserId的音频流,例如["1", "2", "3"], 代表不订阅UserId 1,2,3的音频流;["1.*$"], 代表不订阅UserId前缀为1的音频流。默认不填订阅房间内所有音频流,订阅列表用户数不超过32。 */ UnSubscribeAudioUserIds?: Array<string>; /** * 订阅视频流白名单,指定订阅哪几个UserId的视频流,例如["1", "2", "3"], 代表订阅UserId 1,2,3的视频流;["1.*$"], 代表订阅UserId前缀为1的视频流。默认不填订阅房间内所有视频流,订阅列表用户数不超过32。 */ SubscribeVideoUserIds?: Array<string>; /** * 订阅视频流黑名单,指定不订阅哪几个UserId的视频流,例如["1", "2", "3"], 代表不订阅UserId 1,2,3的视频流;["1.*$"], 代表不订阅UserId前缀为1的视频流。默认不填订阅房间内所有视频流,订阅列表用户数不超过32。 */ UnSubscribeVideoUserIds?: Array<string>; } /** * 水印类型为图片的参数列表 */ export interface WaterMarkImage { /** * 下载的url地址, 只支持jpg, png, jpeg,大小限制不超过5M。注意,url必须携带格式后缀,url内只支持特定的字符串, 范围是a-z A-Z 0-9 '-', '.', '_', '~', ':', '/', '?', '#', '[', ']' '@', '!', '&', '(', ')', '*', '+', ',', '%', '=' */ WaterMarkUrl: string; /** * 画布上该画面左上角的 y 轴坐标,取值范围 [0, 2560],不能超过画布的高。 */ Top: number; /** * 画布上该画面左上角的 x 轴坐标,取值范围 [0, 2560],不能超过画布的宽。 */ Left: number; /** * 画布上该画面宽度的相对值,取值范围 [0, 2560],与Left相加不应超过画布的宽。 */ Width: number; /** * 画布上该画面高度的相对值,取值范围 [0, 2560],与Top相加不应超过画布的高。 */ Height: number; } /** * 混流用户参数 */ export interface McuUserInfoParams { /** * 用户参数。 */ UserInfo: MixUserInfo; /** * 混音的音量调整:取值范围是0到100,100为原始上行音量,不填默认为100,值越小则音量越低。 注:该参数只在音量白名单下配置生效,其他场景配置无效。 */ SoundLevel?: number; } /** * 用户媒体流参数。 */ export interface UserMediaStream { /** * TRTC用户参数。 */ UserInfo?: MixUserInfo; /** * 主辅路流类型,0为摄像头,1为屏幕分享,不填默认为0。 */ StreamType?: number; } /** * sdk或webrtc的事件列表。 */ export interface EventList { /** * 数据内容 */ Content?: Array<EventMessage>; /** * 发送端的userId */ PeerId?: string; } /** * DescribeTrtcUsage请求参数结构体 */ export interface DescribeTrtcUsageRequest { /** * 查询开始时间,格式为YYYY-MM-DD。 */ StartTime: string; /** * 查询结束时间,格式为YYYY-MM-DD。 单次查询统计区间最多不能超过31天。 */ EndTime: string; /** * TRTC的SdkAppId,和房间所对应的SdkAppId相同。如果没有这个参数,返回用户下全部实时音视频应用的汇总。 */ SdkAppId?: number; } /** * DescribeRoomInfo返回参数结构体 */ export interface DescribeRoomInfoResponse { /** * 返回当页数据总数 */ Total?: number; /** * 房间信息列表 */ RoomList?: Array<RoomState>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 混流布局参数。 */ export interface McuLayoutParams { /** * 布局模式:动态布局(1:悬浮布局(默认),2:屏幕分享布局,3:九宫格布局),静态布局(4:自定义布局)。最多支持混入16路音视频流,如果用户只上行音频,也会被算作一路;自定义布局中,如果子画面只设置占位图,也被算作一路。 */ MixLayoutMode?: number; /** * 纯音频上行是否占布局位置,只在动态布局中有效。0表示纯音频不占布局位置,1表示纯音频占布局位置,不填默认为0。 */ PureAudioHoldPlaceMode?: number; /** * 自定义模板中有效,指定用户视频在混合画面中的位置,最多支持设置16个输入流。 */ MixLayoutList?: Array<McuLayout>; /** * 指定动态布局中悬浮布局和屏幕分享布局的大画面信息,只在悬浮布局和屏幕分享布局有效。 */ MaxVideoUser?: MaxVideoUser; /** * 屏幕分享模板、悬浮模板、九宫格模版有效,画面在输出时的显示模式:0为裁剪,1为缩放,2为缩放并显示黑底 */ RenderMode?: number; } /** * DescribeTRTCRealTimeQualityMetricData请求参数结构体 */ export interface DescribeTRTCRealTimeQualityMetricDataRequest { /** * 用户SdkAppId(如:1400xxxxxx) */ SdkAppId: string; /** * 开始时间,unix时间戳,单位:秒(查询时间范围根据监控仪表盘功能版本而定,基础版可查近3小时,进阶版可查近12小时) */ StartTime: number; /** * 结束时间,unix时间戳,单位:秒 */ EndTime: number; /** * 房间ID */ RoomId?: string; } /** * DescribeAITranscription请求参数结构体 */ export interface DescribeAITranscriptionRequest { /** * 查询任务状态,不使用时传入空字符串。 有两种查询方式: 1、只填写TaskId,这种方式使用TaskId来查询任务 2、TaskId为空字符串,填写SdkAppId和SessionId,这种方式不需要使用TaskId查询任务 */ TaskId: string; /** * TRTC的SdkAppId,和SessionId配合使用。 */ SdkAppId?: number; /** * 开启转录任务时传入的SessionId,和SdkAppId配合使用。 */ SessionId?: string; } /** * CreateBasicModeration返回参数结构体 */ export interface CreateBasicModerationResponse { /** * 审核服务分配的任务ID。任务ID是对一次审核任务生命周期过程的唯一标识,结束任务时会失去意义。任务ID需要业务保存下来,作为下次针对这个任务操作的参数 */ TaskId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 查询旁路转码计费时长。 查询时间小于等于1天时,返回每5分钟粒度的数据;查询时间大于1天时,返回按天汇总的数据。 */ export interface SdkAppIdTrtcMcuTranscodeTimeUsage { /** * 本组数据对应的时间点,格式如:2020-09-07或2020-09-07 00:05:05。 */ TimeKey: string; /** * 语音时长,单位:秒。 */ AudioTime: number; /** * 视频时长-标清SD,单位:秒。 */ VideoTimeSd: number; /** * 视频时长-高清HD,单位:秒。 */ VideoTimeHd: number; /** * 视频时长-全高清FHD,单位:秒。 */ VideoTimeFhd: number; /** * 带宽,单位:Mbps。 */ Flux: number; } /** * DescribeAIConversation返回参数结构体 */ export interface DescribeAIConversationResponse { /** * 任务开始时间。 */ StartTime?: string; /** * 任务状态。有4个值:1、Idle表示任务未开始2、Preparing表示任务准备中3、InProgress表示任务正在运行4、Stopped表示任务已停止,正在清理资源中 */ Status?: string; /** * 任务的唯一标识,在启动任务时生成 */ TaskId?: string; /** * 开启对话任务时填写的SessionId,如果没写则不返回。 */ SessionId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ 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返回参数结构体 */ export interface DescribeUserInfoResponse { /** * 返回的用户总条数 */ Total?: number; /** * 用户信息列表 */ UserList?: Array<UserInformation>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * RemoveUserByStrRoomId返回参数结构体 */ export interface RemoveUserByStrRoomIdResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeTRTCRealTimeScaleMetricData返回参数结构体 */ export interface DescribeTRTCRealTimeScaleMetricDataResponse { /** * TRTC监控数据出参 注意:此字段可能返回 null,表示取不到有效值。 */ Data?: TRTCDataResp; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * UpdateStreamIngest返回参数结构体 */ export interface UpdateStreamIngestResponse { /** * 任务的状态信息。InProgress:表示当前任务正在进行中。NotExist:表示当前任务不存在。示例值:InProgress */ Status?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * StartMCUMixTranscode请求参数结构体 */ export interface StartMCUMixTranscodeRequest { /** * TRTC的SDKAppId。 */ SdkAppId: number; /** * 房间号。 */ RoomId: number; /** * 混流输出控制参数。 */ OutputParams: OutputParams; /** * 混流输出编码参数。 */ EncodeParams: EncodeParams; /** * 混流输出布局参数。 */ LayoutParams: LayoutParams; /** * 第三方CDN转推参数。如需转推至腾讯云云直播,此参数无需填写,会默认转推 */ PublishCdnParams?: PublishCdnParams; } /** * 页面录制控制参数 */ export interface WebRecordVideoParams { /** * 录制画面宽度,默认为1280,取值范围[0, 1920] */ Width?: number; /** * 录制画面高度,默认为720,取值范围[0, 1080] */ Height?: number; /** * 指定输出格式,可选hls,mp4。存储到云点播VOD时此参数无效,存储到VOD时请通过TencentVod(https://cloud.tencent.com/document/api/647/44055#TencentVod)内的MediaType设置。 */ Format?: string; /** * 如果是aac或者mp4文件格式,超过长度限制后,系统会自动拆分视频文件。单位:分钟。默认为1440min(24h),取值范围为1-1440。【单文件限制最大为2G,满足文件大小 >2G 或录制时长度 > 24h任意一个条件,文件都会自动切分】 Hls 格式录制此参数不生效。 示例值:1440 */ MaxMediaFileDuration?: number; } /** * 图片水印参数。 */ export interface McuWaterMarkImage { /** * 水印图片URL地址,支持png、jpg、jpeg格式。图片大小限制不超过5MB。 注:您需要确保图片链接的可访问性,后台单次下载超时时间为10秒,最多重试3次,若最终图片下载失败,水印图片将不会生效。 */ WaterMarkUrl: string; /** * 水印在输出时的宽。单位为像素值。 */ WaterMarkWidth: number; /** * 水印在输出时的高。单位为像素值。 */ WaterMarkHeight: number; /** * 水印在输出时的X偏移。单位为像素值。 */ LocationX: number; /** * 水印在输出时的Y偏移。单位为像素值。 */ LocationY: number; /** * 水印在输出时的层级,不填默认为0。 */ ZOrder?: number; /** * 动态水印类型,默认为0。0:关闭;1:随机位置,每秒变动一次;2:边界扫描反弹,每帧变动一次。 */ DynamicPosType?: number; } /** * StartPublishCdnStream返回参数结构体 */ export interface StartPublishCdnStreamResponse { /** * 用于唯一标识转推任务,由腾讯云服务端生成,后续更新和停止请求都需要携带TaskiD参数。 */ TaskId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 实时音视频用量在某一时间段的统计信息。 */ export interface TrtcUsage { /** * 时间点,格式为YYYY-MM-DD HH:mm:ss。多天查询时,HH:mm:ss为00:00:00。 */ TimeKey?: string; /** * 时间点时间戳 */ TimeStampKey?: number; /** * 用量数组。每个数值含义与UsageKey对应。单位:分钟。 */ UsageValue?: Array<number>; } /** * DescribeTRTCMarketScaleMetricData请求参数结构体 */ export interface DescribeTRTCMarketScaleMetricDataRequest { /** * 用户SdkAppId */ SdkAppId: string; /** * 查询开始时间,格式为YYYY-MM-DD。(查询时间范围根据监控仪表盘功能版本而定,【基础版】可查近30天,【进阶版】可查近60天) */ StartTime: string; /** * 查询结束时间,格式为YYYY-MM-DD。 */ EndTime: string; /** * 返回数据的粒度,支持设为以下值: d:按天。此时返回查询时间范围内 UTC 时间为零点的数据。 h:按小时。此时返回查询时间范围内 UTC 时间为整小时的数据。 */ Period: string; } /** * DescribeRelayUsage返回参数结构体 */ export interface DescribeRelayUsageResponse { /** * 用量类型,与UsageValue中各个位置的值对应。 */ UsageKey?: Array<string>; /** * 各个时间点用量明细。 */ UsageList?: Array<TrtcUsage>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * StartStreamIngest请求参数结构体 */ export interface StartStreamIngestRequest { /** * TRTC的[SdkAppId](https://cloud.tencent.com/document/product/647/46351#sdkappid),和TRTC的房间所对应的SdkAppId相同。 */ SdkAppId: number; /** * TRTC的[RoomId](https://cloud.tencent.com/document/product/647/46351#roomid),录制的TRTC房间所对应的RoomId。 */ RoomId: string; /** * TRTC房间号的类型。 【*注意】必须和录制的房间所对应的RoomId类型相同: 0: 字符串类型的RoomId 1: 32位整型的RoomId(默认) */ RoomIdType: number; /** * 输入在线媒体流机器人的UserId,用于进房发起拉流转推任务。 */ UserId: string; /** * 输入在线媒体流机器人UserId对应的校验签名,即UserId和UserSig相当于机器人进房的登录密码,具体计算方法请参考TRTC计算[UserSig](https://cloud.tencent.com/document/product/647/45910#UserSig)的方案。 */ UserSig: string; /** * 源流URL【必填】。如果是视频流,分辨率请保持不变。 */ StreamUrl?: string; /** * TRTC房间权限加密串,只有在TRTC控制台启用了高级权限控制的时候需要携带,在TRTC控制台如果开启高级权限控制后,TRTC 的后台服务系统会校验一个叫做 [PrivateMapKey] 的“权限票据”,权限票据中包含了一个加密后的 RoomId 和一个加密后的“权限位列表”。由于 PrivateMapKey 中包含 RoomId,所以只提供了 UserSig 没有提供 PrivateMapKey 时,并不能进入指定的房间。 */ PrivateMapKey?: string; /** * 【本字段已废弃】视频编码参数。可选,如果不填,保持原始流的参数。 * @deprecated */ VideoEncodeParams?: VideoEncodeParams; /** * 【本字段已废弃】音频编码参数。可选,如果不填,保持原始流的参数。 * @deprecated */ AudioEncodeParams?: AudioEncodeParams; /** * 【本字段已废弃,请使用 StreamUrl 字段】源流URL,支持一个地址。 * @deprecated */ SourceUrl?: Array<string>; /** * 指定视频从某个秒时间戳播放 */ SeekSecond?: number; /** * 开启自动旁路推流,请确认控制台已经开启该功能。 */ AutoPush?: boolean; /** * 循环播放次数, 取值范围[-1, 1000], 默认1次。 - 0 无效值 - -1 循环播放, 需要主动调用停止接口或设置MaxDuration */ RepeatNum?: number; /** * 循环播放最大时长,仅支持RepeatNum设置-1时生效,取值范围[1, 10080],单位分钟。 */ MaxDuration?: number; /** * 音量,取值范围[0, 100],默认100,表示原音量。 */ Volume?: number; } /** * DescribeRecordingUsage返回参数结构体 */ export interface DescribeRecordingUsageResponse { /** * 用量类型,与UsageValue中各个位置的值对应。 */ UsageKey?: Array<string>; /** * 各个时间点用量明细。 */ UsageList?: Array<TrtcUsage>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * StopMCUMixTranscode请求参数结构体 */ export interface StopMCUMixTranscodeRequest { /** * TRTC的SDKAppId。 */ SdkAppId: number; /** * 房间号。 */ RoomId: number; } /** * ModifyPicture返回参数结构体 */ export interface ModifyPictureResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ 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; } /** * 云端录制查询接口,录制文件的信息 */ export interface StorageFile { /** * 录制文件对应的UserId,如果是混流的话的这里返回的是空串。 注意:此字段可能返回 null,表示取不到有效值。 */ UserId?: string; /** * 录制索引文件名。 */ FileName?: string; /** * 录制文件流信息。 video:视频录制文件 audio:音频录制文件 audio_video:音视频录制文件 注意:此字段可能返回 null,表示取不到有效值。 */ TrackType?: string; /** * 录制文件开始Unix时间戳。 */ BeginTimeStamp?: number; } /** * 水印布局参数 */ export interface WaterMark { /** * 水印类型,0为图片(默认),1为文字,2为时间戳。 */ WaterMarkType?: number; /** * 水印为图片时的参数列表,水印为图片时校验必填。 */ WaterMarkImage?: WaterMarkImage; /** * 水印为文字时的参数列表,水印为文字时校验必填。 */ WaterMarkChar?: WaterMarkChar; /** * 水印为时间戳时的参数列表,水印为时间戳时校验必填。 */ WaterMarkTimestamp?: WaterMarkTimestamp; } /** * Mcu转推录制,第三方存储参数。 */ export interface McuStorageParams { /** * 第三方云存储的账号信息(特别说明:若您选择存储至对象存储COS将会收取录制文件投递至COS的费用,详见云端录制收费说明,存储至VOD将不收取此项费用。)。 */ CloudStorage?: CloudStorage; /** * 腾讯云云点播的账号信息。 */ McuCloudVod?: McuCloudVod; } /** * DescribeScaleInfo返回参数结构体 */ export interface DescribeScaleInfoResponse { /** * 返回的数据条数 */ Total?: number; /** * 返回的数据 */ ScaleList?: Array<ScaleInfomation>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 录制的混流布局参数。 */ export interface MixLayoutParams { /** * 布局模式: 1:悬浮布局; 2:屏幕分享布局; 3:九宫格布局; 4:自定义布局; 悬浮布局:默认第一个进入房间的主播(也可以指定一个主播)的视频画面会铺满整个屏幕。其他主播的视频画面从左下角开始依次按照进房顺序水平排列,显示为小画面,小画面悬浮于大画面之上。当画面数量小于等于17个时,每行4个(4 x 4排列)。当画面数量大于17个时,重新布局小画面为每行5个(5 x 5)排列。最多支持25个画面,如果用户只发送音频,仍然会占用画面位置。 屏幕分享布局:指定一个主播在屏幕左侧的大画面位置(如果不指定,那么大画面位置为背景色),其他主播自上而下依次垂直排列于右侧。当画面数量少于17个的时候,右侧每列最多8人,最多占据两列。当画面数量多于17个的时候,超过17个画面的主播从左下角开始依次水平排列。最多支持25个画面,如果主播只发送音频,仍然会占用画面位置。 九宫格布局:根据主播的数量自动调整每个画面的大小,每个主播的画面大小一致,最多支持25个画面。 自定义布局:根据需要在MixLayoutList内定制每个主播画面的布局。 */ MixLayoutMode: number; /** * 如果MixLayoutMode 选择为4自定义布局模式的话,设置此参数为每个主播所对应的布局画面的详细信息,最大不超过25个。 */ MixLayoutList?: Array<MixLayout>; /** * 录制背景颜色,RGB的颜色表的16进制表示,每个颜色通过8bit长度标识,默认为黑色。比如橙色对应的RGB为 R: