urtc-sdk-web/lib/index.d.ts

// Generated by dts-bundle v0.7.3

declare module '@urtc/sdk-web' {
  import { Client } from '__@urtc/sdk-web/client';
  import { LocalStream, LocalStreamOptions } from '__@urtc/sdk-web/stream/local-stream';
  import { generateToken } from '__@urtc/sdk-web/utils/token';
  import { ClientOptions } from '__@urtc/sdk-web/types';
  import { LogLevel } from '__@urtc/sdk-web/logger';
  /**
    * 创建客户端
    * @param appId - 应用 ID，可在控制台查看
    * @param opts - 定义客户端的属性
    * @example
    * ```js
    * const client = createClient('AppID');
    * client
    *   .join('roomId', 'userId', 'token')
    *   .then(() => {
    *     client.publish(localStream);
    *   })
    *   .catch((err) => {
    *     console.log(`加入房间失败 ${err}`);
    *   });
    * ```
    * @throws {@link RtcError}
    */
  export function createClient(appId: string, opts?: ClientOptions): Client;
  /**
    * 创建并返回本地音视频流对象
    * @param opts - 定义本地音视频流的属性
    * > 注：
    * > 1. video, screen 不可同时为 true
    * > 2. audio, video, screen 不可同时为 false
    * > 3. 若指定了 file，则 init 时将优先使用 file 来创建初始化本地流的视频
    * > 4. screenAudio 在不同浏览器上表现不同，参见 {@link LocalStreamOptions}
    * @example
    * ```js
    * const localStream = createStream({ audio: true, video: true, screen: false });
    * localStream
    *   .init()
    *   .then(() => {
    *     localStream
    *       .play(container)
    *       .catch((err) => {console.log(`播放失败: ${err}`)});
    *   })
    *   .catch((err) => {
    *     console.log(`本地流初始化失败 ${err}`);
    *   });
    * ```
    * @throws {@link RtcError}
    */
  export function createStream(opts: LocalStreamOptions): LocalStream;
  /**
    * 设置日志打印级别
    * @param level - 日志级别，有 'debug', 'info', 'warn', 'error' 级别;
    * @example
    * ```js
    * setLogLevel('info');
    * ```
    */
  export function setLogLevel(level: LogLevel): void;
  /**
    * 上报操作/错误/状态日志，未调用时，默认开启上报日志
    * @param enable - 是否开启上报
    * @example
    * ```js
    * reportLog(false); // 关闭日志上报，关闭后，在线上出现错误时，将无法根据日志进行排查
    * ```
    */
  export function reportLog(enable: boolean): void;
  export { generateToken };
  export * from '__@urtc/sdk-web/devices';
  export * from '__@urtc/sdk-web/client';
  export * from '__@urtc/sdk-web/types';
  export * from '__@urtc/sdk-web/event';
  export * from '__@urtc/sdk-web/error';
  export * from '__@urtc/sdk-web/user/user';
  export * from '__@urtc/sdk-web/stream/types';
  export * from '__@urtc/sdk-web/stream/stream';
  export * from '__@urtc/sdk-web/stream/local-stream';
  export * from '__@urtc/sdk-web/stream/remote-stream';
  export * from '__@urtc/sdk-web/server';
  export * from '__@urtc/sdk-web/version';
  /************** 4 plugin ****************/
  export { LocalStream };
  export { RemoteStream } from '__@urtc/sdk-web/stream/remote-stream';
}

