larksr_websdk 3.2.333 → 3.2.336

package/dist/types/appli_params.d.ts

@@ -200,6 +200,7 @@ export interface IAppliParams {
     videoInput: boolean;
     videoInputAutoStart: boolean;
     liveStreaming: boolean;
+    useSeparateMediaSharePeer: boolean;
 }
 export declare enum AppliType {
     DESKTOP = 1,
@@ -266,6 +267,7 @@ export declare class AppliParams implements IAppliParams {
     videoInput: boolean;
     videoInputAutoStart: boolean;
     liveStreaming: boolean;
+    useSeparateMediaSharePeer: boolean;
     static copyAndCreate(params?: IAppliParams): AppliParams;
     static setUpWithSDKConfig(params: IAppliParams, config: ILarkSRConfig): AppliParams;
 }

package/dist/types/lark/application.d.ts

@@ -1,7 +1,6 @@
 import { EventBase, LocalEvent } from '../event/event_base';
 import * as Msg from '../protobuf/cloudlark';
 import WebSocektChannel from './websocket_channel';
-import { RTCMediaTrackBinding } from './peer_connection';
 import WebsocketProxy from './websocket_proxy';
 import { LarkSR } from '../larksr';
 import PixelStreamingWebsocketChannel from './test_pixel_streaming';
@@ -56,19 +55,18 @@ export default class Application extends EventBase<APP_EVENT_TYPE, AppEvent> {
     private websocketProxy;
     private testPixelStreaming;
     private peerConnection;
-    private sharePeerConnection;
+    private mediaSharePeerConnectionImp;
     get peerConnectionCreated(): boolean;
     get state(): APP_STATE;
     set state(state: APP_STATE);
     private _state;
-    get audioDeviceId(): string | undefined;
-    get audioTrack(): MediaStreamTrack | {
-        enabled: boolean;
-    } | undefined;
-    get videoDeviceId(): string | undefined;
-    get videoTrack(): MediaStreamTrack | {
-        enabled: boolean;
-    } | undefined;
+    get audioDeviceId(): string | null | undefined;
+    get audioTrack(): MediaStreamTrack | null | undefined;
+    get videoDeviceId(): string | null | undefined;
+    get videoTrack(): MediaStreamTrack | null | undefined;
+    get audioPaused(): boolean | undefined;
+    get videoPaused(): boolean | undefined;
+    private get sharePeerConnection();
     private retryTime;
     private larksr;
     get voiceId(): number;
@@ -133,44 +131,33 @@ export default class Application extends EventBase<APP_EVENT_TYPE, AppEvent> {
     private onShareMediaInfo;
     private onShareMediaOffer;
     private onShareMediaIce;
-    setAudioEnable(enable: boolean): void | undefined;
-    setVideoEnable(enable: boolean): void | undefined;
-    setShareEnable(enable: boolean): void | undefined;
-    closeAudio(): void | undefined;
-    closeVideo(): void | undefined;
-    closeShare(): void | undefined;
-    openAudio(deviceId?: string): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: RTCMediaTrackBinding[];
-    } | undefined>;
-    openVideo(audio?: boolean, cameraId?: string, width?: number, height?: number): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: RTCMediaTrackBinding[];
-    } | undefined>;
-    openDefaultMedia(video?: boolean, audio?: boolean): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: RTCMediaTrackBinding[];
-    } | undefined>;
-    openShareMediaDevice(): Promise<void | undefined>;
-    getConnectedAudioinputDevices(): Promise<MediaDeviceInfo[] | undefined>;
-    getConnectedAudioOutputDevices(): Promise<MediaDeviceInfo[] | undefined>;
-    getConnectedVideoinputDevices(): Promise<MediaDeviceInfo[] | undefined>;
-    getConnectedDevices(type: MediaDeviceKind): Promise<MediaDeviceInfo[] | undefined>;
-    openAudioDevice(deviceId: string, kind?: "audioinput" | "audiooutput"): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: RTCMediaTrackBinding[];
-    } | undefined>;
-    openCamera(cameraId: string, minWidth?: number, minHeight?: number): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: RTCMediaTrackBinding[];
-    } | undefined>;
-    openUserMeida(constraints?: MediaStreamConstraints, reset?: boolean): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: RTCMediaTrackBinding[];
-    } | undefined>;
+    setAudioEnable(enable: boolean): any;
+    setVideoEnable(enable: boolean): any;
+    setShareEnable(enable: boolean): any;
+    stopLocalAudio(): any;
+    stopLocalVideo(): any;
+    stopLocalShare(): any;
+    pauseAudioSending(): any;
+    resumeAudioSending(): any;
+    pauseVideoSending(): any;
+    resumeVideoSending(): any;
+    closeAudio(): any;
+    closeVideo(): any;
+    closeShare(): any;
+    openAudio(deviceId?: string): Promise<any>;
+    openVideo(audio?: boolean, cameraId?: string, width?: number, height?: number): Promise<any>;
+    openDefaultMedia(video?: boolean, audio?: boolean): Promise<any>;
+    openShareMediaDevice(): Promise<any>;
+    getConnectedAudioinputDevices(): Promise<any>;
+    getConnectedAudioOutputDevices(): Promise<any>;
+    getConnectedVideoinputDevices(): Promise<any>;
+    getConnectedDevices(type: MediaDeviceKind): Promise<any>;
+    openAudioDevice(deviceId: string, kind?: "audioinput" | "audiooutput"): Promise<any>;
+    openCamera(cameraId: string, minWidth?: number, minHeight?: number): Promise<any>;
+    openUserMeida(constraints?: MediaStreamConstraints, reset?: boolean): Promise<any>;
     addMediaTrack(track: MediaStreamTrack, ...streams: MediaStream[]): boolean | undefined;
