@sbhjt-gr/react-native-webrtc 124.0.2 → 124.0.4

package/src/MediaStreamTrack.ts

@@ -1,284 +1,284 @@
-import { EventTarget, Event, defineEventAttribute } from 'event-target-shim/index';
-import { NativeModules } from 'react-native';
-
-import { MediaTrackConstraints } from './Constraints';
-import { addListener, removeListener } from './EventEmitter';
-import Logger from './Logger';
-import { deepClone, normalizeConstraints } from './RTCUtil';
-
-const log = new Logger('pc');
-const { WebRTCModule } = NativeModules;
-
-export type PalabraConfig = {
-    clientId: string;
-    clientSecret: string;
-    sourceLang: string;
-    targetLang: string;
-    apiUrl?: string;
-};
-
-export type PalabraTranscription = {
-    text: string;
-    lang: string;
-    isFinal: boolean;
-};
-
-type MediaStreamTrackState = 'live' | 'ended';
-
-export type MediaStreamTrackInfo = {
-    id: string;
-    kind: string;
-    remote: boolean;
-    constraints: object;
-    enabled: boolean;
-    settings: object;
-    peerConnectionId: number;
-    readyState: MediaStreamTrackState;
-}
-
-export type MediaTrackSettings = {
-    width?: number;
-    height?: number;
-    frameRate?: number;
-    facingMode?: string;
-    deviceId?: string;
-    groupId?: string;
-}
-
-type MediaStreamTrackEventMap = {
-    ended: Event<'ended'>;
-    mute: Event<'mute'>;
-    unmute: Event<'unmute'>;
-}
-
-export default class MediaStreamTrack extends EventTarget<MediaStreamTrackEventMap> {
-    _constraints: MediaTrackConstraints;
-    _enabled: boolean;
-    _settings: MediaTrackSettings;
-    _muted: boolean;
-    _peerConnectionId: number;
-    _readyState: MediaStreamTrackState;
-
-    readonly id: string;
-    readonly kind: string;
-    readonly label: string = '';
-    readonly remote: boolean;
-
-    constructor(info: MediaStreamTrackInfo) {
-        super();
-
-        this._constraints = info.constraints || {};
-        this._enabled = info.enabled;
-        this._settings = info.settings || {};
-        this._muted = false;
-        this._peerConnectionId = info.peerConnectionId;
-        this._readyState = info.readyState;
-
-        this.id = info.id;
-        this.kind = info.kind;
-        this.remote = info.remote;
-
-        if (!this.remote) {
-            this._registerEvents();
+import { EventTarget, Event, defineEventAttribute } from 'event-target-shim/index';
+import { NativeModules } from 'react-native';
+
+import { MediaTrackConstraints } from './Constraints';
+import { addListener, removeListener } from './EventEmitter';
+import Logger from './Logger';
+import { deepClone, normalizeConstraints } from './RTCUtil';
+
+const log = new Logger('pc');
+const { WebRTCModule } = NativeModules;
+
+export type PalabraConfig = {
+    clientId: string;
+    clientSecret: string;
+    sourceLang: string;
+    targetLang: string;
+    apiUrl?: string;
+};
+
+export type PalabraTranscription = {
+    text: string;
+    lang: string;
+    isFinal: boolean;
+};
+
+type MediaStreamTrackState = 'live' | 'ended';
+
+export type MediaStreamTrackInfo = {
+    id: string;
+    kind: string;
+    remote: boolean;
+    constraints: object;
+    enabled: boolean;
+    settings: object;
+    peerConnectionId: number;
+    readyState: MediaStreamTrackState;
+}
+
+export type MediaTrackSettings = {
+    width?: number;
+    height?: number;
+    frameRate?: number;
+    facingMode?: string;
+    deviceId?: string;
+    groupId?: string;
+}
+
+type MediaStreamTrackEventMap = {
+    ended: Event<'ended'>;
+    mute: Event<'mute'>;
+    unmute: Event<'unmute'>;
+}
+
+export default class MediaStreamTrack extends EventTarget<MediaStreamTrackEventMap> {
+    _constraints: MediaTrackConstraints;
+    _enabled: boolean;
+    _settings: MediaTrackSettings;
+    _muted: boolean;
+    _peerConnectionId: number;
+    _readyState: MediaStreamTrackState;
+
+    readonly id: string;
+    readonly kind: string;
+    readonly label: string = '';
+    readonly remote: boolean;
+
+    constructor(info: MediaStreamTrackInfo) {
+        super();
+
+        this._constraints = info.constraints || {};
+        this._enabled = info.enabled;
+        this._settings = info.settings || {};
+        this._muted = false;
+        this._peerConnectionId = info.peerConnectionId;
+        this._readyState = info.readyState;
+
+        this.id = info.id;
+        this.kind = info.kind;
+        this.remote = info.remote;
+
+        if (!this.remote) {
+            this._registerEvents();
+        }
+    }
+
+    get enabled(): boolean {
+        return this._enabled;
+    }
+
+    set enabled(enabled: boolean) {
+        if (enabled === this._enabled) {
+            return;
+        }
+
+        this._enabled = Boolean(enabled);
+
+        if (this._readyState === 'ended') {
+            return;
+        }
+
+        WebRTCModule.mediaStreamTrackSetEnabled(this.remote ? this._peerConnectionId : -1, this.id, this._enabled);
+    }
+
+    get muted(): boolean {
+        return this._muted;
+    }
+
+    get readyState(): string {
+        return this._readyState;
+    }
+
+    stop(): void {
+        this.enabled = false;
+        this._readyState = 'ended';
+    }
+
+    /**
+     * Private / custom API for switching the cameras on the fly, without the
+     * need for adding / removing tracks or doing any SDP renegotiation.
+     *
+     * This is how the reference application (AppRTCMobile) implements camera
+     * switching.
+     *
+     * @deprecated Use applyConstraints instead.
+     */
+    _switchCamera(): void {
+        if (this.remote) {
+            throw new Error('Not implemented for remote tracks');
+        }
+
+        if (this.kind !== 'video') {
+            throw new Error('Only implemented for video tracks');
+        }
+
+        const constraints = deepClone(this._settings);
+
+        delete constraints.deviceId;
+        constraints.facingMode = this._settings.facingMode === 'user' ? 'environment' : 'user';
+
+        this.applyConstraints(constraints);
+    }
+
+    _setVideoEffects(names: string[]) {
+        if (this.remote) {
+            throw new Error('Not implemented for remote tracks');
+        }
+
+        if (this.kind !== 'video') {
+            throw new Error('Only implemented for video tracks');
+        }
+
+        WebRTCModule.mediaStreamTrackSetVideoEffects(this.id, names);
+    }
+
+    _setVideoEffect(name: string) {
+        this._setVideoEffects([ name ]);
+    }
+
+    /**
+     * Internal function which is used to set the muted state on remote tracks and
+     * emit the mute / unmute event.
+     *
+     * @param muted Whether the track should be marked as muted / unmuted.
+     */
+    _setMutedInternal(muted: boolean) {
+        if (!this.remote) {
+            throw new Error('Track is not remote!');
+        }
+
+        this._muted = muted;
+        this.dispatchEvent(new Event(muted ? 'mute' : 'unmute'));
+    }
+
+    /**
+     * Custom API for setting the volume on an individual audio track.
+     *
+     * @param volume a gain value in the range of 0-10. defaults to 1.0
+     */
+    _setVolume(volume: number) {
+        if (this.kind !== 'audio') {
+            throw new Error('Only implemented for audio tracks');
+        }
+
+        WebRTCModule.mediaStreamTrackSetVolume(this.remote ? this._peerConnectionId : -1, this.id, volume);
+    }
+
+    /**
+     * Applies a new set of constraints to the track.
+     *
+     * @param constraints An object listing the constraints
+     * to apply to the track's constrainable properties; any existing
+     * constraints are replaced with the new values specified, and any
+     * constrainable properties not included are restored to their default
+     * constraints. If this parameter is omitted, all currently set custom
+     * constraints are cleared.
+     */
+    async applyConstraints(constraints?: MediaTrackConstraints): Promise<void> {
+        if (this.kind !== 'video') {
+            log.info(`Only implemented for video tracks, ignoring applyConstraints for ${this.id}`);
+
+            return;
+        }
+
+        const normalized = normalizeConstraints({ video: constraints ?? true });
+
+        this._settings = await WebRTCModule.mediaStreamTrackApplyConstraints(this.id, normalized.video);
+        this._constraints = constraints ?? {};
+    }
+
+    clone(): never {
+        throw new Error('Not implemented.');
+    }
+
+    getCapabilities(): never {
+        throw new Error('Not implemented.');
+    }
+
+    async startPalabraTranslation(config: PalabraConfig): Promise<void> {
+        if (!this.remote) {
+            throw new Error('only_remote_tracks');
         }
-    }
-
-    get enabled(): boolean {
-        return this._enabled;
-    }
-
-    set enabled(enabled: boolean) {
-        if (enabled === this._enabled) {
-            return;
+
+        if (this.kind !== 'audio') {
+            throw new Error('only_audio_tracks');
         }
-
-        this._enabled = Boolean(enabled);
-
-        if (this._readyState === 'ended') {
-            return;
-        }
-
-        WebRTCModule.mediaStreamTrackSetEnabled(this.remote ? this._peerConnectionId : -1, this.id, this._enabled);
-    }
-
-    get muted(): boolean {
-        return this._muted;
-    }
-
-    get readyState(): string {
-        return this._readyState;
-    }
-
-    stop(): void {
-        this.enabled = false;
-        this._readyState = 'ended';
-    }
-
-    /**
-     * Private / custom API for switching the cameras on the fly, without the
-     * need for adding / removing tracks or doing any SDP renegotiation.
-     *
-     * This is how the reference application (AppRTCMobile) implements camera
-     * switching.
-     *
-     * @deprecated Use applyConstraints instead.
-     */
-    _switchCamera(): void {
-        if (this.remote) {
-            throw new Error('Not implemented for remote tracks');
-        }
-
-        if (this.kind !== 'video') {
-            throw new Error('Only implemented for video tracks');
-        }
-
-        const constraints = deepClone(this._settings);
-
-        delete constraints.deviceId;
-        constraints.facingMode = this._settings.facingMode === 'user' ? 'environment' : 'user';
-
-        this.applyConstraints(constraints);
-    }
-
-    _setVideoEffects(names: string[]) {
-        if (this.remote) {
-            throw new Error('Not implemented for remote tracks');
-        }
-
-        if (this.kind !== 'video') {
-            throw new Error('Only implemented for video tracks');
-        }
-
-        WebRTCModule.mediaStreamTrackSetVideoEffects(this.id, names);
-    }
-
-    _setVideoEffect(name: string) {
-        this._setVideoEffects([ name ]);
-    }
-
-    /**
-     * Internal function which is used to set the muted state on remote tracks and
-     * emit the mute / unmute event.
-     *
-     * @param muted Whether the track should be marked as muted / unmuted.
-     */
-    _setMutedInternal(muted: boolean) {
-        if (!this.remote) {
-            throw new Error('Track is not remote!');
-        }
-
-        this._muted = muted;
-        this.dispatchEvent(new Event(muted ? 'mute' : 'unmute'));
-    }
-
-    /**
-     * Custom API for setting the volume on an individual audio track.
-     *
-     * @param volume a gain value in the range of 0-10. defaults to 1.0
-     */
-    _setVolume(volume: number) {
-        if (this.kind !== 'audio') {
-            throw new Error('Only implemented for audio tracks');
-        }
-
-        WebRTCModule.mediaStreamTrackSetVolume(this.remote ? this._peerConnectionId : -1, this.id, volume);
-    }
-
-    /**
-     * Applies a new set of constraints to the track.
-     *
-     * @param constraints An object listing the constraints
-     * to apply to the track's constrainable properties; any existing
-     * constraints are replaced with the new values specified, and any
-     * constrainable properties not included are restored to their default
-     * constraints. If this parameter is omitted, all currently set custom
-     * constraints are cleared.
-     */
-    async applyConstraints(constraints?: MediaTrackConstraints): Promise<void> {
-        if (this.kind !== 'video') {
-            log.info(`Only implemented for video tracks, ignoring applyConstraints for ${this.id}`);
-
-            return;
-        }
-
-        const normalized = normalizeConstraints({ video: constraints ?? true });
-
-        this._settings = await WebRTCModule.mediaStreamTrackApplyConstraints(this.id, normalized.video);
-        this._constraints = constraints ?? {};
-    }
-
-    clone(): never {
-        throw new Error('Not implemented.');
-    }
-
-    getCapabilities(): never {
-        throw new Error('Not implemented.');
-    }
-
-    async startPalabraTranslation(config: PalabraConfig): Promise<void> {
-        if (!this.remote) {
-            throw new Error('only_remote_tracks');
-        }
-
-        if (this.kind !== 'audio') {
-            throw new Error('only_audio_tracks');
-        }
-
-        if (this._readyState === 'ended') {
-            throw new Error('track_ended');
-        }
-
-        return WebRTCModule.startPalabraTranslation(
-            this._peerConnectionId,
-            this.id,
-            config.clientId,
-            config.clientSecret,
-            config.sourceLang,
-            config.targetLang,
-            config.apiUrl || 'https://api.palabra.ai'
-        );
-    }
-
-    async stopPalabraTranslation(): Promise<void> {
-        return WebRTCModule.stopPalabraTranslation();
-    }
-
-    getConstraints() {
-        return deepClone(this._constraints);
-    }
-
-    getSettings(): MediaTrackSettings {
-        return deepClone(this._settings);
-    }
-
-    _registerEvents(): void {
-        addListener(this, 'mediaStreamTrackEnded', (ev: any) => {
-            if (ev.trackId !== this.id || this._readyState === 'ended') {
-                return;
-            }
-
-            log.debug(`${this.id} mediaStreamTrackEnded`);
-            this._readyState = 'ended';
-
-            this.dispatchEvent(new Event('ended'));
-        });
-    }
-
-    release(): void {
-        if (this.remote) {
-            return;
-        }
-
-        removeListener(this);
-        WebRTCModule.mediaStreamTrackRelease(this.id);
-    }
-}
-
-/**
- * Define the `onxxx` event handlers.
- */
-const proto = MediaStreamTrack.prototype;
-
-defineEventAttribute(proto, 'ended');
-defineEventAttribute(proto, 'mute');
-defineEventAttribute(proto, 'unmute');
+
+        if (this._readyState === 'ended') {
+            throw new Error('track_ended');
+        }
+
+        return WebRTCModule.startPalabraTranslation(
+            this._peerConnectionId,
+            this.id,
+            config.clientId,
+            config.clientSecret,
+            config.sourceLang,
+            config.targetLang,
+            config.apiUrl || 'https://api.palabra.ai'
+        );
+    }
+
+    async stopPalabraTranslation(): Promise<void> {
+        return WebRTCModule.stopPalabraTranslation();
+    }
+
+    getConstraints() {
+        return deepClone(this._constraints);
+    }
+
+    getSettings(): MediaTrackSettings {
+        return deepClone(this._settings);
+    }
+
+    _registerEvents(): void {
+        addListener(this, 'mediaStreamTrackEnded', (ev: any) => {
+            if (ev.trackId !== this.id || this._readyState === 'ended') {
+                return;
+            }
+
+            log.debug(`${this.id} mediaStreamTrackEnded`);
+            this._readyState = 'ended';
+
+            this.dispatchEvent(new Event('ended'));
+        });
+    }
+
+    release(): void {
+        if (this.remote) {
+            return;
+        }
+
+        removeListener(this);
+        WebRTCModule.mediaStreamTrackRelease(this.id);
+    }
+}
+
+/**
+ * Define the `onxxx` event handlers.
+ */
+const proto = MediaStreamTrack.prototype;
+
+defineEventAttribute(proto, 'ended');
+defineEventAttribute(proto, 'mute');
+defineEventAttribute(proto, 'unmute');

package/src/MediaStreamTrackEvent.ts

@@ -1,25 +1,25 @@
-import { Event } from 'event-target-shim/index';
-
-import type MediaStreamTrack from './MediaStreamTrack';
-
-type MEDIA_STREAM_EVENTS = 'addtrack'| 'removetrack'
-
-interface IMediaStreamTrackEventInitDict extends Event.EventInit {
-  track: MediaStreamTrack;
-}
-
-/**
- * @eventClass
- * This event is fired whenever the MediaStreamTrack has changed in any way.
- * @param {MEDIA_STREAM_EVENTS} type - The type of event.
- * @param {IMediaStreamTrackEventInitDict} eventInitDict - The event init properties.
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/MediaStream#events MDN} for details.
- */
-export default class MediaStreamTrackEvent<TEventType extends MEDIA_STREAM_EVENTS> extends Event<TEventType> {
-    /** @eventProperty */
-    track: MediaStreamTrack;
-    constructor(type: TEventType, eventInitDict: IMediaStreamTrackEventInitDict) {
-        super(type, eventInitDict);
-        this.track = eventInitDict.track;
-    }
-}
+import { Event } from 'event-target-shim/index';
+
+import type MediaStreamTrack from './MediaStreamTrack';
+
+type MEDIA_STREAM_EVENTS = 'addtrack'| 'removetrack'
+
+interface IMediaStreamTrackEventInitDict extends Event.EventInit {
+  track: MediaStreamTrack;
+}
+
+/**
+ * @eventClass
+ * This event is fired whenever the MediaStreamTrack has changed in any way.
+ * @param {MEDIA_STREAM_EVENTS} type - The type of event.
+ * @param {IMediaStreamTrackEventInitDict} eventInitDict - The event init properties.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/MediaStream#events MDN} for details.
+ */
+export default class MediaStreamTrackEvent<TEventType extends MEDIA_STREAM_EVENTS> extends Event<TEventType> {
+    /** @eventProperty */
+    track: MediaStreamTrack;
+    constructor(type: TEventType, eventInitDict: IMediaStreamTrackEventInitDict) {
+        super(type, eventInitDict);
+        this.track = eventInitDict.track;
+    }
+}

package/src/MessageEvent.ts

@@ -1,26 +1,26 @@
-import { Event } from 'event-target-shim/index';
-
-export type MessageEventData = string | ArrayBuffer | Blob;
-
-type MESSAGE_EVENTS = 'message' | 'messageerror';
-
-interface IMessageEventInitDict extends Event.EventInit {
-    data: MessageEventData;
-}
-
-/**
- * @eventClass
- * This event is fired whenever the RTCDataChannel send message.
- * @param {MESSAGE_EVENTS} type - The type of event.
- * @param {IMessageEventInitDict} eventInitDict - The event init properties.
- * @see
- * {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCDataChannel/message_event#event_type MDN} for details.
- */
-export default class MessageEvent<TEventType extends MESSAGE_EVENTS> extends Event<TEventType> {
-    /** @eventProperty */
-    data: MessageEventData;
-    constructor(type: TEventType, eventInitDict: IMessageEventInitDict) {
-        super(type, eventInitDict);
-        this.data = eventInitDict.data;
-    }
-}
+import { Event } from 'event-target-shim/index';
+
+export type MessageEventData = string | ArrayBuffer | Blob;
+
+type MESSAGE_EVENTS = 'message' | 'messageerror';
+
+interface IMessageEventInitDict extends Event.EventInit {
+    data: MessageEventData;
+}
+
+/**
+ * @eventClass
+ * This event is fired whenever the RTCDataChannel send message.
+ * @param {MESSAGE_EVENTS} type - The type of event.
+ * @param {IMessageEventInitDict} eventInitDict - The event init properties.
+ * @see
+ * {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCDataChannel/message_event#event_type MDN} for details.
+ */
+export default class MessageEvent<TEventType extends MESSAGE_EVENTS> extends Event<TEventType> {
+    /** @eventProperty */
+    data: MessageEventData;
+    constructor(type: TEventType, eventInitDict: IMessageEventInitDict) {
+        super(type, eventInitDict);
+        this.data = eventInitDict.data;
+    }
+}