declare module '__@urtc/sdk-web/client' {
  import { RtcEventType } from '__@urtc/sdk-web/event';
  import { Listener } from '__@urtc/sdk-web/event-emitter';
  import { LocalStream } from '__@urtc/sdk-web/stream/local-stream';
  import { RemoteStream } from '__@urtc/sdk-web/stream/remote-stream';
  import { User } from '__@urtc/sdk-web/user/user';
  import { JoinOptions, RoleType } from '__@urtc/sdk-web/types';
  /**
    * URTC 客户端，可进行加入、离开房间，发布、订阅流等操作。
    */
  export class Client {
      /**
        * 获取远端用户信息
        * @example
        * ```js
        * const users = client.getRemoteUsers();
        * ```
        */
      getRemoteUsers(): User[];
      /**
        * 获取当前 Client 已发布的本地流
        * @example
        * ```js
        * const localStreams = client.getLocalStreams();
        * ```
        */
      getLocalStreams(): LocalStream[];
      /**
        * 获取当前 Client 已接收到的远端流（包含已订阅或未订阅的远端流）
        * @example
        * ```js
        * const remoteStreams = client.getRemoteStreams();
        * ```
        */
      getRemoteStreams(): RemoteStream[];
      /**
        * 加入房间
        * @param roomId - 房间ID
        * @param userId - 用户ID
        * @param token - 由 AppId，AppKey，RoomId，UserId 生成的令牌
        * @param opts - 其他选项
        * @example
        * ```js
        * const remoteStreams = client.getRemoteStreams();
        * client
        *   .join('roomId', 'userId', 'token-xxx')
        *   .then(() => {
        *     console.log(`加入房间成功`);
        *     // client.publish(localStream);
        *   })
        *   .catch((err) => {
        *     console.log(`加入房间失败 ${err}`);
        *   });
        * ```
        * @reject {@link RtcError}
        */
      join(roomId: string, userId: string, token: string, opts?: JoinOptions): Promise<void>;
      /**
        * 离开房间
        * @example
        * ```js
        * client
        *   .leave()
        *   .then(() => {
        *     console.log(`离开房间成功`);
        *   })
        *   .catch((err) => {
        *     console.log(`离开房间失败 ${err}`);
        *   });
        * ```
        */
      leave(): Promise<void>;
      /**
        * 监听 Client 对象事件
        * @param type - 事件类型
        * @param listener - 事件监听函数
        * @example
        * ```js
        * const handleStreamAdded = (event) => {
        *   client
        *     .subscribe(event.data)
        *     .catch((err) => {
        *       console.log(`订阅失败 ${err}`);
        *     });
        * }
        * client.on('stream-added', handleStreamAdded);
        * ```
        * @throws {@link RtcError}
        */
      on<T extends RtcEventType>(type: T, listener: Listener<T>): void;
      /**
        * 取消监听 Client 对象事件
        * @param type - 事件类型，特别的，可以使用 * 来一次性取消对所有事件的监听
        * @param listener - 事件监听函数
        * @example
        * ```js
        * client.off('stream-added', handleStreamAdded);
        * ```
        *
        * **特别地，一次性取消对所有事件的监听**
        * @example
        * ```js
        * client.off('*');
        * ```
        * @throws {@link RtcError}
        */
      off<T extends RtcEventType | '*'>(type: T, listener?: Listener<T>): void;
      /**
        * 发布一条本地流
        * @param stream - 需要被发布的本地流
        * @example
        * ```js
        * client
        *   .publish(localStream)
        *   .catch((err) => {
        *     console.log(`发布失败 ${err}`);
        *   });
        * ```
        * @reject {@link RtcError}
        */
      publish(stream: LocalStream): Promise<void>;
      /**
        * 取消发布一条本地流
        * @param stream - 需要取消发布的本地流
        * @example
        * ```js
        * client
        *   .unpublish(localStream)
        *   .then(() => {
        *     console.log('取消发布成功');
        *     // localStream.destroy();
        *   })
        *   .catch((err) => {
        *     console.log(`取消发布失败 ${err}`);
        *   });
        * ```
        * @reject {@link RtcError}
        */
      unpublish(stream: LocalStream): Promise<void>;
      /**
        * 订阅一条远端流
        * @param stream - 需要被订阅的远端流
        * @example
        * ```js
        * client
        *   .subscribe(remoteStream)
        *   .catch((err) => {
        *     console.log(`订阅失败 ${err}`);
        *   });
        * ```
        * @reject {@link RtcError}
        */
      subscribe(stream: RemoteStream): Promise<void>;
      /**
        * 取消订阅一条远端流
        * @param stream - 需要取消订阅的远端流
        * @example
        * ```js
        * client
        *   .unsubscribe(remoteStream)
        *   .catch((err) => {
        *     console.log(`取消订阅失败 ${err}`);
        *   });
        * ```
        * @reject {@link RtcError}
        */
      unsubscribe(stream: RemoteStream): Promise<void>;
      /**
        * 修改用户角色
        * @param role - 用户角色
        * @example
        * ```js
        * client.setRole('push');
        * ```
        * @throws {@link RtcError}
        */
      setRole(role: RoleType): void;
  }
}

