@fishjam-cloud/ts-client 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/dist/index.d.mts +1308 -0
  2. package/dist/index.mjs +1 -0
  3. package/package.json +23 -33
  4. package/dist/src/FishjamClient.d.ts +0 -510
  5. package/dist/src/FishjamClient.js +0 -668
  6. package/dist/src/auth.d.ts +0 -3
  7. package/dist/src/auth.js +0 -8
  8. package/dist/src/connectEventsHandler.d.ts +0 -2
  9. package/dist/src/connectEventsHandler.js +0 -22
  10. package/dist/src/index.d.ts +0 -7
  11. package/dist/src/index.js +0 -3
  12. package/dist/src/protos/fishjam/peer_notifications.d.ts +0 -51
  13. package/dist/src/protos/fishjam/peer_notifications.js +0 -309
  14. package/dist/src/protos/index.d.ts +0 -1
  15. package/dist/src/protos/index.js +0 -1
  16. package/dist/src/reconnection.d.ts +0 -27
  17. package/dist/src/reconnection.js +0 -119
  18. package/dist/src/webrtc/CommandsQueue.d.ts +0 -23
  19. package/dist/src/webrtc/CommandsQueue.js +0 -87
  20. package/dist/src/webrtc/ConnectionManager.d.ts +0 -28
  21. package/dist/src/webrtc/ConnectionManager.js +0 -71
  22. package/dist/src/webrtc/bitrate.d.ts +0 -12
  23. package/dist/src/webrtc/bitrate.js +0 -12
  24. package/dist/src/webrtc/deferred.d.ts +0 -8
  25. package/dist/src/webrtc/deferred.js +0 -17
  26. package/dist/src/webrtc/index.d.ts +0 -3
  27. package/dist/src/webrtc/index.js +0 -1
  28. package/dist/src/webrtc/internal.d.ts +0 -26
  29. package/dist/src/webrtc/internal.js +0 -34
  30. package/dist/src/webrtc/mediaEvent.d.ts +0 -10
  31. package/dist/src/webrtc/mediaEvent.js +0 -16
  32. package/dist/src/webrtc/tracks/Local.d.ts +0 -50
  33. package/dist/src/webrtc/tracks/Local.js +0 -286
  34. package/dist/src/webrtc/tracks/LocalTrack.d.ts +0 -61
  35. package/dist/src/webrtc/tracks/LocalTrack.js +0 -218
  36. package/dist/src/webrtc/tracks/LocalTrackManager.d.ts +0 -38
  37. package/dist/src/webrtc/tracks/LocalTrackManager.js +0 -77
  38. package/dist/src/webrtc/tracks/Remote.d.ts +0 -38
  39. package/dist/src/webrtc/tracks/Remote.js +0 -200
  40. package/dist/src/webrtc/tracks/RemoteTrack.d.ts +0 -39
  41. package/dist/src/webrtc/tracks/RemoteTrack.js +0 -64
  42. package/dist/src/webrtc/tracks/TrackCommon.d.ts +0 -8
  43. package/dist/src/webrtc/tracks/TrackCommon.js +0 -1
  44. package/dist/src/webrtc/tracks/bandwidth.d.ts +0 -1
  45. package/dist/src/webrtc/tracks/bandwidth.js +0 -27
  46. package/dist/src/webrtc/tracks/encodings.d.ts +0 -1
  47. package/dist/src/webrtc/tracks/encodings.js +0 -5
  48. package/dist/src/webrtc/tracks/muteTrackUtils.d.ts +0 -3
  49. package/dist/src/webrtc/tracks/muteTrackUtils.js +0 -19
  50. package/dist/src/webrtc/tracks/transceivers.d.ts +0 -2
  51. package/dist/src/webrtc/tracks/transceivers.js +0 -91
  52. package/dist/src/webrtc/types.d.ts +0 -314
  53. package/dist/src/webrtc/types.js +0 -2
  54. package/dist/src/webrtc/voiceActivityDetection.d.ts +0 -2
  55. package/dist/src/webrtc/voiceActivityDetection.js +0 -2
  56. package/dist/src/webrtc/webRTCEndpoint.d.ts +0 -297
  57. package/dist/src/webrtc/webRTCEndpoint.js +0 -691
