@unwanted/matrix-sdk-mini 34.12.0-1

package/lib/webrtc/callFeed.js

@@ -0,0 +1,289 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/*
+Copyright 2021 Šimon Brandner <simon.bra.ag@gmail.com>
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { SDPStreamMetadataPurpose } from "./callEventTypes.js";
+import { acquireContext, releaseContext } from "./audioContext.js";
+import { logger } from "../logger.js";
+import { TypedEventEmitter } from "../models/typed-event-emitter.js";
+import { CallEvent, CallState } from "./call.js";
+var POLLING_INTERVAL = 200; // ms
+export var SPEAKING_THRESHOLD = -60; // dB
+var SPEAKING_SAMPLE_COUNT = 8; // samples
+
+export var CallFeedEvent = /*#__PURE__*/function (CallFeedEvent) {
+  CallFeedEvent["NewStream"] = "new_stream";
+  CallFeedEvent["MuteStateChanged"] = "mute_state_changed";
+  CallFeedEvent["LocalVolumeChanged"] = "local_volume_changed";
+  CallFeedEvent["VolumeChanged"] = "volume_changed";
+  CallFeedEvent["ConnectedChanged"] = "connected_changed";
+  CallFeedEvent["Speaking"] = "speaking";
+  CallFeedEvent["Disposed"] = "disposed";
+  return CallFeedEvent;
+}({});
+export class CallFeed extends TypedEventEmitter {
+  constructor(opts) {
+    super();
+    _defineProperty(this, "stream", void 0);
+    _defineProperty(this, "sdpMetadataStreamId", void 0);
+    _defineProperty(this, "userId", void 0);
+    _defineProperty(this, "deviceId", void 0);
+    _defineProperty(this, "purpose", void 0);
+    _defineProperty(this, "speakingVolumeSamples", void 0);
+    _defineProperty(this, "client", void 0);
+    _defineProperty(this, "call", void 0);
+    _defineProperty(this, "roomId", void 0);
+    _defineProperty(this, "audioMuted", void 0);
+    _defineProperty(this, "videoMuted", void 0);
+    _defineProperty(this, "localVolume", 1);
+    _defineProperty(this, "measuringVolumeActivity", false);
+    _defineProperty(this, "audioContext", void 0);
+    _defineProperty(this, "analyser", void 0);
+    _defineProperty(this, "frequencyBinCount", void 0);
+    _defineProperty(this, "speakingThreshold", SPEAKING_THRESHOLD);
+    _defineProperty(this, "speaking", false);
+    _defineProperty(this, "volumeLooperTimeout", void 0);
+    _defineProperty(this, "_disposed", false);
+    _defineProperty(this, "_connected", false);
+    _defineProperty(this, "onAddTrack", () => {
+      this.emit(CallFeedEvent.NewStream, this.stream);
+    });
+    _defineProperty(this, "onCallState", state => {
+      if (state === CallState.Connected) {
+        this.connected = true;
+      } else if (state === CallState.Connecting) {
+        this.connected = false;
+      }
+    });
+    _defineProperty(this, "volumeLooper", () => {
+      if (!this.analyser) return;
+      if (!this.measuringVolumeActivity) return;
+      this.analyser.getFloatFrequencyData(this.frequencyBinCount);
+      var maxVolume = -Infinity;
+      for (var volume of this.frequencyBinCount) {
+        if (volume > maxVolume) {
+          maxVolume = volume;
+        }
+      }
+      this.speakingVolumeSamples.shift();
+      this.speakingVolumeSamples.push(maxVolume);
+      this.emit(CallFeedEvent.VolumeChanged, maxVolume);
+      var newSpeaking = false;
+      for (var _volume of this.speakingVolumeSamples) {
+        if (_volume > this.speakingThreshold) {
+          newSpeaking = true;
+          break;
+        }
+      }
+      if (this.speaking !== newSpeaking) {
+        this.speaking = newSpeaking;
+        this.emit(CallFeedEvent.Speaking, this.speaking);
+      }
+      this.volumeLooperTimeout = setTimeout(this.volumeLooper, POLLING_INTERVAL);
+    });
+    this.client = opts.client;
+    this.call = opts.call;
+    this.roomId = opts.roomId;
+    this.userId = opts.userId;
+    this.deviceId = opts.deviceId;
+    this.purpose = opts.purpose;
+    this.audioMuted = opts.audioMuted;
+    this.videoMuted = opts.videoMuted;
+    this.speakingVolumeSamples = new Array(SPEAKING_SAMPLE_COUNT).fill(-Infinity);
+    this.sdpMetadataStreamId = opts.stream.id;
+    this.updateStream(null, opts.stream);
+    this.stream = opts.stream; // updateStream does this, but this makes TS happier
+
+    if (this.hasAudioTrack) {
+      this.initVolumeMeasuring();
+    }
+    if (opts.call) {
+      opts.call.addListener(CallEvent.State, this.onCallState);
+      this.onCallState(opts.call.state);
+    }
+  }
+  get connected() {
+    // Local feeds are always considered connected
+    return this.isLocal() || this._connected;
+  }
+  set connected(connected) {
+    this._connected = connected;
+    this.emit(CallFeedEvent.ConnectedChanged, this.connected);
+  }
+  get hasAudioTrack() {
+    return this.stream.getAudioTracks().length > 0;
+  }
+  updateStream(oldStream, newStream) {
+    if (newStream === oldStream) return;
+    var wasMeasuringVolumeActivity = this.measuringVolumeActivity;
+    if (oldStream) {
+      oldStream.removeEventListener("addtrack", this.onAddTrack);
+      this.measureVolumeActivity(false);
+    }
+    this.stream = newStream;
+    newStream.addEventListener("addtrack", this.onAddTrack);
+    if (this.hasAudioTrack) {
+      this.initVolumeMeasuring();
+      if (wasMeasuringVolumeActivity) this.measureVolumeActivity(true);
+    } else {
+      this.measureVolumeActivity(false);
+    }
+    this.emit(CallFeedEvent.NewStream, this.stream);
+  }
+  initVolumeMeasuring() {
+    if (!this.hasAudioTrack) return;
+    if (!this.audioContext) this.audioContext = acquireContext();
+    this.analyser = this.audioContext.createAnalyser();
+    this.analyser.fftSize = 512;
+    this.analyser.smoothingTimeConstant = 0.1;
+    var mediaStreamAudioSourceNode = this.audioContext.createMediaStreamSource(this.stream);
+    mediaStreamAudioSourceNode.connect(this.analyser);
+    this.frequencyBinCount = new Float32Array(this.analyser.frequencyBinCount);
+  }
+  /**
+   * Returns callRoom member
+   * @returns member of the callRoom
+   */
+  getMember() {
+    var _callRoom$getMember;
+    var callRoom = this.client.getRoom(this.roomId);
+    return (_callRoom$getMember = callRoom === null || callRoom === void 0 ? void 0 : callRoom.getMember(this.userId)) !== null && _callRoom$getMember !== void 0 ? _callRoom$getMember : null;
+  }
+
+  /**
+   * Returns true if CallFeed is local, otherwise returns false
+   * @returns is local?
+   */
+  isLocal() {
+    return this.userId === this.client.getUserId() && (this.deviceId === undefined || this.deviceId === this.client.getDeviceId());
+  }
+
+  /**
+   * Returns true if audio is muted or if there are no audio
+   * tracks, otherwise returns false
+   * @returns is audio muted?
+   */
+  isAudioMuted() {
+    return this.stream.getAudioTracks().length === 0 || this.audioMuted;
+  }
+
+  /**
+   * Returns true video is muted or if there are no video
+   * tracks, otherwise returns false
+   * @returns is video muted?
+   */
+  isVideoMuted() {
+    // We assume only one video track
+    return this.stream.getVideoTracks().length === 0 || this.videoMuted;
+  }
+  isSpeaking() {
+    return this.speaking;
+  }
+
+  /**
+   * Replaces the current MediaStream with a new one.
+   * The stream will be different and new stream as remote parties are
+   * concerned, but this can be used for convenience locally to set up
+   * volume listeners automatically on the new stream etc.
+   * @param newStream - new stream with which to replace the current one
+   */
+  setNewStream(newStream) {
+    this.updateStream(this.stream, newStream);
+  }
+
+  /**
+   * Set one or both of feed's internal audio and video video mute state
+   * Either value may be null to leave it as-is
+   * @param audioMuted - is the feed's audio muted?
+   * @param videoMuted - is the feed's video muted?
+   */
+  setAudioVideoMuted(audioMuted, videoMuted) {
+    if (audioMuted !== null) {
+      if (this.audioMuted !== audioMuted) {
+        this.speakingVolumeSamples.fill(-Infinity);
+      }
+      this.audioMuted = audioMuted;
+    }
+    if (videoMuted !== null) this.videoMuted = videoMuted;
+    this.emit(CallFeedEvent.MuteStateChanged, this.audioMuted, this.videoMuted);
+  }
+
+  /**
+   * Starts emitting volume_changed events where the emitter value is in decibels
+   * @param enabled - emit volume changes
+   */
+  measureVolumeActivity(enabled) {
+    if (enabled) {
+      if (!this.analyser || !this.frequencyBinCount || !this.hasAudioTrack) return;
+      this.measuringVolumeActivity = true;
+      this.volumeLooper();
+    } else {
+      this.measuringVolumeActivity = false;
+      this.speakingVolumeSamples.fill(-Infinity);
+      this.emit(CallFeedEvent.VolumeChanged, -Infinity);
+    }
+  }
+  setSpeakingThreshold(threshold) {
+    this.speakingThreshold = threshold;
+  }
+  clone() {
+    var mediaHandler = this.client.getMediaHandler();
+    var stream = this.stream.clone();
+    logger.log("CallFeed clone() cloning stream (originalStreamId=".concat(this.stream.id, ", newStreamId").concat(stream.id, ")"));
+    if (this.purpose === SDPStreamMetadataPurpose.Usermedia) {
+      mediaHandler.userMediaStreams.push(stream);
+    } else {
+      mediaHandler.screensharingStreams.push(stream);
+    }
+    return new CallFeed({
+      client: this.client,
+      roomId: this.roomId,
+      userId: this.userId,
+      deviceId: this.deviceId,
+      stream,
+      purpose: this.purpose,
+      audioMuted: this.audioMuted,
+      videoMuted: this.videoMuted
+    });
+  }
+  dispose() {
+    var _this$stream, _this$call;
+    clearTimeout(this.volumeLooperTimeout);
+    (_this$stream = this.stream) === null || _this$stream === void 0 || _this$stream.removeEventListener("addtrack", this.onAddTrack);
+    (_this$call = this.call) === null || _this$call === void 0 || _this$call.removeListener(CallEvent.State, this.onCallState);
+    if (this.audioContext) {
+      this.audioContext = undefined;
+      this.analyser = undefined;
+      releaseContext();
+    }
+    this._disposed = true;
+    this.emit(CallFeedEvent.Disposed);
+  }
+  get disposed() {
+    return this._disposed;
+  }
+  set disposed(value) {
+    this._disposed = value;
+  }
+  getLocalVolume() {
+    return this.localVolume;
+  }
+  setLocalVolume(localVolume) {
+    this.localVolume = localVolume;
+    this.emit(CallFeedEvent.LocalVolumeChanged, localVolume);
+  }
+}
+//# sourceMappingURL=callFeed.js.map