declare module '__@urtc/sdk-web/stream/local-stream' {
  import { Stream } from '__@urtc/sdk-web/stream/stream';
  import { PlayOptions } from '__@urtc/sdk-web/types';
  import { SwitchDeviceType } from '__@urtc/sdk-web/stream/types';
  import { VideoProfile, ScreenProfile, CustomVideoProfile } from '__@urtc/sdk-web/stream/profile';
  /**
    * 创建本地流的参数
    */
  export interface LocalStreamOptions {
      /**
        * 是否读取麦克风设备来初始化本地流的音频
        */
      audio: boolean;
      /**
        * 读取指定设备ID的麦克风
        */
      microphoneId?: string;
      /**
        * 是否读取摄像头设备来初始化本地流的视频
        */
      video: boolean;
      /**
        * 读取指定设备ID的摄像头
        */
      cameraId?: string;
      /**
        * 是否使用屏幕共享的画面来初始化本地流
        */
      screen: boolean;
      /**
        * 是否读取屏幕共享的音频，默认: false
        * > 注：仅部分浏览器支持，如 Chrome 74，且不同系统表现不同，如 windows 会读取桌面音频，macOS 只支持读取浏览器 tab 中的音频，
        */
      screenAudio?: boolean;
      /**
        * 在移动设备上，可以设置该参数选择使用前置或后置摄像头，其中，FacingMode 为 'user'（前置摄像头）或 'environment'（后置摄像头）
        */
      facingMode?: 'user' | 'environment';
      /**
        * 使用图片初始化本地流的视频
        */
      file?: string | File;
  }
  /**
    * 本地流，可用于本地预览，也可用 client 进行发布
    */
  export class LocalStream extends Stream {
      /**
        * 初始化本地音视频流对象
        * @example
        * ```js
        * const stream = createStream({audio: true, video: true, screen: false});
        * stream
        *   .init()
        *   .then(() => {
        *     client.publish(stream); // 发布本地流
        *   })
        *   .catch((err) => {
        *     console.log(`初始化本地流失败 ${err}`);
        *   })
        * ```
        */
      init(): Promise<void>;
      /**
        * 添加一条媒体轨道（音轨或视轨）到当前流
        * > 注：
        * > 1. 若创建本地流时，audio 为 false，不可添加音轨，video 为 false 时，不可添加视轨
        * @param track - 媒体轨道
        * @example
        * ```js
        * stream.addTrack(track);
        * ```
        */
      addTrack(track: MediaStreamTrack): void;
      /**
        * 从当前流中删除一条媒体轨道（音轨或视轨）
        * @param track - 媒体轨道
        * @example
        * ```js
        * stream.removeTrack(track);
        * ```
        */
      removeTrack(track: MediaStreamTrack): void;
      /**
        * 替换当前流中的媒体轨道
        * > 注：
        * > 1. 替换视频时，请使用与原轨道相同的分辨率的媒体轨道
        * > 2. 返回值为当前流中相同类型的媒体轨道，此媒体轨道仍可用（占用音频设备或视频设备），请自行决定是否调用其 stop 方法释放设备
        * @param track - 新媒体轨道
        * @example
        * ```js
        * const oldTrack = stream.replaceTrack(track);
        * oldTrack.stop();
        * ```
        */
      replaceTrack(track: MediaStreamTrack): MediaStreamTrack | undefined;
      /**
        * 播放当前流
        * @param container - 播放音视频时，包裹 video 标签所用的容器元素或容器元素的 ID
        * @param opts - 其他播放参数，参见{@link PlayOptions}
        * @example
        * ```js
        * const container = 'xxx'; // 比如 id 为 xxx 的 div 元素
        * stream
        *   .play(container)
        *   .catch((err) => {
        *     console.log(`播放失败: ${err}`); // 一般由于浏览器对自动播放的限制导致播放失败
        *   });
        * ```
        * @reject {@link RtcError}
        */
      play(container: HTMLElement | string, opts?: PlayOptions): Promise<void>;
      /**
        * 设置当前流视频的 Profile，默认 '480p'
        * @param profile - 视频 Profile
        * @example
        * ```js
        * stream.setVideoProfile('720p');
        * ```
        * 或
        * ```js
        * stream.setVideoProfile({width: 640, height: 480, framerate: 15, bitrate: 500});
        * ```
        */
      setVideoProfile(profile: VideoProfile | CustomVideoProfile): void;
      /**
        * 设置当前流（屏幕共享时）视频的 Profile，默认 '1080p'
        * 注：请务必在调用 init 方法之前，设置屏幕共享流的 Profile，否则无法生效。
        * @param profile - 视频 Profile
        * @example
        * ```js
        * stream.setScreenProfile('720p');
        * stream.init().catch((err) => {
        *   console.log(`初始化屏幕共享流失败 ${err}`);
        * });
        * ```
        */
      setScreenProfile(profile: ScreenProfile | CustomVideoProfile): void;
      /**
        * 切换音视频设备
        * @param type - 设备类型
        * @param deviceId - 设备 ID
        * @example
        * ```js
        * stream.switchDevice('audio', 'xxxxxxx')
        *   .then(() => {
        *     console.log('切换设备成功');
        *   })
        *   .catch((err) => {
        *     console.log(`切换设备失败：${err}`);
        *   });
        * ```
        * @reject {@link RtcError}
        */
      switchDevice(type: SwitchDeviceType, deviceId: string): Promise<void>;
      /**
        * 切换图片 - 使用图片生成视频，并将当前流的视频使用其代替
        * @param file - 图片地址或图片文件
        * @example
        * ```js
        * const imgAddr = 'https://a.b.c/d.jpg';
        * stream.switchImage(imgAddr)
        *   .then(() => {
        *     console.log('切换图片成功')
        *   })
        *   .catch((err) => {
        *     console.error(`切换图片失败：${err}`);
        *   });
        * ```
        * @reject {@link RtcError}
        */
      switchImage(file: string | File): Promise<void>;
  }
}

declare module '__@urtc/sdk-web/utils/token' {
  /**
    * 根据 AppId，AppKey，RoomId，UserId 生成 token，用于开发阶段临时快速的加入房间并验证功能，由于 AppKey 不可暴露于公网，因此生产环境中不建议使用此方法生成 token。
    * @param appId - 应用 ID，可在控制台查看
    * @param appKey - 应用密钥，可在控制台查看
    * @param roomId - 房间 ID
    * @param userId - 用户 ID
    * @example
    * ```js
    * const token = generateToken('urtc-xxx', 'yyy', 'roomId', 'userId');
    * client.join('roomId', 'userId', token);
    * ```
    */
  export function generateToken(appId: string, appKey: string, roomId: string, userId: string): string;
}

declare module '__@urtc/sdk-web/types' {
  import { VideoCodec } from '__@urtc/sdk-web/stream/types';
  /**
    * 视频播放时的显示模式
    * - cover 模式：优先保证视窗被填满。
    * - contain 模式：优先保证视频内容全部显示。
    * 播放摄像头视频流默认使用 cover 模式，屏幕共享视频流默认使用 contain 模式。
    */
  export type PlayerVideoFitType = 'cover' | 'contain';
  /**
    * 播放器播放属性
    */
  export interface PlayOptions {
      /**
        * 是否静音播放
        */
      mute: boolean;
      /**
        * 是否镜像播放
        */
      mirror?: boolean;
      /**
        * 视频播放时的{@link PlayerVideoFitType | 显示模式}，默认 'cover'，屏幕共享时默认使用 'contain'
        */
      fit?: PlayerVideoFitType;
  }
  export { /*AudioProfile,*/ VideoProfile, ScreenProfile } from '__@urtc/sdk-web/stream/profile';
  /**
    * 房间类型
    */
  export type RoomType = 'rtc' | 'live';
  /**
    * 用户角色
    */
  export type RoleType = 'pull' | 'push' | 'push-and-pull';
  /**
    * 定义客户端的属性
    */
  export interface ClientOptions {
      /**
        * 客户端{@link VideoCodec | 视频编码格式}，默认 'vp8'
        */
      codec?: VideoCodec;
  }
  /**
    * 加入房间的属性
    */
  export interface JoinOptions {
      /**
        * 加入房间的{@link RoomType | 房间类型}，默认 'rtc'
        */
      type?: RoomType;
      /**
        * 加入房间的{@link RoleType | 角色}，默认 'push-and-pull'
        */
      role?: RoleType;
  }
}