@@ -1,691 +0,0 @@
1
- import { deserializeMediaEvent, generateCustomEvent, generateMediaEvent, serializeMediaEvent } from './mediaEvent';
2
- import { v4 as uuidv4 } from 'uuid';
3
- import EventEmitter from 'events';
4
- import { Deferred } from './deferred';
5
- import { isEncoding } from './types';
6
- import { LocalTrackManager } from './tracks/LocalTrackManager';
7
- import { CommandsQueue } from './CommandsQueue';
8
- import { Remote } from './tracks/Remote';
9
- import { Local } from './tracks/Local';
10
- import { ConnectionManager } from './ConnectionManager';
11
- /**
12
- * Main class that is responsible for connecting to the RTC Engine, sending and receiving media.
13
- */
14
- export class WebRTCEndpoint extends EventEmitter {
15
- endpointMetadataParser;
16
- trackMetadataParser;
17
- localTrackManager;
18
- remote;
19
- local;
20
- commandsQueue;
21
- bandwidthEstimation = BigInt(0);
22
- connectionManager;
23
- clearConnectionCallbacks = null;
24
- constructor(config) {
25
- super();
26
- this.endpointMetadataParser = config?.endpointMetadataParser ?? ((x) => x);
27
- this.trackMetadataParser = config?.trackMetadataParser ?? ((x) => x);
28
- const sendEvent = (mediaEvent) => this.sendMediaEvent(mediaEvent);
29
- const emit = (events, ...args) => {
30
- this.emit(events, ...args);
31
- };
32
- this.remote = new Remote(emit, sendEvent, this.endpointMetadataParser, this.trackMetadataParser);
33
- this.local = new Local(emit, sendEvent, this.endpointMetadataParser, this.trackMetadataParser);
34
- this.localTrackManager = new LocalTrackManager(this.local, sendEvent);
35
- this.commandsQueue = new CommandsQueue(this.localTrackManager);
36
- }
37
- /**
38
- * Tries to connect to the RTC Engine. If user is successfully connected then {@link WebRTCEndpointEvents.connected}
39
- * will be emitted.
40
- *
41
- * @param metadata - Any information that other endpoints will receive in {@link WebRTCEndpointEvents.endpointAdded}
42
- * after accepting this endpoint
43
- *
44
- * @example
45
- * ```ts
46
- * let webrtc = new WebRTCEndpoint();
47
- * webrtc.connect({displayName: "Bob"});
48
- * ```
49
- */
50
- connect = (metadata) => {
51
- this.local.setEndpointMetadata(metadata);
52
- const mediaEvent = generateMediaEvent('connect', {
53
- metadata: metadata,
54
- });
55
- this.sendMediaEvent(mediaEvent);
56
- };
57
- /**
58
- * Feeds media event received from RTC Engine to {@link WebRTCEndpoint}.
59
- * This function should be called whenever some media event from RTC Engine
60
- * was received and can result in {@link WebRTCEndpoint} generating some other
61
- * media events.
62
- *
63
- * @param mediaEvent - String data received over custom signalling layer.
64
- *
65
- * @example
66
- * This example assumes phoenix channels as signalling layer.
67
- * As phoenix channels require objects, RTC Engine encapsulates binary data into
68
- * map with one field that is converted to object with one field on the TS side.
69
- * ```ts
70
- * webrtcChannel.on("mediaEvent", (event) => webrtc.receiveMediaEvent(event.data));
71
- * ```
72
- */
73
- receiveMediaEvent = async (mediaEvent) => {
74
- const deserializedMediaEvent = deserializeMediaEvent(mediaEvent);
75
- switch (deserializedMediaEvent.type) {
76
- case 'connected': {
77
- this.local.setLocalEndpointId(deserializedMediaEvent.data.id);
78
- const endpoints = deserializedMediaEvent.data.otherEndpoints;
79
- // todo implement track mapping (+ validate metadata)
80
- // todo implement endpoint metadata mapping
81
- endpoints.forEach((endpoint) => {
82
- this.remote.addRemoteEndpoint(endpoint);
83
- });
84
- const remoteEndpoints = Object.values(this.remote.getRemoteEndpoints());
85
- this.emit('connected', this.local.getEndpoint().id, remoteEndpoints);
86
- break;
87
- }
88
- default:
89
- if (this.getEndpointId() != null)
90
- await this.handleMediaEvent(deserializedMediaEvent);
91
- }
92
- };
93
- getEndpointId = () => this.local.getEndpoint().id;
94
- onTrackReady = (event) => {
95
- const stream = event.streams[0];
96
- if (!stream)
97
- throw new Error('Cannot find media stream');
98
- const mid = event.transceiver.mid;
99
- const remoteTrack = this.remote.getTrackByMid(mid);
100
- remoteTrack.setReady(stream, event.track);
101
- this.emit('trackReady', remoteTrack.trackContext);
102
- };
103
- /**
104
- * Retrieves statistics related to the RTCPeerConnection.
105
- * These statistics provide insights into the performance and status of the connection.
106
- *
107
- * @return {Promise<RTCStatsReport>}
108
- *
109
- * @external RTCPeerConnection#getStats()
110
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/getStats | MDN Web Docs: RTCPeerConnection.getStats()}
111
- */
112
- async getStatistics(selector) {
113
- return (await this.connectionManager?.getConnection().getStats(selector)) ?? new Map();
114
- }
115
- /**
116
- * Returns a snapshot of currently received remote tracks.
117
- *
118
- * @example
119
- * if (webRTCEndpoint.getRemoteTracks()[trackId]?.simulcastConfig?.enabled) {
120
- * webRTCEndpoint.setTargetTrackEncoding(trackId, encoding);
121
- * }
122
- */
123
- getRemoteTracks() {
124
- return this.remote.getRemoteTrackContexts();
125
- }
126
- /**
127
- * Returns a snapshot of currently received remote endpoints.
128
- */
129
- getRemoteEndpoints() {
130
- return this.remote.getRemoteEndpoints();
131
- }
132
- getLocalEndpoint() {
133
- return this.local.getEndpoint();
134
- }
135
- getBandwidthEstimation() {
136
- return this.bandwidthEstimation;
137
- }
138
- handleMediaEvent = async (deserializedMediaEvent) => {
139
- switch (deserializedMediaEvent.type) {
140
- case 'offerData': {
141
- await this.onOfferData(deserializedMediaEvent);
142
- break;
143
- }
144
- case 'tracksAdded': {
145
- this.localTrackManager.ongoingRenegotiation = true;
146
- const data = deserializedMediaEvent.data;
147
- if (this.getEndpointId() === data.endpointId)
148
- return;
149
- this.remote.addTracks(data.endpointId, data.tracks, data.trackIdToMetadata);
150
- break;
151
- }
152
- case 'tracksRemoved': {
153
- this.localTrackManager.ongoingRenegotiation = true;
154
- const data = deserializedMediaEvent.data;
155
- const endpointId = data.endpointId;
156
- if (this.getEndpointId() === endpointId)
157
- return;
158
- this.remote.removeTracks(data.trackIds);
159
- break;
160
- }
161
- case 'sdpAnswer':
162
- this.localTrackManager.ongoingRenegotiation = false;
163
- await this.onSdpAnswer(deserializedMediaEvent.data);
164
- this.commandsQueue.processNextCommand();
165
- break;
166
- case 'candidate':
167
- await this.onRemoteCandidate(deserializedMediaEvent.data);
168
- break;
169
- case 'endpointAdded':
170
- const endpoint = deserializedMediaEvent.data;
171
- if (endpoint.id === this.getEndpointId())
172
- return;
173
- this.remote.addRemoteEndpoint(endpoint);
174
- break;
175
- case 'endpointRemoved':
176
- if (deserializedMediaEvent.data.id === this.local.getEndpoint().id) {
177
- this.cleanUp();
178
- this.emit('disconnected');
179
- return;
180
- }
181
- if (this.getEndpointId() === deserializedMediaEvent.data.id)
182
- return;
183
- this.remote.removeRemoteEndpoint(deserializedMediaEvent.data.id);
184
- break;
185
- case 'endpointUpdated':
186
- if (this.getEndpointId() === deserializedMediaEvent.data.id)
187
- return;
188
- this.remote.updateRemoteEndpoint(deserializedMediaEvent.data);
189
- break;
190
- case 'trackUpdated': {
191
- if (this.getEndpointId() === deserializedMediaEvent.data.endpointId)
192
- return;
193
- this.remote.updateRemoteTrack(deserializedMediaEvent.data);
194
- break;
195
- }
196
- case 'trackEncodingDisabled': {
197
- if (this.getEndpointId() === deserializedMediaEvent.data.endpointId)
198
- return;
199
- this.remote.disableRemoteTrackEncoding(deserializedMediaEvent.data.trackId, deserializedMediaEvent.data.encoding);
200
- break;
201
- }
202
- case 'trackEncodingEnabled': {
203
- const data = deserializedMediaEvent.data;
204
- if (this.getEndpointId() === data.endpointId)
205
- return;
206
- this.remote.enableRemoteTrackEncoding(data.trackId, data.encoding);
207
- break;
208
- }
209
- case 'encodingSwitched': {
210
- const data = deserializedMediaEvent.data;
211
- this.remote.setRemoteTrackEncoding(data.trackId, data.encoding, data.reason);
212
- break;
213
- }
214
- case 'custom':
215
- await this.handleMediaEvent(deserializedMediaEvent.data);
216
- break;
217
- case 'error':
218
- console.warn('signaling error', {
219
- message: deserializedMediaEvent.data.message,
220
- });
221
- this.emit('signalingError', {
222
- message: deserializedMediaEvent.data.message,
223
- });
224
- this.disconnect();
225
- break;
226
- case 'vadNotification': {
227
- this.remote.setRemoteTrackVadStatus(deserializedMediaEvent.data.trackId, deserializedMediaEvent.data.status);
228
- break;
229
- }
230
- case 'bandwidthEstimation': {
231
- this.bandwidthEstimation = deserializedMediaEvent.data.estimation;
232
- this.emit('bandwidthEstimationChanged', this.bandwidthEstimation);
233
- break;
234
- }
235
- default:
236
- console.warn('Received unknown media event: ', deserializedMediaEvent.type);
237
- break;
238
- }
239
- };
240
- onSdpAnswer = async (data) => {
241
- this.remote.updateMLineIds(data.midToTrackId);
242
- this.local.updateMLineIds(data.midToTrackId);
243
- Object.keys(data.midToTrackId)
244
- .map((mid) => {
245
- if (!mid)
246
- throw new Error('TrackId is not defined');
247
- return mid;
248
- })
249
- .map((mid) => this.local.getTrackByMidOrNull(mid))
250
- .filter((localTrack) => localTrack !== null)
251
- .forEach((localTrack) => {
252
- const trackContext = localTrack.trackContext;
253
- trackContext.negotiationStatus = 'done';
254
- if (trackContext.pendingMetadataUpdate) {
255
- const mediaEvent = generateMediaEvent('updateTrackMetadata', {
256
- trackId: localTrack.id,
257
- trackMetadata: trackContext.metadata,
258
- });
259
- this.sendMediaEvent(mediaEvent);
260
- }
261
- trackContext.pendingMetadataUpdate = false;
262
- });
263
- if (!this.connectionManager)
264
- throw new Error(`There is no active RTCPeerConnection`);
265
- // probably there is no need to reassign it on every onAnswer
266
- this.connectionManager.setOnTrackReady((event) => {
267
- this.onTrackReady(event);
268
- });
269
- try {
270
- await this.connectionManager.setRemoteDescription(data);
271
- }
272
- catch (err) {
273
- console.error(err);
274
- }
275
- };
276
- /**
277
- * Adds track that will be sent to the RTC Engine.
278
- * @param track - Audio or video track e.g. from your microphone or camera.
279
- * @param trackMetadata - Any information about this track that other endpoints will
280
- * receive in {@link WebRTCEndpointEvents.endpointAdded}. E.g. this can source of the track - whether it's
281
- * screensharing, webcam or some other media device.
282
- * @param simulcastConfig - Simulcast configuration. By default simulcast is disabled.
283
- * For more information refer to {@link SimulcastConfig}.
284
- * @param maxBandwidth - maximal bandwidth this track can use.
285
- * Defaults to 0 which is unlimited.
286
- * This option has no effect for simulcast and audio tracks.
287
- * For simulcast tracks use `{@link WebRTCEndpoint.setTrackBandwidth}.
288
- * @returns {string} Returns id of added track
289
- * @example
290
- * ```ts
291
- * let localStream: MediaStream = new MediaStream();
292
- * try {
293
- * localAudioStream = await navigator.mediaDevices.getUserMedia(
294
- * AUDIO_CONSTRAINTS
295
- * );
296
- * localAudioStream
297
- * .getTracks()
298
- * .forEach((track) => localStream.addTrack(track));
299
- * } catch (error) {
300
- * console.error("Couldn't get microphone permission:", error);
301
- * }
302
- *
303
- * try {
304
- * localVideoStream = await navigator.mediaDevices.getUserMedia(
305
- * VIDEO_CONSTRAINTS
306
- * );
307
- * localVideoStream
308
- * .getTracks()
309
- * .forEach((track) => localStream.addTrack(track));
310
- * } catch (error) {
311
- * console.error("Couldn't get camera permission:", error);
312
- * }
313
- *
314
- * localStream
315
- * .getTracks()
316
- * .forEach((track) => webrtc.addTrack(track, localStream));
317
- * ```
318
- */
319
- async addTrack(track, trackMetadata, simulcastConfig = {
320
- enabled: false,
321
- activeEncodings: [],
322
- disabledEncodings: [],
323
- }, maxBandwidth = 0) {
324
- const resolutionNotifier = new Deferred();
325
- const trackId = this.getTrackId(uuidv4());
326
- const stream = new MediaStream();
327
- let metadata;
328
- try {
329
- const parsedMetadata = this.trackMetadataParser(trackMetadata);
330
- metadata = parsedMetadata;
331
- stream.addTrack(track);
332
- this.commandsQueue.pushCommand({
333
- handler: async () => this.localTrackManager.addTrackHandler(trackId, track, stream, parsedMetadata, simulcastConfig, maxBandwidth),
334
- parse: () => this.localTrackManager.parseAddTrack(track, simulcastConfig, maxBandwidth),
335
- resolve: 'after-renegotiation',
336
- resolutionNotifier,
337
- });
338
- }
339
- catch (error) {
340
- resolutionNotifier.reject(error);
341
- }
342
- await resolutionNotifier.promise;
343
- this.emit('localTrackAdded', {
344
- trackId,
345
- track,
346
- stream,
347
- trackMetadata: metadata,
348
- simulcastConfig,
349
- maxBandwidth,
350
- });
351
- return trackId;
352
- }
353
- /**
354
- * Replaces a track that is being sent to the RTC Engine.
355
- * @param trackId - Audio or video track.
356
- * @param {string} trackId - Id of audio or video track to replace.
357
- * @param {MediaStreamTrack} newTrack
358
- * @returns {Promise<boolean>} success
359
- * @example
360
- * ```ts
361
- * // setup camera
362
- * let localStream: MediaStream = new MediaStream();
363
- * try {
364
- * localVideoStream = await navigator.mediaDevices.getUserMedia(
365
- * VIDEO_CONSTRAINTS
366
- * );
367
- * localVideoStream
368
- * .getTracks()
369
- * .forEach((track) => localStream.addTrack(track));
370
- * } catch (error) {
371
- * console.error("Couldn't get camera permission:", error);
372
- * }
373
- * let oldTrackId;
374
- * localStream
375
- * .getTracks()
376
- * .forEach((track) => trackId = webrtc.addTrack(track, localStream));
377
- *
378
- * // change camera
379
- * const oldTrack = localStream.getVideoTracks()[0];
380
- * let videoDeviceId = "abcd-1234";
381
- * navigator.mediaDevices.getUserMedia({
382
- * video: {
383
- * ...(VIDEO_CONSTRAINTS as {}),
384
- * deviceId: {
385
- * exact: videoDeviceId,
386
- * },
387
- * }
388
- * })
389
- * .then((stream) => {
390
- * let videoTrack = stream.getVideoTracks()[0];
391
- * webrtc.replaceTrack(oldTrackId, videoTrack);
392
- * })
393
- * .catch((error) => {
394
- * console.error('Error switching camera', error);
395
- * })
396
- * ```
397
- */
398
- async replaceTrack(trackId, newTrack) {
399
- const resolutionNotifier = new Deferred();
400
- this.commandsQueue.pushCommand({
401
- handler: () => this.localTrackManager.replaceTrackHandler(this, trackId, newTrack),
402
- resolutionNotifier,
403
- resolve: 'on-handler-resolve',
404
- });
405
- return resolutionNotifier.promise.then(() => {
406
- this.emit('localTrackReplaced', { trackId, track: newTrack });
407
- });
408
- }
409
- /**
410
- * Updates maximum bandwidth for the track identified by trackId.
411
- * This value directly translates to quality of the stream and, in case of video, to the amount of RTP packets being sent.
412
- * In case trackId points at the simulcast track bandwidth is split between all of the variant streams proportionally to their resolution.
413
- *
414
- * @param {string} trackId
415
- * @param {BandwidthLimit} bandwidth in kbps
416
- * @returns {Promise<boolean>} success
417
- */
418
- setTrackBandwidth(trackId, bandwidth) {
419
- if (!this.connectionManager)
420
- throw new Error(`There is no active RTCPeerConnection`);
421
- return this.local.setTrackBandwidth(trackId, bandwidth);
422
- }
423
- /**
424
- * Updates maximum bandwidth for the given simulcast encoding of the given track.
425
- *
426
- * @param {string} trackId - id of the track
427
- * @param {string} rid - rid of the encoding
428
- * @param {BandwidthLimit} bandwidth - desired max bandwidth used by the encoding (in kbps)
429
- * @returns
430
- */
431
- async setEncodingBandwidth(trackId, rid, bandwidth) {
432
- if (!isEncoding(rid))
433
- throw new Error(`Rid is invalid ${rid}`);
434
- if (!this.connectionManager)
435
- throw new Error(`There is no active RTCPeerConnection`);
436
- return await this.local.setEncodingBandwidth(trackId, rid, bandwidth);
437
- }
438
- /**
439
- * Removes a track from connection that was sent to the RTC Engine.
440
- * @param {string} trackId - Id of audio or video track to remove.
441
- * @example
442
- * ```ts
443
- * // setup camera
444
- * let localStream: MediaStream = new MediaStream();
445
- * try {
446
- * localVideoStream = await navigator.mediaDevices.getUserMedia(
447
- * VIDEO_CONSTRAINTS
448
- * );
449
- * localVideoStream
450
- * .getTracks()
451
- * .forEach((track) => localStream.addTrack(track));
452
- * } catch (error) {
453
- * console.error("Couldn't get camera permission:", error);
454
- * }
455
- *
456
- * let trackId
457
- * localStream
458
- * .getTracks()
459
- * .forEach((track) => trackId = webrtc.addTrack(track, localStream));
460
- *
461
- * // remove track
462
- * webrtc.removeTrack(trackId)
463
- * ```
464
- */
465
- async removeTrack(trackId) {
466
- const resolutionNotifier = new Deferred();
467
- this.commandsQueue.pushCommand({
468
- handler: async () => this.localTrackManager.removeTrackHandler(trackId),
469
- resolutionNotifier,
470
- resolve: 'after-renegotiation',
471
- });
472
- await resolutionNotifier.promise;
473
- this.emit('localTrackRemoved', {
474
- trackId,
475
- });
476
- }
477
- /**
478
- * Sets track variant that server should send to the client library.
479
- *
480
- * The variant will be sent whenever it is available.
481
- * If chosen variant is temporarily unavailable, some other variant
482
- * will be sent until the chosen variant becomes active again.
483
- *
484
- * @param {string} trackId - id of track
485
- * @param {Encoding} variant - variant to receive
486
- * @example
487
- * ```ts
488
- * webrtc.setTargetTrackEncoding(incomingTrackCtx.trackId, "l")
489
- * ```
490
- */
491
- setTargetTrackEncoding(trackId, variant) {
492
- this.remote.setTargetRemoteTrackEncoding(trackId, variant);
493
- }
494
- /**
495
- * Enables track encoding so that it will be sent to the server.
496
- * @param {string} trackId - id of track
497
- * @param {Encoding} encoding - encoding that will be enabled
498
- * @example
499
- * ```ts
500
- * const trackId = webrtc.addTrack(track, stream, {}, {enabled: true, activeEncodings: ["l", "m", "h"]});
501
- * webrtc.disableTrackEncoding(trackId, "l");
502
- * // wait some time
503
- * webrtc.enableTrackEncoding(trackId, "l");
504
- * ```
505
- */
506
- enableTrackEncoding = async (trackId, encoding) => {
507
- await this.local.enableLocalTrackEncoding(trackId, encoding);
508
- };
509
- /**
510
- * Disables track encoding so that it will be no longer sent to the server.
511
- * @param {string} trackId - id of track
512
- * @param {Encoding} encoding - encoding that will be disabled
513
- * @example
514
- * ```ts
515
- * const trackId = webrtc.addTrack(track, stream, {}, {enabled: true, activeEncodings: ["l", "m", "h"]});
516
- * webrtc.disableTrackEncoding(trackId, "l");
517
- * ```
518
- */
519
- disableTrackEncoding = async (trackId, encoding) => {
520
- await this.local.disableLocalTrackEncoding(trackId, encoding);
521
- };
522
- /**
523
- * Updates the metadata for the current endpoint.
524
- * @param metadata - Data about this endpoint that other endpoints will receive upon being added.
525
- *
526
- * If the metadata is different from what is already tracked in the room, the optional
527
- * event `endpointUpdated` will be emitted for other endpoint in the room.
528
- */
529
- updateEndpointMetadata = (metadata) => {
530
- this.local.updateEndpointMetadata(metadata);
531
- };
532
- /**
533
- * Updates the metadata for a specific track.
534
- * @param trackId - trackId (generated in addTrack) of audio or video track.
535
- * @param trackMetadata - Data about this track that other endpoint will receive upon being added.
536
- *
537
- * If the metadata is different from what is already tracked in the room, the optional
538
- * event `trackUpdated` will be emitted for other endpoints in the room.
539
- */
540
- updateTrackMetadata = (trackId, trackMetadata) => {
541
- this.local.updateLocalTrackMetadata(trackId, trackMetadata);
542
- };
543
- /**
544
- * Disconnects from the room. This function should be called when user disconnects from the room
545
- * in a clean way e.g. by clicking a dedicated, custom button `disconnect`.
546
- * As a result there will be generated one more media event that should be
547
- * sent to the RTC Engine. Thanks to it each other endpoint will be notified
548
- * that endpoint was removed in {@link WebRTCEndpointEvents.endpointRemoved},
549
- */
550
- disconnect = () => {
551
- const mediaEvent = generateMediaEvent('disconnect');
552
- this.sendMediaEvent(mediaEvent);
553
- this.emit('disconnectRequested', {});
554
- this.cleanUp();
555
- };
556
- /**
557
- * Cleans up {@link WebRTCEndpoint} instance.
558
- */
559
- cleanUp = () => {
560
- if (this.connectionManager) {
561
- this.clearConnectionCallbacks?.();
562
- this.connectionManager?.getConnection().close();
563
- this.commandsQueue.cleanUp();
564
- this.localTrackManager.cleanUp();
565
- }
566
- this.connectionManager = undefined;
567
- };
568
- getTrackId(uuid) {
569
- return `${this.getEndpointId()}:${uuid}`;
570
- }
571
- // todo change to private
572
- sendMediaEvent = (mediaEvent) => {
573
- const serializedMediaEvent = serializeMediaEvent(mediaEvent);
574
- this.emit('sendMediaEvent', serializedMediaEvent);
575
- };
576
- async createAndSendOffer() {
577
- const connection = this.connectionManager;
578
- if (!connection)
579
- return;
580
- try {
581
- this.localTrackManager.updateSenders();
582
- const offer = await connection.getConnection().createOffer();
583
- if (!this.connectionManager) {
584
- console.warn('RTCPeerConnection stopped or restarted');
585
- return;
586
- }
587
- await connection.getConnection().setLocalDescription(offer);
588
- if (!this.connectionManager) {
589
- console.warn('RTCPeerConnection stopped or restarted');
590
- return;
591
- }
592
- const mediaEvent = this.local.createSdpOfferEvent(offer);
593
- this.sendMediaEvent(mediaEvent);
594
- this.local.setLocalTrackStatusToOffered();
595
- }
596
- catch (error) {
597
- console.error(error);
598
- }
599
- }
600
- onOfferData = async (offerData) => {
601
- const connection = this.connectionManager;
602
- if (connection && !connection.isExWebRTC) {
603
- connection.getConnection().restartIce();
604
- }
605
- else if (!connection) {
606
- this.setConnection(offerData.data.integratedTurnServers);
607
- const onIceCandidate = (event) => this.onLocalCandidate(event);
608
- const onIceCandidateError = (event) => this.onIceCandidateError(event);
609
- const onConnectionStateChange = (event) => this.onConnectionStateChange(event);
610
- const onIceConnectionStateChange = (event) => this.onIceConnectionStateChange(event);
611
- const connection = this.connectionManager;
612
- if (!connection)
613
- throw new Error(`There is no active RTCPeerConnection`);
614
- this.clearConnectionCallbacks = () => {
615
- connection?.getConnection()?.removeEventListener('icecandidate', onIceCandidate);
616
- connection?.getConnection()?.removeEventListener('icecandidateerror', onIceCandidateError);
617
- connection?.getConnection()?.removeEventListener('connectionstatechange', onConnectionStateChange);
618
- connection?.getConnection()?.removeEventListener('iceconnectionstatechange', onIceConnectionStateChange);
619
- };
620
- connection.getConnection().addEventListener('icecandidate', onIceCandidate);
621
- connection.getConnection().addEventListener('icecandidateerror', onIceCandidateError);
622
- connection.getConnection().addEventListener('connectionstatechange', onConnectionStateChange);
623
- connection.getConnection().addEventListener('iceconnectionstatechange', onIceConnectionStateChange);
624
- this.commandsQueue.initConnection(connection);
625
- this.local.addAllTracksToConnection();
626
- }
627
- const tracks = new Map(Object.entries(offerData.data.tracksTypes));
628
- this.connectionManager?.addTransceiversIfNeeded(tracks);
629
- await this.createAndSendOffer();
630
- };
631
- setConnection = (turnServers) => {
632
- this.connectionManager = new ConnectionManager(turnServers);
633
- this.localTrackManager.updateConnection(this.connectionManager);
634
- this.local.updateConnection(this.connectionManager);
635
- };
636
- onRemoteCandidate = async (candidate) => {
637
- try {
638
- const iceCandidate = new RTCIceCandidate(candidate);
639
- if (!this.connectionManager) {
640
- throw new Error('Received new remote candidate but RTCConnection is undefined');
641
- }
642
- await this.connectionManager.addIceCandidate(iceCandidate);
643
- }
644
- catch (error) {
645
- console.error(error);
646
- }
647
- };
648
- onLocalCandidate = (event) => {
649
- if (event.candidate) {
650
- const mediaEvent = generateCustomEvent({
651
- type: 'candidate',
652
- data: {
653
- candidate: event.candidate.candidate,
654
- sdpMLineIndex: event.candidate.sdpMLineIndex,
655
- sdpMid: event.candidate.sdpMid,
656
- usernameFragment: event.candidate.usernameFragment,
657
- },
658
- });
659
- this.sendMediaEvent(mediaEvent);
660
- }
661
- };
662
- onIceCandidateError = (event) => {
663
- console.warn(event);
664
- };
665
- onConnectionStateChange = (event) => {
666
- switch (this.localTrackManager.connection?.getConnection().connectionState) {
667
- case 'failed':
668
- this.emit('connectionError', {
669
- message: 'RTCPeerConnection failed',
670
- event,
671
- });
672
- break;
673
- }
674
- };
675
- onIceConnectionStateChange = (event) => {
676
- switch (this.localTrackManager.connection?.getConnection().iceConnectionState) {
677
- case 'disconnected':
678
- console.warn('ICE connection: disconnected');
679
- // Requesting renegotiation on ICE connection state failed fixes RTCPeerConnection
680
- // when the user changes their WiFi network.
681
- this.sendMediaEvent(generateCustomEvent({ type: 'renegotiateTracks' }));
682
- break;
683
- case 'failed':
684
- this.emit('connectionError', {
685
- message: 'ICE connection failed',
686
- event,
687
- });
688
- break;
689
- }
690
- };
691
- }