@vkontakte/calls-sdk 2.8.12-dev.c0dd153e.0 → 2.8.12-dev.c58bce06.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 (76) hide show
  1. package/CallsSDK.d.ts +40 -7
  2. package/abstract/BaseApi.d.ts +15 -9
  3. package/abstract/BaseSignaling.d.ts +10 -5
  4. package/calls-sdk.cjs.js +7 -13
  5. package/calls-sdk.esm.js +4521 -2972
  6. package/classes/AudioFix.d.ts +2 -2
  7. package/classes/AudioOutput.d.ts +6 -3
  8. package/classes/CallRegistry.d.ts +5 -1
  9. package/classes/ExternalIdCache.d.ts +1 -0
  10. package/classes/MediaSource.d.ts +6 -2
  11. package/classes/SpecListener.d.ts +2 -2
  12. package/classes/codec/LibVPxDecoder.d.ts +2 -2
  13. package/classes/codec/LibVPxEncoder.d.ts +2 -2
  14. package/classes/codec/WebCodecsDecoder.d.ts +2 -2
  15. package/classes/codec/WebCodecsEncoder.d.ts +2 -2
  16. package/classes/codec/WorkerBase.d.ts +3 -3
  17. package/classes/{Conversation.d.ts → conversation/Conversation.d.ts} +61 -48
  18. package/classes/conversation/Conversation.testUtils.d.ts +148 -0
  19. package/classes/{ConversationResponseValidator.d.ts → conversation/ConversationResponseValidator.d.ts} +1 -1
  20. package/classes/{DisplayLayoutRequester.d.ts → conversation/DisplayLayoutRequester.d.ts} +5 -5
  21. package/classes/conversation/index.d.ts +1 -0
  22. package/classes/screenshare/ScreenCaptureReceiver.d.ts +2 -2
  23. package/classes/screenshare/ScreenCaptureSender.d.ts +2 -2
  24. package/classes/screenshare/StreamBuilder.d.ts +2 -2
  25. package/classes/stat/CallFinishClassifier.d.ts +11 -0
  26. package/classes/stat/CallLifecycleStats.d.ts +42 -0
  27. package/classes/stat/CodecStatsAggregator.d.ts +2 -2
  28. package/classes/stat/ConversationStats.d.ts +24 -8
  29. package/classes/stat/FirstMediaSentProbe.d.ts +13 -0
  30. package/classes/stat/StatAggregator.d.ts +6 -2
  31. package/classes/stat/StatClock.d.ts +35 -0
  32. package/classes/stat/StatDrainScheduler.d.ts +121 -0
  33. package/classes/stat/StatEventCollector.d.ts +54 -0
  34. package/classes/stat/StatPings.d.ts +3 -4
  35. package/classes/stat/StatQueue.d.ts +92 -0
  36. package/classes/stat/StatSignalingCommands.d.ts +3 -4
  37. package/classes/stat/StatUnloadJournal.d.ts +39 -0
  38. package/classes/transport/BaseTransport.d.ts +7 -1
  39. package/classes/transport/DirectTransport.d.ts +3 -2
  40. package/classes/transport/PerfStatReporter.d.ts +2 -0
  41. package/classes/transport/ServerTransport.d.ts +3 -6
  42. package/classes/transport/SimulcastSender.d.ts +31 -0
  43. package/classes/transport/Transport.d.ts +10 -2
  44. package/default/Api.d.ts +29 -5
  45. package/default/ApiExternal.d.ts +2 -1
  46. package/default/Signaling.d.ts +13 -15
  47. package/default/SignalingTransport.d.ts +7 -1
  48. package/enums/ClientHangupReason.d.ts +7 -0
  49. package/enums/HangupType.d.ts +0 -1
  50. package/enums/SessionError.d.ts +15 -0
  51. package/enums/Stat.d.ts +5 -1
  52. package/package.json +3 -3
  53. package/static/ApiTransport.d.ts +7 -0
  54. package/static/AuthData.d.ts +10 -0
  55. package/static/Debug.d.ts +1 -0
  56. package/static/External.d.ts +1 -1
  57. package/static/Params.d.ts +42 -2
  58. package/static/ParticipantConnectionStatusUtils.d.ts +1 -0
  59. package/static/Sdp.d.ts +3 -0
  60. package/static/SessionStore.d.ts +38 -0
  61. package/static/SignalingCapabilities.d.ts +1 -1
  62. package/static/SimulcastInfo.d.ts +5 -3
  63. package/static/Utils.d.ts +1 -2
  64. package/static/WebRTCUtils.d.ts +13 -12
  65. package/types/Api.d.ts +9 -0
  66. package/types/Capabilities.d.ts +1 -0
  67. package/types/Conversation.d.ts +12 -2
  68. package/types/FastHangup.d.ts +66 -0
  69. package/types/Participant.d.ts +1 -0
  70. package/types/PerfStatReporter.d.ts +0 -4
  71. package/types/SignalingCommand.d.ts +2 -0
  72. package/types/SignalingMessage.d.ts +5 -1
  73. package/utils/IceServers.d.ts +2 -0
  74. package/utils/NavigatorPermissions.d.ts +2 -2
  75. package/utils/SerializeLatest.d.ts +5 -0
  76. package/classes/StatsLogger.d.ts +0 -26
