@dtelecom/livekit-client 1.12.1
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.
- package/LICENSE +175 -0
- package/README.md +315 -0
- package/dist/@dtelecom/livekit-client.e2ee.worker.js +2 -0
- package/dist/@dtelecom/livekit-client.e2ee.worker.js.map +1 -0
- package/dist/@dtelecom/livekit-client.e2ee.worker.mjs +1633 -0
- package/dist/@dtelecom/livekit-client.e2ee.worker.mjs.map +1 -0
- package/dist/@dtelecom/livekit-client.esm.mjs +22545 -0
- package/dist/@dtelecom/livekit-client.esm.mjs.map +1 -0
- package/dist/@dtelecom/livekit-client.umd.js +2 -0
- package/dist/@dtelecom/livekit-client.umd.js.map +1 -0
- package/dist/@dtelecom/src/api/SignalClient.d.ts +102 -0
- package/dist/@dtelecom/src/api/SignalClient.d.ts.map +1 -0
- package/dist/@dtelecom/src/connectionHelper/ConnectionCheck.d.ts +26 -0
- package/dist/@dtelecom/src/connectionHelper/ConnectionCheck.d.ts.map +1 -0
- package/dist/@dtelecom/src/connectionHelper/checks/Checker.d.ts +59 -0
- package/dist/@dtelecom/src/connectionHelper/checks/Checker.d.ts.map +1 -0
- package/dist/@dtelecom/src/connectionHelper/checks/publishAudio.d.ts +6 -0
- package/dist/@dtelecom/src/connectionHelper/checks/publishAudio.d.ts.map +1 -0
- package/dist/@dtelecom/src/connectionHelper/checks/publishVideo.d.ts +6 -0
- package/dist/@dtelecom/src/connectionHelper/checks/publishVideo.d.ts.map +1 -0
- package/dist/@dtelecom/src/connectionHelper/checks/reconnect.d.ts +6 -0
- package/dist/@dtelecom/src/connectionHelper/checks/reconnect.d.ts.map +1 -0
- package/dist/@dtelecom/src/connectionHelper/checks/turn.d.ts +6 -0
- package/dist/@dtelecom/src/connectionHelper/checks/turn.d.ts.map +1 -0
- package/dist/@dtelecom/src/connectionHelper/checks/webrtc.d.ts +6 -0
- package/dist/@dtelecom/src/connectionHelper/checks/webrtc.d.ts.map +1 -0
- package/dist/@dtelecom/src/connectionHelper/checks/websocket.d.ts +6 -0
- package/dist/@dtelecom/src/connectionHelper/checks/websocket.d.ts.map +1 -0
- package/dist/@dtelecom/src/e2ee/E2eeManager.d.ts +47 -0
- package/dist/@dtelecom/src/e2ee/E2eeManager.d.ts.map +1 -0
- package/dist/@dtelecom/src/e2ee/KeyProvider.d.ts +44 -0
- package/dist/@dtelecom/src/e2ee/KeyProvider.d.ts.map +1 -0
- package/dist/@dtelecom/src/e2ee/constants.d.ts +15 -0
- package/dist/@dtelecom/src/e2ee/constants.d.ts.map +1 -0
- package/dist/@dtelecom/src/e2ee/errors.d.ts +11 -0
- package/dist/@dtelecom/src/e2ee/errors.d.ts.map +1 -0
- package/dist/@dtelecom/src/e2ee/index.d.ts +4 -0
- package/dist/@dtelecom/src/e2ee/index.d.ts.map +1 -0
- package/dist/@dtelecom/src/e2ee/types.d.ts +130 -0
- package/dist/@dtelecom/src/e2ee/types.d.ts.map +1 -0
- package/dist/@dtelecom/src/e2ee/utils.d.ts +24 -0
- package/dist/@dtelecom/src/e2ee/utils.d.ts.map +1 -0
- package/dist/@dtelecom/src/e2ee/worker/FrameCryptor.d.ts +176 -0
- package/dist/@dtelecom/src/e2ee/worker/FrameCryptor.d.ts.map +1 -0
- package/dist/@dtelecom/src/e2ee/worker/ParticipantKeyHandler.d.ts +65 -0
- package/dist/@dtelecom/src/e2ee/worker/ParticipantKeyHandler.d.ts.map +1 -0
- package/dist/@dtelecom/src/e2ee/worker/e2ee.worker.d.ts +2 -0
- package/dist/@dtelecom/src/e2ee/worker/e2ee.worker.d.ts.map +1 -0
- package/dist/@dtelecom/src/index.d.ts +38 -0
- package/dist/@dtelecom/src/index.d.ts.map +1 -0
- package/dist/@dtelecom/src/logger.d.ts +29 -0
- package/dist/@dtelecom/src/logger.d.ts.map +1 -0
- package/dist/@dtelecom/src/options.d.ts +104 -0
- package/dist/@dtelecom/src/options.d.ts.map +1 -0
- package/dist/@dtelecom/src/proto/livekit_models_pb.d.ts +1264 -0
- package/dist/@dtelecom/src/proto/livekit_models_pb.d.ts.map +1 -0
- package/dist/@dtelecom/src/proto/livekit_rtc_pb.d.ts +1373 -0
- package/dist/@dtelecom/src/proto/livekit_rtc_pb.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/DefaultReconnectPolicy.d.ts +8 -0
- package/dist/@dtelecom/src/room/DefaultReconnectPolicy.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/DeviceManager.d.ts +9 -0
- package/dist/@dtelecom/src/room/DeviceManager.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/PCTransport.d.ts +41 -0
- package/dist/@dtelecom/src/room/PCTransport.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/RTCEngine.d.ts +143 -0
- package/dist/@dtelecom/src/room/RTCEngine.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/ReconnectPolicy.d.ts +24 -0
- package/dist/@dtelecom/src/room/ReconnectPolicy.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/RegionUrlProvider.d.ts +17 -0
- package/dist/@dtelecom/src/room/RegionUrlProvider.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/Room.d.ts +248 -0
- package/dist/@dtelecom/src/room/Room.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/defaults.d.ts +8 -0
- package/dist/@dtelecom/src/room/defaults.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/errors.d.ts +43 -0
- package/dist/@dtelecom/src/room/errors.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/events.d.ts +477 -0
- package/dist/@dtelecom/src/room/events.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/participant/LocalParticipant.d.ts +177 -0
- package/dist/@dtelecom/src/room/participant/LocalParticipant.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/participant/Participant.d.ts +95 -0
- package/dist/@dtelecom/src/room/participant/Participant.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/participant/ParticipantTrackPermission.d.ts +26 -0
- package/dist/@dtelecom/src/room/participant/ParticipantTrackPermission.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/participant/RemoteParticipant.d.ts +55 -0
- package/dist/@dtelecom/src/room/participant/RemoteParticipant.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/participant/publishUtils.d.ts +28 -0
- package/dist/@dtelecom/src/room/participant/publishUtils.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/stats.d.ts +67 -0
- package/dist/@dtelecom/src/room/stats.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/timers.d.ts +13 -0
- package/dist/@dtelecom/src/room/timers.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/LocalAudioTrack.d.ts +25 -0
- package/dist/@dtelecom/src/room/track/LocalAudioTrack.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/LocalTrack.d.ts +78 -0
- package/dist/@dtelecom/src/room/track/LocalTrack.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/LocalTrackPublication.d.ts +38 -0
- package/dist/@dtelecom/src/room/track/LocalTrackPublication.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/LocalVideoTrack.d.ts +54 -0
- package/dist/@dtelecom/src/room/track/LocalVideoTrack.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/RemoteAudioTrack.d.ts +53 -0
- package/dist/@dtelecom/src/room/track/RemoteAudioTrack.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/RemoteTrack.d.ts +15 -0
- package/dist/@dtelecom/src/room/track/RemoteTrack.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/RemoteTrackPublication.d.ts +64 -0
- package/dist/@dtelecom/src/room/track/RemoteTrackPublication.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/RemoteVideoTrack.d.ts +56 -0
- package/dist/@dtelecom/src/room/track/RemoteVideoTrack.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/Track.d.ts +125 -0
- package/dist/@dtelecom/src/room/track/Track.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/TrackPublication.d.ts +72 -0
- package/dist/@dtelecom/src/room/track/TrackPublication.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/create.d.ts +24 -0
- package/dist/@dtelecom/src/room/track/create.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/facingMode.d.ts +41 -0
- package/dist/@dtelecom/src/room/track/facingMode.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/options.d.ts +272 -0
- package/dist/@dtelecom/src/room/track/options.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/processor/types.d.ts +19 -0
- package/dist/@dtelecom/src/room/track/processor/types.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/types.d.ts +24 -0
- package/dist/@dtelecom/src/room/track/types.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/track/utils.d.ts +27 -0
- package/dist/@dtelecom/src/room/track/utils.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/types.d.ts +26 -0
- package/dist/@dtelecom/src/room/types.d.ts.map +1 -0
- package/dist/@dtelecom/src/room/utils.d.ts +92 -0
- package/dist/@dtelecom/src/room/utils.d.ts.map +1 -0
- package/dist/@dtelecom/src/test/MockMediaStreamTrack.d.ts +26 -0
- package/dist/@dtelecom/src/test/MockMediaStreamTrack.d.ts.map +1 -0
- package/dist/@dtelecom/src/test/mocks.d.ts +12 -0
- package/dist/@dtelecom/src/test/mocks.d.ts.map +1 -0
- package/dist/@dtelecom/src/utils/AsyncQueue.d.ts +23 -0
- package/dist/@dtelecom/src/utils/AsyncQueue.d.ts.map +1 -0
- package/dist/@dtelecom/src/utils/browserParser.d.ts +12 -0
- package/dist/@dtelecom/src/utils/browserParser.d.ts.map +1 -0
- package/dist/@dtelecom/src/version.d.ts +3 -0
- package/dist/@dtelecom/src/version.d.ts.map +1 -0
- package/dist/ts4.2/@dtelecom/src/api/SignalClient.d.ts +105 -0
- package/dist/ts4.2/@dtelecom/src/connectionHelper/ConnectionCheck.d.ts +26 -0
- package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/Checker.d.ts +59 -0
- package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/publishAudio.d.ts +6 -0
- package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/publishVideo.d.ts +6 -0
- package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/reconnect.d.ts +6 -0
- package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/turn.d.ts +6 -0
- package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/webrtc.d.ts +6 -0
- package/dist/ts4.2/@dtelecom/src/connectionHelper/checks/websocket.d.ts +6 -0
- package/dist/ts4.2/@dtelecom/src/e2ee/E2eeManager.d.ts +47 -0
- package/dist/ts4.2/@dtelecom/src/e2ee/KeyProvider.d.ts +44 -0
- package/dist/ts4.2/@dtelecom/src/e2ee/constants.d.ts +15 -0
- package/dist/ts4.2/@dtelecom/src/e2ee/errors.d.ts +11 -0
- package/dist/ts4.2/@dtelecom/src/e2ee/index.d.ts +4 -0
- package/dist/ts4.2/@dtelecom/src/e2ee/types.d.ts +130 -0
- package/dist/ts4.2/@dtelecom/src/e2ee/utils.d.ts +24 -0
- package/dist/ts4.2/@dtelecom/src/e2ee/worker/FrameCryptor.d.ts +176 -0
- package/dist/ts4.2/@dtelecom/src/e2ee/worker/ParticipantKeyHandler.d.ts +65 -0
- package/dist/ts4.2/@dtelecom/src/e2ee/worker/e2ee.worker.d.ts +2 -0
- package/dist/ts4.2/@dtelecom/src/index.d.ts +38 -0
- package/dist/ts4.2/@dtelecom/src/logger.d.ts +29 -0
- package/dist/ts4.2/@dtelecom/src/options.d.ts +104 -0
- package/dist/ts4.2/@dtelecom/src/proto/livekit_models_pb.d.ts +1264 -0
- package/dist/ts4.2/@dtelecom/src/proto/livekit_rtc_pb.d.ts +1373 -0
- package/dist/ts4.2/@dtelecom/src/room/DefaultReconnectPolicy.d.ts +8 -0
- package/dist/ts4.2/@dtelecom/src/room/DeviceManager.d.ts +9 -0
- package/dist/ts4.2/@dtelecom/src/room/PCTransport.d.ts +43 -0
- package/dist/ts4.2/@dtelecom/src/room/RTCEngine.d.ts +143 -0
- package/dist/ts4.2/@dtelecom/src/room/ReconnectPolicy.d.ts +24 -0
- package/dist/ts4.2/@dtelecom/src/room/RegionUrlProvider.d.ts +17 -0
- package/dist/ts4.2/@dtelecom/src/room/Room.d.ts +248 -0
- package/dist/ts4.2/@dtelecom/src/room/defaults.d.ts +8 -0
- package/dist/ts4.2/@dtelecom/src/room/errors.d.ts +43 -0
- package/dist/ts4.2/@dtelecom/src/room/events.d.ts +477 -0
- package/dist/ts4.2/@dtelecom/src/room/participant/LocalParticipant.d.ts +177 -0
- package/dist/ts4.2/@dtelecom/src/room/participant/Participant.d.ts +95 -0
- package/dist/ts4.2/@dtelecom/src/room/participant/ParticipantTrackPermission.d.ts +26 -0
- package/dist/ts4.2/@dtelecom/src/room/participant/RemoteParticipant.d.ts +55 -0
- package/dist/ts4.2/@dtelecom/src/room/participant/publishUtils.d.ts +28 -0
- package/dist/ts4.2/@dtelecom/src/room/stats.d.ts +67 -0
- package/dist/ts4.2/@dtelecom/src/room/timers.d.ts +13 -0
- package/dist/ts4.2/@dtelecom/src/room/track/LocalAudioTrack.d.ts +25 -0
- package/dist/ts4.2/@dtelecom/src/room/track/LocalTrack.d.ts +78 -0
- package/dist/ts4.2/@dtelecom/src/room/track/LocalTrackPublication.d.ts +38 -0
- package/dist/ts4.2/@dtelecom/src/room/track/LocalVideoTrack.d.ts +54 -0
- package/dist/ts4.2/@dtelecom/src/room/track/RemoteAudioTrack.d.ts +53 -0
- package/dist/ts4.2/@dtelecom/src/room/track/RemoteTrack.d.ts +15 -0
- package/dist/ts4.2/@dtelecom/src/room/track/RemoteTrackPublication.d.ts +64 -0
- package/dist/ts4.2/@dtelecom/src/room/track/RemoteVideoTrack.d.ts +56 -0
- package/dist/ts4.2/@dtelecom/src/room/track/Track.d.ts +125 -0
- package/dist/ts4.2/@dtelecom/src/room/track/TrackPublication.d.ts +72 -0
- package/dist/ts4.2/@dtelecom/src/room/track/create.d.ts +24 -0
- package/dist/ts4.2/@dtelecom/src/room/track/facingMode.d.ts +41 -0
- package/dist/ts4.2/@dtelecom/src/room/track/options.d.ts +280 -0
- package/dist/ts4.2/@dtelecom/src/room/track/processor/types.d.ts +19 -0
- package/dist/ts4.2/@dtelecom/src/room/track/types.d.ts +24 -0
- package/dist/ts4.2/@dtelecom/src/room/track/utils.d.ts +27 -0
- package/dist/ts4.2/@dtelecom/src/room/types.d.ts +26 -0
- package/dist/ts4.2/@dtelecom/src/room/utils.d.ts +92 -0
- package/dist/ts4.2/@dtelecom/src/test/MockMediaStreamTrack.d.ts +26 -0
- package/dist/ts4.2/@dtelecom/src/test/mocks.d.ts +12 -0
- package/dist/ts4.2/@dtelecom/src/utils/AsyncQueue.d.ts +23 -0
- package/dist/ts4.2/@dtelecom/src/utils/browserParser.d.ts +12 -0
- package/dist/ts4.2/@dtelecom/src/version.d.ts +3 -0
- package/package.json +102 -0
- package/src/api/SignalClient.ts +790 -0
- package/src/connectionHelper/ConnectionCheck.ts +90 -0
- package/src/connectionHelper/checks/Checker.ts +163 -0
- package/src/connectionHelper/checks/publishAudio.ts +33 -0
- package/src/connectionHelper/checks/publishVideo.ts +33 -0
- package/src/connectionHelper/checks/reconnect.ts +45 -0
- package/src/connectionHelper/checks/turn.ts +54 -0
- package/src/connectionHelper/checks/webrtc.ts +82 -0
- package/src/connectionHelper/checks/websocket.ts +27 -0
- package/src/e2ee/E2eeManager.ts +375 -0
- package/src/e2ee/KeyProvider.ts +78 -0
- package/src/e2ee/constants.ts +44 -0
- package/src/e2ee/errors.ts +16 -0
- package/src/e2ee/index.ts +3 -0
- package/src/e2ee/types.ts +161 -0
- package/src/e2ee/utils.ts +127 -0
- package/src/e2ee/worker/FrameCryptor.test.ts +19 -0
- package/src/e2ee/worker/FrameCryptor.ts +612 -0
- package/src/e2ee/worker/ParticipantKeyHandler.ts +175 -0
- package/src/e2ee/worker/e2ee.worker.ts +223 -0
- package/src/e2ee/worker/tsconfig.json +6 -0
- package/src/index.ts +85 -0
- package/src/logger.ts +64 -0
- package/src/options.ts +127 -0
- package/src/proto/livekit_models_pb.ts +2096 -0
- package/src/proto/livekit_rtc_pb.ts +2332 -0
- package/src/room/DefaultReconnectPolicy.ts +35 -0
- package/src/room/DeviceManager.ts +88 -0
- package/src/room/PCTransport.ts +452 -0
- package/src/room/RTCEngine.ts +1421 -0
- package/src/room/ReconnectPolicy.ts +27 -0
- package/src/room/RegionUrlProvider.ts +82 -0
- package/src/room/Room.test.ts +30 -0
- package/src/room/Room.ts +1907 -0
- package/src/room/defaults.ts +49 -0
- package/src/room/errors.ts +90 -0
- package/src/room/events.ts +535 -0
- package/src/room/participant/LocalParticipant.ts +1350 -0
- package/src/room/participant/Participant.ts +299 -0
- package/src/room/participant/ParticipantTrackPermission.ts +42 -0
- package/src/room/participant/RemoteParticipant.ts +359 -0
- package/src/room/participant/publishUtils.test.ts +189 -0
- package/src/room/participant/publishUtils.ts +399 -0
- package/src/room/stats.ts +136 -0
- package/src/room/timers.ts +16 -0
- package/src/room/track/LocalAudioTrack.ts +171 -0
- package/src/room/track/LocalTrack.ts +430 -0
- package/src/room/track/LocalTrackPublication.ts +87 -0
- package/src/room/track/LocalVideoTrack.test.ts +73 -0
- package/src/room/track/LocalVideoTrack.ts +513 -0
- package/src/room/track/RemoteAudioTrack.ts +248 -0
- package/src/room/track/RemoteTrack.ts +62 -0
- package/src/room/track/RemoteTrackPublication.ts +311 -0
- package/src/room/track/RemoteVideoTrack.test.ts +152 -0
- package/src/room/track/RemoteVideoTrack.ts +410 -0
- package/src/room/track/Track.ts +452 -0
- package/src/room/track/TrackPublication.ts +158 -0
- package/src/room/track/create.ts +143 -0
- package/src/room/track/facingMode.test.ts +31 -0
- package/src/room/track/facingMode.ts +103 -0
- package/src/room/track/options.ts +362 -0
- package/src/room/track/processor/types.ts +20 -0
- package/src/room/track/types.ts +25 -0
- package/src/room/track/utils.test.ts +111 -0
- package/src/room/track/utils.ts +183 -0
- package/src/room/types.ts +39 -0
- package/src/room/utils.test.ts +16 -0
- package/src/room/utils.ts +501 -0
- package/src/room/worker.d.ts +4 -0
- package/src/test/MockMediaStreamTrack.ts +84 -0
- package/src/test/mocks.ts +19 -0
- package/src/utils/AsyncQueue.test.ts +100 -0
- package/src/utils/AsyncQueue.ts +57 -0
- package/src/utils/browserParser.test.ts +88 -0
- package/src/utils/browserParser.ts +74 -0
- package/src/version.ts +4 -0
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
import { EventEmitter } from 'events';
|
|
2
|
+
import type TypedEmitter from 'typed-emitter';
|
|
3
|
+
import log from '../../logger';
|
|
4
|
+
import {
|
|
5
|
+
DataPacket_Kind,
|
|
6
|
+
ParticipantInfo,
|
|
7
|
+
ParticipantPermission,
|
|
8
|
+
ConnectionQuality as ProtoQuality,
|
|
9
|
+
SubscriptionError,
|
|
10
|
+
} from '../../proto/livekit_models_pb';
|
|
11
|
+
import { ParticipantEvent, TrackEvent } from '../events';
|
|
12
|
+
import type LocalTrackPublication from '../track/LocalTrackPublication';
|
|
13
|
+
import type RemoteTrack from '../track/RemoteTrack';
|
|
14
|
+
import type RemoteTrackPublication from '../track/RemoteTrackPublication';
|
|
15
|
+
import { Track } from '../track/Track';
|
|
16
|
+
import type { TrackPublication } from '../track/TrackPublication';
|
|
17
|
+
|
|
18
|
+
export enum ConnectionQuality {
|
|
19
|
+
Excellent = 'excellent',
|
|
20
|
+
Good = 'good',
|
|
21
|
+
Poor = 'poor',
|
|
22
|
+
Unknown = 'unknown',
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
function qualityFromProto(q: ProtoQuality): ConnectionQuality {
|
|
26
|
+
switch (q) {
|
|
27
|
+
case ProtoQuality.EXCELLENT:
|
|
28
|
+
return ConnectionQuality.Excellent;
|
|
29
|
+
case ProtoQuality.GOOD:
|
|
30
|
+
return ConnectionQuality.Good;
|
|
31
|
+
case ProtoQuality.POOR:
|
|
32
|
+
return ConnectionQuality.Poor;
|
|
33
|
+
default:
|
|
34
|
+
return ConnectionQuality.Unknown;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export default class Participant extends (EventEmitter as new () => TypedEmitter<ParticipantEventCallbacks>) {
|
|
39
|
+
protected participantInfo?: ParticipantInfo;
|
|
40
|
+
|
|
41
|
+
audioTracks: Map<string, TrackPublication>;
|
|
42
|
+
|
|
43
|
+
videoTracks: Map<string, TrackPublication>;
|
|
44
|
+
|
|
45
|
+
/** map of track sid => all published tracks */
|
|
46
|
+
tracks: Map<string, TrackPublication>;
|
|
47
|
+
|
|
48
|
+
/** audio level between 0-1.0, 1 being loudest, 0 being softest */
|
|
49
|
+
audioLevel: number = 0;
|
|
50
|
+
|
|
51
|
+
/** if participant is currently speaking */
|
|
52
|
+
isSpeaking: boolean = false;
|
|
53
|
+
|
|
54
|
+
/** server assigned unique id */
|
|
55
|
+
sid: string;
|
|
56
|
+
|
|
57
|
+
/** client assigned identity, encoded in JWT token */
|
|
58
|
+
identity: string;
|
|
59
|
+
|
|
60
|
+
/** client assigned display name, encoded in JWT token */
|
|
61
|
+
name?: string;
|
|
62
|
+
|
|
63
|
+
/** client metadata, opaque to livekit */
|
|
64
|
+
metadata?: string;
|
|
65
|
+
|
|
66
|
+
lastSpokeAt?: Date | undefined;
|
|
67
|
+
|
|
68
|
+
permissions?: ParticipantPermission;
|
|
69
|
+
|
|
70
|
+
private _connectionQuality: ConnectionQuality = ConnectionQuality.Unknown;
|
|
71
|
+
|
|
72
|
+
get isEncrypted() {
|
|
73
|
+
return this.tracks.size > 0 && Array.from(this.tracks.values()).every((tr) => tr.isEncrypted);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** @internal */
|
|
77
|
+
constructor(sid: string, identity: string, name?: string, metadata?: string) {
|
|
78
|
+
super();
|
|
79
|
+
this.setMaxListeners(100);
|
|
80
|
+
this.sid = sid;
|
|
81
|
+
this.identity = identity;
|
|
82
|
+
this.name = name;
|
|
83
|
+
this.metadata = metadata;
|
|
84
|
+
this.audioTracks = new Map();
|
|
85
|
+
this.videoTracks = new Map();
|
|
86
|
+
this.tracks = new Map();
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
getTracks(): TrackPublication[] {
|
|
90
|
+
return Array.from(this.tracks.values());
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* Finds the first track that matches the source filter, for example, getting
|
|
95
|
+
* the user's camera track with getTrackBySource(Track.Source.Camera).
|
|
96
|
+
* @param source
|
|
97
|
+
* @returns
|
|
98
|
+
*/
|
|
99
|
+
getTrack(source: Track.Source): TrackPublication | undefined {
|
|
100
|
+
for (const [, pub] of this.tracks) {
|
|
101
|
+
if (pub.source === source) {
|
|
102
|
+
return pub;
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* Finds the first track that matches the track's name.
|
|
109
|
+
* @param name
|
|
110
|
+
* @returns
|
|
111
|
+
*/
|
|
112
|
+
getTrackByName(name: string): TrackPublication | undefined {
|
|
113
|
+
for (const [, pub] of this.tracks) {
|
|
114
|
+
if (pub.trackName === name) {
|
|
115
|
+
return pub;
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
get connectionQuality(): ConnectionQuality {
|
|
121
|
+
return this._connectionQuality;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
get isCameraEnabled(): boolean {
|
|
125
|
+
const track = this.getTrack(Track.Source.Camera);
|
|
126
|
+
return !(track?.isMuted ?? true);
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
get isMicrophoneEnabled(): boolean {
|
|
130
|
+
const track = this.getTrack(Track.Source.Microphone);
|
|
131
|
+
return !(track?.isMuted ?? true);
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
get isScreenShareEnabled(): boolean {
|
|
135
|
+
const track = this.getTrack(Track.Source.ScreenShare);
|
|
136
|
+
return !!track;
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
get isLocal(): boolean {
|
|
140
|
+
return false;
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
/** when participant joined the room */
|
|
144
|
+
get joinedAt(): Date | undefined {
|
|
145
|
+
if (this.participantInfo) {
|
|
146
|
+
return new Date(Number.parseInt(this.participantInfo.joinedAt.toString()) * 1000);
|
|
147
|
+
}
|
|
148
|
+
return new Date();
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/** @internal */
|
|
152
|
+
updateInfo(info: ParticipantInfo): boolean {
|
|
153
|
+
// it's possible the update could be applied out of order due to await
|
|
154
|
+
// during reconnect sequences. when that happens, it's possible for server
|
|
155
|
+
// to have sent more recent version of participant info while JS is waiting
|
|
156
|
+
// to process the existing payload.
|
|
157
|
+
// when the participant sid remains the same, and we already have a later version
|
|
158
|
+
// of the payload, they can be safely skipped
|
|
159
|
+
if (
|
|
160
|
+
this.participantInfo &&
|
|
161
|
+
this.participantInfo.sid === info.sid &&
|
|
162
|
+
this.participantInfo.version > info.version
|
|
163
|
+
) {
|
|
164
|
+
return false;
|
|
165
|
+
}
|
|
166
|
+
this.identity = info.identity;
|
|
167
|
+
this.sid = info.sid;
|
|
168
|
+
this.setName(info.name);
|
|
169
|
+
this.setMetadata(info.metadata);
|
|
170
|
+
if (info.permission) {
|
|
171
|
+
this.setPermissions(info.permission);
|
|
172
|
+
}
|
|
173
|
+
// set this last so setMetadata can detect changes
|
|
174
|
+
this.participantInfo = info;
|
|
175
|
+
log.trace('update participant info', { info });
|
|
176
|
+
return true;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/** @internal */
|
|
180
|
+
setMetadata(md: string) {
|
|
181
|
+
const changed = this.metadata !== md;
|
|
182
|
+
const prevMetadata = this.metadata;
|
|
183
|
+
this.metadata = md;
|
|
184
|
+
|
|
185
|
+
if (changed) {
|
|
186
|
+
this.emit(ParticipantEvent.ParticipantMetadataChanged, prevMetadata);
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
protected setName(name: string) {
|
|
191
|
+
const changed = this.name !== name;
|
|
192
|
+
this.name = name;
|
|
193
|
+
|
|
194
|
+
if (changed) {
|
|
195
|
+
this.emit(ParticipantEvent.ParticipantNameChanged, name);
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
/** @internal */
|
|
200
|
+
setPermissions(permissions: ParticipantPermission): boolean {
|
|
201
|
+
const prevPermissions = this.permissions;
|
|
202
|
+
const changed =
|
|
203
|
+
permissions.canPublish !== this.permissions?.canPublish ||
|
|
204
|
+
permissions.canSubscribe !== this.permissions?.canSubscribe ||
|
|
205
|
+
permissions.canPublishData !== this.permissions?.canPublishData ||
|
|
206
|
+
permissions.hidden !== this.permissions?.hidden ||
|
|
207
|
+
permissions.recorder !== this.permissions?.recorder ||
|
|
208
|
+
permissions.canPublishSources.length !== this.permissions.canPublishSources.length ||
|
|
209
|
+
permissions.canPublishSources.some(
|
|
210
|
+
(value, index) => value !== this.permissions?.canPublishSources[index],
|
|
211
|
+
);
|
|
212
|
+
this.permissions = permissions;
|
|
213
|
+
|
|
214
|
+
if (changed) {
|
|
215
|
+
this.emit(ParticipantEvent.ParticipantPermissionsChanged, prevPermissions);
|
|
216
|
+
}
|
|
217
|
+
return changed;
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
/** @internal */
|
|
221
|
+
setIsSpeaking(speaking: boolean) {
|
|
222
|
+
if (speaking === this.isSpeaking) {
|
|
223
|
+
return;
|
|
224
|
+
}
|
|
225
|
+
this.isSpeaking = speaking;
|
|
226
|
+
if (speaking) {
|
|
227
|
+
this.lastSpokeAt = new Date();
|
|
228
|
+
}
|
|
229
|
+
this.emit(ParticipantEvent.IsSpeakingChanged, speaking);
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
/** @internal */
|
|
233
|
+
setConnectionQuality(q: ProtoQuality) {
|
|
234
|
+
const prevQuality = this._connectionQuality;
|
|
235
|
+
this._connectionQuality = qualityFromProto(q);
|
|
236
|
+
if (prevQuality !== this._connectionQuality) {
|
|
237
|
+
this.emit(ParticipantEvent.ConnectionQualityChanged, this._connectionQuality);
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
protected addTrackPublication(publication: TrackPublication) {
|
|
242
|
+
// forward publication driven events
|
|
243
|
+
publication.on(TrackEvent.Muted, () => {
|
|
244
|
+
this.emit(ParticipantEvent.TrackMuted, publication);
|
|
245
|
+
});
|
|
246
|
+
|
|
247
|
+
publication.on(TrackEvent.Unmuted, () => {
|
|
248
|
+
this.emit(ParticipantEvent.TrackUnmuted, publication);
|
|
249
|
+
});
|
|
250
|
+
|
|
251
|
+
const pub = publication;
|
|
252
|
+
if (pub.track) {
|
|
253
|
+
pub.track.sid = publication.trackSid;
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
this.tracks.set(publication.trackSid, publication);
|
|
257
|
+
switch (publication.kind) {
|
|
258
|
+
case Track.Kind.Audio:
|
|
259
|
+
this.audioTracks.set(publication.trackSid, publication);
|
|
260
|
+
break;
|
|
261
|
+
case Track.Kind.Video:
|
|
262
|
+
this.videoTracks.set(publication.trackSid, publication);
|
|
263
|
+
break;
|
|
264
|
+
default:
|
|
265
|
+
break;
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
export type ParticipantEventCallbacks = {
|
|
271
|
+
trackPublished: (publication: RemoteTrackPublication) => void;
|
|
272
|
+
trackSubscribed: (track: RemoteTrack, publication: RemoteTrackPublication) => void;
|
|
273
|
+
trackSubscriptionFailed: (trackSid: string, reason?: SubscriptionError) => void;
|
|
274
|
+
trackUnpublished: (publication: RemoteTrackPublication) => void;
|
|
275
|
+
trackUnsubscribed: (track: RemoteTrack, publication: RemoteTrackPublication) => void;
|
|
276
|
+
trackMuted: (publication: TrackPublication) => void;
|
|
277
|
+
trackUnmuted: (publication: TrackPublication) => void;
|
|
278
|
+
localTrackPublished: (publication: LocalTrackPublication) => void;
|
|
279
|
+
localTrackUnpublished: (publication: LocalTrackPublication) => void;
|
|
280
|
+
participantMetadataChanged: (prevMetadata: string | undefined, participant?: any) => void;
|
|
281
|
+
participantNameChanged: (name: string) => void;
|
|
282
|
+
dataReceived: (payload: Uint8Array, kind: DataPacket_Kind) => void;
|
|
283
|
+
isSpeakingChanged: (speaking: boolean) => void;
|
|
284
|
+
connectionQualityChanged: (connectionQuality: ConnectionQuality) => void;
|
|
285
|
+
trackStreamStateChanged: (
|
|
286
|
+
publication: RemoteTrackPublication,
|
|
287
|
+
streamState: Track.StreamState,
|
|
288
|
+
) => void;
|
|
289
|
+
trackSubscriptionPermissionChanged: (
|
|
290
|
+
publication: RemoteTrackPublication,
|
|
291
|
+
status: TrackPublication.PermissionStatus,
|
|
292
|
+
) => void;
|
|
293
|
+
mediaDevicesError: (error: Error) => void;
|
|
294
|
+
participantPermissionsChanged: (prevPermissions?: ParticipantPermission) => void;
|
|
295
|
+
trackSubscriptionStatusChanged: (
|
|
296
|
+
publication: RemoteTrackPublication,
|
|
297
|
+
status: TrackPublication.SubscriptionStatus,
|
|
298
|
+
) => void;
|
|
299
|
+
};
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import { TrackPermission } from '../../proto/livekit_rtc_pb';
|
|
2
|
+
|
|
3
|
+
export interface ParticipantTrackPermission {
|
|
4
|
+
/**
|
|
5
|
+
* The participant identity this permission applies to.
|
|
6
|
+
* You can either provide this or `participantSid`
|
|
7
|
+
*/
|
|
8
|
+
participantIdentity?: string;
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* The participant server id this permission applies to.
|
|
12
|
+
* You can either provide this or `participantIdentity`
|
|
13
|
+
*/
|
|
14
|
+
participantSid?: string;
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* Grant permission to all all tracks. Takes precedence over allowedTrackSids.
|
|
18
|
+
* false if unset.
|
|
19
|
+
*/
|
|
20
|
+
allowAll?: boolean;
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* The list of track ids that the target participant can subscribe to.
|
|
24
|
+
* When unset, it'll allow all tracks to be subscribed by the participant.
|
|
25
|
+
* When empty, this participant is disallowed from subscribing to any tracks.
|
|
26
|
+
*/
|
|
27
|
+
allowedTrackSids?: string[];
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export function trackPermissionToProto(perms: ParticipantTrackPermission): TrackPermission {
|
|
31
|
+
if (!perms.participantSid && !perms.participantIdentity) {
|
|
32
|
+
throw new Error(
|
|
33
|
+
'Invalid track permission, must provide at least one of participantIdentity and participantSid',
|
|
34
|
+
);
|
|
35
|
+
}
|
|
36
|
+
return new TrackPermission({
|
|
37
|
+
participantIdentity: perms.participantIdentity ?? '',
|
|
38
|
+
participantSid: perms.participantSid ?? '',
|
|
39
|
+
allTracks: perms.allowAll ?? false,
|
|
40
|
+
trackSids: perms.allowedTrackSids || [],
|
|
41
|
+
});
|
|
42
|
+
}
|
|
@@ -0,0 +1,359 @@
|
|
|
1
|
+
import type { SignalClient } from '../../api/SignalClient';
|
|
2
|
+
import log from '../../logger';
|
|
3
|
+
import type { ParticipantInfo, SubscriptionError } from '../../proto/livekit_models_pb';
|
|
4
|
+
import type { UpdateSubscription, UpdateTrackSettings } from '../../proto/livekit_rtc_pb';
|
|
5
|
+
import { ParticipantEvent, TrackEvent } from '../events';
|
|
6
|
+
import RemoteAudioTrack from '../track/RemoteAudioTrack';
|
|
7
|
+
import type RemoteTrack from '../track/RemoteTrack';
|
|
8
|
+
import RemoteTrackPublication from '../track/RemoteTrackPublication';
|
|
9
|
+
import RemoteVideoTrack from '../track/RemoteVideoTrack';
|
|
10
|
+
import { Track } from '../track/Track';
|
|
11
|
+
import type { TrackPublication } from '../track/TrackPublication';
|
|
12
|
+
import type { AudioOutputOptions } from '../track/options';
|
|
13
|
+
import type { AdaptiveStreamSettings } from '../track/types';
|
|
14
|
+
import Participant from './Participant';
|
|
15
|
+
import type { ParticipantEventCallbacks } from './Participant';
|
|
16
|
+
|
|
17
|
+
export default class RemoteParticipant extends Participant {
|
|
18
|
+
audioTracks: Map<string, RemoteTrackPublication>;
|
|
19
|
+
|
|
20
|
+
videoTracks: Map<string, RemoteTrackPublication>;
|
|
21
|
+
|
|
22
|
+
tracks: Map<string, RemoteTrackPublication>;
|
|
23
|
+
|
|
24
|
+
signalClient: SignalClient;
|
|
25
|
+
|
|
26
|
+
private volumeMap: Map<Track.Source, number>;
|
|
27
|
+
|
|
28
|
+
private audioContext?: AudioContext;
|
|
29
|
+
|
|
30
|
+
private audioOutput?: AudioOutputOptions;
|
|
31
|
+
|
|
32
|
+
/** @internal */
|
|
33
|
+
static fromParticipantInfo(signalClient: SignalClient, pi: ParticipantInfo): RemoteParticipant {
|
|
34
|
+
return new RemoteParticipant(signalClient, pi.sid, pi.identity, pi.name, pi.metadata);
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
/** @internal */
|
|
38
|
+
constructor(
|
|
39
|
+
signalClient: SignalClient,
|
|
40
|
+
sid: string,
|
|
41
|
+
identity?: string,
|
|
42
|
+
name?: string,
|
|
43
|
+
metadata?: string,
|
|
44
|
+
) {
|
|
45
|
+
super(sid, identity || '', name, metadata);
|
|
46
|
+
this.signalClient = signalClient;
|
|
47
|
+
this.tracks = new Map();
|
|
48
|
+
this.audioTracks = new Map();
|
|
49
|
+
this.videoTracks = new Map();
|
|
50
|
+
this.volumeMap = new Map();
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
protected addTrackPublication(publication: RemoteTrackPublication) {
|
|
54
|
+
super.addTrackPublication(publication);
|
|
55
|
+
|
|
56
|
+
// register action events
|
|
57
|
+
publication.on(TrackEvent.UpdateSettings, (settings: UpdateTrackSettings) => {
|
|
58
|
+
log.debug('send update settings', settings);
|
|
59
|
+
this.signalClient.sendUpdateTrackSettings(settings);
|
|
60
|
+
});
|
|
61
|
+
publication.on(TrackEvent.UpdateSubscription, (sub: UpdateSubscription) => {
|
|
62
|
+
sub.participantTracks.forEach((pt) => {
|
|
63
|
+
pt.participantSid = this.sid;
|
|
64
|
+
});
|
|
65
|
+
this.signalClient.sendUpdateSubscription(sub);
|
|
66
|
+
});
|
|
67
|
+
publication.on(
|
|
68
|
+
TrackEvent.SubscriptionPermissionChanged,
|
|
69
|
+
(status: TrackPublication.PermissionStatus) => {
|
|
70
|
+
this.emit(ParticipantEvent.TrackSubscriptionPermissionChanged, publication, status);
|
|
71
|
+
},
|
|
72
|
+
);
|
|
73
|
+
publication.on(
|
|
74
|
+
TrackEvent.SubscriptionStatusChanged,
|
|
75
|
+
(status: TrackPublication.SubscriptionStatus) => {
|
|
76
|
+
this.emit(ParticipantEvent.TrackSubscriptionStatusChanged, publication, status);
|
|
77
|
+
},
|
|
78
|
+
);
|
|
79
|
+
publication.on(TrackEvent.Subscribed, (track: RemoteTrack) => {
|
|
80
|
+
this.emit(ParticipantEvent.TrackSubscribed, track, publication);
|
|
81
|
+
});
|
|
82
|
+
publication.on(TrackEvent.Unsubscribed, (previousTrack: RemoteTrack) => {
|
|
83
|
+
this.emit(ParticipantEvent.TrackUnsubscribed, previousTrack, publication);
|
|
84
|
+
});
|
|
85
|
+
publication.on(TrackEvent.SubscriptionFailed, (error: SubscriptionError) => {
|
|
86
|
+
this.emit(ParticipantEvent.TrackSubscriptionFailed, publication.trackSid, error);
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
getTrack(source: Track.Source): RemoteTrackPublication | undefined {
|
|
91
|
+
const track = super.getTrack(source);
|
|
92
|
+
if (track) {
|
|
93
|
+
return track as RemoteTrackPublication;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
getTrackByName(name: string): RemoteTrackPublication | undefined {
|
|
98
|
+
const track = super.getTrackByName(name);
|
|
99
|
+
if (track) {
|
|
100
|
+
return track as RemoteTrackPublication;
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* sets the volume on the participant's audio track
|
|
106
|
+
* by default, this affects the microphone publication
|
|
107
|
+
* a different source can be passed in as a second argument
|
|
108
|
+
* if no track exists the volume will be applied when the microphone track is added
|
|
109
|
+
*/
|
|
110
|
+
setVolume(
|
|
111
|
+
volume: number,
|
|
112
|
+
source: Track.Source.Microphone | Track.Source.ScreenShareAudio = Track.Source.Microphone,
|
|
113
|
+
) {
|
|
114
|
+
this.volumeMap.set(source, volume);
|
|
115
|
+
const audioPublication = this.getTrack(source);
|
|
116
|
+
if (audioPublication && audioPublication.track) {
|
|
117
|
+
(audioPublication.track as RemoteAudioTrack).setVolume(volume);
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* gets the volume on the participant's microphone track
|
|
123
|
+
*/
|
|
124
|
+
getVolume(
|
|
125
|
+
source: Track.Source.Microphone | Track.Source.ScreenShareAudio = Track.Source.Microphone,
|
|
126
|
+
) {
|
|
127
|
+
const audioPublication = this.getTrack(source);
|
|
128
|
+
if (audioPublication && audioPublication.track) {
|
|
129
|
+
return (audioPublication.track as RemoteAudioTrack).getVolume();
|
|
130
|
+
}
|
|
131
|
+
return this.volumeMap.get(source);
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/** @internal */
|
|
135
|
+
addSubscribedMediaTrack(
|
|
136
|
+
mediaTrack: MediaStreamTrack,
|
|
137
|
+
sid: Track.SID,
|
|
138
|
+
mediaStream: MediaStream,
|
|
139
|
+
receiver?: RTCRtpReceiver,
|
|
140
|
+
adaptiveStreamSettings?: AdaptiveStreamSettings,
|
|
141
|
+
triesLeft?: number,
|
|
142
|
+
) {
|
|
143
|
+
// find the track publication
|
|
144
|
+
// it's possible for the media track to arrive before participant info
|
|
145
|
+
let publication = this.getTrackPublication(sid);
|
|
146
|
+
|
|
147
|
+
// it's also possible that the browser didn't honor our original track id
|
|
148
|
+
// FireFox would use its own local uuid instead of server track id
|
|
149
|
+
if (!publication) {
|
|
150
|
+
if (!sid.startsWith('TR')) {
|
|
151
|
+
// find the first track that matches type
|
|
152
|
+
this.tracks.forEach((p) => {
|
|
153
|
+
if (!publication && mediaTrack.kind === p.kind.toString()) {
|
|
154
|
+
publication = p;
|
|
155
|
+
}
|
|
156
|
+
});
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
// when we couldn't locate the track, it's possible that the metadata hasn't
|
|
161
|
+
// yet arrived. Wait a bit longer for it to arrive, or fire an error
|
|
162
|
+
if (!publication) {
|
|
163
|
+
if (triesLeft === 0) {
|
|
164
|
+
log.error('could not find published track', { participant: this.sid, trackSid: sid });
|
|
165
|
+
this.emit(ParticipantEvent.TrackSubscriptionFailed, sid);
|
|
166
|
+
return;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
if (triesLeft === undefined) triesLeft = 20;
|
|
170
|
+
setTimeout(() => {
|
|
171
|
+
this.addSubscribedMediaTrack(
|
|
172
|
+
mediaTrack,
|
|
173
|
+
sid,
|
|
174
|
+
mediaStream,
|
|
175
|
+
receiver,
|
|
176
|
+
adaptiveStreamSettings,
|
|
177
|
+
triesLeft! - 1,
|
|
178
|
+
);
|
|
179
|
+
}, 150);
|
|
180
|
+
return;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
if (mediaTrack.readyState === 'ended') {
|
|
184
|
+
log.error(
|
|
185
|
+
'unable to subscribe because MediaStreamTrack is ended. Do not call MediaStreamTrack.stop()',
|
|
186
|
+
{ participant: this.sid, trackSid: sid },
|
|
187
|
+
);
|
|
188
|
+
this.emit(ParticipantEvent.TrackSubscriptionFailed, sid);
|
|
189
|
+
return;
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
const isVideo = mediaTrack.kind === 'video';
|
|
193
|
+
let track: RemoteTrack;
|
|
194
|
+
if (isVideo) {
|
|
195
|
+
track = new RemoteVideoTrack(mediaTrack, sid, receiver, adaptiveStreamSettings);
|
|
196
|
+
} else {
|
|
197
|
+
track = new RemoteAudioTrack(mediaTrack, sid, receiver, this.audioContext, this.audioOutput);
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
// set track info
|
|
201
|
+
track.source = publication.source;
|
|
202
|
+
// keep publication's muted status
|
|
203
|
+
track.isMuted = publication.isMuted;
|
|
204
|
+
track.setMediaStream(mediaStream);
|
|
205
|
+
track.start();
|
|
206
|
+
|
|
207
|
+
publication.setTrack(track);
|
|
208
|
+
// set participant volumes on new audio tracks
|
|
209
|
+
if (this.volumeMap.has(publication.source) && track instanceof RemoteAudioTrack) {
|
|
210
|
+
track.setVolume(this.volumeMap.get(publication.source)!);
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
return publication;
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
/** @internal */
|
|
217
|
+
get hasMetadata(): boolean {
|
|
218
|
+
return !!this.participantInfo;
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
getTrackPublication(sid: Track.SID): RemoteTrackPublication | undefined {
|
|
222
|
+
return this.tracks.get(sid);
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
/** @internal */
|
|
226
|
+
updateInfo(info: ParticipantInfo): boolean {
|
|
227
|
+
if (!super.updateInfo(info)) {
|
|
228
|
+
return false;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
// we are getting a list of all available tracks, reconcile in here
|
|
232
|
+
// and send out events for changes
|
|
233
|
+
|
|
234
|
+
// reconcile track publications, publish events only if metadata is already there
|
|
235
|
+
// i.e. changes since the local participant has joined
|
|
236
|
+
const validTracks = new Map<string, RemoteTrackPublication>();
|
|
237
|
+
const newTracks = new Map<string, RemoteTrackPublication>();
|
|
238
|
+
|
|
239
|
+
info.tracks.forEach((ti) => {
|
|
240
|
+
let publication = this.getTrackPublication(ti.sid);
|
|
241
|
+
if (!publication) {
|
|
242
|
+
// new publication
|
|
243
|
+
const kind = Track.kindFromProto(ti.type);
|
|
244
|
+
if (!kind) {
|
|
245
|
+
return;
|
|
246
|
+
}
|
|
247
|
+
publication = new RemoteTrackPublication(
|
|
248
|
+
kind,
|
|
249
|
+
ti,
|
|
250
|
+
this.signalClient.connectOptions?.autoSubscribe,
|
|
251
|
+
);
|
|
252
|
+
publication.updateInfo(ti);
|
|
253
|
+
newTracks.set(ti.sid, publication);
|
|
254
|
+
const existingTrackOfSource = Array.from(this.tracks.values()).find(
|
|
255
|
+
(publishedTrack) => publishedTrack.source === publication?.source,
|
|
256
|
+
);
|
|
257
|
+
if (existingTrackOfSource && publication.source !== Track.Source.Unknown) {
|
|
258
|
+
log.debug(
|
|
259
|
+
`received a second track publication for ${this.identity} with the same source: ${publication.source}`,
|
|
260
|
+
{
|
|
261
|
+
oldTrack: existingTrackOfSource,
|
|
262
|
+
newTrack: publication,
|
|
263
|
+
participant: this,
|
|
264
|
+
participantInfo: info,
|
|
265
|
+
},
|
|
266
|
+
);
|
|
267
|
+
}
|
|
268
|
+
this.addTrackPublication(publication);
|
|
269
|
+
} else {
|
|
270
|
+
publication.updateInfo(ti);
|
|
271
|
+
}
|
|
272
|
+
validTracks.set(ti.sid, publication);
|
|
273
|
+
});
|
|
274
|
+
|
|
275
|
+
// detect removed tracks
|
|
276
|
+
this.tracks.forEach((publication) => {
|
|
277
|
+
if (!validTracks.has(publication.trackSid)) {
|
|
278
|
+
log.trace('detected removed track on remote participant, unpublishing', {
|
|
279
|
+
publication,
|
|
280
|
+
participantSid: this.sid,
|
|
281
|
+
});
|
|
282
|
+
this.unpublishTrack(publication.trackSid, true);
|
|
283
|
+
}
|
|
284
|
+
});
|
|
285
|
+
|
|
286
|
+
// always emit events for new publications, Room will not forward them unless it's ready
|
|
287
|
+
newTracks.forEach((publication) => {
|
|
288
|
+
this.emit(ParticipantEvent.TrackPublished, publication);
|
|
289
|
+
});
|
|
290
|
+
return true;
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
/** @internal */
|
|
294
|
+
unpublishTrack(sid: Track.SID, sendUnpublish?: boolean) {
|
|
295
|
+
const publication = <RemoteTrackPublication>this.tracks.get(sid);
|
|
296
|
+
if (!publication) {
|
|
297
|
+
return;
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
// also send unsubscribe, if track is actively subscribed
|
|
301
|
+
const { track } = publication;
|
|
302
|
+
if (track) {
|
|
303
|
+
track.stop();
|
|
304
|
+
publication.setTrack(undefined);
|
|
305
|
+
}
|
|
306
|
+
|
|
307
|
+
// remove track from maps only after unsubscribed has been fired
|
|
308
|
+
this.tracks.delete(sid);
|
|
309
|
+
|
|
310
|
+
// remove from the right type map
|
|
311
|
+
switch (publication.kind) {
|
|
312
|
+
case Track.Kind.Audio:
|
|
313
|
+
this.audioTracks.delete(sid);
|
|
314
|
+
break;
|
|
315
|
+
case Track.Kind.Video:
|
|
316
|
+
this.videoTracks.delete(sid);
|
|
317
|
+
break;
|
|
318
|
+
default:
|
|
319
|
+
break;
|
|
320
|
+
}
|
|
321
|
+
|
|
322
|
+
if (sendUnpublish) {
|
|
323
|
+
this.emit(ParticipantEvent.TrackUnpublished, publication);
|
|
324
|
+
}
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
/**
|
|
328
|
+
* @internal
|
|
329
|
+
*/
|
|
330
|
+
setAudioContext(ctx: AudioContext | undefined) {
|
|
331
|
+
this.audioContext = ctx;
|
|
332
|
+
this.audioTracks.forEach(
|
|
333
|
+
(track) => track.track instanceof RemoteAudioTrack && track.track.setAudioContext(ctx),
|
|
334
|
+
);
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
/**
|
|
338
|
+
* @internal
|
|
339
|
+
*/
|
|
340
|
+
async setAudioOutput(output: AudioOutputOptions) {
|
|
341
|
+
this.audioOutput = output;
|
|
342
|
+
const promises: Promise<void>[] = [];
|
|
343
|
+
this.audioTracks.forEach((pub) => {
|
|
344
|
+
if (pub.track instanceof RemoteAudioTrack) {
|
|
345
|
+
promises.push(pub.track.setSinkId(output.deviceId ?? 'default'));
|
|
346
|
+
}
|
|
347
|
+
});
|
|
348
|
+
await Promise.all(promises);
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
/** @internal */
|
|
352
|
+
emit<E extends keyof ParticipantEventCallbacks>(
|
|
353
|
+
event: E,
|
|
354
|
+
...args: Parameters<ParticipantEventCallbacks[E]>
|
|
355
|
+
): boolean {
|
|
356
|
+
log.trace('participant event', { participant: this.sid, event, args });
|
|
357
|
+
return super.emit(event, ...args);
|
|
358
|
+
}
|
|
359
|
+
}
|