package/lib/webrtc/callFeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callFeed.js","names":["SDPStreamMetadataPurpose","acquireContext","releaseContext","logger","TypedEventEmitter","CallEvent","CallState","POLLING_INTERVAL","SPEAKING_THRESHOLD","SPEAKING_SAMPLE_COUNT","CallFeedEvent","CallFeed","constructor","opts","_defineProperty","emit","NewStream","stream","state","Connected","connected","Connecting","analyser","measuringVolumeActivity","getFloatFrequencyData","frequencyBinCount","maxVolume","Infinity","volume","speakingVolumeSamples","shift","push","VolumeChanged","newSpeaking","speakingThreshold","speaking","Speaking","volumeLooperTimeout","setTimeout","volumeLooper","client","call","roomId","userId","deviceId","purpose","audioMuted","videoMuted","Array","fill","sdpMetadataStreamId","id","updateStream","hasAudioTrack","initVolumeMeasuring","addListener","State","onCallState","isLocal","_connected","ConnectedChanged","getAudioTracks","length","oldStream","newStream","wasMeasuringVolumeActivity","removeEventListener","onAddTrack","measureVolumeActivity","addEventListener","audioContext","createAnalyser","fftSize","smoothingTimeConstant","mediaStreamAudioSourceNode","createMediaStreamSource","connect","Float32Array","getMember","_callRoom$getMember","callRoom","getRoom","getUserId","undefined","getDeviceId","isAudioMuted","isVideoMuted","getVideoTracks","isSpeaking","setNewStream","setAudioVideoMuted","MuteStateChanged","enabled","setSpeakingThreshold","threshold","clone","mediaHandler","getMediaHandler","log","concat","Usermedia","userMediaStreams","screensharingStreams","dispose","_this$stream","_this$call","clearTimeout","removeListener","_disposed","Disposed","disposed","value","getLocalVolume","localVolume","setLocalVolume","LocalVolumeChanged"],"sources":["../../src/webrtc/callFeed.ts"],"sourcesContent":["/*\nCopyright 2021 Šimon Brandner <simon.bra.ag@gmail.com>\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n*/\n\nimport { SDPStreamMetadataPurpose } from \"./callEventTypes.ts\";\nimport { acquireContext, releaseContext } from \"./audioContext.ts\";\nimport { MatrixClient } from \"../client.ts\";\nimport { RoomMember } from \"../models/room-member.ts\";\nimport { logger } from \"../logger.ts\";\nimport { TypedEventEmitter } from \"../models/typed-event-emitter.ts\";\nimport { CallEvent, CallState, MatrixCall } from \"./call.ts\";\n\nconst POLLING_INTERVAL = 200; // ms\nexport const SPEAKING_THRESHOLD = -60; // dB\nconst SPEAKING_SAMPLE_COUNT = 8; // samples\n\nexport interface ICallFeedOpts {\n    client: MatrixClient;\n    roomId?: string;\n    userId: string;\n    deviceId: string | undefined;\n    stream: MediaStream;\n    purpose: SDPStreamMetadataPurpose;\n    /**\n     * Whether or not the remote SDPStreamMetadata says audio is muted\n     */\n    audioMuted: boolean;\n    /**\n     * Whether or not the remote SDPStreamMetadata says video is muted\n     */\n    videoMuted: boolean;\n    /**\n     * The MatrixCall which is the source of this CallFeed\n     */\n    call?: MatrixCall;\n}\n\nexport enum CallFeedEvent {\n    NewStream = \"new_stream\",\n    MuteStateChanged = \"mute_state_changed\",\n    LocalVolumeChanged = \"local_volume_changed\",\n    VolumeChanged = \"volume_changed\",\n    ConnectedChanged = \"connected_changed\",\n    Speaking = \"speaking\",\n    Disposed = \"disposed\",\n}\n\ntype EventHandlerMap = {\n    [CallFeedEvent.NewStream]: (stream: MediaStream) => void;\n    [CallFeedEvent.MuteStateChanged]: (audioMuted: boolean, videoMuted: boolean) => void;\n    [CallFeedEvent.LocalVolumeChanged]: (localVolume: number) => void;\n    [CallFeedEvent.VolumeChanged]: (volume: number) => void;\n    [CallFeedEvent.ConnectedChanged]: (connected: boolean) => void;\n    [CallFeedEvent.Speaking]: (speaking: boolean) => void;\n    [CallFeedEvent.Disposed]: () => void;\n};\n\nexport class CallFeed extends TypedEventEmitter<CallFeedEvent, EventHandlerMap> {\n    public stream: MediaStream;\n    public sdpMetadataStreamId: string;\n    public userId: string;\n    public readonly deviceId: string | undefined;\n    public purpose: SDPStreamMetadataPurpose;\n    public speakingVolumeSamples: number[];\n\n    private client: MatrixClient;\n    private call?: MatrixCall;\n    private roomId?: string;\n    private audioMuted: boolean;\n    private videoMuted: boolean;\n    private localVolume = 1;\n    private measuringVolumeActivity = false;\n    private audioContext?: AudioContext;\n    private analyser?: AnalyserNode;\n    private frequencyBinCount?: Float32Array;\n    private speakingThreshold = SPEAKING_THRESHOLD;\n    private speaking = false;\n    private volumeLooperTimeout?: ReturnType<typeof setTimeout>;\n    private _disposed = false;\n    private _connected = false;\n\n    public constructor(opts: ICallFeedOpts) {\n        super();\n\n        this.client = opts.client;\n        this.call = opts.call;\n        this.roomId = opts.roomId;\n        this.userId = opts.userId;\n        this.deviceId = opts.deviceId;\n        this.purpose = opts.purpose;\n        this.audioMuted = opts.audioMuted;\n        this.videoMuted = opts.videoMuted;\n        this.speakingVolumeSamples = new Array(SPEAKING_SAMPLE_COUNT).fill(-Infinity);\n        this.sdpMetadataStreamId = opts.stream.id;\n\n        this.updateStream(null, opts.stream);\n        this.stream = opts.stream; // updateStream does this, but this makes TS happier\n\n        if (this.hasAudioTrack) {\n            this.initVolumeMeasuring();\n        }\n\n        if (opts.call) {\n            opts.call.addListener(CallEvent.State, this.onCallState);\n            this.onCallState(opts.call.state);\n        }\n    }\n\n    public get connected(): boolean {\n        // Local feeds are always considered connected\n        return this.isLocal() || this._connected;\n    }\n\n    private set connected(connected: boolean) {\n        this._connected = connected;\n        this.emit(CallFeedEvent.ConnectedChanged, this.connected);\n    }\n\n    public get hasAudioTrack(): boolean {\n        return this.stream.getAudioTracks().length > 0;\n    }\n\n    private updateStream(oldStream: MediaStream | null, newStream: MediaStream): void {\n        if (newStream === oldStream) return;\n\n        const wasMeasuringVolumeActivity = this.measuringVolumeActivity;\n\n        if (oldStream) {\n            oldStream.removeEventListener(\"addtrack\", this.onAddTrack);\n            this.measureVolumeActivity(false);\n        }\n\n        this.stream = newStream;\n        newStream.addEventListener(\"addtrack\", this.onAddTrack);\n\n        if (this.hasAudioTrack) {\n            this.initVolumeMeasuring();\n            if (wasMeasuringVolumeActivity) this.measureVolumeActivity(true);\n        } else {\n            this.measureVolumeActivity(false);\n        }\n\n        this.emit(CallFeedEvent.NewStream, this.stream);\n    }\n\n    private initVolumeMeasuring(): void {\n        if (!this.hasAudioTrack) return;\n        if (!this.audioContext) this.audioContext = acquireContext();\n\n        this.analyser = this.audioContext.createAnalyser();\n        this.analyser.fftSize = 512;\n        this.analyser.smoothingTimeConstant = 0.1;\n\n        const mediaStreamAudioSourceNode = this.audioContext.createMediaStreamSource(this.stream);\n        mediaStreamAudioSourceNode.connect(this.analyser);\n\n        this.frequencyBinCount = new Float32Array(this.analyser.frequencyBinCount);\n    }\n\n    private onAddTrack = (): void => {\n        this.emit(CallFeedEvent.NewStream, this.stream);\n    };\n\n    private onCallState = (state: CallState): void => {\n        if (state === CallState.Connected) {\n            this.connected = true;\n        } else if (state === CallState.Connecting) {\n            this.connected = false;\n        }\n    };\n\n    /**\n     * Returns callRoom member\n     * @returns member of the callRoom\n     */\n    public getMember(): RoomMember | null {\n        const callRoom = this.client.getRoom(this.roomId);\n        return callRoom?.getMember(this.userId) ?? null;\n    }\n\n    /**\n     * Returns true if CallFeed is local, otherwise returns false\n     * @returns is local?\n     */\n    public isLocal(): boolean {\n        return (\n            this.userId === this.client.getUserId() &&\n            (this.deviceId === undefined || this.deviceId === this.client.getDeviceId())\n        );\n    }\n\n    /**\n     * Returns true if audio is muted or if there are no audio\n     * tracks, otherwise returns false\n     * @returns is audio muted?\n     */\n    public isAudioMuted(): boolean {\n        return this.stream.getAudioTracks().length === 0 || this.audioMuted;\n    }\n\n    /**\n     * Returns true video is muted or if there are no video\n     * tracks, otherwise returns false\n     * @returns is video muted?\n     */\n    public isVideoMuted(): boolean {\n        // We assume only one video track\n        return this.stream.getVideoTracks().length === 0 || this.videoMuted;\n    }\n\n    public isSpeaking(): boolean {\n        return this.speaking;\n    }\n\n    /**\n     * Replaces the current MediaStream with a new one.\n     * The stream will be different and new stream as remote parties are\n     * concerned, but this can be used for convenience locally to set up\n     * volume listeners automatically on the new stream etc.\n     * @param newStream - new stream with which to replace the current one\n     */\n    public setNewStream(newStream: MediaStream): void {\n        this.updateStream(this.stream, newStream);\n    }\n\n    /**\n     * Set one or both of feed's internal audio and video video mute state\n     * Either value may be null to leave it as-is\n     * @param audioMuted - is the feed's audio muted?\n     * @param videoMuted - is the feed's video muted?\n     */\n    public setAudioVideoMuted(audioMuted: boolean | null, videoMuted: boolean | null): void {\n        if (audioMuted !== null) {\n            if (this.audioMuted !== audioMuted) {\n                this.speakingVolumeSamples.fill(-Infinity);\n            }\n            this.audioMuted = audioMuted;\n        }\n        if (videoMuted !== null) this.videoMuted = videoMuted;\n        this.emit(CallFeedEvent.MuteStateChanged, this.audioMuted, this.videoMuted);\n    }\n\n    /**\n     * Starts emitting volume_changed events where the emitter value is in decibels\n     * @param enabled - emit volume changes\n     */\n    public measureVolumeActivity(enabled: boolean): void {\n        if (enabled) {\n            if (!this.analyser || !this.frequencyBinCount || !this.hasAudioTrack) return;\n\n            this.measuringVolumeActivity = true;\n            this.volumeLooper();\n        } else {\n            this.measuringVolumeActivity = false;\n            this.speakingVolumeSamples.fill(-Infinity);\n            this.emit(CallFeedEvent.VolumeChanged, -Infinity);\n        }\n    }\n\n    public setSpeakingThreshold(threshold: number): void {\n        this.speakingThreshold = threshold;\n    }\n\n    private volumeLooper = (): void => {\n        if (!this.analyser) return;\n\n        if (!this.measuringVolumeActivity) return;\n\n        this.analyser.getFloatFrequencyData(this.frequencyBinCount!);\n\n        let maxVolume = -Infinity;\n        for (const volume of this.frequencyBinCount!) {\n            if (volume > maxVolume) {\n                maxVolume = volume;\n            }\n        }\n\n        this.speakingVolumeSamples.shift();\n        this.speakingVolumeSamples.push(maxVolume);\n\n        this.emit(CallFeedEvent.VolumeChanged, maxVolume);\n\n        let newSpeaking = false;\n\n        for (const volume of this.speakingVolumeSamples) {\n            if (volume > this.speakingThreshold) {\n                newSpeaking = true;\n                break;\n            }\n        }\n\n        if (this.speaking !== newSpeaking) {\n            this.speaking = newSpeaking;\n            this.emit(CallFeedEvent.Speaking, this.speaking);\n        }\n\n        this.volumeLooperTimeout = setTimeout(this.volumeLooper, POLLING_INTERVAL);\n    };\n\n    public clone(): CallFeed {\n        const mediaHandler = this.client.getMediaHandler();\n        const stream = this.stream.clone();\n        logger.log(`CallFeed clone() cloning stream (originalStreamId=${this.stream.id}, newStreamId${stream.id})`);\n\n        if (this.purpose === SDPStreamMetadataPurpose.Usermedia) {\n            mediaHandler.userMediaStreams.push(stream);\n        } else {\n            mediaHandler.screensharingStreams.push(stream);\n        }\n\n        return new CallFeed({\n            client: this.client,\n            roomId: this.roomId,\n            userId: this.userId,\n            deviceId: this.deviceId,\n            stream,\n            purpose: this.purpose,\n            audioMuted: this.audioMuted,\n            videoMuted: this.videoMuted,\n        });\n    }\n\n    public dispose(): void {\n        clearTimeout(this.volumeLooperTimeout);\n        this.stream?.removeEventListener(\"addtrack\", this.onAddTrack);\n        this.call?.removeListener(CallEvent.State, this.onCallState);\n        if (this.audioContext) {\n            this.audioContext = undefined;\n            this.analyser = undefined;\n            releaseContext();\n        }\n        this._disposed = true;\n        this.emit(CallFeedEvent.Disposed);\n    }\n\n    public get disposed(): boolean {\n        return this._disposed;\n    }\n\n    private set disposed(value: boolean) {\n        this._disposed = value;\n    }\n\n    public getLocalVolume(): number {\n        return this.localVolume;\n    }\n\n    public setLocalVolume(localVolume: number): void {\n        this.localVolume = localVolume;\n        this.emit(CallFeedEvent.LocalVolumeChanged, localVolume);\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/webrtc/groupCall.d.ts