-    removeMediaTrack(track: RTCRtpSender): boolean | undefined;
-    requestUserMediaPermission(constraints?: MediaStreamConstraints): Promise<MediaStream> | undefined;
+    removeMediaTrack(track: RTCRtpSender): any;
+    requestUserMediaPermission(constraints?: MediaStreamConstraints): any;
     StartCloudLiveStreaming(params: Msg.CloudLark.IRtmp_Start): Promise<void> | undefined;
     StopLiveStreaming(): void | undefined;
     private onPeerConnectionDisconnect;

package/dist/types/lark/media_share_interface.d.ts

@@ -0,0 +1,46 @@
+export interface RTCMediaTrackBinding {
+    deviceId: string;
+    track: MediaStreamTrack;
+    sender: RTCRtpSender | undefined;
+}
+export interface RTCShareMediaTrackBinding {
+    deviceId: string;
+    track: MediaStreamTrack;
+    transceiver: RTCRtpTransceiver | undefined;
+    paused: boolean;
+}
+export interface MediaShareInterface {
+    audioDeviceId: string | undefined | null;
+    audioTrack: MediaStreamTrack | undefined | null;
+    videoDeviceId: string | undefined | null;
+    videoTrack: MediaStreamTrack | undefined | null;
+    audioPaused: boolean;
+    videoPaused: boolean;
+    setAudioEnable(enable: boolean): any;
+    setVideoEnable(enable: boolean): any;
+    setShareEnable(enable: boolean): any;
+    stopLocalAudio(): any;
+    stopLocalVideo(): any;
+    stopLocalShare(): any;
+    pauseAudioSending(): any;
+    resumeAudioSending(): any;
+    pauseVideoSending(): any;
+    resumeVideoSending(): any;
+    closeAudio(): any;
+    closeVideo(): any;
+    closeShare(): any;
+    openAudio(deviceId: string): Promise<any>;
+    openVideo(audio: boolean, cameraId: string, width: number, height: number): Promise<any>;
+    openDefaultMedia(video: boolean, audio: boolean): Promise<any>;
+    openShareMediaDevice(): Promise<any>;
+    getConnectedAudioinputDevices(): Promise<any>;
+    getConnectedAudioOutputDevices(): Promise<any>;
+    getConnectedVideoinputDevices(): Promise<any>;
+    getConnectedDevices(type: MediaDeviceKind): Promise<any>;
+    openAudioDevice(deviceId: string, kind: "audioinput" | "audiooutput"): Promise<any>;
+    openCamera(cameraId: string, minWidth: number, minHeight: number): Promise<any>;
+    openUserMeida(constraints?: MediaStreamConstraints, reset?: boolean): Promise<any>;
+    addMediaTrack(track: MediaStreamTrack, ...streams: MediaStream[]): boolean;
+    removeMediaTrack(track: RTCRtpSender): any;
+    requestUserMediaPermission(constraints?: MediaStreamConstraints): any;
+}