@@ -3,7 +3,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
3
3
  import { type DebugLogger } from '../../static/Debug';
4
4
  import { ParticipantId } from '../../types/Participant';
5
5
  import ServerSettings from '../../types/ServerSettings';
6
- import StatsLogger from '../StatsLogger';
6
+ import StatEventCollector from '../stat/StatEventCollector';
7
7
  import { MediaSource } from '../MediaSource';
8
8
  import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
9
9
  import { StatAggregator } from '../stat/StatAggregator';
@@ -42,12 +42,12 @@ export default class ServerTransport extends BaseTransport {
42
42
  private _rtpReceiversByStreamId;
43
43
  private _producerSessionId;
44
44
  private _newAudioShareTrack;
45
- private _simulcastInfo;
46
45
  private readonly _debug;
47
46
  private readonly _logger;
48
47
  private readonly _statAggregator;
49
48
  private readonly _codecStatsAggregator;
50
- constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
49
+ private readonly _simulcast;
50
+ constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
51
51
  updateStatisticsInterval(): void;
52
52
  open(observer?: boolean): void;
53
53
  close(error?: Error): void;
@@ -85,8 +85,6 @@ export default class ServerTransport extends BaseTransport {
85
85
  private _detectStaleTracks;
86
86
  private _allocateConsumer;
87
87
  private _processOffer;
88
- private _findFirstSimTransceiver;
89
- private _setupSimulcastTransceiver;
90
88
  private _acceptProducer;
91
89
  private _replaceScreenShareTrack;
92
90
  private _handleTracks;
@@ -101,7 +99,6 @@ export default class ServerTransport extends BaseTransport {
101
99
  private _onReplacedTrack;
102
100
  private _onSourcesChanged;
103
101
  getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;
104
- private _changeSimulcastInfo;
105
102
  private _monitorRtpShare;
106
103
  private _startMonitorRtpShareInterval;
107
104
  private _stopMonitorRtpShareInterval;
@@ -0,0 +1,31 @@
1
+ import BaseSignaling from '../../abstract/BaseSignaling';
2
+ import { type DebugLogger } from '../../static/Debug';
3
+ import type VideoSettings from '../../types/VideoSettings';
4
+ import { MediaSource } from '../MediaSource';
5
+ import StatEventCollector from '../stat/StatEventCollector';
6
+ export default class SimulcastSender {
7
+ private _pc;
8
+ private _transceiver;
9
+ private _currentSimulcastInfo;
10
+ private readonly _signaling;
11
+ private readonly _mediaSource;
12
+ private readonly _getCameraSettings;
13
+ private readonly _debug;
14
+ private readonly _logger;
15
+ constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatEventCollector | null);
16
+ configureFromRemoteOffer(pc: RTCPeerConnection): Promise<void>;
17
+ finalizeAnswer(sdp: string): string;
18
+ sync({ force }?: {
19
+ force?: boolean;
20
+ }): Promise<void>;
21
+ replaceTrack(track: MediaStreamTrack): boolean;
22
+ reset(): void;
23
+ private _findTransceiver;
24
+ private _findMediaSection;
25
+ private _getConfig;
26
+ private _getTrackConfig;
27
+ private _applyConfig;
28
+ private _applyCurrentMediaState;
29
+ private _syncReplacedTrack;
30
+ private _changeSimulcast;
31
+ }
@@ -6,7 +6,7 @@ import { type DebugLogger } from '../../static/Debug';
6
6
  import { ParticipantId } from '../../types/Participant';
7
7
  import ServerSettings from '../../types/ServerSettings';
8
8
  import EventEmitter from '../EventEmitter';
9
- import StatsLogger from '../StatsLogger';
9
+ import StatEventCollector from '../stat/StatEventCollector';
10
10
  import { MediaSource } from '../MediaSource';
11
11
  import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
12
12
  import { StatAggregator } from '../stat/StatAggregator';
@@ -48,13 +48,17 @@ export declare class Transport extends EventEmitter {
48
48
  private readonly _logger;
49
49
  private readonly _statAggregator;
50
50
  private readonly _codecStatsAggregator;
51
- constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
51
+ private readonly _onFirstMediaSent;
52
+ private _firstMediaSentProbeStopped;
53
+ private _vadController;
54
+ constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
52
55
  updateSettings(settings: ServerSettings): void;
53
56
  updateStatisticsInterval(): void;
54
57
  allocate(participantId: ParticipantId, isMaster?: boolean): void;
55
58
  open(participantIds: ParticipantId[], peerId?: string | null, observer?: boolean, force?: boolean): void;
56
59
  close(participantId: ParticipantId): void;
57
60
  destroy(): void;
61
+ stopFirstMediaSentProbe(): void;
58
62
  holdClose(): void;
59
63
  setRemoteHold(hold: boolean): void;
60
64
  getTopology(): TransportTopology;
@@ -69,6 +73,8 @@ export declare class Transport extends EventEmitter {
69
73
  private _setStates;
70
74
  private _setLocalState;
71
75
  private _onSignalingNotification;
76
+ private _handleFirstMediaSent;
77
+ private _getFirstMediaSentCallback;
72
78
  private _onTopologyChanged;
73
79
  private _createDirectTransport;
74
80
  private _createServerTransport;
@@ -91,6 +97,8 @@ export declare class Transport extends EventEmitter {
91
97
  private _onAnimojiStream;
92
98
  /** Обработчик, досылающий MediaSourceEvent.SOURCE_CHANGED событие до аллокации транспортов */
93
99
  private _onAnimojiStatus;
100
+ private _createVad;
101
+ private _updateVadTrack;
94
102
  private _createAnimojiTransport;
95
103
  private _removeAnimojiTransport;
96
104
  getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;
package/default/Api.d.ts CHANGED
@@ -1,25 +1,49 @@
1
1
  import BaseApi, { ClientStats } from '../abstract/BaseApi';
2
2
  import CallType from '../enums/CallType';
3
3
  import HangupType from '../enums/HangupType';
4
+ import { IHangupParams } from '../types/Api';
4
5
  import ConversationParams from '../types/ConversationParams';
5
6
  import ConversationResponse from '../types/ConversationResponse';
6
7
  import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/ExternalId';
7
8
  import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
8
9
  import PushData from '../types/PushData';
9
10
  export default class Api extends BaseApi {
10
- private _userId;
11
11
  private _uuid;
12
12
  private _idCache;
13
13
  private _callUnsafe;
14
- protected _call(method: string, data?: any, noSession?: boolean): Promise<any>;
15
- userId(participantId: ParticipantId): Promise<ExternalParticipantId>;
14
+ protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
15
+ userId(participantId: ParticipantId): ExternalParticipantId;
16
16
  authorize(): Promise<void>;
17
+ /**
18
+ * Запрос auth.anonymLogin без побочных эффектов: ничего не пишет в
19
+ * AuthData и кэш. Пустой токен — анонимный логин версии 2.
20
+ */
21
+ private _anonymLogin;
17
22
  private _getAnonymLoginCacheKey;
18
23
  private _getCachedAnonymLogin;
19
24
  private _setCachedAnonymLogin;
20
25
  private _removeCachedAnonymLogin;
26
+ private _reauthorize;
21
27
  private _applyAnonymLogin;
22
- logClientStats(items: ClientStats[]): void;
28
+ private _buildClientStatsData;
29
+ /**
30
+ * Ошибки по отдельным событиям логируются, но не влияют на результат:
31
+ * батч трактуется целиком, иначе одно всегда отвергаемое событие
32
+ * залипило бы очередь навсегда.
33
+ */
34
+ private _reportClientStatsItemErrors;
35
+ /**
36
+ * noSession = true: _prepareQuery не подставит session_key из AuthData,
37
+ * наш явный ключ останется; application_key добавится как обычно.
38
+ */
39
+ private _sendClientStatsWith;
40
+ /**
41
+ * Бекенд присылает 200 в любой ситуации, нужно читать тело.
42
+ * В теле есть ошибки если есть проблемы со статой.
43
+ */
44
+ private _sendClientStats;
45
+ logClientStats(items: ClientStats[]): Promise<void>;
46
+ logClientStatsWith(sessionKey: string, items: ClientStats[]): Promise<void>;
23
47
  uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
24
48
  joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
25
49
  createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, audienceMode, audioOnly, waitForAdmin, closedConversation, }?: {
@@ -56,7 +80,7 @@ export default class Api extends BaseApi {
56
80
  getConversationParams(conversationId?: string): Promise<ConversationParams>;
57
81
  getUserId(): OkUserId | null;
58
82
  setUserId(userId: OkUserId): void;
59
- hangupConversation(conversationId: string, reason?: HangupType): void;
83
+ hangupConversation(conversationId: string, reason?: HangupType, params?: Partial<IHangupParams>): void;
60
84
  removeHistoryRecords(recordIds: number[]): Promise<void>;
61
85
  cleanup(): void;
62
86
  getServerTime(): Promise<number>;
@@ -1,3 +1,4 @@
1
+ import { IHangupParams } from '../types/Api';
1
2
  import { IAPIBaseUrl, IApiEnv } from '../types/Params';
2
3
  export declare class ApiExternal {
3
4
  private readonly _uuid;
@@ -8,5 +9,5 @@ export declare class ApiExternal {
8
9
  private _sessionKey;
9
10
  constructor(apiEvn: IApiEnv, apiKey: string, callToken: string, baseApiUrl?: IAPIBaseUrl);
10
11
  authorize(): Promise<boolean>;
11
- hangupConversation(conversationId: string): Promise<void>;
12
+ hangupConversation(conversationId: string, params?: Partial<IHangupParams>): Promise<void>;
12
13
  }
@@ -4,7 +4,7 @@ import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
4
4
  import { StatAggregator } from '../classes/stat/StatAggregator';
5
5
  import { StatPings } from '../classes/stat/StatPings';
6
6
  import { StatSignalingCommands } from '../classes/stat/StatSignalingCommands';
7
- import StatsLogger from '../classes/StatsLogger';
7
+ import StatEventCollector from '../classes/stat/StatEventCollector';
8
8
  import ConversationFeature from '../enums/ConversationFeature';
9
9
  import ConversationOption from '../enums/ConversationOption';
10
10
  import MediaOption from '../enums/MediaOption';
@@ -35,13 +35,13 @@ export default class Signaling extends BaseSignaling {
35
35
  private datachannelCommandsQueue;
36
36
  private incomingCache;
37
37
  private responseHandlers;
38
+ private disposed;
38
39
  private connectionType;
39
40
  private conversationResolve;
40
41
  private conversationReject;
41
42
  private connected;
42
43
  private listenersReady;
43
44
  private peerId;
44
- private conversationId;
45
45
  private connectionMessageWaitTimer;
46
46
  private participantIdRegistry;
47
47
  private producerNotificationDataChannel;
@@ -56,26 +56,22 @@ export default class Signaling extends BaseSignaling {
56
56
  private static get WAIT_CONNECTION_DELAY();
57
57
  private static get WAIT_RESPONSE_DELAY();
58
58
  get ready(): boolean;
59
- constructor(debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
59
+ constructor(debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
60
60
  setAbortSignal(signal: AbortSignal | undefined): void;
61
61
  setEndpoint(endpoint: string): void;
62
62
  setWebTransportEndpoint(endpoint: string | null): void;
63
- setConversationId(conversationId: string): void;
64
63
  setParticipantIdRegistry(participantIdRegistry: ParticipantIdRegistry): void;
65
64
  setProducerNotificationDataChannel(dataChannel: RTCDataChannel): void;
66
65
  setProducerCommandDataChannel(dataChannel: RTCDataChannel): void;
67
66
  useCommandDataChannel(status: boolean): void;
68
- /**
69
- * Free used resources
70
- */
71
- cleanup(): void;
67
+ resetProducerConnection(cause?: Error): void;
72
68
  /**
73
69
  * Open a connection with a signaling server
74
70
  */
75
71
  connect(connectionType: SignalingConnectionType): Promise<SignalingMessage.Connection>;
76
72
  getNextCommandSequenceNumber(): number;
77
- hangup(reason: string): Promise<SignalingMessage | void>;
78
- sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidate): Promise<SignalingMessage>;
73
+ hangup(reason: string): Promise<SignalingMessage>;
74
+ sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidateInit): Promise<SignalingMessage>;
79
75
  requestTestMode(consumerCommand: string, producerCommand: string | null): Promise<SignalingMessage>;
80
76
  sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit, extraPayload?: Record<string, any>): Promise<SignalingMessage>;
81
77
  acceptCall(mediaSettings: MediaSettings): Promise<SignalingMessage>;
@@ -138,10 +134,7 @@ export default class Signaling extends BaseSignaling {
138
134
  acceptPromotion(reject?: boolean): Promise<SignalingMessage>;
139
135
  feedback(key: string): Promise<SignalingMessage>;
140
136
  getHandQueue(): Promise<SignalingMessage>;
141
- /**
142
- * Close a connection with a signaling server
143
- */
144
- close(): void;
137
+ dispose(cause?: Error): void;
145
138
  /**
146
139
  * Этот метод нужен т.к. после получения сообщения "connected" устанавливается транспорт
147
140
  * и подписывается на сигналинг. Данные приходят очень быстро и транспорт пропускает
@@ -173,20 +166,25 @@ export default class Signaling extends BaseSignaling {
173
166
  private _onError;
174
167
  private _serializeErrorEvent;
175
168
  private _onClose;
176
- private _closeSocket;
169
+ private _terminate;
170
+ private _fail;
177
171
  private _isRecordCommand;
178
172
  private _resolvePendingRecordCommands;
179
173
  private _handleCommandResponse;
180
174
  private _handleCommandsQueue;
181
175
  private _startResponseTimer;
176
+ private _resolveCommandWithoutResponse;
182
177
  private _serializeBinary;
183
178
  private _serializeJson;
184
179
  private _convertDisplayLayout;
185
180
  private _waitConnectionMessage;
186
181
  private _stopWaitConnectionMessage;
182
+ private _onTransportConnecting;
187
183
  private _onTransportFailed;
188
184
  private _onTransportReconnectScheduled;
189
185
  private _onTransportConnectionDead;
186
+ private _attachNotificationCallError;
187
+ private _createSignalingCallError;
190
188
  private _getSocketType;
191
189
  private _markTransportStat;
192
190
  private _logTransportStat;
@@ -9,13 +9,19 @@ export declare enum SignalingTransportFailure {
9
9
  export type SignalingTransportFailedEvent = {
10
10
  failure: SignalingTransportFailure;
11
11
  message: string;
12
+ source: SignalingTransportType;
12
13
  remote?: boolean;
13
14
  };
14
15
  export type SignalingTransportReconnectEvent = {
15
16
  count: number;
16
17
  delay: number;
17
18
  };
19
+ export type SignalingTransportConnectingEvent = {
20
+ connectionType: SignalingConnectionType;
21
+ source: SignalingTransportType;
22
+ };
18
23
  export type SignalingTransportHandlers = {
24
+ onConnecting: (event: SignalingTransportConnectingEvent) => void;
19
25
  onOpen: () => void;
20
26
  onMessage: (event: MessageEvent) => void;
21
27
  onError: (event: Event) => void;
@@ -51,7 +57,7 @@ export default class SignalingTransport {
51
57
  resetReconnectCount(): void;
52
58
  connect(connectionType: SignalingConnectionType): void;
53
59
  close(code?: number): void;
54
- send(data: string | ArrayBuffer): void;
60
+ send(data: string | ArrayBuffer): Promise<void>;
55
61
  private _connect;
56
62
  private _connectWebTransport;
57
63
  private _connectWebSocket;
@@ -0,0 +1,7 @@
1
+ import HangupType from './HangupType';
2
+ /**
3
+ * Причины завершения звонка, которые клиент может передать в {@link hangup}/{@link declineCall}
4
+ * и пробросить в сигналинг без маппинга.
5
+ */
6
+ export type ClientHangupReason = HangupType.HUNGUP | HangupType.CANCELED | HangupType.REJECTED | HangupType.BUSY | HangupType.MISSED | HangupType.CALL_TIMEOUT;
7
+ export default ClientHangupReason;
@@ -20,7 +20,6 @@ declare enum HangupType {
20
20
  CALLER_IS_REJECTED = "CALLER_IS_REJECTED",
21
21
  UNKNOWN_ERROR = "UNKNOWN_ERROR",
22
22
  UNSUPPORTED = "UNSUPPORTED",
23
- OLD_VERSION = "OLD_VERSION",
24
23
  SERVICE_DISABLED = "SERVICE_DISABLED",
25
24
  SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
26
25
  EXTERNAL_API_ERROR = "EXTERNAL_API_ERROR",
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Коды ошибок сессии API
3
+ */
4
+ declare enum SessionError {
5
+ PARAM_SESSION_EXPIRED = 102,
6
+ PARAM_SESSION_KEY = 103,
7
+ PARAM_SIGNATURE = 104,
8
+ AUTH_LOGIN = 401
9
+ }
10
+ /**
11
+ * Ошибки, после которых имеет смысл переавторизоваться: сессия протухла или
12
+ * подпись не сошлась. 401 сюда не входит — там протух токен хоста.
13
+ */
14
+ export declare function isSessionErrorCode(code: unknown): boolean;
15
+ export default SessionError;
package/enums/Stat.d.ts CHANGED
@@ -1,4 +1,9 @@
1
1
  declare const enum Stat {
2
+ CALL_INIT = "call_init",
3
+ CALL_START = "call_start",
4
+ CALL_ACCEPTED_OUTGOING = "call_accepted_outgoing",
5
+ CALL_ACCEPTED_INCOMING = "call_accepted_incoming",
6
+ FIRST_MEDIA_SENT = "first_media_sent",
2
7
  CALL_FINISH = "call_finish",// событие отправляемое в конце звонка
3
8
  CODEC_USAGE = "codec_usage",// событие когда меняется кодек
4
9
  SIGNALING_CONNECTED = "signaling_connected",// measure
@@ -7,7 +12,6 @@ declare const enum Stat {
7
12
  FIRST_MEDIA_RECEIVED = "first_media_received",
8
13
  CALL_DECLINED_OR_HANGED_LOCALLY = "CallDeclinedOrHangedLocally",
9
14
  USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
10
- CALL_START = "call_start",
11
15
  SIGNALING_PING_SUMMARY = "signaling_ping_summary",
12
16
  SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
13
17
  WEBSOCKET_CONNECTED = "websocket_connected",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vkontakte/calls-sdk",
3
- "version": "2.8.12-dev.c0dd153e.0",
3
+ "version": "2.8.12-dev.c58bce06.0",
4
4
  "author": "vk.com",
5
5
  "description": "Library for video calls based on the vk.com platform",
6
6
  "homepage": "https://vk.com",
@@ -14,7 +14,7 @@
14
14
  "**/*.d.ts"
15
15
  ],
16
16
  "dependencies": {
17
- "@vkontakte/calls-audio-effects": "1.2.8",
17
+ "@vkontakte/calls-audio-effects": "1.4.1",
18
18
  "@vkontakte/calls-video-effects": "2.2.3-beta.7",
19
19
  "@vkontakte/calls-vmoji": "1.0.10-beta.17",
20
20
  "@vkontakte/libvpx": "2.0.9",
@@ -22,6 +22,6 @@
22
22
  "fflate": "^0.8.2",
23
23
  "messagepack": "1.1.12",
24
24
  "simple-ebml-builder": "0.2.2",
25
- "webrtc-adapter": "7.7.0"
25
+ "webrtc-adapter": "9.0.5"
26
26
  }
27
27
  }
@@ -1,5 +1,9 @@
1
1
  import { IAPIBaseUrl, IApiEnv } from '../types/Params';
2
2
  export declare function resetApiEndpoint(): void;
3
+ /**
4
+ * Убираем слэш на конце
5
+ */
6
+ export declare function sanitizeApiBaseUrl(url: IAPIBaseUrl): IAPIBaseUrl;
3
7
  export declare function _resolveApiEndpoint(apiBaseUrl?: IAPIBaseUrl, apiEnv?: IApiEnv): Promise<string>;
4
8
  export declare function sendBeakon(method: string, params?: {
5
9
  [key: string]: any;
@@ -7,4 +11,7 @@ export declare function sendBeakon(method: string, params?: {
7
11
  export declare function request(method: string, params?: {
8
12
  [key: string]: any;
9
13
  }, noSession?: boolean, customEndpoint?: string): Promise<any>;
14
+ export declare function requestKeepalive(method: string, params?: {
15
+ [key: string]: any;
16
+ }, noSession?: boolean): Promise<any>;
10
17
  export declare function sendFormData(url: string, data: FormData): Promise<void>;
@@ -1,12 +1,22 @@
1
+ import type { OkUserId } from '../types/Participant';
1
2
  export default abstract class AuthData {
2
3
  private static _sessionKey;
3
4
  private static _sessionSecretKey;
4
5
  private static _accessToken;
6
+ private static _userId;
7
+ private static _reauthorizePromise;
5
8
  static get sessionKey(): string | undefined;
6
9
  static set sessionKey(value: string | undefined);
7
10
  static get sessionSecretKey(): string | undefined;
8
11
  static set sessionSecretKey(value: string | undefined);
9
12
  static get accessToken(): string | undefined;
10
13
  static set accessToken(value: string | undefined);
14
+ static get userId(): OkUserId | null;
15
+ static set userId(value: OkUserId | null);
11
16
  static isEmpty(): boolean;
17
+ /**
18
+ * Дедуплицирует одновременные попытки реавторизации из разных инстансов Api.
19
+ * Первый вызов выполняет authorizeFn, остальные ждут того же промиса.
20
+ */
21
+ static reauthorize(authorizeFn: () => Promise<void>): Promise<void>;
12
22
  }
package/static/Debug.d.ts CHANGED
@@ -21,6 +21,7 @@ export type DebugSessionLogger = DebugLogger & {
21
21
  readonly sessionId: string | null;
22
22
  readonly conversationId: string | null;
23
23
  setConversationId(conversationId: string | null): void;
24
+ send(type: DebugMessageType, ...args: any[]): void;
24
25
  };
25
26
  declare namespace Debug {
26
27
  type ContextProvider = () => DebugMessageContext;
@@ -637,6 +637,6 @@ declare namespace External {
637
637
  /**
638
638
  * Собеседник подключился к сигналлингу
639
639
  */
640
- function onPeerRegistered(conversationId?: string): void;
640
+ function onPeerRegistered(conversationId?: string, externalIds?: ExternalId[]): void;
641
641
  }
642
642
  export default External;
@@ -1,5 +1,5 @@
1
1
  import type { VideoEffects } from '@vkontakte/calls-video-effects';
2
- import type { EffectVoiceChange } from '@vkontakte/calls-audio-effects';
2
+ import type { EffectVoiceChange, VadControllerOptions, VadLib } from '@vkontakte/calls-audio-effects';
3
3
  import type * as Vmoji from '@vkontakte/calls-vmoji';
4
4
  import { IAsrData } from '../types/Asr';
5
5
  import { ConversationData } from '../types/Conversation';
@@ -37,6 +37,18 @@ export type ParamsObject = {
37
37
  platform: string;
38
38
  /** @hidden */
39
39
  clientStatsPlatform: string;
40
+ /**
41
+ * Автоматически запускать отправку клиентской статистики при `init()`.
42
+ *
43
+ * Если `false`, события звонков продолжают копиться в IndexedDB, но в сеть
44
+ * не уходят, пока хост не вызовет `startStats()`. Так хост может прогреть
45
+ * приложение, не нагружая сеть. До старта неактивен и fallback прямой
46
+ * отправки при недоступном хранилище. Если `startStats()` не вызвать
47
+ * никогда, очередь дорастёт до лимита и начнёт вытеснять старые звонки.
48
+ *
49
+ * _По умолчанию: `true`_
50
+ */
51
+ autoStartStats: boolean;
40
52
  /** @hidden */
41
53
  clientType: string;
42
54
  /** @hidden */
@@ -193,6 +205,14 @@ export type ParamsObject = {
193
205
  * Можно установить позднее методом `setAudioEffects`
194
206
  */
195
207
  audioEffects: EffectVoiceChange | null;
208
+ /**
209
+ * Namespace библиотеки VAD из `@vkontakte/calls-audio-effects`.
210
+ *
211
+ * Можно установить методом `setVad`
212
+ */
213
+ vad: VadLib | null;
214
+ /** Настройки VAD (threshold, hangoverMs, enabled) */
215
+ vadOptions: VadControllerOptions;
196
216
  /**
197
217
  * Максимальная ширина видео в пикселях для видео эффекта
198
218
  *
@@ -505,6 +525,16 @@ export type ParamsObject = {
505
525
  * _По умолчанию: `false`_
506
526
  */
507
527
  enableSessionStateUpdates: boolean;
528
+ /**
529
+ * Использовать `<audio>` вместо `<video>` для воспроизведения звука в desktop Safari
530
+ * @hidden
531
+ */
532
+ safariAudioElement: boolean;
533
+ /**
534
+ * Отправлять пустой ICE candidate (end-of-candidates) удалённому пиру
535
+ * @hidden
536
+ */
537
+ forwardEmptyIceCandidate: boolean;
508
538
  /**
509
539
  * Получен локальный стрим с камеры/микрофона
510
540
  */
@@ -892,7 +922,7 @@ export type ParamsObject = {
892
922
  /**
893
923
  * Собеседник подключился к сигналлингу
894
924
  */
895
- onPeerRegistered?: (conversationId?: string) => void;
925
+ onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
896
926
  };
897
927
  export default abstract class Params {
898
928
  private static _params;
@@ -910,6 +940,7 @@ export default abstract class Params {
910
940
  static set platform(value: string);
911
941
  static get clientStatsPlatform(): string;
912
942
  static set clientStatsPlatform(value: string);
943
+ static get autoStartStats(): boolean;
913
944
  static get clientType(): string;
914
945
  static set clientType(value: string);
915
946
  static get externalUserType(): string;
@@ -960,6 +991,10 @@ export default abstract class Params {
960
991
  static get displaySurface(): DisplayCaptureSurfaceType;
961
992
  static get audioEffects(): EffectVoiceChange | null;
962
993
  static set audioEffects(value: EffectVoiceChange | null);
994
+ static get vad(): VadLib | null;
995
+ static set vad(value: VadLib | null);
996
+ static get vadOptions(): VadControllerOptions;
997
+ static set vadOptions(value: VadControllerOptions);
963
998
  static get videoEffects(): VideoEffects | null;
964
999
  static set videoEffects(value: VideoEffects | null);
965
1000
  static get videoEffectMaxWidth(): number;
@@ -1027,6 +1062,8 @@ export default abstract class Params {
1027
1062
  static get waitForRecordResponse(): boolean;
1028
1063
  static get transparentAudio(): boolean;
1029
1064
  static get enableSessionStateUpdates(): boolean;
1065
+ static get safariAudioElement(): boolean;
1066
+ static get forwardEmptyIceCandidate(): boolean;
1030
1067
  static toJSON(): {
1031
1068
  apiKey: string;
1032
1069
  apiEnv: string;
@@ -1056,6 +1093,7 @@ export default abstract class Params {
1056
1093
  movieShare: boolean;
1057
1094
  clientType: string;
1058
1095
  clientStatsPlatform: string;
1096
+ autoStartStats: boolean;
1059
1097
  consumerScreenDataChannelPacketSize: number;
1060
1098
  switchVideoAtBadNetwork: boolean;
1061
1099
  simulcast: boolean;
@@ -1063,5 +1101,7 @@ export default abstract class Params {
1063
1101
  waitForRecordResponse: boolean;
1064
1102
  transparentAudio: boolean;
1065
1103
  enableSessionStateUpdates: boolean;
1104
+ safariAudioElement: boolean;
1105
+ forwardEmptyIceCandidate: boolean;
1066
1106
  };
1067
1107
  }
@@ -11,6 +11,7 @@ declare namespace ParticipantConnectionStatusUtils {
11
11
  function computeEffective(status: ParticipantConnectionStatus): ParticipantStatus;
12
12
  function setSessionState(status: ParticipantConnectionStatus, sessionState?: ParticipantSessionState, sessionStateConnectedBySpeaker?: boolean): StatusTransition;
13
13
  function setTransport(status: ParticipantConnectionStatus, transport: ParticipantStatus): StatusTransition;
14
+ function setStalled(status: ParticipantConnectionStatus, stalled: boolean): StatusTransition;
14
15
  function setSessionStateApplicable(status: ParticipantConnectionStatus, applicable: boolean): StatusTransition;
15
16
  }
16
17
  export default ParticipantConnectionStatusUtils;
@@ -0,0 +1,3 @@
1
+ export declare const SDP_LINE_ENDING = "\r\n";
2
+ export declare function splitSdpLines(sdp: string): string[];
3
+ export declare function joinSdpLines(lines: string[]): string;
@@ -0,0 +1,38 @@
1
+ export type StoredSession = {
2
+ sessionKey: string;
3
+ /** Ключ окружения на момент сохранения, см. currentEndpoint(). */
4
+ endpoint: string;
5
+ savedAt: number;
6
+ };
7
+ /**
8
+ * Снимки сессий по uid на диске. В памяти сессия текущего пользователя —
9
+ * AuthData; здесь — то, что SDK видел раньше.
10
+ *
11
+ * Это снимок: он может быть протухшим, переавторизовать его извне нельзя.
12
+ * Годится только для отложенных best-effort задач (например, досылка
13
+ * статистики). Живые запросы звонка им подписывать нельзя.
14
+ *
15
+ * Хранится только session_key: секрет сессии транспорту не нужен, а токен
16
+ * хоста незачем — протухший снимок не переавторизуется, а выбрасывается.
17
+ */
18
+ export default abstract class SessionStore {
19
+ static remember(uid: number, session: {
20
+ sessionKey: string;
21
+ endpoint: string;
22
+ }): void;
23
+ static get(uid: number): StoredSession | null;
24
+ static forget(uid: number): void;
25
+ /** Удаляет записи старше MAX_AGE_MS. */
26
+ static prune(now?: number): void;
27
+ /**
28
+ * Ключ окружения: сессия прода не должна улететь на тестовый кластер.
29
+ * Синхронный, в отличие от резолва endpoint в транспорте.
30
+ *
31
+ * Адрес нормализуется так же, как в транспорте: иначе снимок, сделанный
32
+ * при apiBaseUrl со слэшем на конце, не совпал бы сам с собой.
33
+ */
34
+ static currentEndpoint(): string;
35
+ private static _read;
36
+ private static _write;
37
+ private static _isValid;
38
+ }
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @see https://confluence.vk.team/display/VIDEOOK/Websocket+Capability+Flags
2
+ * @see https://confluence.vk.team/display/CALLS/Websocket+Capability+Flags
3
3
  */
4
4
  declare const PREDICATES: {
5
5
  readonly producerScreenTrack: () => boolean;
@@ -6,8 +6,10 @@ export declare const SIMULCAST_DEFAULT: {
6
6
  BITRATE: number;
7
7
  };
8
8
  export declare const SIMULCAST_SCALABILITY_MODE = "L1T2";
9
- export declare const MAP_RID_TO_SCALE_RESOLUTION_DOWN_BY: Record<string, number>;
10
9
  export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;
11
10
  export declare function findBitrateAsc(maxDimension: number, bitrates: VideoBitrateSettings[]): number;
12
- export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[]): ISimulcastInfo;
13
- export declare function findScaleResolutionDownBy(rid?: string): number;
11
+ export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[], fps?: number): {
12
+ streams: import("../types/SimulcastInfo").SimulcastStreamInfo[];
13
+ };
14
+ export declare function findScaleResolutionDownBy(rid: string | undefined, simulcastInfo: ISimulcastInfo): number;
15
+ export declare function applySimulcastInfoToEncodings(encodings: RTCRtpEncodingParameters[], simulcastInfo: ISimulcastInfo, maxDimension?: number, maxBitrate?: number): void;