mediasoup-client 3.6.89 → 3.6.90

package/lib/Producer.d.ts

@@ -1,169 +0,0 @@
-import { EnhancedEventEmitter } from './EnhancedEventEmitter';
-import { MediaKind, RtpCodecCapability, RtpParameters, RtpEncodingParameters } from './RtpParameters';
-import { AppData } from './types';
-export type ProducerOptions<ProducerAppData extends AppData = AppData> = {
-    track?: MediaStreamTrack;
-    encodings?: RtpEncodingParameters[];
-    codecOptions?: ProducerCodecOptions;
-    codec?: RtpCodecCapability;
-    stopTracks?: boolean;
-    disableTrackOnPause?: boolean;
-    zeroRtpOnPause?: boolean;
-    appData?: ProducerAppData;
-};
-export type ProducerCodecOptions = {
-    opusStereo?: boolean;
-    opusFec?: boolean;
-    opusDtx?: boolean;
-    opusMaxPlaybackRate?: number;
-    opusMaxAverageBitrate?: number;
-    opusPtime?: number;
-    opusNack?: boolean;
-    videoGoogleStartBitrate?: number;
-    videoGoogleMaxBitrate?: number;
-    videoGoogleMinBitrate?: number;
-};
-export type ProducerEvents = {
-    transportclose: [];
-    trackended: [];
-    '@pause': [
-        () => void,
-        (error: Error) => void
-    ];
-    '@resume': [
-        () => void,
-        (error: Error) => void
-    ];
-    '@replacetrack': [
-        MediaStreamTrack | null,
-        () => void,
-        (error: Error) => void
-    ];
-    '@setmaxspatiallayer': [
-        number,
-        () => void,
-        (error: Error) => void
-    ];
-    '@setrtpencodingparameters': [
-        RTCRtpEncodingParameters,
-        () => void,
-        (error: Error) => void
-    ];
-    '@getstats': [(stats: RTCStatsReport) => void, (error: Error) => void];
-    '@close': [];
-};
-export type ProducerObserverEvents = {
-    close: [];
-    pause: [];
-    resume: [];
-    trackended: [];
-};
-export declare class Producer<ProducerAppData extends AppData = AppData> extends EnhancedEventEmitter<ProducerEvents> {
-    private readonly _id;
-    private readonly _localId;
-    private _closed;
-    private readonly _rtpSender?;
-    private _track;
-    private readonly _kind;
-    private readonly _rtpParameters;
-    private _paused;
-    private _maxSpatialLayer;
-    private _stopTracks;
-    private _disableTrackOnPause;
-    private _zeroRtpOnPause;
-    private _appData;
-    protected readonly _observer: EnhancedEventEmitter<ProducerObserverEvents>;
-    constructor({ id, localId, rtpSender, track, rtpParameters, stopTracks, disableTrackOnPause, zeroRtpOnPause, appData }: {
-        id: string;
-        localId: string;
-        rtpSender?: RTCRtpSender;
-        track: MediaStreamTrack;
-        rtpParameters: RtpParameters;
-        stopTracks: boolean;
-        disableTrackOnPause: boolean;
-        zeroRtpOnPause: boolean;
-        appData?: ProducerAppData;
-    });
-    /**
-     * Producer id.
-     */
-    get id(): string;
-    /**
-     * Local id.
-     */
-    get localId(): string;
-    /**
-     * Whether the Producer is closed.
-     */
-    get closed(): boolean;
-    /**
-     * Media kind.
-     */
-    get kind(): MediaKind;
-    /**
-     * Associated RTCRtpSender.
-     */
-    get rtpSender(): RTCRtpSender | undefined;
-    /**
-     * The associated track.
-     */
-    get track(): MediaStreamTrack | null;
-    /**
-     * RTP parameters.
-     */
-    get rtpParameters(): RtpParameters;
-    /**
-     * Whether the Producer is paused.
-     */
-    get paused(): boolean;
-    /**
-     * Max spatial layer.
-     *
-     * @type {Number | undefined}
-     */
-    get maxSpatialLayer(): number | undefined;
-    /**
-     * App custom data.
-     */
-    get appData(): ProducerAppData;
-    /**
-     * App custom data setter.
-     */
-    set appData(appData: ProducerAppData);
-    get observer(): EnhancedEventEmitter;
-    /**
-     * Closes the Producer.
-     */
-    close(): void;
-    /**
-     * Transport was closed.
-     */
-    transportClosed(): void;
-    /**
-     * Get associated RTCRtpSender stats.
-     */
-    getStats(): Promise<RTCStatsReport>;
-    /**
-     * Pauses sending media.
-     */
-    pause(): void;
-    /**
-     * Resumes sending media.
-     */
-    resume(): void;
-    /**
-     * Replaces the current track with a new one or null.
-     */
-    replaceTrack({ track }: {
-        track: MediaStreamTrack | null;
-    }): Promise<void>;
-    /**
-     * Sets the video max spatial layer to be sent.
-     */
-    setMaxSpatialLayer(spatialLayer: number): Promise<void>;
-    setRtpEncodingParameters(params: RTCRtpEncodingParameters): Promise<void>;
-    private onTrackEnded;
-    private handleTrack;
-    private destroyTrack;
-}
-//# sourceMappingURL=Producer.d.ts.map