package/dist/types/lark/peer_connection.d.ts

@@ -1,6 +1,7 @@
 import { EventBase, LocalEvent } from '../event/event_base';
 import * as Input from '../protobuf/cloudlark';
 import { LarkSR } from '../larksr';
+import { MediaShareInterface, RTCMediaTrackBinding } from './media_share_interface';
 export declare enum IceState {
     DISCONNECT = 1,
     BAD = 2,
@@ -80,12 +81,7 @@ export interface AggregatedStats {
     currentRoundTripTime: number;
     packetsLostPerc: number;
 }
-export interface RTCMediaTrackBinding {
-    deviceId: string;
-    track: MediaStreamTrack;
-    sender: RTCRtpSender | undefined;
-}
-export default class PeerConnection extends EventBase<WEBRTC_EVENT_TYPE, WebRTCEvent> {
+export default class PeerConnection extends EventBase<WEBRTC_EVENT_TYPE, WebRTCEvent> implements MediaShareInterface {
     private config;
     private pc;
     private dataChannel;
@@ -103,9 +99,11 @@ export default class PeerConnection extends EventBase<WEBRTC_EVENT_TYPE, WebRTCE
     get audioTrack(): MediaStreamTrack | undefined;
     get videoDeviceId(): string | undefined;
     get videoTrack(): MediaStreamTrack | undefined;
-    private localAudioTrackBinding;
-    private localVideoTrackBinding;
-    private localShareTrackBinding;
+    get audioPaused(): boolean;
+    get videoPaused(): boolean;
+    private audioBinding;
+    private videoBinding;
+    private readonly sendStream;
     private sdpCreateSuccess;
     constructor(larksr: LarkSR, config: WebRTCConfig);
     create(streams?: MediaStream | undefined | null): Promise<void>;
@@ -114,19 +112,29 @@ export default class PeerConnection extends EventBase<WEBRTC_EVENT_TYPE, WebRTCE
     setAudioEnable(enable: boolean): void;
     setVideoEnable(enable: boolean): void;
     setShareEnable(enable: boolean): void;
-    closeAudio(): boolean;
-    closeVideo(): boolean;
-    closeShare(): boolean;
+    stopLocalAudio(): void;
+    stopLocalVideo(): void;
+    stopLocalShare(): void;
+    pauseAudioSending(): false | undefined;
+    resumeAudioSending(): false | undefined;
+    pauseVideoSending(): false | undefined;
+    resumeVideoSending(): false | undefined;
+    closeAudio(): false | undefined;
+    closeVideo(): false | undefined;
+    closeShare(): false | undefined;
     private stopLocalTrackBing;
     openAudio(deviceId?: string): Promise<{
         streams: MediaStream;
         rtcRtpSenders: RTCMediaTrackBinding[];
     }>;
-    openVideo(audio?: boolean, cameraId?: string): Promise<{
+    openVideo(audio?: boolean, cameraId?: string, width?: number, height?: number): Promise<{
+        streams: MediaStream;
+        rtcRtpSenders: RTCMediaTrackBinding[];
+    }>;
+    openDefaultMedia(video?: boolean, audio?: boolean): Promise<{
         streams: MediaStream;
         rtcRtpSenders: RTCMediaTrackBinding[];
     }>;
-    openDefaultMedia(video?: boolean, audio?: boolean): Promise<void>;
     openShareMediaDevice(): Promise<void>;
     getConnectedAudioinputDevices(): Promise<MediaDeviceInfo[]>;
     getConnectedAudioOutputDevices(): Promise<MediaDeviceInfo[]>;
@@ -136,14 +144,15 @@ export default class PeerConnection extends EventBase<WEBRTC_EVENT_TYPE, WebRTCE
         streams: MediaStream;
         rtcRtpSenders: RTCMediaTrackBinding[];
     }>;
-    openCamera(cameraId: string, minWidth?: number, minHeight?: number): Promise<{
+    openCamera(cameraId: string, width?: number, height?: number, audio?: boolean): Promise<{
         streams: MediaStream;
         rtcRtpSenders: RTCMediaTrackBinding[];
     }>;
-    openUserMeida(constraints?: MediaStreamConstraints): Promise<{
+    openUserMeida(constraints?: MediaStreamConstraints, reset?: boolean): Promise<{
         streams: MediaStream;
         rtcRtpSenders: RTCMediaTrackBinding[];
     }>;
+    private resumeOrCreateBinding;
     addMediaTrack(track: MediaStreamTrack, ...streams: MediaStream[]): boolean;
     removeMediaTrack(track: RTCRtpSender): boolean;
     requestUserMediaPermission(constraints?: MediaStreamConstraints): Promise<MediaStream>;

package/dist/types/lark/peer_connection_media_share.d.ts

@@ -1,6 +1,6 @@
 import { EventBase, LocalEvent } from '../event/event_base';
 import { LarkSR } from '../larksr';
-import { RTCMediaTrackBinding } from './peer_connection';
+import { MediaShareInterface, RTCMediaTrackBinding } from './media_share_interface';
 export declare enum WEBRTC_MEDIA_SHARE_EVENT_TYPE {
     RTC_SDP = 0,
     RTC_ICECANDIDATE = 1,
@@ -15,21 +15,20 @@ export interface WebRTCConfig {
     serverIP: string;
     preferPubOutIp: string;
 }
-export default class PeerConnectionMediaShare extends EventBase<WEBRTC_MEDIA_SHARE_EVENT_TYPE, WebRTCMediaShareEvent> {
+export default class PeerConnectionMediaShare extends EventBase<WEBRTC_MEDIA_SHARE_EVENT_TYPE, WebRTCMediaShareEvent> implements MediaShareInterface {
     get audioDeviceId(): string | undefined;
-    get audioTrack(): MediaStreamTrack | {
-        enabled: boolean;
-    };
+    get audioTrack(): MediaStreamTrack | undefined;
     get videoDeviceId(): string | undefined;
-    get videoTrack(): MediaStreamTrack | {
-        enabled: boolean;
-    };
+    get videoTrack(): MediaStreamTrack | undefined;
+    get audioPaused(): boolean;
+    get videoPaused(): boolean;
     private larksr;
     private offerOptions;
     private pcConfig;
     private pc;
     private audioBinding;
     private videoBinding;
+    private readonly sendStream;
     constructor(larksr: LarkSR);
     create(): Promise<void>;
     createOffer(): void;
@@ -37,9 +36,16 @@ export default class PeerConnectionMediaShare extends EventBase<WEBRTC_MEDIA_SHA
     setAudioEnable(enable: boolean): void;
     setVideoEnable(enable: boolean): void;
     setShareEnable(enable: boolean): void;
-    closeAudio(): void;
-    closeVideo(): void;
-    closeShare(): void;
+    stopLocalAudio(): void;
+    stopLocalVideo(): void;
+    stopLocalShare(): void;
+    pauseAudioSending(): false | undefined;
+    resumeAudioSending(): false | undefined;
+    pauseVideoSending(): false | undefined;
+    resumeVideoSending(): false | undefined;
+    closeAudio(): false | undefined;
+    closeVideo(): false | undefined;
+    closeShare(): false | undefined;
     private stopLocalTrackBing;
     openAudio(deviceId?: string): Promise<{
         streams: MediaStream;
@@ -70,6 +76,7 @@ export default class PeerConnectionMediaShare extends EventBase<WEBRTC_MEDIA_SHA
         streams: MediaStream;
         rtcRtpSenders: RTCMediaTrackBinding[];
     }>;
+    private resumeOrCreateBinding;
     addMediaTrack(track: MediaStreamTrack, ...streams: MediaStream[]): boolean;
     removeMediaTrack(track: RTCRtpSender): boolean;
     requestUserMediaPermission(constraints?: MediaStreamConstraints): Promise<MediaStream>;

package/dist/types/larksr.d.ts

@@ -466,6 +466,11 @@ interface ILarkSRConfig {
      * 默认 20S
      */
     playTimeout?: number;
+    /**
+     * 是否使用新版摄像头/麦克风协议
+     * 单独上传流程要求渲染服务器版本大于3290）
+     */
+    useSeparateMediaSharePeer?: boolean;
 }
 declare class LarkSR extends EventBase<LarkSRClientEvent, LarkSREvent> {
     /**
@@ -563,6 +568,16 @@ declare class LarkSR extends EventBase<LarkSRClientEvent, LarkSREvent> {
      */
     set isEnableTouchPonit(enable: boolean);
     set isEnableTouchPoint(enable: boolean);
+    /**
+     * 设置是否使用canvas渲染画面。
+     * iOS/Mac下默认开启.在 iOS/Mac下关闭canvas渲染可能导致样式问题异常显示。
+     */
+    set enableCanvasRender(enable: boolean);
+    /**
+     * 获取是否使用canvas渲染画面。
+     * iOS/Mac下默认开启.在 iOS/Mac下关闭canvas渲染可能导致样式问题异常显示。
+     */
+    get enableCanvasRender(): boolean;
     /**
      * 虚拟鼠标的当前位置,相对于整体容器
      */
@@ -611,23 +626,27 @@ declare class LarkSR extends EventBase<LarkSRClientEvent, LarkSREvent> {
     /**
      * 当前打开的音频设备 ID，如果打开时没指定为空
      */
-    get audioDeviceId(): string | undefined;
+    get audioDeviceId(): string | null | undefined;
     /**
      * 当前打开音频的track对象，未打开状态为空
      */
-    get audioTrack(): MediaStreamTrack | {
-        enabled: boolean;
-    } | undefined;
+    get audioTrack(): MediaStreamTrack | null | undefined;
     /**
      * 当前打开视频设备 ID，如果打开时没指定特设备id为空
      */
-    get videoDeviceId(): string | undefined;
+    get videoDeviceId(): string | null | undefined;
     /**
      * 当前打开视频track对象，未打开状态为空
      */
-    get videoTrack(): MediaStreamTrack | {
-        enabled: boolean;
-    } | undefined;
+    get videoTrack(): MediaStreamTrack | null | undefined;
+    /**
+     * 音频通道是否暂停
+     */
+    get audioPaused(): boolean | undefined;
+    /**
+     * 视频通道是否暂停
+     */
+    get videoPaused(): boolean | undefined;
     /**
      * LarkSR 客户端。所有操作和事件通过该类传递
      * @param config 本地配置，优先级最高
@@ -996,45 +1015,82 @@ declare class LarkSR extends EventBase<LarkSRClientEvent, LarkSREvent> {
      * @param enable 是否启用
      * @returns
      */
-    setAudioEnable(enable: boolean): void | undefined;
+    setAudioEnable(enable: boolean): any;
     /**
      * 设置当前已开启的视频track是否启用状态
      * @param enable 是否启用
      * @returns
      */
-    setVideoEnable(enable: boolean): void | undefined;
-    setShareEnable(enable: boolean): void | undefined;
+    setVideoEnable(enable: boolean): any;
+    setShareEnable(enable: boolean): any;
+    /**
+     * 停止本地音频轨道
+     * @returns
+     */
+    stopLocalAudio(): any;
+    /**
+     * 停止本地已打开的视频轨道
+     * @returns
+     */
+    stopLocalVideo(): any;
+    /**
+     * 停止本地共享轨道
+     * @returns
+     */
+    stopLocalShare(): any;
+    /**
+     * 暂停发送音频
+     * @returns
+     */
+    pauseAudioSending(): any;
+    /**
+     * 恢复发送音频
+     * @returns
+     */
+    resumeAudioSending(): any;
+    /**
+     * 暂停发送视频
+     * @returns
+     */
+    pauseVideoSending(): any;
+    /**
+     * 恢复发送视频
+     * @returns
+     */
+    resumeVideoSending(): any;
     /**
      * 关闭当前的音频设备
      * @returns
      */
-    closeAudio(): void | undefined;
-    closeVideo(): void | undefined;
-    closeShare(): void | undefined;
+    closeAudio(): any;
+    /**
+     * 关闭当前已打开的视频设备
+     * @returns
+     */
+    closeVideo(): any;
+    /**
+     * 关闭当前已打开的共享设备如共享的标签页等
+     * @returns
+     */
+    closeShare(): any;
+    /**
+     * 关闭整个媒体上传连接。再次使用时重新打开。
+     * @returns
+     */
     closeMediaChannel(): void;
     /**
      * 打开一个音频设备，要注意浏览器限制在 https 或者 localhost 下才能打开音频
      * @param deviceId 音频设备id，如果不传将打开默认设备。@see getConnectedAudioinputDevices
      * @returns Promise
      */
-    openAudio(deviceId?: string): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: import("./lark/peer_connection").RTCMediaTrackBinding[]; /**
-         * 应用参数，构建时传入
-         */
-    } | undefined>;
+    openAudio(deviceId?: string): Promise<any>;
     /**
      * 打开一个视频设备，要注意浏览器限制在 https 或者 localhost 下才能打开视频
      * @param audio boolean 是否同时开启音频
      * @param cameraId 视频设备id，如果不传将打开默认设备。@see getConnectedVideoinputDevices
      * @returns Promise
      */
-    openVideo(audio?: boolean, cameraId?: string, width?: number, height?: number): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: import("./lark/peer_connection").RTCMediaTrackBinding[]; /**
-         * 应用参数，构建时传入
-         */
-    } | undefined>;
+    openVideo(audio?: boolean, cameraId?: string, width?: number, height?: number): Promise<any>;
     /**
      * 打开默认媒体设备，要注意浏览器限制在 https 或者 localhost 下
      * 如果需要指定特殊的媒体设备请单独使用 @see openAudio @see openVideo
@@ -1042,46 +1098,74 @@ declare class LarkSR extends EventBase<LarkSRClientEvent, LarkSREvent> {
      * @param audio 是否包含音频
      * @returns Promise
      */
-    openDefaultMedia(video?: boolean, audio?: boolean): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: import("./lark/peer_connection").RTCMediaTrackBinding[]; /**
-         * 应用参数，构建时传入
-         */
-    } | undefined>;
-    openShareMediaDevice(): Promise<void | undefined>;
+    openDefaultMedia(video?: boolean, audio?: boolean): Promise<any>;
+    /**
+     * 打开共享设备，浏览器可共享窗口，标签页等
+     * @returns Promise
+     */
+    openShareMediaDevice(): Promise<any>;
     /**
      * 返回已连接的音频设备列表，设备列表中的设备的 deviceId 可用来打开某个音频设备
      * @returns Promise<MediaDeviceInfo[]>
      */
-    getConnectedAudioinputDevices(): Promise<MediaDeviceInfo[] | undefined>;
-    getConnectedAudioOutputDevices(): Promise<MediaDeviceInfo[] | undefined>;
+    getConnectedAudioinputDevices(): Promise<any>;
+    getConnectedAudioOutputDevices(): Promise<any>;
     /**
      * 返回已连接的视频设备
      * @returns Promise<MediaDeviceInfo[]>
      */
-    getConnectedVideoinputDevices(): Promise<MediaDeviceInfo[] | undefined>;
-    getConnectedDevices(type: MediaDeviceKind): Promise<MediaDeviceInfo[] | undefined>;
-    openAudioDevice(deviceId: string, kind?: "audioinput" | "audiooutput"): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: import("./lark/peer_connection").RTCMediaTrackBinding[]; /**
-         * 应用参数，构建时传入
-         */
-    } | undefined>;
-    openCamera(cameraId: string, minWidth?: number, minHeight?: number): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: import("./lark/peer_connection").RTCMediaTrackBinding[]; /**
-         * 应用参数，构建时传入
-         */
-    } | undefined>;
-    openUserMeida(constraints?: MediaStreamConstraints, reset?: boolean): Promise<{
-        streams: MediaStream;
-        rtcRtpSenders: import("./lark/peer_connection").RTCMediaTrackBinding[]; /**
-         * 应用参数，构建时传入
-         */
-    } | undefined>;
+    getConnectedVideoinputDevices(): Promise<any>;
+    /**
+     * 获取所有连接的摄像头麦克风设备信息
+     * @param type *"audioinput" | "audiooutput" | "videoinput"*
+     * @returns Promise<MediaDeviceInfo[]>
+     */
+    getConnectedDevices(type: MediaDeviceKind): Promise<any>;
+    /**
+     * 打开麦克风设备
+     * @param deviceId 麦克风设备 ID， @see getConnectedAudioOutputDevices
+     * @param kind “audioinput”
+     * @returns @see this.openUserMedia
+     */
+    openAudioDevice(deviceId: string, kind?: "audioinput" | "audiooutput"): Promise<any>;
+    /**
+     * 打开摄像头设备
+     * @param cameraId 摄像头设备ID，@see getConnectedVideoinputDevices
+     * @param minWidth 限制打开设备的宽
+     * @param minHeight 限制打开设备的高
+     * @returns @see openUserMedia
+     */
+    openCamera(cameraId: string, minWidth?: number, minHeight?: number): Promise<any>;
+    /**
+     * 请求浏览器打开媒体并且打开上传到服务器通道。
+     * 要注意的是在服务器连接成功之后请求打开
+     * @param constraints 参考 navigator.mediaDevices.getUserMedia(constraints)
+     * @param reset 是否重制媒体通道。true 的情况下重制整个 peerconnection
+     * @returns 打开的通道的绑定信息。管理媒体通道如关闭暂停或恢复使用。
+     */
+    openUserMedia(constraints?: MediaStreamConstraints, reset?: boolean): Promise<any>;
+    openUserMeida(constraints?: MediaStreamConstraints, reset?: boolean): Promise<any>;
+    /**
+     * 添加媒体轨道
+     * 一般情况下使用 @see openUserMedia
+     * @param track
+     * @param streams
+     * @returns
+     */
     addMediaTrack(track: MediaStreamTrack, ...streams: MediaStream[]): boolean | undefined;
-    removeMediaTrack(track: RTCRtpSender): boolean | undefined;
-    requestUserMediaPermission(constraints?: MediaStreamConstraints): Promise<MediaStream> | undefined;
+    /**
+     * 移除某个媒体轨道。一般为  openUserMedia 打开的通道。
+     * 一般使用 @see closeVideo closeAudio 或 @see pauseAudioSending pauseVideoSending
+     * @param track @see openUserMedia 返回值
+     * @returns
+     */
+    removeMediaTrack(track: RTCRtpSender): any;
+    /**
+     * 请求媒体设备权限，相当于 navigator.mediaDevices.getUserMedia(constraints)
+     * @param constraints
+     * @returns
+     */
+    requestUserMediaPermission(constraints?: MediaStreamConstraints): any;
     /**
      * 启动云端推流功能
      * @param params {