declare module '__@urtc/sdk-web/logger' {
  /**
    * 日志级别
    */
  export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
}

declare module '__@urtc/sdk-web/devices' {
  /**
    * 获取音视频输入/输出设备列表，点击 [MediaDeviceInfo](https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo) 查看详情
    * @example
    * ```js
    * getDevices()
    *  .then(devices => {
    *    console.log(`获取设备列表成功：`, devices);
    *  })
    *  .catch(err => {
    *    console.log(`获取设备列表失败：${err}`);
    *  });
    * ```
    * @reject {@link RtcError}
    */
  export function getDevices(): Promise<MediaDeviceInfo[]>;
  /**
    * 获取摄像头设备列表，点击 [MediaDeviceInfo](https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo) 查看详情
    * @example
    * ```js
    * getCameras()
    *  .then(devices => {
    *    console.log(`获取设备列表成功：`, devices);
    *  })
    *  .catch(err => {
    *    console.log(`获取设备列表失败：${err}`);
    *  });
    * ```
    * @reject {@link RtcError}
    */
  export function getCameras(): Promise<MediaDeviceInfo[]>;
  /**
    * 获取麦克风设备列表，点击 [MediaDeviceInfo](https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo) 查看详情
    * @example
    * ```js
    * getMicrophones()
    *  .then(devices => {
    *    console.log(`获取设备列表成功：`, devices);
    *  })
    *  .catch(err => {
    *    console.log(`获取设备列表失败：${err}`);
    *  });
    * ```
    * @reject {@link RtcError}
    */
  export function getMicrophones(): Promise<MediaDeviceInfo[]>;
  /**
    * 获取扬声器设备列表，点击 [MediaDeviceInfo](https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo) 查看详情
    * @example
    * ```js
    * getLoudspeakers()
    *  .then(devices => {
    *    console.log(`获取设备列表成功：`, devices);
    *  })
    *  .catch(err => {
    *    console.log(`获取设备列表失败：${err}`);
    *  });
    * ```
    * @reject {@link RtcError}
    */
  export function getLoudspeakers(): Promise<MediaDeviceInfo[]>;
  /**
    * 设备检测选项
    */
  export interface DeviceDetectionOptions {
      /**
        * 必填，指定是还检测麦克风设备
        */
      audio: boolean;
      /**
        * 必填，指定是否检测摄像头设备
        */
      video: boolean;
      /**
        * 选填，指定需要检测的麦克风设备的ID，可通过 getMicrophones 方法查询获得该ID，不填时，将检测默认的麦克风设备
        */
      microphoneId?: string;
      /**
        * 选填，指定需要检测的摄像头设备的ID，可以通过 getCameras 方法查询获得该ID，不填时，将检测默认的摄像头设备
        */
      cameraId?: string;
  }
  /**
    * 设备可用性检测 - 创建包含麦克风音频或摄像头视频的本地流时，有可能因为麦克风或摄像头设备问题（如驱动问题，或未经授权等），导致无法正确创建。此方法可用于设备检测，根据检测结果，再决定创建本地流时启用麦克风或摄像头或麦克风和摄像头
    * @param options - 需指定设备时，请传入设备 ID
    * @example
    * ```js
    * deviceDetection({audio: true, video: true})
    *   .then(() => {
    *     console.log('设备可用');
    *   })
    *   .catch(err => {
    *     console.log(`设备不可用，${err}`);
    *   });
    * ```
    * @reject {@link RtcError}
    */
  export function deviceDetection(options: DeviceDetectionOptions): Promise<void>;
  /**
    * 检测浏览器是否完全（可访问本地音视频设备）支持 WebRTC。
    * @example
    * ```js
    * if (!isSupportWebRTC()) {
    *   console.log(`当前浏览器不完全支持 WebRTC，建议使用 Chrome 浏览器，iOS 系统建议使用 Safari 浏览器`);
    * }
    * ```
    */
  export function isSupportWebRTC(): boolean;
  /**
    * 检测浏览器是否支持屏幕共享
    * @example
    * ```js
    * if (!isSupportScreenShare()) {
    *   console.log(`当前浏览器不支持屏幕共享`);
    * }
    * ```
    */
  export function isSupportScreenShare(): boolean;
}