package/lib/Producer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Producer.d.ts","sourceRoot":"","sources":["../src/Producer.ts"],"names":[],"mappings":"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"}

package/lib/Producer.js

@@ -1,287 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Producer = void 0;
-const Logger_1 = require("./Logger");
-const EnhancedEventEmitter_1 = require("./EnhancedEventEmitter");
-const errors_1 = require("./errors");
-const logger = new Logger_1.Logger('Producer');
-class Producer extends EnhancedEventEmitter_1.EnhancedEventEmitter {
-    constructor({ id, localId, rtpSender, track, rtpParameters, stopTracks, disableTrackOnPause, zeroRtpOnPause, appData }) {
-        super();
-        // Closed flag.
-        this._closed = false;
-        // Observer instance.
-        this._observer = new EnhancedEventEmitter_1.EnhancedEventEmitter();
-        logger.debug('constructor()');
-        this._id = id;
-        this._localId = localId;
-        this._rtpSender = rtpSender;
-        this._track = track;
-        this._kind = track.kind;
-        this._rtpParameters = rtpParameters;
-        this._paused = disableTrackOnPause ? !track.enabled : false;
-        this._maxSpatialLayer = undefined;
-        this._stopTracks = stopTracks;
-        this._disableTrackOnPause = disableTrackOnPause;
-        this._zeroRtpOnPause = zeroRtpOnPause;
-        this._appData = appData || {};
-        this.onTrackEnded = this.onTrackEnded.bind(this);
-        // NOTE: Minor issue. If zeroRtpOnPause is true, we cannot emit the
-        // '@replacetrack' event here, so RTCRtpSender.track won't be null.
-        this.handleTrack();
-    }
-    /**
-     * Producer id.
-     */
-    get id() {
-        return this._id;
-    }
-    /**
-     * Local id.
-     */
-    get localId() {
-        return this._localId;
-    }
-    /**
-     * Whether the Producer is closed.
-     */
-    get closed() {
-        return this._closed;
-    }
-    /**
-     * Media kind.
-     */
-    get kind() {
-        return this._kind;
-    }
-    /**
-     * Associated RTCRtpSender.
-     */
-    get rtpSender() {
-        return this._rtpSender;
-    }
-    /**
-     * The associated track.
-     */
-    get track() {
-        return this._track;
-    }
-    /**
-     * RTP parameters.
-     */
-    get rtpParameters() {
-        return this._rtpParameters;
-    }
-    /**
-     * Whether the Producer is paused.
-     */
-    get paused() {
-        return this._paused;
-    }
-    /**
-     * Max spatial layer.
-     *
-     * @type {Number | undefined}
-     */
-    get maxSpatialLayer() {
-        return this._maxSpatialLayer;
-    }
-    /**
-     * App custom data.
-     */
-    get appData() {
-        return this._appData;
-    }
-    /**
-     * App custom data setter.
-     */
-    set appData(appData) {
-        this._appData = appData;
-    }
-    get observer() {
-        return this._observer;
-    }
-    /**
-     * Closes the Producer.
-     */
-    close() {
-        if (this._closed) {
-            return;
-        }
-        logger.debug('close()');
-        this._closed = true;
-        this.destroyTrack();
-        this.emit('@close');
-        // Emit observer event.
-        this._observer.safeEmit('close');
-    }
-    /**
-     * Transport was closed.
-     */
-    transportClosed() {
-        if (this._closed) {
-            return;
-        }
-        logger.debug('transportClosed()');
-        this._closed = true;
-        this.destroyTrack();
-        this.safeEmit('transportclose');
-        // Emit observer event.
-        this._observer.safeEmit('close');
-    }
-    /**
-     * Get associated RTCRtpSender stats.
-     */
-    async getStats() {
-        if (this._closed) {
-            throw new errors_1.InvalidStateError('closed');
-        }
-        return new Promise((resolve, reject) => {
-            this.safeEmit('@getstats', resolve, reject);
-        });
-    }
-    /**
-     * Pauses sending media.
-     */
-    pause() {
-        logger.debug('pause()');
-        if (this._closed) {
-            logger.error('pause() | Producer closed');
-            return;
-        }
-        this._paused = true;
-        if (this._track && this._disableTrackOnPause) {
-            this._track.enabled = false;
-        }
-        if (this._zeroRtpOnPause) {
-            new Promise((resolve, reject) => {
-                this.safeEmit('@pause', resolve, reject);
-            }).catch(() => { });
-        }
-        // Emit observer event.
-        this._observer.safeEmit('pause');
-    }
-    /**
-     * Resumes sending media.
-     */
-    resume() {
-        logger.debug('resume()');
-        if (this._closed) {
-            logger.error('resume() | Producer closed');
-            return;
-        }
-        this._paused = false;
-        if (this._track && this._disableTrackOnPause) {
-            this._track.enabled = true;
-        }
-        if (this._zeroRtpOnPause) {
-            new Promise((resolve, reject) => {
-                this.safeEmit('@resume', resolve, reject);
-            }).catch(() => { });
-        }
-        // Emit observer event.
-        this._observer.safeEmit('resume');
-    }
-    /**
-     * Replaces the current track with a new one or null.
-     */
-    async replaceTrack({ track }) {
-        logger.debug('replaceTrack() [track:%o]', track);
-        if (this._closed) {
-            // This must be done here. Otherwise there is no chance to stop the given
-            // track.
-            if (track && this._stopTracks) {
-                try {
-                    track.stop();
-                }
-                catch (error) { }
-            }
-            throw new errors_1.InvalidStateError('closed');
-        }
-        else if (track && track.readyState === 'ended') {
-            throw new errors_1.InvalidStateError('track ended');
-        }
-        // Do nothing if this is the same track as the current handled one.
-        if (track === this._track) {
-            logger.debug('replaceTrack() | same track, ignored');
-            return;
-        }
-        await new Promise((resolve, reject) => {
-            this.safeEmit('@replacetrack', track, resolve, reject);
-        });
-        // Destroy the previous track.
-        this.destroyTrack();
-        // Set the new track.
-        this._track = track;
-        // If this Producer was paused/resumed and the state of the new
-        // track does not match, fix it.
-        if (this._track && this._disableTrackOnPause) {
-            if (!this._paused) {
-                this._track.enabled = true;
-            }
-            else if (this._paused) {
-                this._track.enabled = false;
-            }
-        }
-        // Handle the effective track.
-        this.handleTrack();
-    }
-    /**
-     * Sets the video max spatial layer to be sent.
-     */
-    async setMaxSpatialLayer(spatialLayer) {
-        if (this._closed) {
-            throw new errors_1.InvalidStateError('closed');
-        }
-        else if (this._kind !== 'video') {
-            throw new errors_1.UnsupportedError('not a video Producer');
-        }
-        else if (typeof spatialLayer !== 'number') {
-            throw new TypeError('invalid spatialLayer');
-        }
-        if (spatialLayer === this._maxSpatialLayer) {
-            return;
-        }
-        await new Promise((resolve, reject) => {
-            this.safeEmit('@setmaxspatiallayer', spatialLayer, resolve, reject);
-        }).catch(() => { });
-        this._maxSpatialLayer = spatialLayer;
-    }
-    async setRtpEncodingParameters(params) {
-        if (this._closed) {
-            throw new errors_1.InvalidStateError('closed');
-        }
-        else if (typeof params !== 'object') {
-            throw new TypeError('invalid params');
-        }
-        await new Promise((resolve, reject) => {
-            this.safeEmit('@setrtpencodingparameters', params, resolve, reject);
-        });
-    }
-    onTrackEnded() {
-        logger.debug('track "ended" event');
-        this.safeEmit('trackended');
-        // Emit observer event.
-        this._observer.safeEmit('trackended');
-    }
-    handleTrack() {
-        if (!this._track) {
-            return;
-        }
-        this._track.addEventListener('ended', this.onTrackEnded);
-    }
-    destroyTrack() {
-        if (!this._track) {
-            return;
-        }
-        try {
-            this._track.removeEventListener('ended', this.onTrackEnded);
-            // Just stop the track unless the app set stopTracks: false.
-            if (this._stopTracks) {
-                this._track.stop();
-            }
-        }
-        catch (error) { }
-    }
-}
-exports.Producer = Producer;