@techsee/techsee-media-service 999.7.0 → 999.7.1-mbariyehAlpha2

package/README.md

@@ -1,25 +1,25 @@
 # @techsee/techsee-media-service
 
 **General Info**  
-This package is a starting point for creating Techsee Media SDK. 
+This package is a starting point for creating Techsee Media SDK.
 It contains basic framework for creating applications that utilizes media abilities.
 It can be video and/or audio, with or without streaming over WebRTC protocol.  
-The framework currently supports: Video+Voip over Techsee Video (Turn) + IE Plugin and OpenTOK + IE Plugin.  
+The framework currently supports: Video+Voip over Techsee Video (Turn) + IE Plugin and OpenTOK + IE Plugin.
 
 You can see a very simple demo, which demonstrates how to create very basic MediaService implementation and use it for rendering video in react component.
-Clone the repository, run `npm i`, then run `npm run demo`. The source code of the demo, can be found in ./demo folder. 
+Clone the repository, run `npm i`, then run `npm run demo`. The source code of the demo, can be found in ./demo folder.
 
 ---
 
 Some basic framework principles are described below, which will help you to work with media framework.
 
 **Framework actors**  
-`MediaStreamTrack` -  WebRTC object, the most basic media unit.  
-It can be video track (WebCam or ScreenShare), or audio track (Microphone stream).  
-  
+`MediaStreamTrack` - WebRTC object, the most basic media unit.  
+It can be video track (WebCam or ScreenShare), or audio track (Microphone stream).
+
 `MediaStream` - WebRTC object that just organizes multiple `MediaStreamTracks` into single group.
 The same `MediaStreamTrack` can belong to multiple `MediaStreams`.
-In Techsee Media Service implementation, `MediaStream` can not contain more than one `MediaStreamTrack` and it used only because HTML5 video element works with `MediaStream` object.   
+In Techsee Media Service implementation, `MediaStream` can not contain more than one `MediaStreamTrack` and it used only because HTML5 video element works with `MediaStream` object.
 
 `TechseeMediaStream` - This is a logical wrapper for WebRTC `MediaStreamTrack` and manages some additional information regarding the specific `MediaStreamTrack`.
 For example this object has the type of the `MediaStreamTrack` (USER_VIDEO, AGENT_AUDIO...etc), has indication if track is local or remote.