declare module '__@urtc/sdk-web/event' {
  import { User } from '__@urtc/sdk-web/user/user';
  import { Stream } from '__@urtc/sdk-web/stream/stream';
  import { ConnectionStates } from '__@urtc/sdk-web/connection/types';
  import { LocalStream } from '__@urtc/sdk-web/';
  import { RemoteStream } from '__@urtc/sdk-web/stream/remote-stream';
  /**
    * @private
    */
  export const RtcEventTypes: readonly ["user-joined", "user-left", "stream-added", "stream-removed", "stream-subscribed", "stream-published", "mute-audio", "unmute-audio", "mute-video", "unmute-video", "connection-state-changed", "kick-off", "screenshare-stopped", "first-key-frame", "network-quality", "logoff"];
  /**
    * Rtc 用户事件类型：
    *
    * {@link RtcUserEvent 用户事件}
    * - user-joined - 有用户加入房间
    * - user-left - 有用户离开房间
    * - kick-off - 当前用户被踢出房间
    * @example
    * ```js
    * client.on('user-joined', (event) => {
    *   console.log(`用户 ${event.data.id} 加入`);
    * });
    * ```
    */
  export type RtcUserEventType = 'user-joined' | 'user-left' | 'kick-off';
  /**
    * Rtc 流事件类型：
    *
    * {@link RtcStreamEvent 流事件}
    * - stream-added - 有远端流加入，此时事件中的 data 为 {@link RemoteStream} 远端流
    * - stream-removed - 有远端流移除，此时事件中的 data 为 {@link RemoteStream} 远端流
    * - stream-subscribed - 远端流订阅完成，此时事件中的 data 为 {@link RemoteStream} 远端流
    * - stream-published - 本地流发布完成，此时事件中的 data 为 {@link LocalStream} 本地流
    * - mute-audio - 流的音频被 mute
    * - unmute-audio - 流的音频被取消 mute
    * - mute-video - 流的视频被 mute
    * - unmute-video - 流的视频被取消 mute
    * - first-key-frame - 接收到远端流的首帧
    * @example
    * ```js
    * client.on('stream-add', (event) => {
    *   client.subscribe(event.data);
    * });
    * ```
    *
    * **特别地，以下事件需在单条流上进行监听**
    * - screenshare-stopped - 屏幕共享流被中止，此时事件中的 data 为 {@link LocalStream} 本地流
    * @example
    * ```js
    * localStream.on('screenshare-stopped', (event) => {
    *   client.unpublish(event.data);
    *   event.data.destroy();
    * });
    * ```
    */
  export type RtcStreamEventType = 'stream-added' | 'stream-removed' | 'stream-subscribed' | 'stream-published' | 'mute-audio' | 'unmute-audio' | 'mute-video' | 'unmute-video' | 'first-key-frame' | 'screenshare-stopped';
  /**
    * Rtc 客户端连接事件类型：
    *
    * {@link RtcConnectionEvent 连接事件}
    * - connection-state-changed - 连接状态改变
    * @example
    * ```js
    * client.on('connection-state-changed', (event) => {
    *   console.log(`连接状态：${event.data.previous} => ${event.data.current}`);
    * });
    * ```
    */
  export type RtcConnectionEventType = 'connection-state-changed';
  /**
    * Rtc 事件类型
    */
  export type RtcEventType = RtcUserEventType | RtcStreamEventType | RtcConnectionEventType;
  /**
    * Rtc 事件
    *
    * 当 type - T 为 {@link RtcUserEventType} 事件时，data - S 为 {@link User} 类型
    * 当 type - T 为 {@link RtcStreamEventType} 事件时，data - S 为 {@link LocalStream} | {@link RemoteStream} 类型
    * 当 type - T 为 {@link RtcConnectionEventType } 事件时，data - S 为 {@link ConnectionStates } 类型
    */
  export interface RtcEvent<T, S> {
      type: T;
      data: S;
  }
  /**
    * Rtc 用户事件，事件类型参见 {@link RtcUserEventType}
    */
  export type RtcUserEvent = RtcEvent<RtcUserEventType, User>;
  /**
    * Rtc 流事件，事件类型参见 {@link RtcStreamEventType}
    */
  export type RtcStreamEvent = RtcEvent<RtcStreamEventType, Stream | LocalStream | RemoteStream>;
  /**
    * Rtc 连接事件，事件类型参见 {@link RtcConnectionEventType}
    */
  export type RtcConnectionEvent = RtcEvent<RtcConnectionEventType, ConnectionStates>;
}

declare module '__@urtc/sdk-web/error' {
  export * from '__@urtc/sdk-web/error/codes';
  /**
    * RTC 错误 类型
    *
    * 通用错误及代码
    * - 1000 - 非法参数
    * - 1001 - 非法操作
    * - 1002 - 不支持
    * - 1003 - 不存在
    * - 1004 - 请求失败
    * - 1999 - 其他错误
    *
    * 房间相关错误及代码
    * - 2000 - 网关不可达
    * - 2001 - 获取 Access Token 失败
    * - 2002 - Access Token 非法
    * - 2003 - Websocket 连接失败
    * - 2004 - 加入房间失败
    * - 2005 - 未加入房间
    * - 2006 - 正在加入房间
    * - 2007 - 正在离开房间,
    * - 2008 - 角色类型不匹配
    * - 2009 - 信令服务器地址错误
    *
    * 流相关错误及代码
    * - 3000 - 流不存在
    * - 3001 - 同类型的流已存在
    * - 3002 - 音频不存在
    * - 3003 - 视频不存在
    * - 3004 - [中止错误] 尽管用户和操作系统都授予了访问设备硬件的权利，而且未出现可能抛出NotReadableError异常的硬件问题，但仍然有一些问题的出现导致了设备无法被使用。
    * - 3005 - [拒绝错误] 用户拒绝了当前的浏览器实例的访问请求；或者用户拒绝了当前会话的访问；或者用户在全局范围内拒绝了所有媒体访问请求。
    * - 3006 - [找不到错误] 找不到满足请求参数的媒体类型。
    * - 3007 - [无法读取错误] 尽管用户已经授权使用相应的设备，操作系统上某个硬件、浏览器或者网页层面发生的错误导致设备无法被访问。
    * - 3008 - [无法满足要求错误] 指定的要求无法被设备满足。
    * - 3009 - 流连接失败
    * - 3010 - 流正在重连
    * - 3011 - 流尚未发布
    * - 3012 - 流正在发布
    * - 3013 - 流正在取消发布
    * - 3014 - 流已经发布
    * - 3015 - 流尚未订阅
    * - 3016 - 流正在订阅
    * - 3017 - 流正在取消订阅
    * - 3018 - 流已经订阅
    */
  export class RtcError extends Error {
    constructor(code: number, message: string);
    getCode(): string;
    toString(): string;
  }
}

declare module '__@urtc/sdk-web/user/user' {
  /**
    * 用户
    */
  export class User {
      /**
        * 用户ID
        */
      id: string;
  }
}