@@ -0,0 +1,323 @@
+import { TypedEventEmitter } from "../models/typed-event-emitter.ts";
+import { CallFeed } from "./callFeed.ts";
+import { MatrixClient } from "../client.ts";
+import { CallEvent, CallEventHandlerMap, MatrixCall } from "./call.ts";
+import { RoomMember } from "../models/room-member.ts";
+import { Room } from "../models/room.ts";
+import { SDPStreamMetadataPurpose } from "./callEventTypes.ts";
+import { IScreensharingOpts } from "./mediaHandler.ts";
+import { GroupCallStats } from "./stats/groupCallStats.ts";
+import { ByteSentStatsReport, CallFeedReport, ConnectionStatsReport, SummaryStatsReport } from "./stats/statsReport.ts";
+import { CallMembershipData } from "../matrixrtc/CallMembership.ts";
+export declare enum GroupCallIntent {
+    Ring = "m.ring",
+    Prompt = "m.prompt",
+    Room = "m.room"
+}
+export declare enum GroupCallType {
+    Video = "m.video",
+    Voice = "m.voice"
+}
+export declare enum GroupCallTerminationReason {
+    CallEnded = "call_ended"
+}
+export type CallsByUserAndDevice = Map<string, Map<string, MatrixCall>>;
+/**
+ * Because event names are just strings, they do need
+ * to be unique over all event types of event emitter.
+ * Some objects could emit more then one set of events.
+ */
+export declare enum GroupCallEvent {
+    GroupCallStateChanged = "group_call_state_changed",
+    ActiveSpeakerChanged = "active_speaker_changed",
+    CallsChanged = "calls_changed",
+    UserMediaFeedsChanged = "user_media_feeds_changed",
+    ScreenshareFeedsChanged = "screenshare_feeds_changed",
+    LocalScreenshareStateChanged = "local_screenshare_state_changed",
+    LocalMuteStateChanged = "local_mute_state_changed",
+    ParticipantsChanged = "participants_changed",
+    Error = "group_call_error"
+}
+export type GroupCallEventHandlerMap = {
+    [GroupCallEvent.GroupCallStateChanged]: (newState: GroupCallState, oldState: GroupCallState) => void;
+    [GroupCallEvent.ActiveSpeakerChanged]: (activeSpeaker: CallFeed | undefined) => void;
+    [GroupCallEvent.CallsChanged]: (calls: CallsByUserAndDevice) => void;
+    [GroupCallEvent.UserMediaFeedsChanged]: (feeds: CallFeed[]) => void;
+    [GroupCallEvent.ScreenshareFeedsChanged]: (feeds: CallFeed[]) => void;
+    [GroupCallEvent.LocalScreenshareStateChanged]: (isScreensharing: boolean, feed?: CallFeed, sourceId?: string) => void;
+    [GroupCallEvent.LocalMuteStateChanged]: (audioMuted: boolean, videoMuted: boolean) => void;
+    [GroupCallEvent.ParticipantsChanged]: (participants: Map<RoomMember, Map<string, ParticipantState>>) => void;
+    /**
+     * Fires whenever an error occurs when call.js encounters an issue with setting up the call.
+     * <p>
+     * The error given will have a code equal to either `MatrixCall.ERR_LOCAL_OFFER_FAILED` or
+     * `MatrixCall.ERR_NO_USER_MEDIA`. `ERR_LOCAL_OFFER_FAILED` is emitted when the local client
+     * fails to create an offer. `ERR_NO_USER_MEDIA` is emitted when the user has denied access
+     * to their audio/video hardware.
+     * @param error - The error raised by MatrixCall.
+     * @example
+     * ```
+     * matrixCall.on("error", function(err){
+     *   console.error(err.code, err);
+     * });
+     * ```
+     */
+    [GroupCallEvent.Error]: (error: GroupCallError) => void;
+};
+export declare enum GroupCallStatsReportEvent {
+    ConnectionStats = "GroupCall.connection_stats",
+    ByteSentStats = "GroupCall.byte_sent_stats",
+    SummaryStats = "GroupCall.summary_stats",
+    CallFeedStats = "GroupCall.call_feed_stats"
+}
+/**
+ * The final report-events that get consumed by client.
+ */
+export type GroupCallStatsReportEventHandlerMap = {
+    [GroupCallStatsReportEvent.ConnectionStats]: (report: GroupCallStatsReport<ConnectionStatsReport>) => void;
+    [GroupCallStatsReportEvent.ByteSentStats]: (report: GroupCallStatsReport<ByteSentStatsReport>) => void;
+    [GroupCallStatsReportEvent.SummaryStats]: (report: GroupCallStatsReport<SummaryStatsReport>) => void;
+    [GroupCallStatsReportEvent.CallFeedStats]: (report: GroupCallStatsReport<CallFeedReport>) => void;
+};
+export declare enum GroupCallErrorCode {
+    NoUserMedia = "no_user_media",
+    UnknownDevice = "unknown_device",
+    PlaceCallFailed = "place_call_failed"
+}
+export interface GroupCallStatsReport<T extends ConnectionStatsReport | ByteSentStatsReport | SummaryStatsReport | CallFeedReport> {
+    report: T;
+}
+export declare class GroupCallError extends Error {
+    code: string;
+    constructor(code: GroupCallErrorCode, msg: string, err?: Error);
+}
+export declare class GroupCallUnknownDeviceError extends GroupCallError {
+    userId: string;
+    constructor(userId: string);
+}
+export declare class OtherUserSpeakingError extends Error {
+    constructor();
+}
+export interface IGroupCallDataChannelOptions {
+    ordered: boolean;
+    maxPacketLifeTime: number;
+    maxRetransmits: number;
+    protocol: string;
+}
+export interface IGroupCallRoomState {
+    "m.intent": GroupCallIntent;
+    "m.type": GroupCallType;
+    "m.terminated"?: GroupCallTerminationReason;
+    "io.element.ptt"?: boolean;
+    "dataChannelsEnabled"?: boolean;
+    "dataChannelOptions"?: IGroupCallDataChannelOptions;
+    "io.element.livekit_service_url"?: string;
+}
+export interface IGroupCallRoomMemberFeed {
+    purpose: SDPStreamMetadataPurpose;
+}
+export interface IGroupCallRoomMemberDevice {
+    device_id: string;
+    session_id: string;
+    expires_ts: number;
+    feeds: IGroupCallRoomMemberFeed[];
+}
+export interface IGroupCallRoomMemberCallState {
+    "m.call_id": string;
+    "m.foci"?: string[];
+    "m.devices": IGroupCallRoomMemberDevice[];
+}
+export interface IGroupCallRoomMemberState {
+    "m.calls": IGroupCallRoomMemberCallState[];
+}
+export interface ExperimentalGroupCallRoomMemberState {
+    memberships: CallMembershipData[];
+}
+export declare enum GroupCallState {
+    LocalCallFeedUninitialized = "local_call_feed_uninitialized",
+    InitializingLocalCallFeed = "initializing_local_call_feed",
+    LocalCallFeedInitialized = "local_call_feed_initialized",
+    Entered = "entered",
+    Ended = "ended"
+}
+export interface ParticipantState {
+    sessionId: string;
+    screensharing: boolean;
+}
+export declare class GroupCall extends TypedEventEmitter<GroupCallEvent | CallEvent | GroupCallStatsReportEvent, GroupCallEventHandlerMap & CallEventHandlerMap & GroupCallStatsReportEventHandlerMap> {
+    private client;
+    room: Room;
+    type: GroupCallType;
+    isPtt: boolean;
+    intent: GroupCallIntent;
+    private dataChannelsEnabled?;
+    private dataChannelOptions?;
+    private useLivekit;
+    activeSpeakerInterval: number;
+    retryCallInterval: number;
+    participantTimeout: number;
+    pttMaxTransmitTime: number;
+    activeSpeaker?: CallFeed;
+    localCallFeed?: CallFeed;
+    localScreenshareFeed?: CallFeed;
+    localDesktopCapturerSourceId?: string;
+    readonly userMediaFeeds: CallFeed[];
+    readonly screenshareFeeds: CallFeed[];
+    groupCallId: string;
+    readonly allowCallWithoutVideoAndAudio: boolean;
+    private readonly calls;
+    private callHandlers;
+    private activeSpeakerLoopInterval?;
+    private retryCallLoopInterval?;
+    private retryCallCounts;
+    private reEmitter;
+    private transmitTimer;
+    private participantsExpirationTimer;
+    private resendMemberStateTimer;
+    private initWithAudioMuted;
+    private initWithVideoMuted;
+    private initCallFeedPromise?;
+    private _livekitServiceURL?;
+    private stats;
+    /**
+     * Configure default webrtc stats collection interval in ms
+     * Disable collecting webrtc stats by setting interval to 0
+     */
+    private statsCollectIntervalTime;
+    constructor(client: MatrixClient, room: Room, type: GroupCallType, isPtt: boolean, intent: GroupCallIntent, groupCallId?: string, dataChannelsEnabled?: boolean | undefined, dataChannelOptions?: IGroupCallDataChannelOptions | undefined, isCallWithoutVideoAndAudio?: boolean, useLivekit?: boolean, livekitServiceURL?: string);
+    private onConnectionStats;
+    private onByteSentStats;
+    private onSummaryStats;
+    private onCallFeedReport;
+    create(): Promise<GroupCall>;
+    private sendCallStateEvent;
+    get livekitServiceURL(): string | undefined;
+    updateLivekitServiceURL(newURL: string): Promise<void>;
+    private _state;
+    /**
+     * The group call's state.
+     */
+    get state(): GroupCallState;
+    private set state(value);
+    private _participants;
+    /**
+     * The current participants in the call, as a map from members to device IDs
+     * to participant info.
+     */
+    get participants(): Map<RoomMember, Map<string, ParticipantState>>;
+    private set participants(value);
+    private _creationTs;
+    /**
+     * The timestamp at which the call was created, or null if it has not yet
+     * been created.
+     */
+    get creationTs(): number | null;
+    private set creationTs(value);
+    private _enteredViaAnotherSession;
+    /**
+     * Whether the local device has entered this call via another session, such
+     * as a widget.
+     */
+    get enteredViaAnotherSession(): boolean;
+    set enteredViaAnotherSession(value: boolean);
+    /**
+     * Executes the given callback on all calls in this group call.
+     * @param f - The callback.
+     */
+    forEachCall(f: (call: MatrixCall) => void): void;
+    getLocalFeeds(): CallFeed[];
+    hasLocalParticipant(): boolean;
+    /**
+     * Determines whether the given call is one that we were expecting to exist
+     * given our knowledge of who is participating in the group call.
+     */
+    private callExpected;
+    initLocalCallFeed(): Promise<void>;
+    private initLocalCallFeedInternal;
+    updateLocalUsermediaStream(stream: MediaStream): Promise<void>;
+    enter(): Promise<void>;
+    private dispose;
+    leave(): void;
+    terminate(emitStateEvent?: boolean): Promise<void>;
+    isLocalVideoMuted(): boolean;
+    isMicrophoneMuted(): boolean;
+    /**
+     * Sets the mute state of the local participants's microphone.
+     * @param muted - Whether to mute the microphone
+     * @returns Whether muting/unmuting was successful
+     */
+    setMicrophoneMuted(muted: boolean): Promise<boolean>;
+    /**
+     * If we allow entering a call without a camera and without video, it can happen that the access rights to the
+     * devices have not yet been queried. If a stream does not yet have an audio track, we assume that the rights have
+     * not yet been checked.
+     *
+     * `this.client.getMediaHandler().getUserMediaStream` clones the current stream, so it only wanted to be called when
+     * not Audio Track exists.
+     * As such, this is a compromise, because, the access rights should always be queried before the call.
+     */
+    private checkAudioPermissionIfNecessary;
+    /**
+     * Sets the mute state of the local participants's video.
+     * @param muted - Whether to mute the video
+     * @returns Whether muting/unmuting was successful
+     */
+    setLocalVideoMuted(muted: boolean): Promise<boolean>;
+    setScreensharingEnabled(enabled: boolean, opts?: IScreensharingOpts): Promise<boolean>;
+    isScreensharing(): boolean;
+    private onIncomingCall;
+    /**
+     * Determines whether a given participant expects us to call them (versus
+     * them calling us).
+     * @param userId - The participant's user ID.
+     * @param deviceId - The participant's device ID.
+     * @returns Whether we need to place an outgoing call to the participant.
+     */
+    private wantsOutgoingCall;
+    /**
+     * Places calls to all participants that we're responsible for calling.
+     */
+    private placeOutgoingCalls;
+    private getMemberStateEvents;
+    private onRetryCallLoop;
+    private initCall;
+    private disposeCall;
+    private onCallFeedsChanged;
+    private onCallStateChanged;
+    private onCallHangup;
+    private onCallReplaced;
+    getUserMediaFeed(userId: string, deviceId: string): CallFeed | undefined;
+    private addUserMediaFeed;
+    private replaceUserMediaFeed;
+    private removeUserMediaFeed;
+    private onActiveSpeakerLoop;
+    getScreenshareFeed(userId: string, deviceId: string): CallFeed | undefined;
+    private addScreenshareFeed;
+    private replaceScreenshareFeed;
+    private removeScreenshareFeed;
+    /**
+     * Recalculates and updates the participant map to match the room state.
+     */
+    private updateParticipants;
+    /**
+     * Updates the local user's member state with the devices returned by the given function.
+     * @param fn - A function from the current devices to the new devices. If it
+     *   returns null, the update will be skipped.
+     * @param keepAlive - Whether the request should outlive the window.
+     */
+    private updateDevices;
+    private addDeviceToMemberState;
+    private updateMemberState;
+    /**
+     * Cleans up our member state by filtering out logged out devices, inactive
+     * devices, and our own device (if we know we haven't entered).
+     */
+    cleanMemberState(): Promise<void>;
+    private onRoomState;
+    private onParticipantsChanged;
+    private onStateChanged;
+    private onLocalFeedsChanged;
+    getGroupCallStats(): GroupCallStats;
+    setGroupCallStatsInterval(interval: number): void;
+}
+//# sourceMappingURL=groupCall.d.ts.map