@@ -27,58 +27,57 @@ For example this object has the type of the `MediaStreamTrack` (USER_VIDEO, AGEN
 `MediaSubscriber` - Techsee logical unit, that responsible to render `MediaStreams` into DOM.
 In simple words this object creates video element in html, and renders `MediaStream` into it, when stream is ready.
 `MediaSubscriber` is created for specific `MediaStream`, and whenever that stream created, the subscriber will start playing it.
-The subscriber will notify it's consumers about the state changes through `onStateChanged` method.    
+The subscriber will notify it's consumers about the state changes through `onStateChanged` method.
 
 `MediaSession` - Techsee logical unit, that used to stream video over WebRTC protocol. This object is responsible to handle all aspect of peers connectivity, including signaling, or third party service handling, like OpenTok.  
 When connection with peer established, this service registers `MediaStreamTracks` that received from peer and publishes local streams the connected peer.
 Current implementation contains `MediaSessionBase` object, which have basic abstractions for all types of sessions. `SessionTurn` which handles the Techsee video sessions over TURN server.
 `SessionOpentok` which handles the session connectivity over OpenTok third party service.
- 
+
 `RTCPeerConnection` - WebRTC object that represents connection with single peer, when SessionTurn is used for session. The same peer is used to send and/or receive media information.
 
-`OTPeerConnection` - Design time only Typescript abstraction, which represents the connectivity with peer over OpenTok session. 
+`OTPeerConnection` - Design time only Typescript abstraction, which represents the connectivity with peer over OpenTok session.
 
 `MediaPublisher` - Techsee logical unit which organizes local MediaStreamTracks into single MediaStream for publishing.
 
 `MediaService` - Techsee logical unit. Represents the Facade of the framework and glues all of the above together.
 Current implementation provides `MediaServiceBase` abstract object that contains all base logic and tools for displaying media locally or streaming it over WebRTC.
-Each application should create its concrete `MediaService` and fill specific application logic gaps. 
+Each application should create its concrete `MediaService` and fill specific application logic gaps.
 For example, currently exist `DashboardMediaService` in `techsee-app` and `MobileMediaService` in `techee-mobile`.
 
 ---
 
 **Consuming media service - High Level Flow**
-  
+
 In order to be able to use media service, first you need to create and instance of it and initialize it.
-Depending on application, the constructor parameters can be different, but MediaServiceBase need to get the following in it's constructor:  
+Depending on application, the constructor parameters can be different, but MediaServiceBase need to get the following in it's constructor:
 
 `let mediaService = new SomeSpecificMediaService(environment, webRtcInfo);`
- 
-* **environment: IMediaEnvironment** - Service which will help understand in which environment the media service is currently running.
-* **webRtcSupportInfo: ClientWebRtcInfo** - Information about WebRTC support on currently running device  
 
+-   **environment: IMediaEnvironment** - Service which will help understand in which environment the media service is currently running.
+-   **webRtcSupportInfo: ClientWebRtcInfo** - Information about WebRTC support on currently running device
 
 When instance of specific MediaService was created, it should be initialized with `mediaService.initMediaService(serviceOptions)` method.
 See `MediaServiceOptions` for options details. The method returns promise that resolved when initialization is done.
 Initialization process, detects what media support currently running device have.
 It checks if video can be played (natively or using IE plugins), if device have mic and so on...
-After initialization promise resolved, the device information get be accessed through `mediaService.deviceSupportInfo`. 
+After initialization promise resolved, the device information get be accessed through `mediaService.deviceSupportInfo`.
 
-***Note:*** Before promise returned by `mediaService.initMediaService(serviceOptions)` was not resolved, you not able to call `mediaService.initLocalMediaStreams(serviceOptions)`,
+**_Note:_** Before promise returned by `mediaService.initMediaService(serviceOptions)` was not resolved, you not able to call `mediaService.initLocalMediaStreams(serviceOptions)`,
 but you can create media subscribers if needed by calling `mediaService.createSubscriber(subscriberParams)`.
 
 If audio stream is needed during the session, `mediaService.enableVoipDuringSession()` method should be called before initializing local streams.
-After initialization was done and promise was resolved `mediaService.initLocalMediaStreams(serviceOptions)` can be called when video/audio streams should be created.    
+After initialization was done and promise was resolved `mediaService.initLocalMediaStreams(serviceOptions)` can be called when video/audio streams should be created.  
 This method will start the local MediaStream creation process, and Camera/ScreenShare approval dialog will popup if there permission currently exists.
 `initLocalMediaStreams` method is called by controller which displays local media stream on mobile, and in MediaSession, when `peerConnection ` is created.
- `initLocalMediaStreams` synchronizes the calls and insures there only one instance of stream exists, and both sides receives the same one.  
- 
- As mentioned before, `mediaService.createSubscriber(subscriberParams)` can be called even before initialization, so whenever you have the `div` container that should hold video element,
- you can create the subscriber, by providing `KnownMediaStream` and `div` as container. Whenever the stream is ready, it will be played automatically by `MediaSubscriber`.
- `MediaSubscriber` will create `video` element, add it to `div` container and will insure it plays.
- `MediaSubscriber` has 'onStateChanged' method, which can be used for being notified on state changes of the subscriber.
- It will notify when it starts or stops playing the video, or when it has been muted or unmuted. In event listener you can inspect properties of the subscriber to see in which state it currently exists.
- In addition, `MediaSubscriber` has `onDispose` event handler, which will be called after `MediaSubscriber` was disposed and will never play video again, so references to it can be removed in order to avoid memory leaks.   
+`initLocalMediaStreams` synchronizes the calls and insures there only one instance of stream exists, and both sides receives the same one.
+
+As mentioned before, `mediaService.createSubscriber(subscriberParams)` can be called even before initialization, so whenever you have the `div` container that should hold video element,
+you can create the subscriber, by providing `KnownMediaStream` and `div` as container. Whenever the stream is ready, it will be played automatically by `MediaSubscriber`.
+`MediaSubscriber` will create `video` element, add it to `div` container and will insure it plays.
+`MediaSubscriber` has 'onStateChanged' method, which can be used for being notified on state changes of the subscriber.
+It will notify when it starts or stops playing the video, or when it has been muted or unmuted. In event listener you can inspect properties of the subscriber to see in which state it currently exists.
+In addition, `MediaSubscriber` has `onDispose` event handler, which will be called after `MediaSubscriber` was disposed and will never play video again, so references to it can be removed in order to avoid memory leaks.
 
 **Connecting to WebRTC Media Session - High Level Flow**
 
@@ -86,4 +85,4 @@ After initialization promise was resolved, `mediaService.connectToSession(sessio
 Connection to session can be done before media streams were initialized, if your use case requires it.
 In case of of Techsee Live implementation, connection to session is done only when Terms and camera access approved by the user.
 Depending on configuration passed in initialization method, `SessionTurn` or `SessionOpentok` will be created to manage the media session peers.
-Whenever WebRTC peer will be connected, MediaSession instance will ask from `mediaService` for MediaStream that should be published to connected peer. 
+Whenever WebRTC peer will be connected, MediaSession instance will ask from `mediaService` for MediaStream that should be published to connected peer.

package/lib/LocalStreamManager.d.ts

@@ -1,21 +1,40 @@
 import { Nullable } from '@techsee/techsee-common';
-import { LocalMediaConstraints, LocalVideoStreamConstraints, MediaRequestSuccessResult, IMediaEnvironment } from './MediaContracts';
+import { IMediaEnvironment, LocalMediaConstraints, LocalVideoStreamConstraints, MediaRequestSuccessResult } from './MediaContracts';
 declare global {
     interface Window {
         latestUserMediaStream: Nullable<MediaRequestSuccessResult>;
         latestDesktopMediaStream: Nullable<MediaRequestSuccessResult>;
+        latestLocalMediaConstraints: Nullable<LocalMediaConstraints>;
+        mediaStreamAlreadyReplaced: boolean;
     }
 }
+interface IGroupedDevices {
+    video: Nullable<{
+        back?: MediaDeviceInfo;
+        front?: MediaDeviceInfo;
+    }>;
+    audio: Nullable<MediaDeviceInfo>;
+    camerasCount: number;
+}
 export declare class LocalStreamManager {
     private environment;
+    private _groupedDevices;
     constructor(environment: IMediaEnvironment);
+    get groupedDevices(): IGroupedDevices;
     getUserMediaStream(constraints: LocalMediaConstraints): Promise<MediaRequestSuccessResult>;
     getDesktopMediaStream(constraints: LocalVideoStreamConstraints): Promise<MediaRequestSuccessResult>;
     destroyUserMediaStream(): Promise<void>;
     destroyDesktopMediaStream(): Promise<void>;
     clearAllStreams(): Promise<void>;
     private getHighestResolutionStream;
+    private getUserMediaStreamMediaDevice;
     private getStreamPromiseByParsedConstraints;
+    setGroupedDevices(groupedDevices: {
+        video: MediaDeviceInfo[];
+        audio: MediaDeviceInfo[];
+    }): void;
     private getParsedConstraints;
     private parseMediaErrorThenThrow;
 }
+export {};
+//# sourceMappingURL=LocalStreamManager.d.ts.map

package/lib/LocalStreamManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/LocalStreamManager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAEjD,OAAO,EAEH,qBAAqB,EACrB,2BAA2B,EAE3B,yBAAyB,EACzB,iBAAiB,EACpB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,qBAAqB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;QAC3D,wBAAwB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;KACjE;CACJ;AAcD,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,WAAW,CAAoB;gBAE3B,WAAW,EAAE,iBAAiB;IAO1C,kBAAkB,CAAC,WAAW,EAAE,qBAAqB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAyC1F,qBAAqB,CAAC,WAAW,EAAE,2BAA2B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA0CnG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAevC,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;IAe1C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC,OAAO,CAAC,0BAA0B;IAqDlC,OAAO,CAAC,mCAAmC;IAsB3C,OAAO,CAAC,oBAAoB;IAsD5B,OAAO,CAAC,wBAAwB;CAoCnC","file":"LocalStreamManager.d.ts","sourcesContent":["import assign from 'lodash/assign';\nimport get from 'lodash/get';\nimport {Promise} from 'bluebird';\n\nimport {Nullable} from '@techsee/techsee-common';\n\nimport {\n    VideoStreamResolution,\n    LocalMediaConstraints,\n    LocalVideoStreamConstraints,\n    MediaRequestFailResult,\n    MediaRequestSuccessResult,\n    IMediaEnvironment\n} from './MediaContracts';\n\nimport {\n    ConstraintType,\n    DEFAULT_VIDEO_CONSTRAINT_TYPE,\n    DEFAULT_VIDEO_RESOLUTION,\n    MediaRequestErrorCode\n} from './MediaConstants';\n\ndeclare global {\n    interface Window {\n        latestUserMediaStream: Nullable<MediaRequestSuccessResult>;\n        latestDesktopMediaStream: Nullable<MediaRequestSuccessResult>;\n    }\n}\n\ndeclare const window: Window;\n\nwindow.latestUserMediaStream = null;\nlet userMediaPromise: Nullable<Promise<MediaRequestSuccessResult>> = null;\n\nwindow.latestDesktopMediaStream = null;\nlet desktopMediaPromise: Nullable<Promise<MediaRequestSuccessResult>> = null;\n\nimport {getMediaTracer} from './MediaUtils/MediaTracer';\n\nconst trace = getMediaTracer('LocalStreamManager');\n\nexport class LocalStreamManager {\n    private environment: IMediaEnvironment;\n\n    constructor(environment: IMediaEnvironment) {\n        this.environment = environment;\n\n        this.parseMediaErrorThenThrow = this.parseMediaErrorThenThrow.bind(this);\n        this.clearAllStreams = this.clearAllStreams.bind(this);\n    }\n\n    getUserMediaStream(constraints: LocalMediaConstraints): Promise<MediaRequestSuccessResult> {\n        trace.info('getUserMediaStream', constraints);\n        if (userMediaPromise) {\n            return userMediaPromise;\n        }\n\n        if (window.latestUserMediaStream) {\n            const videoTrack = window.latestUserMediaStream.mediaStream.getVideoTracks();\n\n            if (videoTrack.length > 0 && videoTrack[0].readyState === 'live') {\n                return Promise.resolve({...window.latestUserMediaStream, isNew: false});\n            }\n            this.destroyUserMediaStream();\n\n        }\n\n\n        userMediaPromise = new Promise((resolve, reject) => {\n            const catchHandler = (err: any): void => {\n                userMediaPromise = null;\n                window.latestUserMediaStream = null;\n                trace.error('getUserMedia error', err);\n                reject(err);\n            };\n\n            try {\n                this.getHighestResolutionStream(false, constraints)\n                    .then((streamResult: MediaRequestSuccessResult) => {\n                        userMediaPromise = null;\n                        window.latestUserMediaStream = streamResult;\n                        resolve({...window.latestUserMediaStream, isNew: true});\n                    })\n                    .catch(catchHandler);\n            } catch (err) {\n                catchHandler(err);\n            }\n        });\n\n        return userMediaPromise;\n    }\n\n    getDesktopMediaStream(constraints: LocalVideoStreamConstraints): Promise<MediaRequestSuccessResult> {\n        if (desktopMediaPromise) {\n            return desktopMediaPromise;\n        }\n\n        if (window.latestDesktopMediaStream) {\n            const track = window.latestDesktopMediaStream.mediaStream.getVideoTracks();\n\n            if (track.length > 0 && track[0].readyState === 'live') {\n                //return Promise.resolve();\n                return Promise.resolve({...window.latestDesktopMediaStream, isNew: false});\n            }\n            this.destroyDesktopMediaStream().catch((error: any) => {\n                trace.error('Error destroying desktop media stream', error);\n            });\n\n        }\n\n        desktopMediaPromise = new Promise((resolve, reject) => {\n            const mediaCatchHandler = (err: any): void => {\n                desktopMediaPromise = null;\n                window.latestDesktopMediaStream = null;\n                trace.error('getDisplayMedia error', err);\n                reject(err);\n            };\n\n            try {\n                this.getHighestResolutionStream(true, {video: constraints, audio: false})\n                    .then((streamResult: MediaRequestSuccessResult) => {\n                        desktopMediaPromise = null;\n                        window.latestDesktopMediaStream = streamResult;\n\n                        resolve({...window.latestDesktopMediaStream, isNew: true});\n                    }).catch(mediaCatchHandler);\n            } catch (err) {\n                mediaCatchHandler(err);\n            }\n        });\n\n        return desktopMediaPromise;\n    }\n\n    destroyUserMediaStream(): Promise<void> {\n        const streamResult = window.latestUserMediaStream;\n\n        window.latestUserMediaStream = null;\n        userMediaPromise = null;\n\n        if (streamResult) {\n            streamResult.mediaStream.getTracks().forEach((track: MediaStreamTrack) => {\n                track.stop();\n            });\n        }\n\n        return Promise.resolve();\n    }\n\n    destroyDesktopMediaStream(): Promise<void> {\n        const streamResult = window.latestDesktopMediaStream;\n\n        window.latestDesktopMediaStream = null;\n        desktopMediaPromise = null;\n\n        if (streamResult) {\n            streamResult.mediaStream.getTracks().forEach((track: MediaStreamTrack) => {\n                track.stop();\n            });\n        }\n\n        return Promise.resolve();\n    }\n\n    clearAllStreams(): Promise<void> {\n        trace.info('LocalStreamManager Clearing all streams');\n\n        return Promise.all([\n            this.destroyDesktopMediaStream(),\n            this.destroyUserMediaStream()\n        ]).then(() => undefined);\n    }\n\n    private getHighestResolutionStream(isDesktopMedia: boolean, constraints?: LocalMediaConstraints): Promise<MediaRequestSuccessResult> {\n        const constraintsCandidates = this.getParsedConstraints(isDesktopMedia, constraints);\n\n        if (constraintsCandidates.length === 0) {\n            return Promise.reject(new Error('No constraints to retrieve the stream'));\n        }\n\n        return new Promise((resolve, reject) => {\n            let lastSuccessfulResult: Nullable<MediaRequestSuccessResult> = null;\n            let lastFailedResult: Nullable<MediaRequestFailResult> = null;\n            let isStreamRequestFulfilled = false;\n\n            (Promise as any).reduce(constraintsCandidates, (total: any, candidate: MediaStreamConstraints) => {\n                if (isStreamRequestFulfilled) {\n                    return;\n                }\n                const constraintType = get(constraints, 'video.videoResolution.constraintType') || get(constraints, 'video.videoResolution[0].constraintType');\n\n                return this.getStreamPromiseByParsedConstraints(candidate, isDesktopMedia)\n                    .then((stream: MediaStream) => {\n                        lastSuccessfulResult = {\n                            mediaStream: stream,\n                            constraint: candidate,\n                            constraintType,\n                            isNew: true\n                        };\n                        trace.info('getHighestResolutionStream Success', lastSuccessfulResult);\n                        isStreamRequestFulfilled = true;\n                        resolve(lastSuccessfulResult);\n                    })\n                    .catch((failResult: MediaRequestFailResult) => {\n                        lastFailedResult = failResult;\n                        if (lastFailedResult.errorCode === MediaRequestErrorCode.PermissionDenied) {\n                            isStreamRequestFulfilled = true;\n                            reject(lastFailedResult);\n                        }\n                    });\n            }, 0)\n                .then(() => {\n                    if (!isStreamRequestFulfilled) {\n                        if (!lastFailedResult) {\n                            lastFailedResult = {\n                                errorCode: MediaRequestErrorCode.GeneralError,\n                                message: 'Suitable stream cannot be created'\n                            };\n                        }\n                        reject(lastFailedResult);\n                    }\n                });\n        });\n    }\n\n    //@ts-ignore\n    private getStreamPromiseByParsedConstraints(constraints: MediaStreamConstraints, isDesktopMedia: boolean): Promise<MediaStream> {\n        let streamPromise = null;\n\n        trace.info('getStreamPromiseByParsedConstraints', constraints);\n\n        try {\n            if (!isDesktopMedia) {\n                streamPromise = navigator.mediaDevices.getUserMedia(constraints);\n            } else {\n                //@ts-ignore\n                streamPromise = navigator.mediaDevices.getDisplayMedia\n                    //@ts-ignore\n                    ? navigator.mediaDevices.getDisplayMedia(constraints)\n                    : navigator.getDisplayMedia(constraints);\n            }\n\n            return streamPromise.catch(this.parseMediaErrorThenThrow);\n        } catch (e) {\n            this.parseMediaErrorThenThrow(e);\n        }\n    }\n\n    private getParsedConstraints(isDesktopMedia: boolean, streamConstraints?: LocalMediaConstraints): MediaStreamConstraints[] {\n        const constraintCandidates: MediaStreamConstraints[] = [];\n\n        //TODO - Alex: need to understand which constraints not compatible with screen share\n        if (isDesktopMedia) {\n            return [{video: true}];\n        }\n\n        if (!streamConstraints) {\n            return constraintCandidates;\n        }\n\n        const baseConstraints: MediaStreamConstraints = {};\n\n        baseConstraints.audio = typeof streamConstraints.audio === 'boolean' ? streamConstraints.audio : undefined;\n\n        if (!streamConstraints.video) {\n            return [baseConstraints];\n        }\n\n        baseConstraints.video = {\n            facingMode: 'environment',\n            frameRate: {ideal: 15, max: 30}\n        };\n\n        const assignConstraint = (videoResolution: VideoStreamResolution): void => {\n            const [width, height] = videoResolution.resolution.split('x');\n            const constraintCandidate = assign({}, baseConstraints);\n\n            constraintCandidate.video = assign({}, baseConstraints.video, {\n                width: _constraintByType(width, videoResolution.constraintType),\n                height: _constraintByType(height, videoResolution.constraintType)\n            });\n            constraintCandidates.push(constraintCandidate);\n        };\n\n        if ((baseConstraints.video && typeof streamConstraints.video === 'boolean') ||\n            !((streamConstraints.video as LocalVideoStreamConstraints).videoResolution instanceof Array)) {\n\n            const defaultResolution: VideoStreamResolution = {\n                resolution: DEFAULT_VIDEO_RESOLUTION,\n                constraintType: DEFAULT_VIDEO_CONSTRAINT_TYPE\n            };\n\n            assignConstraint(defaultResolution);\n\n            return constraintCandidates;\n        }\n\n        (streamConstraints.video as any).videoResolution.forEach(assignConstraint);\n\n        return constraintCandidates;\n    }\n\n    private parseMediaErrorThenThrow(error: any): MediaRequestFailResult {\n        trace.error('Get media stream error.', error);\n        const errorName = error && error.name ? error.name : '';\n\n        const permissionErrorNames = [\n            'NotAllowedError',\n            'PermissionDismissedError',\n            'PermissionDeniedError'\n\n        ];\n\n        // const generalError = [\n        //     'NotFoundError',\n        //     'DevicesNotFoundError',\n        //     'NotReadableError',\n        //     'TrackStartError'\n        // ];\n\n        const constraintsErrors = [\n            'OverconstrainedError',\n            'ConstraintNotSatisfiedError'\n\n        ];\n\n        const isErrorOfType = (errorsArr: string[]) => errorsArr.filter((err: string) => err === errorName).length > 0;\n\n        if (isErrorOfType(permissionErrorNames)) {\n            throw {errorCode: MediaRequestErrorCode.PermissionDenied, message: errorName};\n        }\n\n        if (isErrorOfType(constraintsErrors)) {\n            throw {errorCode: MediaRequestErrorCode.Overconstrained, message: errorName};\n        }\n\n        throw {errorCode: MediaRequestErrorCode.GeneralError, message: errorName};\n    }\n}\n\nfunction _constraintByType(value: any, type: ConstraintType): any {\n    switch (type) {\n        case ConstraintType.MIN:\n            return {min: value};\n        default:\n            return {ideal: value};\n    }\n}\n"]}
+{"version":3,"file":"LocalStreamManager.d.ts","sourceRoot":"","sources":["../src/LocalStreamManager.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAEjD,OAAO,EACH,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAE3B,yBAAyB,EAE5B,MAAM,kBAAkB,CAAC;AAY1B,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,qBAAqB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;QAC3D,wBAAwB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAC;QAC9D,2BAA2B,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QAC7D,0BAA0B,EAAE,OAAO,CAAC;KACvC;CACJ;AAeD,UAAU,eAAe;IACrB,KAAK,EAAE,QAAQ,CAAC;QAAC,IAAI,CAAC,EAAE,eAAe,CAAC;QAAC,KAAK,CAAC,EAAE,eAAe,CAAA;KAAC,CAAC,CAAC;IACnE,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,WAAW,CAAoB;IAEvC,OAAO,CAAC,eAAe,CAAgE;gBAE3E,WAAW,EAAE,iBAAiB;IAO1C,IAAI,cAAc,oBAEjB;IAED,kBAAkB,CAAC,WAAW,EAAE,qBAAqB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA4C1F,qBAAqB,CAAC,WAAW,EAAE,2BAA2B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA4CnG,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBvC,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB1C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC,OAAO,CAAC,0BAA0B;IAkElC,OAAO,CAAC,6BAA6B;IAoBrC,OAAO,CAAC,mCAAmC;IA0E3C,iBAAiB,CAAC,cAAc,EAAE;QAAC,KAAK,EAAE,eAAe,EAAE,CAAC;QAAC,KAAK,EAAE,eAAe,EAAE,CAAA;KAAC;IAWtF,OAAO,CAAC,oBAAoB;IA6E5B,OAAO,CAAC,wBAAwB;CA+BnC"}

package/lib/LocalStreamManager.js

@@ -1,37 +1,49 @@
 "use strict";
-
-var __assign = undefined && undefined.__assign || function () {
-    __assign = Object.assign || function (t) {
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
         for (var s, i = 1, n = arguments.length; i < n; i++) {
             s = arguments[i];
-            for (var p in s) {
-                if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
-            }
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
         }
         return t;
     };
     return __assign.apply(this, arguments);
 };
-var __importDefault = undefined && undefined.__importDefault || function (mod) {
-    return mod && mod.__esModule ? mod : { "default": mod };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalStreamManager = void 0;
 var assign_1 = __importDefault(require("lodash/assign"));
 var get_1 = __importDefault(require("lodash/get"));
+var last_1 = __importDefault(require("lodash/last"));
+var first_1 = __importDefault(require("lodash/first"));
+var cloneDeep_1 = __importDefault(require("lodash/cloneDeep"));
 var bluebird_1 = require("bluebird");
 var MediaConstants_1 = require("./MediaConstants");
+var MediaTracer_1 = require("./MediaUtils/MediaTracer");
 window.latestUserMediaStream = null;
 var userMediaPromise = null;
 window.latestDesktopMediaStream = null;
 var desktopMediaPromise = null;
-var MediaTracer_1 = require("./MediaUtils/MediaTracer");
-var trace = MediaTracer_1.getMediaTracer('LocalStreamManager');
-var LocalStreamManager = /** @class */function () {
+window.mediaStreamAlreadyReplaced = false;
+window.latestLocalMediaConstraints = null;
+var trace = (0, MediaTracer_1.getMediaTracer)('LocalStreamManager');
+var LocalStreamManager = (function () {
     function LocalStreamManager(environment) {
+        this._groupedDevices = { video: null, audio: null, camerasCount: 0 };
         this.environment = environment;
         this.parseMediaErrorThenThrow = this.parseMediaErrorThenThrow.bind(this);
         this.clearAllStreams = this.clearAllStreams.bind(this);
     }
+    Object.defineProperty(LocalStreamManager.prototype, "groupedDevices", {
+        get: function () {
+            return this._groupedDevices;
+        },
+        enumerable: false,
+        configurable: true
+    });
     LocalStreamManager.prototype.getUserMediaStream = function (constraints) {
         var _this = this;
         trace.info('getUserMediaStream', constraints);
@@ -41,24 +53,30 @@ var LocalStreamManager = /** @class */function () {
         if (window.latestUserMediaStream) {
             var videoTrack = window.latestUserMediaStream.mediaStream.getVideoTracks();
             if (videoTrack.length > 0 && videoTrack[0].readyState === 'live') {
-                return bluebird_1.Promise.resolve(__assign({}, window.latestUserMediaStream, { isNew: false }));
+                return bluebird_1.Promise.resolve(__assign(__assign({}, window.latestUserMediaStream), { isNew: false }));
             }
             this.destroyUserMediaStream();
         }
         userMediaPromise = new bluebird_1.Promise(function (resolve, reject) {
-            var catchHandler = function catchHandler(err) {
+            var catchHandler = function (err) {
                 userMediaPromise = null;
                 window.latestUserMediaStream = null;
                 trace.error('getUserMedia error', err);
                 reject(err);
             };
             try {
-                _this.getHighestResolutionStream(false, constraints).then(function (streamResult) {
+                _this.getHighestResolutionStream(false, constraints)
+                    .then(function (streamResult) {
                     userMediaPromise = null;
                     window.latestUserMediaStream = streamResult;
-                    resolve(__assign({}, window.latestUserMediaStream, { isNew: true }));
-                }).catch(catchHandler);
-            } catch (err) {
+                    window.latestLocalMediaConstraints = (0, cloneDeep_1.default)(constraints);
+                    window.latestLocalMediaConstraints.audio = (streamResult.constraint &&
+                        streamResult.constraint.audio);
+                    resolve(__assign(__assign({}, window.latestUserMediaStream), { isNew: true }));
+                })
+                    .catch(catchHandler);
+            }
+            catch (err) {
                 catchHandler(err);
             }
         });
@@ -69,30 +87,33 @@ var LocalStreamManager = /** @class */function () {
         if (desktopMediaPromise) {
             return desktopMediaPromise;
         }
+        trace.info('getDesktopMediaStream', constraints);
         if (window.latestDesktopMediaStream) {
             var track = window.latestDesktopMediaStream.mediaStream.getVideoTracks();
             if (track.length > 0 && track[0].readyState === 'live') {
-                //return Promise.resolve();
-                return bluebird_1.Promise.resolve(__assign({}, window.latestDesktopMediaStream, { isNew: false }));
+                return bluebird_1.Promise.resolve(__assign(__assign({}, window.latestDesktopMediaStream), { isNew: false }));
             }
             this.destroyDesktopMediaStream().catch(function (error) {
                 trace.error('Error destroying desktop media stream', error);
             });
         }
         desktopMediaPromise = new bluebird_1.Promise(function (resolve, reject) {
-            var mediaCatchHandler = function mediaCatchHandler(err) {
+            var mediaCatchHandler = function (err) {
                 desktopMediaPromise = null;
                 window.latestDesktopMediaStream = null;
                 trace.error('getDisplayMedia error', err);
                 reject(err);
             };
             try {
-                _this.getHighestResolutionStream(true, { video: constraints, audio: false }).then(function (streamResult) {
+                _this.getHighestResolutionStream(true, { video: constraints, audio: false })
+                    .then(function (streamResult) {
                     desktopMediaPromise = null;
                     window.latestDesktopMediaStream = streamResult;
-                    resolve(__assign({}, window.latestDesktopMediaStream, { isNew: true }));
-                }).catch(mediaCatchHandler);
-            } catch (err) {
+                    resolve(__assign(__assign({}, window.latestDesktopMediaStream), { isNew: true }));
+                })
+                    .catch(mediaCatchHandler);
+            }
+            catch (err) {
                 mediaCatchHandler(err);
             }
         });
@@ -100,12 +121,20 @@ var LocalStreamManager = /** @class */function () {
     };
     LocalStreamManager.prototype.destroyUserMediaStream = function () {
         var streamResult = window.latestUserMediaStream;
-        window.latestUserMediaStream = null;
         userMediaPromise = null;
-        if (streamResult) {
-            streamResult.mediaStream.getTracks().forEach(function (track) {
-                track.stop();
-            });
+        window.latestUserMediaStream = null;
+        window.latestLocalMediaConstraints = null;
+        window.mediaStreamAlreadyReplaced = false;
+        if (streamResult && streamResult.mediaStream) {
+            try {
+                streamResult.mediaStream.getTracks().forEach(function (track) {
+                    track.stop();
+                });
+                trace.info('destroyUserMediaStream - stop all tracks');
+            }
+            catch (e) {
+                trace.info('destroyUserMediaStream - Failed to stop all tracks', e);
+            }
         }
         return bluebird_1.Promise.resolve();
     };
@@ -113,22 +142,27 @@ var LocalStreamManager = /** @class */function () {
         var streamResult = window.latestDesktopMediaStream;
         window.latestDesktopMediaStream = null;
         desktopMediaPromise = null;
-        if (streamResult) {
-            streamResult.mediaStream.getTracks().forEach(function (track) {
-                track.stop();
-            });
+        if (streamResult && streamResult.mediaStream) {
+            try {
+                streamResult.mediaStream.getTracks().forEach(function (track) {
+                    track.stop();
+                });
+                trace.info('destroyDesktopMediaStream - stop all tracks');
+            }
+            catch (e) {
+                trace.info('destroyDesktopMediaStream - Failed to stop all tracks', e);
+            }
         }
         return bluebird_1.Promise.resolve();
     };
     LocalStreamManager.prototype.clearAllStreams = function () {
         trace.info('LocalStreamManager Clearing all streams');
-        return bluebird_1.Promise.all([this.destroyDesktopMediaStream(), this.destroyUserMediaStream()]).then(function () {
-            return undefined;
-        });
+        return bluebird_1.Promise.all([this.destroyDesktopMediaStream(), this.destroyUserMediaStream()]).then(function () { return undefined; });
     };
     LocalStreamManager.prototype.getHighestResolutionStream = function (isDesktopMedia, constraints) {
         var _this = this;
         var constraintsCandidates = this.getParsedConstraints(isDesktopMedia, constraints);
+        trace.info('getHighestResolutionStream - constraintsCandidates:', constraintsCandidates);
         if (constraintsCandidates.length === 0) {
             return bluebird_1.Promise.reject(new Error('No constraints to retrieve the stream'));
         }
@@ -136,12 +170,15 @@ var LocalStreamManager = /** @class */function () {
             var lastSuccessfulResult = null;
             var lastFailedResult = null;
             var isStreamRequestFulfilled = false;
-            bluebird_1.Promise.reduce(constraintsCandidates, function (total, candidate) {
+            bluebird_1.Promise
+                .reduce(constraintsCandidates, function (total, candidate) {
                 if (isStreamRequestFulfilled) {
                     return;
                 }
-                var constraintType = get_1.default(constraints, 'video.videoResolution.constraintType') || get_1.default(constraints, 'video.videoResolution[0].constraintType');
-                return _this.getStreamPromiseByParsedConstraints(candidate, isDesktopMedia).then(function (stream) {
+                var constraintType = (0, get_1.default)(constraints, 'video.videoResolution.constraintType') ||
+                    (0, get_1.default)(constraints, 'video.videoResolution[0].constraintType');
+                return _this.getStreamPromiseByParsedConstraints(candidate, isDesktopMedia)
+                    .then(function (stream) {
                     lastSuccessfulResult = {
                         mediaStream: stream,
                         constraint: candidate,
@@ -151,14 +188,16 @@ var LocalStreamManager = /** @class */function () {
                     trace.info('getHighestResolutionStream Success', lastSuccessfulResult);
                     isStreamRequestFulfilled = true;
                     resolve(lastSuccessfulResult);
-                }).catch(function (failResult) {
+                })
+                    .catch(function (failResult) {
                     lastFailedResult = failResult;
                     if (lastFailedResult.errorCode === MediaConstants_1.MediaRequestErrorCode.PermissionDenied) {
                         isStreamRequestFulfilled = true;
                         reject(lastFailedResult);
                     }
                 });
-            }, 0).then(function () {
+            }, 0)
+                .then(function () {
                 if (!isStreamRequestFulfilled) {
                     if (!lastFailedResult) {
                         lastFailedResult = {
@@ -171,27 +210,72 @@ var LocalStreamManager = /** @class */function () {
             });
         });
     };
-    //@ts-ignore
-    LocalStreamManager.prototype.getStreamPromiseByParsedConstraints = function (constraints, isDesktopMedia) {
+    LocalStreamManager.prototype.getUserMediaStreamMediaDevice = function (constraints, isDesktopMedia) {
         var streamPromise = null;
+        if (!isDesktopMedia) {
+            streamPromise = navigator.mediaDevices.getUserMedia(constraints);
+        }
+        else {
+            streamPromise = navigator.mediaDevices.getDisplayMedia
+                ?
+                    navigator.mediaDevices.getDisplayMedia(constraints)
+                :
+                    navigator.getDisplayMedia(constraints);
+        }
+        return streamPromise;
+    };
+    LocalStreamManager.prototype.getStreamPromiseByParsedConstraints = function (constraints, isDesktopMedia) {
+        var _this = this;
         trace.info('getStreamPromiseByParsedConstraints', constraints);
         try {
-            if (!isDesktopMedia) {
-                streamPromise = navigator.mediaDevices.getUserMedia(constraints);
-            } else {
-                //@ts-ignore
-                streamPromise = navigator.mediaDevices.getDisplayMedia
-                //@ts-ignore
-                ? navigator.mediaDevices.getDisplayMedia(constraints) : navigator.getDisplayMedia(constraints);
-            }
-            return streamPromise.catch(this.parseMediaErrorThenThrow);
-        } catch (e) {
-            this.parseMediaErrorThenThrow(e);
+            return this.getUserMediaStreamMediaDevice(constraints, isDesktopMedia).catch(function (err) {
+                var streamPromise = null;
+                trace.info('getStreamPromiseByParsedConstraints - get user stream error', err.name);
+                if (err &&
+                    err.name === 'NotReadableError' &&
+                    (0, get_1.default)(constraints, 'video.facingMode') &&
+                    (0, get_1.default)(constraints, 'video.deviceId')) {
+                    var newConstraints = constraints;
+                    trace.info("getStreamPromiseByParsedConstraints - NotReadableError - Failed to get video user media stream with facingMode=".concat((0, get_1.default)(constraints, 'video.facingMode')), err.name);
+                    delete newConstraints.video.facingMode;
+                    newConstraints.video.deviceId = {
+                        exact: constraints.video.deviceId
+                    };
+                    streamPromise = _this.getStreamPromiseByParsedConstraints(newConstraints, isDesktopMedia);
+                }
+                else if (err && err.name && constraints.audio && !constraints.video) {
+                    trace.info('getStreamPromiseByParsedConstraints - audioStreamFailed - Failed to get audio user media stream', err.name);
+                    return _this.parseMediaErrorThenThrow({ name: 'audioStreamFailed' });
+                }
+                else if (err && err.name && constraints.audio) {
+                    var newConstraints = constraints;
+                    trace.info('getStreamPromiseByParsedConstraints - Failed to get video and audio user media stream, try to get video media stream only', err.name);
+                    newConstraints.audio = false;
+                    streamPromise = _this.getStreamPromiseByParsedConstraints(newConstraints, isDesktopMedia);
+                }
+                else if (err && !streamPromise) {
+                    trace.info('getStreamPromiseByParsedConstraints - Failed to get video user media stream', err && err.name);
+                    streamPromise = bluebird_1.Promise.reject(err);
+                }
+                return streamPromise && streamPromise.catch(_this.parseMediaErrorThenThrow);
+            });
+        }
+        catch (e) {
+            return this.parseMediaErrorThenThrow(e);
         }
     };
+    LocalStreamManager.prototype.setGroupedDevices = function (groupedDevices) {
+        var _a;
+        trace.info('setGroupedDevices', groupedDevices);
+        this._groupedDevices = {
+            video: groupedDevices.video
+                ? (_a = {}, _a[MediaConstants_1.CameraTypes.BACK] = (0, last_1.default)(groupedDevices.video), _a[MediaConstants_1.CameraTypes.FRONT] = (0, first_1.default)(groupedDevices.video), _a) : null,
+            audio: (0, last_1.default)(groupedDevices.audio) || null,
+            camerasCount: groupedDevices.video.length
+        };
+    };
     LocalStreamManager.prototype.getParsedConstraints = function (isDesktopMedia, streamConstraints) {
         var constraintCandidates = [];
-        //TODO - Alex: need to understand which constraints not compatible with screen share
         if (isDesktopMedia) {
             return [{ video: true }];
         }
@@ -203,22 +287,32 @@ var LocalStreamManager = /** @class */function () {
         if (!streamConstraints.video) {
             return [baseConstraints];
         }
+        var cameraType = streamConstraints.video !== 'boolean' &&
+            streamConstraints.video.videoSourceType;
         baseConstraints.video = {
-            facingMode: 'environment',
+            facingMode: cameraType && cameraType === MediaConstants_1.LocalVideoSourceType.CAMERA_FRONT ? 'user' : 'environment',
             frameRate: { ideal: 15, max: 30 }
         };
-        var assignConstraint = function assignConstraint(videoResolution) {
-            var _a = videoResolution.resolution.split('x'),
-                width = _a[0],
-                height = _a[1];
-            var constraintCandidate = assign_1.default({}, baseConstraints);
-            constraintCandidate.video = assign_1.default({}, baseConstraints.video, {
+        var deviceId = (0, get_1.default)(this._groupedDevices, "video.".concat(cameraType === MediaConstants_1.LocalVideoSourceType.CAMERA_FRONT ? MediaConstants_1.CameraTypes.FRONT : MediaConstants_1.CameraTypes.BACK, ".deviceId"));
+        if (deviceId) {
+            baseConstraints.video.deviceId = deviceId;
+            if (this._groupedDevices.camerasCount > 1) {
+                baseConstraints.video.facingMode = {
+                    exact: baseConstraints.video.facingMode
+                };
+            }
+        }
+        var assignConstraint = function (videoResolution) {
+            var _a = videoResolution.resolution.split('x'), width = _a[0], height = _a[1];
+            var constraintCandidate = (0, assign_1.default)({}, baseConstraints);
+            constraintCandidate.video = (0, assign_1.default)({}, baseConstraints.video, {
                 width: _constraintByType(width, videoResolution.constraintType),
                 height: _constraintByType(height, videoResolution.constraintType)
             });
             constraintCandidates.push(constraintCandidate);
         };
-        if (baseConstraints.video && typeof streamConstraints.video === 'boolean' || !(streamConstraints.video.videoResolution instanceof Array)) {
+        if ((baseConstraints.video && typeof streamConstraints.video === 'boolean') ||
+            !(streamConstraints.video.videoResolution instanceof Array)) {
             var defaultResolution = {
                 resolution: MediaConstants_1.DEFAULT_VIDEO_RESOLUTION,
                 constraintType: MediaConstants_1.DEFAULT_VIDEO_CONSTRAINT_TYPE
@@ -230,21 +324,14 @@ var LocalStreamManager = /** @class */function () {
         return constraintCandidates;
     };
     LocalStreamManager.prototype.parseMediaErrorThenThrow = function (error) {
+        if (error && error.errorCode) {
+            throw error;
+        }
         trace.error('Get media stream error.', error);
         var errorName = error && error.name ? error.name : '';
         var permissionErrorNames = ['NotAllowedError', 'PermissionDismissedError', 'PermissionDeniedError'];
-        // const generalError = [
-        //     'NotFoundError',
-        //     'DevicesNotFoundError',
-        //     'NotReadableError',
-        //     'TrackStartError'
-        // ];
         var constraintsErrors = ['OverconstrainedError', 'ConstraintNotSatisfiedError'];
-        var isErrorOfType = function isErrorOfType(errorsArr) {
-            return errorsArr.filter(function (err) {
-                return err === errorName;
-            }).length > 0;
-        };
+        var isErrorOfType = function (errorsArr) { return errorsArr.filter(function (err) { return err === errorName; }).length > 0; };
         if (isErrorOfType(permissionErrorNames)) {
             throw { errorCode: MediaConstants_1.MediaRequestErrorCode.PermissionDenied, message: errorName };
         }
@@ -254,7 +341,7 @@ var LocalStreamManager = /** @class */function () {
         throw { errorCode: MediaConstants_1.MediaRequestErrorCode.GeneralError, message: errorName };
     };
     return LocalStreamManager;
-}();
+}());
 exports.LocalStreamManager = LocalStreamManager;
 function _constraintByType(value, type) {
     switch (type) {
@@ -264,6 +351,4 @@ function _constraintByType(value, type) {
             return { ideal: value };
     }
 }
-
-//# sourceMappingURL=LocalStreamManager.js.map
-//# sourceMappingURL=LocalStreamManager.js.map
+//# sourceMappingURL=LocalStreamManager.js.map