declare module '__@urtc/sdk-web/stream/types' {
  /**
    * 音频编解码格式
    */
  export type AudioCodec = 'opus';
  /**
    * 视频编解码格式
    */
  export type VideoCodec = 'vp8' | 'h264';
  /**
    * 流的音频的统计数据
    * @public
    */
  export interface AudioStats {
      /**
        * 音频码率
        */
      bitrate: number;
      /**
        * 音频丢包率
        */
      packetLossRate: number;
      /**
        * 音频音量
        */
      volume: number;
      /**
        * 音频编码格式
        */
      codec: AudioCodec;
  }
  /**
    * 流的视频的统计数据
    */
  export interface VideoStats {
      /**
        * 视频码率
        */
      bitrate: number;
      /**
        * 视频丢包率
        */
      packetLossRate: number;
      /**
        * 视频帧率
        */
      framerate: number;
      /**
        * 视频宽
        */
      width: number;
      /**
        * 视频高
        */
      height: number;
      /**
        * 视频编码格式
        */
      codec: VideoCodec;
  }
  /**
    * 流的网络连接统计数据
    */
  export interface NetworkStats {
      /**
        * 网络往返时间
        */
      rtt: number;
  }
  /**
    * 已发布/已订阅流的统计数据
    */
  export interface StreamStats {
      /**
        * 流包含音频时，音频统计数据
        */
      audio?: AudioStats;
      /**
        * 流包含视频时，视频统计数据
        */
      video?: VideoStats;
      /**
        * 流的网络连接统计数据
        */
      network?: NetworkStats;
  }
  /**
    * 流的媒体类型, main - 主视频流，auxiliary - 辅助视频流，通常是一个屏幕分享流
    */
  export type MediaType = 'main' | 'auxiliary';
  /**
    * 切换设备的类型
    */
  export type SwitchDeviceType = 'audio' | 'video';
}

declare module '__@urtc/sdk-web/stream/stream' {
  import { EventEmitter } from '__@urtc/sdk-web/event-emitter';
  import { PlayOptions } from '__@urtc/sdk-web/types';
  import { MediaType, StreamStats } from '__@urtc/sdk-web/stream/types';
  /**
    * @public
    */
  export interface StreamPlugin {
      name: string;
      init(stream: Stream): void;
  }
  /**
    * @public
    */
  export class Stream extends EventEmitter {
      /**
        * 加载某个插件，使用插件功能
        * @param plugins - 插件
        */
      static use(...plugins: StreamPlugin[]): void;
      /**
        * 当前流ID
        */
      id: string;
      /**
        * 当前流包含的媒体流，关于媒体流，请详见 [MediaStream](https://developer.mozilla.org/en-US/docs/Web/API/MediaStream)。
        */
      readonly mediaStream: MediaStream;
      /**
        * 获取流的媒体类型
        * @example
        * ```js
        * const type = stream.getMediaType();
        * ```
        */
      getMediaType(): MediaType;
      /**
        * 当前流是否 mute 了音频
        */
      audioMuted: boolean;
      /**
        * 当前流是否 mute 了视频
        */
      videoMuted: boolean;
      /**
        * 判断当前流是否有音频
        * @example
        * ```js
        * const result = stream.hasAudio();
        * ```
        */
      hasAudio(): boolean;
      /**
        * 判断当前流是否有视频
        * @example
        * ```js
        * const result = stream.hasVideo();
        * ```
        */
      hasVideo(): boolean;
      /**
        * mute 当前流的音频
        * * 本地流调用此方法时，远端用户将收到 `mute-audio` 的事件通知，流的 audioMuted 状态也将改变
        * * 远端流调用此方法时，仅为不从服务器拉取音频数据，并无事件通知用户，且不改变流的 audioMuted 状态
        * @example
        * ```js
        * const result = stream.muteAudio();
        * ```
        */
      muteAudio(): boolean;
      /**
        * unmute 当前流的音频
        * * 本地流调用此方法时，远端用户将收到 `unmute-audio` 的事件通知，流的 audioMuted 状态也将改变
        * * 远端流调用此方法时，会从服务器拉取音频数据，并无事件通知用户，且不改变流的 audioMuted 状态
        * @example
        * ```js
        * const result = stream.unmuteAudio();
        * ```
        */
      unmuteAudio(): boolean;
      /**
        * mute 当前流的视频
        * * 本地流调用此方法时，远端用户将收到 `mute-video` 的事件通知，流的 videoMuted 状态也将改变
        * * 远端流调用此方法时，仅为不从服务器拉取视频数据，并无事件通知用户，且不改变流的 videoMuted 状态
        * @example
        * ```js
        * const result = stream.muteVideo();
        * ```
        */
      muteVideo(): boolean;
      /**
        * unmute 当前流的视频
        * * 本地流调用此方法时，远端用户将收到 `unmute-video` 的事件通知，流的 videoMuted 状态也将改变
        * * 远端流调用此方法时，会从服务器拉取视频数据，并无事件通知用户，且不改变流的 videoMuted 状态
        * @example
        * ```js
        * const result = stream.unmuteVideo();
        * ```
        */
      unmuteVideo(): boolean;
      /**
        * 播放当前流
        * @param container - 播放音视频时，包裹 video 标签所用的容器元素或容器元素的 ID
        * @param opts - 其他播放参数，参见{@link PlayOptions}
        * @example
        * ```js
        * const container = 'xxx'; // 比如 id 为 xxx 的 div 元素
        * stream
        *   .play(container)
        *   .catch((err) => {
        *     console.log(`播放失败: ${err}`); // 一般由于浏览器对自动播放的限制导致播放失败
        *   });
        * ```
        * @reject {@link RtcError}
        */
      play(container: HTMLElement | string, opts?: PlayOptions): Promise<void>;
      /**
        * 恢复播放流，一般由于浏览器限制无法自动播放时，可提示用户手动触发该方法进行恢复播放
        * @example
        * ```js
        * stream
        *   .resume()
        *   .catch((err) => {
        *     console.log(`恢复播放失败：${err}`);
        *   });
        * ```
        */
      resume(): Promise<void>;
      /**
        * 停止播放当前流
        * @example
        * ```js
        * stream.stop();
        * ```
        */
      stop(): void;
      /**
        * 获取当前流的音量大小，只有当本地流或远端流中有音频数据才有效。
        * @example
        * ```js
        * setInterval(() => {
        *   const level = stream.getAudioLevel();
        *   if (level > 0) {
        *     console.log(`user ${stream.userId} is speaking`);
        *   }
        * }, 200);
        * ```
        */
      getAudioLevel(): number;
      /**
        * 销毁当前流，一般在本地流不再被使用时，可调用此方法销毁，解除摄像头或麦克风设备的占用。
        * > 注：远端流，不需要手动调用此方法
        * @example
        * ```js
        * stream.destroy();
        * ```
        */
      destroy(): void;
      /**
        * 获取流发布或订阅后的统计数据
        * @example
        * ```js
        * stream
        *   .getStats()
        *   .then((stats) => {
        *     console.log('当前流的统计数据为: ', stats);
        *   });
        * ```
        */
      getStats(): Promise<StreamStats>;
  }
}

