nertc-electron-sdk
Version:
nertc-electron-sdk
1,102 lines (1,000 loc) • 67.5 kB
text/typescript
import { type } from "os";
export interface RendererOptions
{
append: boolean
}
/** 日志级别。*/
export enum NERtcLogLevel{
kNERtcLogLevelFatal = 0, /**< Fatal 级别日志信息。 */
kNERtcLogLevelError = 1, /**< Error 级别日志信息。 */
kNERtcLogLevelWarning = 2, /**< Warning 级别日志信息。 */
kNERtcLogLevelInfo = 3, /**< Info 级别日志信息。默认级别 */
kNERtcLogLevelDetailInfo = 4, /**< Detail Info 级别日志信息。 */
kNERtcLogLevelVerbos = 5, /**< Verbos 级别日志信息。 */
kNERtcLogLevelDebug = 6, /**< Debug 级别日志信息。如果你想获取最完整的日志，可以将日志级别设为该等级。*/
kNERtcLogLevelOff = 7, /**< 不输出日志信息。*/
}
export interface NERtcJoinChannelOptions {
custom_info: string; /**< 自定义信息，最长支持 127 个字符。 <127chars */
permission_key: string; /**< 权限密钥。能控制通话时长及媒体权限能力。*/
}
/** 范围语音模式。*/
export enum NERtcRangeAudioMode{
NERtcRangeAudioModeDefault = 0, /**< 默认模式。设置后玩家附近一定范围的人都能听到该玩家讲话，如果范围内也有玩家设置为此模式，则也可以互相通话。 */
NERtcRangeAudioModeTeam = 1, /**< 小组模式。仅TeamID相同的队友可以互相听到 */
}
export interface NERtcJoinChannelOptionsEx {
custom_info: string; /**< 自定义信息，最长支持 127 个字符。 <127chars */
permission_key: string; /**< 权限密钥。能控制通话时长及媒体权限能力。*/
team_id: number; /**< 小队号。*/
mode: NERtcRangeAudioMode; /**< 语音模式。 */
audible_distance: number; /**< 语音接收范围。*/
}
/** 音频帧请求格式。*/
export interface NERtcAudioFrameRequestFormat {
channels: number; /**< 音频声道数量。如果是立体声，数据是交叉的。单声道: 1；双声道 : 2。*/
sample_rate: number; /**< 采样率。*/
mode: NERtcRawAudioFrameOpModeType;/**< 读写模式*/
}
/** 私有化服务器配置项 */
export interface NERtcServerAddresses {
channel_server: string; /**< 获取通道信息服务器, <256chars */
statistics_server: string; /**< 统计上报服务器, <256chars */
room_server: string; /**< roomServer服务器, <256chars */
compat_server: string; /**< 兼容性配置服务器, <256chars */
nos_lbs_server: string; /**< nos 域名解析服务器, <256chars */
nos_upload_sever: string; /**< 默认nos 上传服务器, <256chars */
nos_token_server: string; /**< 获取NOS token 服务器, <256chars */
use_ipv6: Boolean; /**< 是否使用IPv6（默认false) */
}
export interface NERtcEngineContext {
app_key: string; /**< 用户注册云信的APP Key。如果你的开发包里面缺少 APP Key，请申请注册一个新的 APP Key。*/
log_dir_path: string; /**< 日志目录的完整路径，采用UTF-8 编码。*/
log_level: NERtcLogLevel; /**< 日志级别，默认级别为 kNERtcLogLevelInfo。*/
log_file_max_size_KBytes: number; /**< 指定 SDK 输出日志文件的大小上限，单位为 KB。如果设置为 0，则默认为 20 M。*/
server_config: NERtcServerAddresses; /**< 私有化服务器地址 */
}
/** 场景模式 */
export enum NERtcChannelProfileType
{
kNERtcChannelProfileCommunication = 0, /**< 通话场景 */
kNERtcChannelProfileLiveBroadcasting = 1, /**< 直播推流场景 */
}
/** 视频流类型。*/
export enum NERtcRemoteVideoStreamType{
kNERtcRemoteVideoStreamTypeHigh = 0, /**< 默认大流 */
kNERtcRemoteVideoStreamTypeLow = 1, /**< 小流 */
kNERtcRemoteVideoStreamTypeNone = 2, /**< 不订阅 */
}
/** 错误代码。
错误代码意味着 SDK 遇到不可恢复的错误，需要应用程序干预。
*/
export enum NERtcErrorCode
{
kNERtcNoError = 0, /**< 没有错误 */
//资源分配错误 （正常请求时不会有此类错误返回）
kNERtcErrChannelReservePermissionDenied = 403, /**< 没有权限，包括没有开通音视频功能、没有开通非安全但是请求了非安全等 */
kNERtcErrChannelReserveTimeOut = 408, /**< 请求超时 */
kNERtcErrChannelReserveErrorParam = 414, /**< 服务器请求参数错误 */
kNERtcErrChannelReserveServerFail = 500, /**< 分配频道服务器未知错误 */
kNERtcErrChannelReserveMoreThanTwoUser = 600, /**< 只支持两个用户, 有第三个人试图使用相同的频道名分配频道 */
//livestream task
kNERtcErrLsTaskRequestInvalid = 1301, /**< task请求无效，被后续操作覆盖 */
kNERtcErrLsTaskIsInvaild = 1400, /**< task参数格式错误 */
kNERtcErrLsTaskRoomExited = 1401, /**< 房间已经退出 */
kNERtcErrLsTaskNumLimit = 1402, /**< 推流任务超出上限 */
kNERtcErrLsTaskDuplicateId = 1403, /**< 推流ID重复 */
kNERtcErrLsTaskNotFound = 1404, /**< taskId任务不存在，或频道不存在 */
kNERtcErrLsTaskRequestErr = 1417, /**< 请求失败 */
kNERtcErrLsTaskInternalServerErr = 1500, /**< 服务器内部错误 */
kNERtcErrLsTaskInvalidLayout = 1501, /**< 布局参数错误 */
kNERtcErrLsTaskUserPicErr = 1512, /**< 用户图片错误 */
//其他错误
kNERtcErrChannelStartFail = 11000, /**< 通道发起失败 */
kNERtcErrChannelDisconnected = 11001, /**< 断开连接 */
kNERtcErrVersionSelfLow = 11002, /**< 本人SDK版本太低不兼容 */
kNERtcErrVersionRemoteLow = 11003, /**< 对方SDK版本太低不兼容 */
kNERtcErrChannelClosed = 11004, /**< 通道被关闭 */
kNERtcErrChannelKicked = 11005, /**< 账号被踢 */
kNERtcErrDataError = 11400, /**< 数据错误 */
kNERtcErrInvalid = 11403, /**< 无效的操作 */
//连接服务器错误
kNERtcErrChannelJoinTimeOut = 20101, /**< 请求超时 */
kNERtcErrChannelJoinMeetingModeError = 20102, /**< 会议模式错误 */
kNERtcErrChannelJoinRtmpModeError = 20103, /**< rtmp用户加入非rtmp频道 */
kNERtcErrChannelJoinRtmpNodesError = 20104, /**< 超过频道最多rtmp人数限制 */
kNERtcErrChannelJoinRtmpHostError = 20105, /**< 已经存在一个主播 */
kNERtcErrChannelJoinRtmpCreateError = 20106, /**< 需要旁路直播, 但频道创建者非主播 */
kNERtcErrChannelJoinLayoutError = 20208, /**< 主播自定义布局错误 */
kNERtcErrChannelJoinInvalidParam = 20400, /**< 错误参数 */
kNERtcErrChannelJoinDesKey = 20401, /**< 密码加密错误 */
kNERtcErrChannelJoinInvalidRequst = 20417, /**< 错误请求 */
kNERtcErrChannelServerUnknown = 20500, /**< 服务器内部错误 */
//Engine error code
kNERtcErrFatal = 30001, /**< 通用错误 */
kNERtcErrOutOfMemory = 30002, /**< 内存耗尽 */
kNERtcErrInvalidParam = 30003, /**< 错误的参数 */
kNERtcErrNotSupported = 30004, /**< 不支持的操作 */
kNERtcErrInvalidState = 30005, /**< 当前状态不支持的操作 */
kNERtcErrLackOfResource = 30006, /**< 资源耗尽 */
kNERtcErrInvalidIndex = 30007, /**< 非法 index */
kNERtcErrDeviceNotFound = 30008, /**< 设备未找到 */
kNERtcErrInvalidDeviceSourceID = 30009,/**< 非法设备 ID */
kNERtcErrInvalidVideoProfile = 30010, /**< 非法的视频 profile type */
kNERtcErrCreateDeviceSourceFail = 30011, /**< 设备创建错误 */
kNERtcErrInvalidRender = 30012, /**< 非法的渲染容器 */
kNERtcErrDevicePreviewAlreadyStarted = 30013,/**< 设备已经打开 */
kNERtcErrTransmitPendding = 30014, /**< 传输错误 */
kNERtcErrConnectFail = 30015, /**< 连接服务器错误 */
kNERtcErrCreateDumpFileFail = 30016, /**< 创建Audio dump文件失败 */
kNERtcErrStartDumpFail = 30017, /**< 开启Audio dump失败 */
kNERtcErrDesktopCaptureInvalidState = 30020, /**< 启动桌面录屏失败，不能与camera同时启动 */
kNERtcErrDesktopCaptureInvalidParam = 30021, /**< 桌面录屏传入参数无效 */
kNERtcErrDesktopCaptureNotReady = 30022, /**< 桌面录屏未就绪 */
kNERtcErrChannelAlreadyJoined = 30100, /**< 重复加入频道 */
kNERtcErrChannelNotJoined = 30101, /**< 尚未加入频道 */
kNERtcErrChannelRepleatedlyLeave = 30102, /**< 重复离开频道 */
kNERtcErrRequestJoinChannelFail = 30103, /**< 加入频道操作失败 */
kNERtcErrSessionNotFound = 30104, /**< 会话未找到 */
kNERtcErrUserNotFound = 30105, /**< 用户未找到 */
kNERtcErrInvalidUserID = 30106, /**< 非法的用户 ID */
kNERtcErrMediaNotStarted = 30107, /**< 用户多媒体数据未连接 */
kNERtcErrSourceNotFound = 30108, /**< source 未找到 */
kNERtcErrConnectionNotFound = 30200, /**< 连接未找到 */
kNERtcErrStreamNotFound = 30201, /**< 媒体流未找到 */
kNERtcErrAddTrackFail = 30202, /**< 加入 track 失败 */
kNERtcErrTrackNotFound = 30203, /**< track 未找到 */
kNERtcErrMediaConnectionDisconnected = 30204, /**< 媒体连接断开 */
kNERtcErrSignalDisconnected = 30205, /**< 信令连接断开 */
kNERtcErrServerKicked = 30206, /**< 被踢出频道 */
kNERtcErrKickedForRoomClosed = 30207, /**< 因频道已关闭而被踢出 */
kNERtcRuntimeErrADMNoAuthorize = 40000, /**< 没有音频设备权限 */
kNERtcRuntimeErrVDMNoAuthorize = 50000, /**< 没有视频设备权限 */
kNERtcRuntimeErrScreenCaptureNoAuthorize = 60000, /**< 没有录制视频权限 */
}
/** 用户离开原因。*/
export enum NERtcSessionLeaveReason
{
kNERtcSessionLeaveNormal = 0, /**< 正常离开。*/
kNERtcSessionLeaveForFailOver = 1, /**< 用户断线导致离开。*/
kNERtcSessionLeaveUpdate = 2, /**< 用户 Failover 过程中产生的 leave。*/
kNERtcSessionLeaveForKick = 3, /**< 用户被踢导致离开。*/
kNERtcSessionLeaveTimeOut = 4, /**< 用户超时导致离开。*/
}
/** 视频编码配置。用于衡量编码质量。*/
export enum NERtcVideoProfileType
{
kNERtcVideoProfileLowest = 0, /**< 160x90/120, 15fps */
kNERtcVideoProfileLow = 1, /**< 320x180/240, 15fps */
kNERtcVideoProfileStandard = 2, /**< 640x360/480, 30fps */
kNERtcVideoProfileHD720P = 3, /**< 1280x720, 30fps */
kNERtcVideoProfileHD1080P = 4, /**< 1920x1080, 30fps */
kNERtcVideoProfileNone = 5,
kNERtcVideoProfileMAX = kNERtcVideoProfileHD1080P,
kNERtcVideoProfileFake = 6, /**< FakeVideo标识，仅在回调中显示。请勿主动设置，否则 SDK 会按照STANDARD处理。 当远端在纯音频状态发送 SEI 时，本端将会收到远端的onUserVideoStart回调，其中 max_profile 参数为kNERtcVideoProfileFake ， 表示对端发送 16*16 的FakeVideo，此时如果本端需要接收远端的SEI信息，只需要订阅一下远端的视频即可，无须设置远端画布。*/
}
export enum NERtcVideoScalingMode {
kNERtcVideoScaleFit = 0, /**< 0: 视频尺寸等比缩放。优先保证视频内容全部显示。因视频尺寸与显示视窗尺寸不一致造成的视窗未被填满的区域填充黑色。*/
kNERtcVideoScaleFullFill = 1, /**< 1: 视频尺寸非等比缩放。保证视频内容全部显示，且填满视窗。*/
kNERtcVideoScaleCropFill = 2, /**< 2: 视频尺寸等比缩放。优先保证视窗被填满。因视频尺寸与显示视窗尺寸不一致而多出的视频将被截掉。*/
}
/** @enum NERtcVideoMirrorMode 设置镜像模式。*/
export enum NERtcVideoMirrorMode
{
kNERtcVideoMirrorModeAuto = 0, /**< 0: Windows/macOS SDK 启用镜像模式。在 iOS/Android 平台中：如果你使用前置摄像头，SDK 默认启用镜像模式；如果你使用后置摄像头，SDK 默认关闭镜像模式。*/
kNERtcVideoMirrorModeEnabled = 1, /**< 1: 启用镜像模式。*/
kNERtcVideoMirrorModeDisabled = 2, /**< 2: （默认）关闭镜像模式。*/
}
/** @enum NERtcVideoOutputOrientationMode 设置镜像模式。*/
export enum NERtcVideoOutputOrientationMode
{
kNERtcVideoOutputOrientationModeAdaptative = 0, /**< 0: （默认）该模式下 SDK 输出的视频方向与采集到的视频方向一致。接收端会根据收到的视频旋转信息对视频进行旋转。*/
kNERtcVideoOutputOrientationModeFixedLandscape = 1, /**< 1:该模式下 SDK 固定输出横屏模式的视频。如果采集到的视频是竖屏模式，则视频编码器会对其进行裁剪。*/
kNERtcVideoOutputOrientationModeFixedPortrait = 2, /**< 2: 该模式下 SDK 固定输出竖屏模式的视频，如果采集到的视频是横屏模式，则视频编码器会对其进行裁剪。*/
}
/** @enum NERtcRawAudioFrameOpModeType 读写模式*/
export enum NERtcRawAudioFrameOpModeType
{
kNERtcRawAudioFrameOpModeReadOnly = 0, /**< 0: 返回数据只读模式。*/
kNERtcRawAudioFrameOpModeReadWrite = 1, /**< 1:返回数据可读写。*/
}
export interface NERtcVideoCanvas {
mode: NERtcVideoScalingMode;
view: Element;
}
export enum NERtcAudioProfileType {
kNERtcAudioProfileDefault = 0, /**< 0: 默认设置。Speech场景下为 kNERtcAudioProfileStandardExtend，Music场景下为 kNERtcAudioProfileHighQuality */
kNERtcAudioProfileStandard = 1, /**< 1: 普通质量的音频编码，16000Hz，20Kbps */
kNERtcAudioProfileStandardExtend = 2, /**< 2: 普通质量的音频编码，16000Hz，32Kbps */
kNERtcAudioProfileMiddleQuality = 3, /**< 3: 中等质量的音频编码，48000Hz，32Kbps */
kNERtcAudioProfileMiddleQualityStereo = 4, /**< 4: 中等质量的立体声编码，48000Hz * 2，64Kbps */
kNERtcAudioProfileHighQuality = 5, /**< 5: 高质量的音频编码，48000Hz，64Kbps */
kNERtcAudioProfileHighQualityStereo = 6, /**< 6: 高质量的立体声编码，48000Hz * 2，128Kbps */
}
export enum NERtcAudioScenarioType {
kNERtcAudioScenarioDefault = 0, /** 0: 默认设置:kNERtcChannelProfileCommunication下为kNERtcAudioScenarioSpeech，kNERtcChannelProfileLiveBroadcasting下为kNERtcAudioScenarioMusic。 */
kNERtcAudioScenarioSpeech = 1, /** 1: 语音场景. NERtcAudioProfileType 推荐使用 kNERtcAudioProfileMiddleQuality 及以下 */
kNERtcAudioScenarioMusic = 2, /** 2: 音乐场景。NERtcAudioProfileType 推荐使用 kNERtcAudioProfileMiddleQualityStereo 及以上 */
}
/** @enum NERtcVideoCropMode 视频画面裁剪模式。*/
export enum NERtcVideoCropMode {
kNERtcVideoCropModeDefault = 0, /**< Device Defalut */
kNERtcVideoCropMode16x9 = 1, /**< 16:9 */
kNERtcVideoCropMode4x3 = 2, /**< 4:3 */
kNERtcVideoCropMode1x1 = 3, /**< 1:1 */
}
/** @enum NERtcVideoFramerateType 视频帧率。*/
export enum NERtcVideoFramerateType {
kNERtcVideoFramerateFpsDefault = 0, /**< 默认帧率 */
kNERtcVideoFramerateFps_7 = 7, /**< 7帧每秒 */
kNERtcVideoFramerateFps_10 = 10, /**< 10帧每秒 */
kNERtcVideoFramerateFps_15 = 15, /**< 15帧每秒 */
kNERtcVideoFramerateFps_24 = 24, /**< 24帧每秒 */
kNERtcVideoFramerateFps_30 = 30, /**< 30帧每秒 */
kNERtcVideoFramerateFps_60 = 60, /**< 60帧每秒 */
}
/** @enum NERtcDegradationPreference 视频编码策略。*/
export enum NERtcDegradationPreference {
kNERtcDegradationDefault = 0, /**< 使用引擎推荐值。通话场景使用平衡模式，直播推流场景使用清晰优先 */
kNERtcDegradationMaintainFramerate = 1, /**< 帧率优先 */
kNERtcDegradationMaintainQuality = 2, /**< 清晰度优先 */
kNERtcDegradationBalanced = 3, /**< 平衡模式 */
}
/** @enum NERtcAudioStreamType 伴音跟随音频主流还是辅流，默认跟随主流。*/
export enum NERtcAudioStreamType {
kNERtcAudioStreamTypeMain = 0, /**< 主流 */
kNERtcAudioStreamTypeSub = 1, /**< 辅流 */
}
/** @enum NERtcDistanceRolloffModel 空间音效衰减模式 */
export enum NERtcDistanceRolloffModel {
kNERtcDistanceRolloffLogarithmic = 0, /**< 指数模式 */
kNERtcDistanceRolloffLinear = 1, /**< 线性模式 */
kNERtcDistanceRolloffNone = 2,/**< 无衰减 */
}
/** 视频配置的属性。*/
export interface NERtcVideoConfig {
max_profile: NERtcVideoProfileType; /**< 视频编码的分辨率，用于衡量编码质量。*/
width: number; /**< 视频编码自定义分辨率之宽度。width为0表示使用max_profile*/
height: number; /**< 视频编码自定义分辨率之高度。height为0表示使用max_profile*/
crop_mode: NERtcVideoCropMode; /**< 视频画面裁剪模式，默认kNERtcVideoCropModeDefault。*/
framerate: NERtcVideoFramerateType; /**< 视频帧率 */
min_framerate: NERtcVideoFramerateType; /**< 视频最小帧率 */
bitrate: number; /**< 视频编码码率kbps，取0时使用默认值 */
min_bitrate: number; /**< 视频编码码率下限kbps，取0时使用默认值 */
degradation_preference: NERtcDegradationPreference; /**< 编码策略 */
mirror_mode: NERtcVideoMirrorMode; /**< 设置本地视频编码的镜像模式，即本地发送视频的镜像模式，只影响远端用户看到的视频画面。 */
orientation_mode: NERtcVideoOutputOrientationMode; /**< 设置本地视频编码的方向模式，即本地发送视频的方向模式，同时影响本端用户的预览画面和远端用户看到的视频画面。*/
}
/** 创建混音的配置项 */
export interface NERtcCreateAudioMixingOption {
path: String; /**< 本地文件全路径或URL < 256 chars */
loop_count: number; /**< 循环次数， <= 0, 表示无限循环，默认 1 */
send_enabled: boolean; /**< 是否可发送，默认为 true */
send_volume: number; /**< 发送音量。最大为 100（默认）含义（0%-100%）*/
playback_enabled: boolean; /**< 是否可回放，默认为 true */
playback_volume: number; /**< 回放音量。最大为 100（默认）*/
start_timestamp: number; /**< 音乐文件开始播放的时间，UTC 时间戳，即从1970 年 1 月 1 日 0 点 0 分 0 秒开始到事件发生时的毫秒数。默认值为 0，表示立即播放。*/
send_with_audio_type: NERtcAudioStreamType; /**< 伴音跟随音频主流还是辅流，默认跟随主流。*/
progress_interval: number; /**< 伴音播放进度回调间隔，单位ms，取值范围为 100~10000, 默认1000ms*/
}
/** 创建音效的配置项 */
export interface NERtcCreateAudioEffectOption {
path: String; /**< 本地文件全路径或URL < 256 chars */
loop_count: number; /**< 循环次数， <= 0, 表示无限循环，默认 1 */
send_enabled: boolean; /**< 是否可发送，默认为 true */
send_volume: number; /**< 发送音量。最大为 100（默认）含义（0%-100%）*/
playback_enabled: boolean; /**< 是否可回放，默认为 true */
playback_volume: number; /**< 回放音量。最大为 100（默认）*/
start_timestamp: number; /**< 音乐文件开始播放的时间，UTC 时间戳，即从1970 年 1 月 1 日 0 点 0 分 0 秒开始到事件发生时的毫秒数。默认值为 0，表示立即播放。*/
send_with_audio_type: NERtcAudioStreamType; /**< 伴音跟随音频主流还是辅流，默认跟随主流。*/
progress_interval: number; /**< 伴音播放进度回调间隔，单位ms，取值范围为 100~10000, 默认1000ms*/
}
/** 待共享区域相对于整个屏幕或窗口的位置，如不填，则表示共享整个屏幕或窗口。*/
export interface NERtcRectangle {
x: number; /**< 左上角的横向偏移。*/
y: number; /**< 左上角的纵向偏移。*/
width: number; /**< 待共享区域的宽。*/
height: number; /**< 待共享区域的高。*/
}
/** 屏幕共享编码参数配置。*/
export enum NERtcScreenProfileType
{
kNERtcScreenProfile480P = 0, /**< 640x480, 5fps */
kNERtcScreenProfileHD720P = 1, /**< 1280x720, 5fps */
kNERtcScreenProfileHD1080P = 2, /**< 1920x1080, 5fps。默认 */
kNERtcScreenProfileCustom = 3, /**< 自定义 */
kNERtcScreenProfileNone = 4,
kNERtcScreenProfileMAX = kNERtcScreenProfileHD1080P,
}
/** 视频尺寸。*/
export interface NERtcVideoDimensions
{
width: number; /**< 宽度 */
height: number; /**< 高度 */
}
/** 屏幕共享功能的编码策略倾向
- kNERtcSubStreamContentPreferMotion: 内容类型为动画;当共享的内容是视频、电影或游戏时，推荐选择该内容类型
当用户设置内容类型为动画时，按用户设置的帧率处理
- kNERtcSubStreamContentPreferDetails: 内容类型为细节;当共享的内容是图片或文字时，推荐选择该内容类型
当用户设置内容类型为细节时，最高允许用户设置到 10 帧，设置超过 10 帧时，不生效，按 10 帧处理
*/
export enum NERtcSubStreamContentPrefer
{
kNERtcSubStreamContentPreferMotion = 0, /**< 动画模式。*/
kNERtcSubStreamContentPreferDetails = 1, /**< 细节模式。*/
}
/** 屏幕共享编码参数配置。用于衡量编码质量。一期只支持profile设置。*/
export interface NERtcScreenCaptureParameters {
profile: NERtcScreenProfileType; /**< 屏幕共享编码参数配置。*/
dimensions: NERtcVideoDimensions; /**< 屏幕共享视频发送的最大像素值，kNERtcScreenProfileCustom下生效。*/
frame_rate: number; /**< 共享视频的帧率，kNERtcScreenProfileCustom下生效，单位为 fps；默认值为 5，建议不要超过 15。*/
bitrate: number; /**< 共享视频的码率，单位为 bps；默认值为 0，表示 SDK 根据当前共享屏幕的分辨率计算出一个合理的值。*/
capture_mouse_cursor: boolean; /**< 是否采集鼠标用于屏幕共享。*/
window_focus: boolean; /**< 调用 startScreenCaptureByWindowId 方法共享窗口时，是否将该窗口前置。*/
excluded_window_list: Array<Number>; /**< 待屏蔽窗口的 ID 列表。 */
excluded_window_count: number; /**< 待屏蔽窗口的数量。*/
prefer: NERtcSubStreamContentPrefer; /**< 编码策略倾向。*/
}
/** 媒体优先级类型。*/
export enum NERtcMediaPriorityType
{
kNERtcMediaPriorityHigh = 50, /**< 高优先级 */
kNERtcMediaPriorityNormal = 100, /**< （默认）普通优先级 */
}
export interface NERtcScreenCaptureWindowParam
{
window_list: Array<Number>; /**< 待屏蔽窗口的 ID 列表。 */
}
/** 录音音质 */
export enum NERtcAudioRecordingQuality
{
kNERtcAudioRecordingQualityLow = 0, /**< 低音质 */
kNERtcAudioRecordingQualityMedium = 1, /**< 中音质 */
kNERtcAudioRecordingQualityHigh = 2, /**< 高音质 */
}
/** Data structure related to media stream relay.*/
export interface NERtcChannelMediaRelayInfo
{
channel_name: String; /**< The name of the destination room to which the media stream is relayed. */
channel_token: String; /**< The token used to connect to the destination room. */
uid: number; /**< The user ID used in the destination room. This ID can be different from the ID used in the current room. */
}
/** Configurations for media stream relay.*/
export interface NERtcChannelMediaRelayConfiguration
{
src_infos: NERtcChannelMediaRelayInfo; /**<The information about the current room. */
dest_infos: NERtcChannelMediaRelayInfo; /**< The configuration of the destination room. */
dest_count: number; /**< The number of destination rooms. The default value is 0. */
}
/** Media stream encryption mode. */
export enum NERtcEncryptionMode
{
kNERtcGMCryptoSM4ECB = 0, /**< 128-bit SM4 encryption, ECB mode. */
kNERtcEncryptionModeCustom = 1, /**< custom encryption. >*/
}
/** Media stream encryption scheme. */
export interface NERtcEncryptionConfig
{
mode: NERtcEncryptionMode; /**< Media stream encryption mode. For more information, see NERtcEncryptionMode. */
key: String; /**< Media stream encryption key. The key is of string type. We recommend that you set the key to a string that contains only letters. */
}
/** 直播推流模式 */
export enum NERtcLiveStreamMode
{
kNERtcLsModeVideo = 0, /**< 推流带视频 */
kNERtcLsModeAudio = 1, /**< 推流纯音频 */
}
/** 直播推流视频裁剪模式 */
export enum NERtcLiveStreamVideoScaleMode
{
kNERtcLsModeVideoScaleFit = 0, /**< 0: 视频尺寸等比缩放。优先保证视频内容全部显示。因视频尺寸与显示视窗尺寸不一致造成的视窗未被填满的区域填充背景色。*/
kNERtcLsModeVideoScaleCropFill = 1, /**< 1: 视频尺寸等比缩放。优先保证视窗被填满。因视频尺寸与显示视窗尺寸不一致而多出的视频将被截掉。*/
}
/** 直播推流音频采样率 */
export enum NERtcLiveStreamAudioSampleRate
{
kNERtcLiveStreamAudioSampleRate32000 = 32000, /**< 采样率为 32 kHz。*/
kNERtcLiveStreamAudioSampleRate44100 = 44100, /**< 采样率为 44.1 kHz。*/
kNERtcLiveStreamAudioSampleRate48000 = 48000 /**< （默认）采样率为 48 kHz。*/
}
/** 直播推流音频编码规格 */
export enum NERtcLiveStreamAudioCodecProfile
{
kNERtcLiveStreamAudioCodecProfileLCAAC = 0, /**< （默认）LC-AAC 规格，表示基本音频编码规格。*/
kNERtcLiveStreamAudioCodecProfileHEAAC = 1 /**< HE-AAC 规格，表示高效音频编码规格。*/
}
/** 直播成员布局 */
export interface NERtcLiveStreamUserTranscoding {
uid: number; /**< 用户id */
video_push: boolean; /**< 是否推送该用户视频流，kNERtcLsModeAudio时无效 */
adaption: NERtcLiveStreamVideoScaleMode; /**< 视频流裁剪模式 */
x: number; /**< 画面离主画面左边距 */
y: number; /**< 画面离主画面上边距 */
width: number; /**< 画面在主画面的显示宽度，画面右边超出主画面会失败 */
height: number; /**< 画面在主画面的显示高度，画面底边超出主画面会失败 */
audio_push: boolean; /**< 是否推送该用户音频流 */
}
/** 图片布局 */
export interface NERtcLiveStreamImageInfo {
url: String; /**< 图片地址 */
x: number; /**< 画面离主画面左边距 */
y: number; /**< 画面离主画面上边距 */
width: number; /**< 画面在主画面的显示宽度，画面右边超出主画面会失败 */
height: number; /**< 画面在主画面的显示高度，画面底边超出主画面会失败 */
}
/** 直播布局 */
export interface NERtcLiveStreamLayout {
width: number; /**< 视频推流宽度 */
height: number; /**< 视频推流高度 */
background_color: number; /**< 视频推流背景色，(R & 0xff) << 16 | (G & 0xff) << 8 | (B & 0xff) */
user_count: number; /**< 成员布局个数 */
users: Array<NERtcLiveStreamUserTranscoding>; /**< 成员布局数组 */
bg_image: NERtcLiveStreamImageInfo; /**< 背景图信息 */
}
export interface NERtcLiveConfig {
single_video_passthrough: boolean; /**< 单路视频透传开关，默认为关闭状态，开启后，如果房间中只有一路视频流输入， 则不对输入视频流进行转码，不遵循转码布局，直接推流 CDN，如果有多个房间成员视频流混合为一路流，则该设置失效，并在恢复为一个成员画面（单路流）时也不会恢复。*/
audio_bitrate: number; /**< 音频推流码率，单位为 kbps，取值范围为 10~192，语音场景建议设置为 64 及以上码率，音乐场景建议设置为 128 及以上码率。 */
sample_rate: NERtcLiveStreamAudioSampleRate; /**< 音频推流采样率。单位为Hz。默认为 kNERtcLiveStreamAudioSampleRate48000，即采样率为 48 kHz。 */
channels: number; /**< 音频推流声道数，默认值为 2 双声道。 */
audio_codec_profile: NERtcLiveStreamAudioCodecProfile /**< 音频编码规格。默认值 NERtcLiveStreamAudioCodecProfileLCAAC，普通编码规格，0: LC-AAC 规格，表示基本音频编码规格，1: HE-AAC 规格，表示高效音频编码规格 */
}
/** 直播推流任务的配置项。*/
export interface NERtcLiveStreamTaskInfo
{
task_id: String; /**< 推流任务ID，为推流任务的唯一标识，用于过程中增删任务操作 < 64 chars*/
stream_url: String; /**< 直播推流地址 <256 chars */
server_record_enabled: Boolean; /**< 服务器录制功能是否开启 */
ls_mode: NERtcLiveStreamMode; /**< 直播推流模式，NERtcLiveStreamMode */
layout: NERtcLiveStreamLayout; /**< 视频布局 */
config: NERtcLiveConfig; /**< 音视频流编码参数等设置。详细信息请参考 NERtcLiveConfig */
}
/** 音频设备链接类型。*/
export enum NERtcAudioDeviceTransportType
{
kNERtcAudioDeviceTransportTypeUnknown = 0, /**< 未知设备 */
kNERtcAudioDeviceTransportTypeBluetooth = 1, /**< 蓝牙设备 */
kNERtcAudioDeviceTransportTypeBluetoothA2DP = 2, /**< 蓝牙立体声设备 */
kNERtcAudioDeviceTransportTypeBluetoothLE = 3, /**< 蓝牙低功耗设备 */
kNERtcAudioDeviceTransportTypeUSB = 4, /**< USB设备 */
kNERtcAudioDeviceTransportTypeHDMI = 5, /**< HDMI设备 */
kNERtcAudioDeviceTransportTypeBuiltIn = 6, /**< 内置设备 */
kNERtcAudioDeviceTransportTypeThunderbolt = 7, /**< 雷电接口设备 */
kNERtcAudioDeviceTransportTypeAirPlay = 8, /**< AirPlay设备 */
kNERtcAudioDeviceTransportTypeVirtual = 9, /**< 虚拟设备 */
kNERtcAudioDeviceTransportTypeOther = 10, /**< 其他设备 */
}
/** 摄像头设备链接类型。*/
export enum NERtcVideoDeviceTransportType
{
kNERtcVideoDeviceTransportTypeUnknown = 0, /**< 未知设备 */
kNERtcVideoDeviceTransportTypeUSB = 1, /**< USB设备 */
kNERtcVideoDeviceTransportTypeVirtual = 2, /**< 虚拟设备 */
kNERtcVideoDeviceTransportTypeOther = 3, /**< 其他设备 */
}
export interface NERtcDevice
{
device_id: String;
device_name: String;
transport_type: number; //NERtcAudioDeviceTransportType or NERtcVideoDeviceTransportType
suspected_unavailable: boolean;
system_default_device: boolean;
}
/** 参会者角色类型 */
export enum NERtcClientRole
{
kNERtcClientRoleBroadcaster = 0, /**< 主播 */
kNERtcClientRoleAudience = 1, /**< 观众 */
}
/** SEI 发送的流通道类型 */
export enum NERtcStreamChannelType {
kNERtcStreamChannelTypeMainStream = 0, /**< 主流通道 */
kNERtcStreamChannelTypeSubStream = 1, /**< 辅流通道 */
}
/** 摄像头采集配置 */
export interface NERtcCameraCaptureConfig
{
captureWidth: number; /**< 本地采集的视频宽度，单位为 px。*/
captureHeight: number; /**< 本地采集的视频高度，单位为 px）。*/
}
export interface NERtcPullExternalAudioFrameCb
{
(data: ArrayBuffer): void
}
export enum NERtcVideoStreamType {
kNERtcVideoStreamMain = 0, /** 视频流主流 */
kNERtcVideoStreamSub = 1 /** 视频流副流 */
}
/** 通话相关的统计信息。*/
export interface NERtcStats
{
cpu_app_usage: number; /**< 当前 App 的 CPU 使用率 (%)。*/
cpu_idle_usage: number; /**< 当前系统的 CPU 空闲率 (%)。*/
cpu_total_usage: number; /**< 当前系统的 CPU 使用率 (%)。*/
memory_app_usage: number; /**< 当前App的内存使用率 (%)。*/
memory_total_usage: number;/**< 当前系统的内存使用率 (%)。*/
memory_app_kbytes: number; /**< 当前App的内存使用量 (KB)。*/
total_duration: number; /**< 通话时长（秒）。*/
tx_bytes: number; /**< 发送字节数，累计值。(bytes)*/
rx_bytes: number; /**< 接收字节数，累计值。(bytes)*/
tx_audio_bytes: number; /**< 音频发送字节数，累计值。(bytes)*/
tx_video_bytes: number; /**< 视频发送字节数，累计值。(bytes)*/
rx_audio_bytes: number; /**< 音频接收字节数，累计值。(bytes)*/
rx_video_bytes: number; /**< 视频接收字节数，累计值。(bytes)*/
tx_audio_kbitrate: number; /**< 音频发送码率。(kbps)*/
rx_audio_kbitrate: number; /**< 音频接收码率。(kbps)*/
tx_video_kbitrate: number; /**< 视频发送码率。(kbps)*/
rx_video_kbitrate: number; /**< 视频接收码率。(kbps)*/
up_rtt: number; /**< 上行平均往返时延rtt(ms) */
tx_audio_packet_loss_rate: number; /**< 本地上行音频实际丢包率。(%) */
tx_video_packet_loss_rate: number; /**< 本地上行视频实际丢包率。(%) */
tx_audio_packet_loss_sum: number; /**< 本地上行音频实际丢包数。 */
tx_video_packet_loss_sum: number; /**< 本地上行视频实际丢包数。 */
tx_audio_jitter: number; /**< 本地上行音频抖动计算。(ms) */
tx_video_jitter: number; /**< 本地上行视频抖动计算。(ms) */
rx_audio_packet_loss_rate: number; /**< 本地下行音频实际丢包率。(%) */
rx_video_packet_loss_rate: number; /**< 本地下行视频实际丢包率。(%) */
rx_audio_packet_loss_sum: number; /**< 本地下行音频实际丢包数。 */
rx_video_packet_loss_sum: number; /**< 本地下行视频实际丢包数。 */
rx_audio_jitter: number; /**< 本地下行音频抖动计算。(ms) */
rx_video_jitter: number; /**< 本地下行视频抖动计算。(ms) */
}
/** 本地视频流上传统计信息。*/
export interface NERtcVideoSendStats
{
width: number; /**< 视频流宽（像素）。*/
height: number; /**< 视频流高（像素）。*/
capture_frame_rate: number; /**< 视频采集帧率。*/
encoder_frame_rate: number; /**< （上次统计后）编码帧率 (fps)。*/
sent_bitrate: number; /**< （上次统计后）发送码率(Kbps)。*/
sent_frame_rate: number; /**< （上次统计后）发送帧率 (fps)。*/
target_bitrate: number; /**< （上次统计后）编码器目标码率(Kbps)。*/
}
/** 远端视频流的统计信息。*/
export interface NERtcVideoRecvStats
{
uid: number; /**< 用户 ID，指定是哪个用户的视频流。*/
width: number; /**< 视频流宽（像素）。*/
height: number; /**< 视频流高（像素）。*/
received_bitrate: number; /**< （上次统计后）接收到的码率(Kbps)。*/
packet_loss_rate: number; /**< 下行丢包率(%)。*/
decoder_frame_rate: number; /**< （上次统计后）解码帧率 (fps)。*/
render_frame_rate: number; /**< （上次统计后）渲染帧率 (fps)。*/
received_frame_rate: number; /**< （上次统计后）接收到的帧率 (fps)。*/
total_frozen_time: number; /**< 用户的下行视频卡顿累计时长(ms)。*/
frozen_rate: number; /**< 用户的下行视频平均卡顿率(%)。*/
}
/** 本地音频流上传统计信息。*/
export interface NERtcAudioSendStats
{
num_channels: number; /**< 当前采集声道数。*/
sent_sample_rate: number; /**< 本地上行音频采样率。*/
sent_bitrate: number; /**< （上次统计后）发送码率(Kbps)。*/
audio_loss_rate: number; /**< 特定时间内的音频丢包率 (%)。*/
rtt: number; /**< RTT。*/
volume: number; /**< 音量，范围为 0（最低）- 100（最高）。*/
}
/** 远端用户的音频统计。*/
export interface NERtcAudioRecvStats
{
uid: number; /**< 用户 ID，指定是哪个用户的音频流。*/
received_bitrate: number; /**< （上次统计后）接收到的码率(Kbps)。*/
total_frozen_time: number; /**< 用户的下行音频卡顿累计时长(ms)。*/
frozen_rate: number; /**< 用户的下行音频平均卡顿率(%)。*/
audio_loss_rate: number; /**< 特定时间内的音频丢包率 (%)。*/
volume: number; /**< 音量，范围为 0（最低）- 100（最高）。*/
}
/** @enum NERtcNetworkQualityType 网络质量类型。*/
export enum NERtcNetworkQualityType
{
kNERtcNetworkQualityUnknown = 0, /**< 0: 网络质量未知。*/
kNERtcNetworkQualityExcellent = 1, /**< 1: 网络质量极好。*/
kNERtcNetworkQualityGood = 2, /**< 2: 用户主观感觉和 excellent 差不多，但码率可能略低于 excellent。*/
kNERtcNetworkQualityPoor = 3, /**< 3: 用户主观感受有瑕疵但不影响沟通。*/
kNERtcNetworkQualityBad = 4, /**< 4: 勉强能沟通但不顺畅。*/
kNERtcNetworkQualityVeryBad = 5, /**< 5: 网络质量非常差，基本不能沟通。*/
kNERtcNetworkQualityDown = 6, /**< 6: 完全无法沟通。*/
}
/** 网络质量统计信息。*/
export interface NERtcNetworkQualityInfo
{
uid: number; /**< 用户 ID，指定是哪个用户的网络质量统计。*/
tx_quality: NERtcNetworkQualityType; /**< 该用户的上行网络质量，详见 #NERtcNetworkQualityType.*/
rx_quality: NERtcNetworkQualityType; /**< 该用户的下行网络质量，详见 #NERtcNetworkQualityType.*/
}
/** 连接状态 */
export enum NERtcConnectionStateType
{
kNERtcConnectionStateDisconnected = 1, /**< 没加入频道。*/
kNERtcConnectionStateConnecting = 2, /**< 正在加入频道。*/
kNERtcConnectionStateConnected = 3, /**< 加入频道成功。*/
kNERtcConnectionStateReconnecting = 4, /**< 正在尝试重新加入频道。*/
kNERtcConnectionStateFailed = 5, /**< 加入频道失败。*/
}
/** 连接状态变更原因 */
export enum NERtcReasonConnectionChangedType
{
kNERtcReasonConnectionChangedLeaveChannel = 1, //kNERtcConnectionStateDisconnected 离开房间
kNERtcReasonConnectionChangedChannelClosed = 2, //kNERtcConnectionStateDisconnected 房间被关闭
kNERtcReasonConnectionChangedBeKicked = 3, //kNERtcConnectionStateDisconnected 用户被踢
kNERtcReasonConnectionChangedTimeOut = 4, //kNERtcConnectionStateDisconnected 服务超时
kNERtcReasonConnectionChangedJoinChannel = 5, //kNERtcConnectionStateConnecting 加入房间
kNERtcReasonConnectionChangedJoinSucceed = 6, //kNERtcConnectionStateConnected 加入房间成功
kNERtcReasonConnectionChangedReJoinSucceed = 7, //kNERtcConnectionStateConnected 重新加入房间成功（重连）
kNERtcReasonConnectionChangedMediaConnectionDisconnected = 8, //kNERtcConnectionStateReconnecting 媒体连接断开
kNERtcReasonConnectionChangedSignalDisconnected = 9, //kNERtcConnectionStateReconnecting 信令连接断开
kNERtcReasonConnectionChangedRequestChannelFailed = 10, //kNERtcConnectionStateFailed 请求频道失败
kNERtcReasonConnectionChangedJoinChannelFailed = 11, //kNERtcConnectionStateFailed 加入频道失败
}
/** 音频设备类型。*/
export enum NERtcAudioDeviceType
{
kNERtcAudioDeviceUnknown = 0, /**< 未知音频设备 */
kNERtcAudioDeviceRecord, /**< 音频采集设备 */
kNERtcAudioDevicePlayout, /**< 音频播放设备 */
}
/** 音频设备类型状态。*/
export enum NERtcAudioDeviceState
{
kNERtcAudioDeviceActive = 0, /**< 音频设备已激活 */
kNERtcAudioDeviceUnactive, /**< 音频设备未激活 */
}
/** 音乐文件播放状态。
*/
export enum NERtcAudioMixingState
{
kNERtcAudioMixingStateFinished = 0, /**< 音乐文件播放结束。*/
kNERtcAudioMixingStateFailed = 1, /**< 音乐文件报错。详见: #NERtcAudioMixingErrorCode*/
}
/** @enum NERtcAudioMixingErrorCode 混音音乐文件错误码。
*/
export enum NERtcAudioMixingErrorCode
{
kNERtcAudioMixingErrorOK = 0, /**< 没有错误。*/
kNERtcAudioMixingErrorFatal = 1, /**< 通用错误。*/
kNERtcAudioMixingErrorCanNotOpen, /**< 伴音不能正常打开*/
kNERtcAudioMixingErrorDecode, /**<音频解码错误*/
kNERtcAudioMixingErrorInterrupt, /**<操作中断码*/
kNERtcAudioMixingErrorHttpNotFound, /**<404 file not found，only for http / https*/
kNERtcAudioMixingErrorOpen, /**<打开流 / 文件失败*/
kNERtcAudioMixingErrorNInfo, /**<获取解码信息失败 / 超时*/
kNERtcAudioMixingErrorNStream, /**<无音频流*/
kNERtcAudioMixingErrorNCodec, /**<无解码器*/
kNERtcAudioMixingErrorNMem, /**<无内存*/
kNERtcAudioMixingErrorCodecOpen, /**<解码器打开失败 / 超时*/
kNERtcAudioMixingErrorInvalidInfo, /**<无效音频参数（声道、采样率）*/
kNERtcAudioMixingErrorOpenTimeout, /**<打开流 / 文件超时*/
kNERtcAudioMixingErrorIoTimeout, /**<网络io超时*/
kNERtcAudioMixingErrorIo, /**<网络io错误*/
//kNERtcAudioMixingErrorTooFrequentCall = 101, /**< 音乐文件打开太频繁。*/
//kNERtcAudioMixingErrorInterruptedEOF= 102, /**< 音乐文件播放中断。*/
}
/** 声音音量信息。一个数组，包含每个说话者的用户 ID 和音量信息。*/
export interface NERtcAudioVolumeInfo
{
uid: number; /**< 说话者的用户 ID。如果返回的 uid 为 0，则默认为本地用户。*/
volume: number; /**< 说话者的音量，范围为 0（最低）- 100（最高）。*/
}
/** 直播推流状态。*/
export enum NERtcLiveStreamStateCode
{
kNERtcLsStatePushing = 505, /**< 推流中 */
kNERtcLsStatePushFail = 506, /**< 互动直播推流失败 */
kNERtcLsStatePushStopped = 511, /**< 推流结束 */
kNERtcLsStateImageError = 512, /**< 背景图片设置出错 */
}
/** @enum NERtcMediaStatsEventName SDK 向 App 上报统计信息 */
export enum NERtcMediaStatsEventName {
RtcStats = "onRtcStats", /**< 当前通话统计回调, 每 2 秒触发一次 */
LocalAudioStats = "onLocalAudioStats", /**< 本地音频流统计信息回调,每 2 秒触发一次 */
RemoteAudioStats = "onRemoteAudioStats", /**< 通话中远端音频流的统计信息回调, 每 2 秒触发一次 */
LocalVideoStats = "onLocalVideoStats", /**< 本地视频流统计信息回调, 每 2 秒触发一次 */
RemoteVideoStats = "onRemoteVideoStats", /**< 通话中远端视频流的统计信息回调, 每 2 秒触发一次 */
NetworkQuality = "onNetworkQuality", /**< 通话中每个用户的网络上下行质量报告回调, 每 2 秒触发一次, 只上报状态有变更的成员 */
}
/** 4.1.1 */
/** 变声 预设值 */
export enum NERtcVoiceChangerType {
kNERtcVoiceChangerOff = 0, /**< 默认关闭 */
kNERtcVoiceChangerRobot = 1, /**< 机器人 */
kNERtcVoiceChangerGaint = 2, /**< 巨人 */
kNERtcVoiceChangerHorror = 3, /**< 恐怖 */
kNERtcVoiceChangerMature = 4, /**< 成熟 */
kNERtcVoiceChangerManToWoman = 5, /**< 男变女 */
kNERtcVoiceChangerWomanToMan = 6, /**< 女变男 */
kNERtcVoiceChangerManToLoli = 7, /**< 男变萝莉 */
kNERtcVoiceChangerWomanToLoli = 8 /**< 女变萝莉 */
}
/** 预设的美声效果 */
export enum NERtcVoiceBeautifierType {
kNERtcVoiceBeautifierOff = 0, /**< 默认关闭 */
kNERtcVoiceBeautifierMuffled = 1, /**< 低沉 */
kNERtcVoiceBeautifierMellow = 2, /**< 圆润 */
kNERtcVoiceBeautifierClear = 3, /**< 清澈 */
kNERtcVoiceBeautifierMagnetic = 4, /**< 磁性 */
kNERtcVoiceBeautifierRecordingstudio = 5, /**< 录音棚 */
kNERtcVoiceBeautifierNature = 6, /**< 天籁 */
kNERtcVoiceBeautifierKTV = 7, /**< KTV */
kNERtcVoiceBeautifierRemote = 8, /**< 悠远 */
kNERtcVoiceBeautifierChurch = 9, /**< 教堂 */
kNERtcVoiceBeautifierBedroom = 10, /**< 卧室 */
kNERtcVoiceBeautifierLive = 11, /**< Live */
}
/** 音效均衡波段的中心频率 */
export enum NERtcVoiceEqualizationBand {
kNERtcVoiceEqualizationBand_31 = 0, /**< 31 Hz */
kNERtcVoiceEqualizationBand_62 = 1, /**< 62 Hz */
kNERtcVoiceEqualizationBand_125 = 2, /**< 125 Hz */
kNERtcVoiceEqualizationBand_250 = 3, /**< 250 Hz */
kNERtcVoiceEqualizationBand_500 = 4, /**< 500 Hz */
kNERtcVoiceEqualizationBand_1K = 5, /**< 1 kHz */
kNERtcVoiceEqualizationBand_2K = 6, /**< 2 kHz */
kNERtcVoiceEqualizationBand_4K = 7, /**< 4 kHz */
kNERtcVoiceEqualizationBand_8K = 8, /**< 8 kHz */
kNERtcVoiceEqualizationBand_16K = 9, /**< 16 kHz */
}
/** 3D音效算法中坐标信息 */
export interface NERtcSpatializerPositionInfo {
speaker_position: Array<Number>; /**< 发声坐标 */
speaker_quaternion: Array<Number>; /**< 发声旋转角度四元数 */
head_position: Array<Number>; /**< 头部听觉坐标 */
head_quaternion: Array<Number>; /**< 头部听觉旋转角度四元数 */
}
/** 空间音效房间大小 */
export enum NERtcSpatializerRoomCapacity {
kNERtcSpatializerRoomCapacitySmall = 0, /**< 小房间 */
kNERtcSpatializerRoomCapacityMedium = 1, /**< 中等大小房间 */
kNERtcSpatializerRoomCapacityLarge = 2, /**< 大房间 */
kNERtcSpatializerRoomCapacityHuge = 3, /**< 巨大房间 */
kNERtcSpatializerRoomCapacityNone = 4, /**< 无房间效果 */
}
/** 空间音效中房间材质名称 */
export enum NERtcSpatializerMaterialName {
kNERtcSpatializerMaterialTransparent = 0, /**< 透明的 */
kNERtcSpatializerMaterialAcousticCeilingTiles = 1, /**< 声学天花板，未开放 */
kNERtcSpatializerMaterialBrickBare = 2, /**< 砖块，未开放 */
kNERtcSpatializerMaterialBrickPainted = 3, /**< 涂漆的砖块，未开放 */
kNERtcSpatializerMaterialConcreteBlockCoarse = 4, /**< 粗糙的混凝土块，未开放 */
kNERtcSpatializerMaterialConcreteBlockPainted = 5, /**< 涂漆的混凝土块，未开放 */
kNERtcSpatializerMaterialCurtainHeavy = 6, /**< 厚重的窗帘 */
kNERtcSpatializerMaterialFiberGlassInsulation = 7, /**< 隔音的玻璃纤维，未开放 */
kNERtcSpatializerMaterialGlassThin = 8, /**< 薄的的玻璃，未开放 */
kNERtcSpatializerMaterialGlassThick = 9, /**< 茂密的草地，未开放 */
kNERtcSpatializerMaterialGrass = 10, /**< 草地 */
kNERtcSpatializerMaterialLinoleumOnConcrete = 11, /**< 铺装了油毡的混凝土，未开放 */
kNERtcSpatializerMaterialMarble = 12, /**< 大理石 */
kNERtcSpatializerMaterialMetal = 13, /**< 金属，未开放 */
kNERtcSpatializerMaterialParquetOnConcrete = 14, /**< 镶嵌木板的混凝土，未开放 */
kNERtcSpatializerMaterialPlasterRough = 15, /**< 石膏，未开放 */
kNERtcSpatializerMaterialPlasterSmooth = 16, /**< 粗糙石膏，未开放 */
kNERtcSpatializerMaterialPlywoodPanel = 17, /**< 光滑石膏，未开放 */
kNERtcSpatializerMaterialPolishedConcreteOrTile = 18, /**< 木板，未开放 */
kNERtcSpatializerMaterialSheetrock = 19, /**< 石膏灰胶纸板，未开放 */
kNERtcSpatializerMaterialWaterOrIceSurface = 20, /**< 水面或者冰面，未开放 */
kNERtcSpatializerMaterialWoodCeiling = 21, /**< 木头天花板，未开放 */
kNERtcSpatializerMaterialWoodPanel = 22, /**< 木头枪板，未开放 */
kNERtcSpatializerMaterialUniform = 23, /**< 均匀分布，未开放 */
}
/** 3D音效房间属性设置 */
export interface NERtcSpatializerRoomProperty {
room_capacity: NERtcSpatializerRoomCapacity; /**< 房间大小 #NERtcSpatializerRoomCapacity ，默认值 #kNERtcSpatializerRoomCapacitySmall */
material: NERtcSpatializerMaterialName; /**< 房间材质 #NERtcSpatializerMaterialName ，默认值 #kNERtcSpatializerMaterialTransparent */
reflection_scalar: Number; /**< 反射比例，默认值1.0 */
reverb_gain: Number; /**< 混响增益比例因子，默认值1.0 */
reverb_time: Number; /**< 混响时间比例因子，默认值1.0 */
reverb_brightness: Number; /**< 混响亮度，默认值1.0 */
}
/** 空间音效渲染模式 */
export enum NERtcSpatializerRenderMode {
kNERtcSpatializerRenderStereoPanning = 0, /**< 立体声 */
kNERtcSpatializerRenderBinauralLowQuality = 1, /**< 双声道低 */
kNERtcSpatializerRenderBinauralMediumQuality = 2, /**< 双声道中 */
kNERtcSpatializerRenderBinauralHighQuality = 3, /**< 双声道高 */
kNERtcSpatializerRenderRoomEffectsOnly = 4, /**< 仅房间音效 */
}
export enum NERtcAudioRecordingPosition {
kNERtcAudioRecordingPositionMixedRecordingAndPlayback = 0, /**< 录制本地和所有远端用户混音后的音频（默认） */
kNERtcAudioRecordingPositionRecording = 1, /**< 仅录制本地用户的音频 */
kNERtcAudioRecordingPositionMixedPlayback = 2, /**< 仅录制所有远端用户的音频 */
}
export enum NERtcAudioRecordingCycleTime {
kNERtcAudioRecordingCycleTime0 = 0, /**< 音频录制缓存时间为0，实时写文件（默认） */
kNERtcAudioRecordingCycleTime10 = 10, /**< 音频录制缓存时间为10s，StopAudioRectording()后，将缓存都写到文件，文件数据时间跨度为: [0,10s] */
kNERtcAudioRecordingCycleTime60 = 60, /**< 音频录制缓存时间为60s，StopAudioRectording()后，将缓存都写到文件，文件数据时间跨度为: [0,60s] */
kNERtcAudioRecordingCycleTime360 = 360, /**< 音频录制缓存时间为360s，StopAudioRectording()后，将缓存都写到文件，文件数据时间跨度为: [0,360s] */
kNERtcAudioRecordingCycleTime900 = 900, /**< 音频录制缓存时间为900s，StopAudioRectording()后，将缓存都写到文件，文件数据时间跨度为: [0,900s] */
}
/** */
export interface NERtcAudioRecordingConfiguration {
filePath: string; /**< 录音文件在本地保存的绝对路径，需要精确到文件名及格式。例如：sdcard/xxx/audio.aac。*/
sampleRate: number; /**< 录音采样率（Hz），可以设为 16000、32000（默认）、44100 或 48000。 */
quality: NERtcAudioRecordingQuality; /**< 录音音质，只在 AAC 格式下有效 */
position: NERtcAudioRecordingPosition; /**< 录音文件所包含的内容 */
cycleTime: NERtcAudioRecordingCycleTime; /**< 录制过程中，循环缓存的最大时间长度，单位(s) */
}
export enum NERtcBackgroundSourceType {
kNERtcBackgroundColor = 1, /**< 背景图像为纯色（默认） */
kNERtcBackgroundImage = 2, /**< 背景图像只支持 PNG 或 JPG 格式的文件 */
}
/** 自定义背景图像*/
export interface VirtualBackgroundSource {
background_source_type: NERtcBackgroundSourceType; /**< 自定义背景图片的类型*/
color: number; /**< 自定义背景图像的颜色。格式为RGB定义的十六进制整数，不带#号 */
source: string; /**< 自定义背景图片的本地绝对路径。支持 PNG 和 JPG 格式。 */
}
/** 混响参数*/
export interface NERtcReverbParam {
wetGain: number; /**< 湿信号，取值范围为 0 ~ 1，默认值为 0.0f。*/
dryGain: number; /**< 干信号，取值范围为 0 ~ 1，默认值为 1.0f。 */
damping: number; /**< 混响阻尼，取值范围为 0 ~ 1，默认值为 1.0f。 */
roomSize: number; /**< 房间大小，取值范围为 0.1 ~ 2，默认值为 0.1f。 */
decayTime: number; /**< 持续强度（余响），取值范围为 0.1 ~ 20，默认值为 0.1f。 */
preDelay: number; /**< 延迟长度，取值范围为 0 ~ 1，默认值为 0.0f。 */
}
/** */
export interface NERtcSize {
width: number; /**< The target width (px) of the thumbnail or icon. The default value is 0.*/
height: number; /**< The target height (px) of the thumbnail or icon. The default value is 0. */
}
export interface NERtcSize {
width: number; /**< The target width (px) of the thumbnail or icon. The default value is 0.*/
height: number; /**< The target height (px) of the thumbnail or icon. The default value is 0. */
}
export interface CaptureSoureInfo {
type: number; /**< 信息源类型:-1-未知 0-窗口 1-屏幕 2-自定义*/
source_id: number; /**< 信息源ID. */
}
/** 功能类型 */
export enum NERtcFeatureType
{
kNERTCVirtualBackground = 0 /**< 虚拟背景*/
}
/** 屏幕分享状态 */
export enum NERtcScreenCaptureStatus
{
kScreenCaptureStatusStart = 1, /**< 开始屏幕共享*/
kScreenCaptureStatusPause = 2, /**< 暂停屏幕共享*/
kScreenCaptureStatusResume = 3, /**< 开始屏幕共享*/
kScreenCaptureStatusStop = 4, /**< 开始屏幕共享*/
kScreenCaptureStatusCovered = 5, /**< 开始屏幕共享*/
kScreenCaptureStatusAbort = 6, /**< 开始屏幕共享*/
}
/** The type of the shared target. */
export enum NERtcScreenCaptureCustomHLBorderAction
{
kSetPos = 0, /**< The shared target is a window.*/
kSetAbove = 1, /**< The shared target is a screen of a particular monitor.*/
kSetBelow = 2, /**< Reserved parameter.*/
kHide = 3, /**< The shared target is a window.*/
kShow = 4, /**< The shared target is a window.*/
}
export interface NERtcScreenCaptureSourceData {
type: CaptureSoureInfo; /**< 信息源类型:-1-未知 0-窗口 1-屏幕 2-自定义*/
source_id: number; /**< 信息源ID. */
status: NERtcScreenCaptureStatus; /**< 屏幕分享状态*/
action: NERtcScreenCaptureCustomHLBorderAction; /**< 屏幕分享自定义高亮框的设置动作，结合capture_rect使用。*/
level: number; /**< 屏幕分享源的层级，仅用于macOS */
capture_rect: NERtcRectangle; /**< 屏幕分享源的采集范围，可用于设置用户自定义高亮框的位置。*/
}
export interface NERtcEngineAPI {
initialize(context: NERtcEngineContext): number;
release(): void;
setChannelProfile(profile: NERtcChannelProfileType): number;
joinChannel(token: String, channelName: String, uid: number): number;
joinChannelWithOptions(token: string, channelName: string, uid: number, channelOptions: NERtcJoinChannelOptions): number;
switchChannelWithOptionsEx(token: string, channelName: string, channelOptions: NERtcJoinChannelOptionsEx): number;
leaveChannel(): number;
enableLocalAudio(enabled: Boolean): number;
enableLocalVideo(enabled: Boolean): number;
enableLocalVideoWithType(streamType: NERtcVideoStreamType, enabled: boolean): number;
subscribeRemoteVideoStream(uid: number, type: NERtcRemoteVideoStreamType, subscribe: Boolean): number;
setupVideoCanvas(uid: number, enabled: Boolean): number;
onVideoFrame(callback: Function): number;
onEvent(eventName: String, callback: Function): void;
onAudioFrameEvent(eventName: String, callback: Function, enable: boolean): void;
getConnectionState(): number;
muteLocalAudioStream(enabled: Boolean): number;
setAudioProfile(profile: NERtcAudioProfileType, scenario: NERtcAudioScenarioType): number;
subscribeRemoteAudioStream(uid: number, enabled: Boolean): number;
setVideoConfig(config: NERtcVideoConfig): number;
enableDualStreamMode(enabled: Boolean): number;
startVideoPreview(): number;
stopVideoPreview(): number;
muteLocalVideoStream(enabled: Boolean): number;
setParameters(parameters: String): number;
getParameters(parameters: String, extra_info: String): String;
startAudioDump(): number;
stopAudioDump(): number;
startAudioMixing(opt: NERtcCreateAudioMixingOption): number;
stopAudioMixing(): number;
pauseAudioMixing(): number;
resumeAudioMixing(): number;
setAudioMixingSendVolume(volume: number): number;
getAudioMixingSendVolume(): number;
setAudioMixingPlaybackVolume(volume: number): number;
getAudioMixingPlaybackVolume(): number;
getAudioMixingDuration(): number;
getAudioMixingCurrentPosition(): number;
setAudioMixingPosition(pos: number): number;
playEffect(effectId: number, opt: Array<NERtcCreateAudioEffectOption>): number;
stopEffect(effectId: number): number;
stopAllEffects(): number;
pauseEffect(effectId: number): number;
resumeEffect(effectId: number): number;
pauseAllEffects(): number;
resumeAllEffects(): number;
setEffectSendVolume(effectId: number, volume: number): number;
getEffectSendVolume(effectId: number): number;
setEffectPlaybackVolume(effectId: number, volume: number): number;
getEffectPlaybackVolume(effectId: number): number;
enableEarback(enabled: boolean, volume: number): number;
setEarbackVolume(volume: number): number;
onStatsObserver(eventName: String, enabled: boolean, callback: Function): void;
enableAudioVolumeIndication(enabled: boolean, interval: number): number;
startScreenCaptureByScreenRect(screenRect: NERtcRectangle, regionRect: NERtcRectangle, param: NERtcScreenCaptureParameters): number;
startScreenCaptureByDisplayId(displayId: number, regionRect: NERtcRectangle, param: NERtcScreenCaptureParameters): number;
startScreenCaptureByWindowId(windowid: number, regionRect: NERtcRectangle, param: NERtcScreenCaptureParameters): number;
updateScreenCaptureRegion(regionRect: NERtcRectangle): number;
stopScreenCapture(): number;
pauseScreenCapture(): number;
resumeScreenCapture(): number;
getVersion(): String;
getErrorDescription(errorCode: number): String;
uploadSdkInfo(): void;
addLiveStreamTask(info: NERtcLiveStreamTaskInfo): number;
updateLiveStreamTask(info: NERtcLiveStreamTaskInfo): number;
removeLiveStreamTask(taskId: String): number;
enumerateRecordDevices(): Array<NERtcDevice>;
setRecordDevice(id: String): number; //<256chars
getRecordDevice(): String;
enumeratePlayoutDevices(): Array<NERtcDevice>;
setPlayoutDevice(id: String): number; //<256chars
getPlayoutDevice(): String;
setRecordDeviceVolume(volume: number): number;
getRecordDeviceVolume(): number;
setPlayoutDeviceVolume(volume: number): number;
getPlayoutDeviceVolume(): number;
setPlayoutDeviceMute(mute: boolean): number;
getPlayoutDeviceMute(): boolean;
setRecordDeviceMute(mute: boolean): number;
getRecordDeviceMute(): boolean;
adjustRecordingSignalVolume(volume: number): number;
adjustPlaybackSignalVolume(volume: number): number;
startRecordDeviceTest(interval: number): number;
stopRecordDeviceTest(): number;
startPlayoutDeviceTest(path: String): number;
stopPlayoutDeviceTest(): number;
startAudioDeviceLoopbackTest(interval: number): number;
stopAudioDeviceLoopbackTest(): number;
enumerateCaptureDevices(): Array<NERtcDevice>;
getScreenCaptureSources(thumbSize: NERtcSize, iconSize: NERtcSize, includeScreen: boolean): Array<Object>;
setDevice(id: String): number; //<256chars
getDevice(): String;
setLocalVideoMirrorMode(mode: NERtcVideoMirrorMode): number;
setClientRole(role: NERtcClientRole): number;
setupSubStreamVideoCanvas(uid: number, enabled: Boolean): number;
subscribeRemoteVideoSubStream(uid: number, sub: boolean): number;
enumerateScreenCaptureSourceInfo(thumbWidth: number, thumbHeight: number, iconWidth: number, iconHeight: number): Array<Object>;
startSystemAudioLoopbackCapture(): number;
stopSystemAudioLoopbackCapture(): number;
setSystemAudioLoopbackCaptureVolume(volume: number): number;
sendSEIMsg(data: ArrayBuffer): number;
sendSEIMsgWithType(data: ArrayBuffer, type: NERtcStreamChannelType): number;
setExternalAudioRender(enable: boolean, sampleRate: number, channels: number): number;
pullExternalAudioFrame(pullLength: number, cb: NERtcPullExternalAudioFrameCb): number;
setAudioEffectPreset(type: NERtcVoiceChangerType): number;
setVoiceBeautifierPreset(type: NERtcVoiceBeautifierType): number;
setLocalVoicePitch(pitch: number): number;
setLocalVoiceEqualization(bandFrequency: NERtcVoiceEqualizationBand, bandGain: number): number;
switchChannel(token: String, channelName: String): number;
setLocalMediaPriority(priority: NERtcMediaPriorityType, preemptive: boolean): number;
setExcludeWindowList(param: NERtcScreenCaptureWindowParam): number;
enableLoopbackRecording(enable: boolean, deviceName: String): number;
startAudioRecording(filePath: String, sampleRate: number, quality: NERtcAudioRecordingQuality): number;
stopAudioRecording(): number;
adjustUserPlaybackSignalVolume(uid: number, volume: number): number;
adjustLoopbackRecordingSignalVolume(volume: number): number;
startChannelMediaRelay(config: NERtcChannelMediaRelayConfiguration): number;
updateChannelMediaRelay(config: NERtcChannelMediaRelayConfiguration): number;
stopChannelMediaRelay(): number;
setLocalPublishFallbackOption(option: number): number;
setRemot