declare module '__@urtc/sdk-web/stream/remote-stream' {
  import { Stream } from '__@urtc/sdk-web/stream/stream';
  /**
    * @public
    */
  export class RemoteStream extends Stream {
      /**
        * 该流所属用户的ID
        */
      userId: string;
      /**
        * 设置输出音量，默认为 100
        * @param volume - 音量大小, 可设范围[0-100]
        * @throws RtcError
        * @example
        * ```js
        * stream.setAudioVolume(50);
        * ```
        */
      setAudioVolume(volume: number): void;
  }
}

declare module '__@urtc/sdk-web/server' {
  /**
    * 服务器配置，可设置置网关（gateway）、信令（signal）、日志（log）服务器地址
    * > 注：
    * > 1. gateway 和 signal 须二选一进行设置
    * > 2. 没有日志服务器时，log 可不设
    */
  export interface ServerConfig {
      /**
        * 网关地址，如 'https://urtc.com.cn'
        */
      gateway?: string;
      /**
        * 信令服务器地址，如 'wss://urtc.com.cn:5005'
        */
      signal?: string;
      /**
        * 日志服务器地址，如 'https://log.urtc.com.cn'
        */
      log?: string;
  }
  /**
    * 用于私有化部署时，指定部署的服务器地址
    * @param conf - 服务器配置，具体描述参见 ServerConfig 的说明
    * @example
    * ```js
    * setServers({
    *  gateway: 'https://private-rtc.com', // 指定网关
    *  log: 'https://log.private-rtc.com', // 指定日志服务器
    * });
    * ```
    *
    * **特别地，单信令服务器时，不需要网关进行分配信令服务器，可以直接指定信令服务器**
    * ```js
    * setServers({
    *  signal: 'wss://private-rtc.com:5005', // 直接指定信令服务器
    *  log: 'https://log.private-rtc.com', // 指定日志服务器
    * });
    * ```
    * @throws {@link RtcError}
    */
  export function setServers(conf: ServerConfig): void;
}

declare module '__@urtc/sdk-web/version' {
  /**
    * 当前 sdk 的版本
    */
  export const version: string;
}

declare module '__@urtc/sdk-web/event-emitter' {
  import { RtcEventType, RtcUserEventType, RtcUserEvent, RtcStreamEvent, RtcConnectionEventType, RtcConnectionEvent, RtcStreamEventType } from '__@urtc/sdk-web/event';
  /**
    * 事件监听函数
    * 其中 T 为 RtcEvent 泛型
    * @private
    */
  export type RtcEventInstance<T> = T extends RtcUserEventType ? RtcUserEvent : T extends RtcStreamEventType ? RtcStreamEvent : T extends RtcConnectionEventType ? RtcConnectionEvent : never;
  /**
    * 事件监听函数
    * 其中 RtcEventInstance 为事件实例
    * > 注：使用 typescript 时，会根据 T {@link RtcEventType} 类型自动推断 {@link RtcEvent} 的类型。
    */
  export interface Listener<T> {
      (event: RtcEventInstance<T>): void;
  }
  /**
    * @private
    */
  export class EventEmitter {
      /**
        * 监听流对象事件
        * @param type - 流事件类型
        * @param listener - 流事件监听函数
        */
      on<T extends RtcEventType>(type: T, listener: Listener<T>): EventEmitter;
      /**
        * 取消监听流对象事件
        * @param type - 流对象事件类型，特别的，当为 '*' 时，取消监听所有事件
        * @param listener - 流对象事件监听函数
        */
      off<T extends RtcEventType | '*'>(type: T, listener: Listener<T>): EventEmitter;
  }
}

declare module '__@urtc/sdk-web/stream/profile' {
  /**
    * 预设的视频 Profile
    *
    * 名称 | 视频宽 | 视频高 | 帧率 (fps) | 码率 (kbps)
    * :-: | :-: | :-: | :-: | :-:
    * 180p | 240 | 180 | 15 | 200
    * 180p_2 | 320 | 180 | 15 | 300
    * 240p | 320 | 240 | 15 | 400
    * 360p | 480 | 360 | 15 | 400
    * 360p_2 | 640 | 360 | 15 | 500
    * 480p | 640 | 480 | 15 | 600
    * 720p | 1280 | 720 | 15 | 1000
    * 720p_2 | 1280 | 720 | 15 | 1500
    * 720p_3 | 1280 | 720 | 30 | 2000
    * 1080p | 1920 | 1080 | 15 | 1500
    * 1080p_2 | 1920 | 1080 | 15 | 2000
    * 1080p_3 | 1920 | 1080 | 30 | 2500
    */
  export type VideoProfile = '180p' | '180p_2' | '240p' | '360p' | '360p_2' | '480p' | '720p' | '720p_2' | '720p_3' | '1080p' | '1080p_2' | '1080p_3';
  /**
    * 预设的屏幕共享视频 Profile
    *
    * 名称 | 视频宽 | 视频高 | 帧率 (fps) | 码率 (kbps)
    * :-: | :-: | :-: | :-: | :-:
    * 480p | 640 | 480 | 5 | 600
    * 480p_2 | 640 | 480 | 30 | 1000
    * 720p | 1280 | 720 | 5 | 1000
    * 720p_2 | 1280 | 720 | 30 | 2000
    * 1080p | 1920 | 1080 | 5 | 1500
    * 1080p_2 | 1920 | 1080 | 30 | 2500
    */
  export type ScreenProfile = '480p' | '480p_2' | '720p' | '720p_2' | '1080p' | '1080p_2';
  /**
    * 自定义视频 Profile，请根据实际使用场景及网络环境，合理的设置
    * @example
    * ```js
    * { width: 640, height: 480, framerate: 15, bitrate: 500 }
    * ```
    */
  export interface CustomVideoProfile {
      /**
        * 视频宽，如：640
        */
      width: number;
      /**
        * 视频高，如：480
        */
      height: number;
      /**
        * 帧率 (fps)，如：15
        */
      framerate: number;
      /**
        * 码率 (kbps)，如：500
        */
      bitrate: number;
  }
}

declare module '__@urtc/sdk-web/connection/types' {
  /**
    * 连接状态类型：
    * - OPEN - 已连接
    * - CONNECTING - 连接中
    * - CLOSING - 断开中
    * - RECONNECTING- 开始重连
    * - CLOSED - 已断开
    */
  export type ConnectionState = 'OPEN' | 'CONNECTING' | 'CLOSING' | 'RECONNECTING' | 'CLOSED';
  /**
    * 客户端（Client）与服务器之间的{@link ConnectionState 连接状态}
    */
  export interface ConnectionStates {
      current: ConnectionState;
      previous: ConnectionState;
  }
}

declare module '__@urtc/sdk-web/' {
  import { Client } from '__@urtc/sdk-web/client';
  import { LocalStream, LocalStreamOptions } from '__@urtc/sdk-web/stream/local-stream';
  import { generateToken } from '__@urtc/sdk-web/utils/token';
  import { ClientOptions } from '__@urtc/sdk-web/types';
  import { LogLevel } from '__@urtc/sdk-web/logger';
  /**
    * 创建客户端
    * @param appId - 应用 ID，可在控制台查看
    * @param opts - 定义客户端的属性
    * @example
    * ```js
    * const client = createClient('AppID');
    * client
    *   .join('roomId', 'userId', 'token')
    *   .then(() => {
    *     client.publish(localStream);
    *   })
    *   .catch((err) => {
    *     console.log(`加入房间失败 ${err}`);
    *   });
    * ```
    * @throws {@link RtcError}
    */
  export function createClient(appId: string, opts?: ClientOptions): Client;
  /**
    * 创建并返回本地音视频流对象
    * @param opts - 定义本地音视频流的属性
    * > 注：
    * > 1. video, screen 不可同时为 true
    * > 2. audio, video, screen 不可同时为 false
    * > 3. 若指定了 file，则 init 时将优先使用 file 来创建初始化本地流的视频
    * > 4. screenAudio 在不同浏览器上表现不同，参见 {@link LocalStreamOptions}
    * @example
    * ```js
    * const localStream = createStream({ audio: true, video: true, screen: false });
    * localStream
    *   .init()
    *   .then(() => {
    *     localStream
    *       .play(container)
    *       .catch((err) => {console.log(`播放失败: ${err}`)});
    *   })
    *   .catch((err) => {
    *     console.log(`本地流初始化失败 ${err}`);
    *   });
    * ```
    * @throws {@link RtcError}
    */
  export function createStream(opts: LocalStreamOptions): LocalStream;
  /**
    * 设置日志打印级别
    * @param level - 日志级别，有 'debug', 'info', 'warn', 'error' 级别;
    * @example
    * ```js
    * setLogLevel('info');
    * ```
    */
  export function setLogLevel(level: LogLevel): void;
  /**
    * 上报操作/错误/状态日志，未调用时，默认开启上报日志
    * @param enable - 是否开启上报
    * @example
    * ```js
    * reportLog(false); // 关闭日志上报，关闭后，在线上出现错误时，将无法根据日志进行排查
    * ```
    */
  export function reportLog(enable: boolean): void;
  export { generateToken };
  export * from '__@urtc/sdk-web/devices';
  export * from '__@urtc/sdk-web/client';
  export * from '__@urtc/sdk-web/types';
  export * from '__@urtc/sdk-web/event';
  export * from '__@urtc/sdk-web/error';
  export * from '__@urtc/sdk-web/user/user';
  export * from '__@urtc/sdk-web/stream/types';
  export * from '__@urtc/sdk-web/stream/stream';
  export * from '__@urtc/sdk-web/stream/local-stream';
  export * from '__@urtc/sdk-web/stream/remote-stream';
  export * from '__@urtc/sdk-web/server';
  export * from '__@urtc/sdk-web/version';
  /************** 4 plugin ****************/
  export { LocalStream };
  export { RemoteStream } from '__@urtc/sdk-web/stream/remote-stream';
}

declare module '__@urtc/sdk-web/error/codes' {
  export {};
}