@vkontakte/calls-sdk 2.8.13-dev.4ce2e1bb.0 → 2.8.13-dev.56ef08c8.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 (46) hide show
  1. package/CallsSDK.d.ts +5 -0
  2. package/abstract/BaseApi.d.ts +12 -8
  3. package/calls-sdk.cjs.js +7 -7
  4. package/calls-sdk.esm.js +3137 -2289
  5. package/classes/AudioFix.d.ts +2 -2
  6. package/classes/AudioOutput.d.ts +3 -3
  7. package/classes/MediaSource.d.ts +6 -2
  8. package/classes/SpecListener.d.ts +2 -2
  9. package/classes/VolumesDetector.d.ts +0 -1
  10. package/classes/codec/LibVPxDecoder.d.ts +2 -2
  11. package/classes/codec/LibVPxEncoder.d.ts +2 -2
  12. package/classes/codec/WebCodecsDecoder.d.ts +2 -2
  13. package/classes/codec/WebCodecsEncoder.d.ts +2 -2
  14. package/classes/codec/WorkerBase.d.ts +3 -3
  15. package/classes/conversation/Conversation.d.ts +1 -0
  16. package/classes/screenshare/ScreenCaptureReceiver.d.ts +2 -2
  17. package/classes/screenshare/ScreenCaptureSender.d.ts +2 -2
  18. package/classes/screenshare/StreamBuilder.d.ts +2 -2
  19. package/classes/stat/ApiCallStats.d.ts +12 -0
  20. package/classes/stat/CallLifecycleStats.d.ts +2 -2
  21. package/classes/stat/CodecStatsAggregator.d.ts +2 -2
  22. package/classes/stat/ConversationStats.d.ts +14 -2
  23. package/classes/stat/SdpStats.d.ts +38 -0
  24. package/classes/stat/StatAggregator.d.ts +10 -3
  25. package/classes/stat/StatClock.d.ts +28 -0
  26. package/classes/stat/StatDrainScheduler.d.ts +92 -0
  27. package/classes/stat/StatEventCollector.d.ts +50 -0
  28. package/classes/stat/StatPings.d.ts +2 -2
  29. package/classes/stat/StatQueue.d.ts +79 -0
  30. package/classes/stat/StatSignalingCommands.d.ts +2 -2
  31. package/classes/stat/StatUnloadJournal.d.ts +27 -0
  32. package/classes/transport/DirectTransport.d.ts +7 -2
  33. package/classes/transport/ServerTransport.d.ts +3 -2
  34. package/classes/transport/SimulcastSender.d.ts +2 -2
  35. package/classes/transport/Transport.d.ts +2 -2
  36. package/default/Api.d.ts +10 -1
  37. package/default/Signaling.d.ts +11 -3
  38. package/enums/SessionError.d.ts +10 -0
  39. package/enums/Stat.d.ts +13 -0
  40. package/package.json +1 -1
  41. package/static/ApiTransport.d.ts +4 -0
  42. package/static/Params.d.ts +28 -0
  43. package/static/SessionStore.d.ts +29 -0
  44. package/static/SimulcastInfo.d.ts +1 -0
  45. package/static/WebRTCUtils.d.ts +5 -5
  46. package/types/IEventualStatLog.d.ts +1 -1
@@ -0,0 +1,79 @@
1
+ /** Потолок хранения событий: и очереди на диске, и буфера в памяти вкладки. */
2
+ export declare const RECORD_LIMIT = 5000;
3
+ /** Срок жизни события в очереди. */
4
+ export declare const MAX_AGE_MS: number;
5
+ /** Произвольный набор скалярных полей события. */
6
+ export type StatPayload = Record<string, string | number | boolean | null>;
7
+ /** Запись очереди без сгенерированного ключа. */
8
+ export type StatQueueEntry = {
9
+ /** userId владельца события. Не может быть неизвестным. */
10
+ uid: number;
11
+ /** conversationId. null — событие залогировано до старта звонка. */
12
+ vcid: string | null;
13
+ /** Время записи в device-time, без коррекции по серверу. */
14
+ ts: number;
15
+ /** Поправка к серверному времени на момент записи. null — ещё не знали. */
16
+ delta?: number | null;
17
+ ev: StatPayload;
18
+ };
19
+ /** Запись очереди, прочитанная из хранилища. */
20
+ export type StatQueueRecord = StatQueueEntry & {
21
+ /** Автоинкремент. Единственный источник истины для порядка событий. */
22
+ id: number;
23
+ };
24
+ /**
25
+ * Персистентная очередь событий статистики поверх IndexedDB.
26
+ *
27
+ * База одна на origin, поэтому класс статический. Ошибки хранилища только
28
+ * логируются: статистика не влияет на звонок.
29
+ */
30
+ export default abstract class StatQueue {
31
+ private static _db;
32
+ private static _dbPromise;
33
+ /** Имя базы. Подменяется только тестами, см. __resetForTests(). */
34
+ private static _dbName;
35
+ private static _supported;
36
+ private static _appendsSinceEvictCheck;
37
+ /** Момент последней неудачи открытия; до конца кулдауна не пробуем снова. */
38
+ private static _lastOpenFailureAt;
39
+ static isSupported(): boolean;
40
+ /** @returns ключ записи или null, если хранилище не приняло её. */
41
+ static append(entry: StatQueueEntry): Promise<number | null>;
42
+ /**
43
+ * Проставляет delta перечисленным записям, у которых её ещё нет.
44
+ *
45
+ * Ключи перечисляются явно: между своими в очередь могли лечь чужие записи,
46
+ * писанные другими часами.
47
+ */
48
+ static fillDelta(ids: number[], delta: number): Promise<void>;
49
+ static count(): Promise<number>;
50
+ /**
51
+ * Читает самые старые события пользователя. Индекс by_uid отдаёт их в
52
+ * порядке автоинкрементного id, то есть в порядке записи.
53
+ */
54
+ static readOldest(uid: number, limit: number): Promise<StatQueueRecord[]>;
55
+ static remove(ids: number[]): Promise<void>;
56
+ /** Уникальные uid, у которых есть записи. Курсор по индексу by_uid с nextunique. */
57
+ static listUids(): Promise<number[]>;
58
+ /**
59
+ * Приводит размер хранилища к лимиту, вынося самые старые звонки целиком:
60
+ * частично удалённый звонок — это неполная цепочка событий. Записи без
61
+ * vcid одной группой не считаются, иначе эвикшн вынес бы pre-call события
62
+ * сразу всех звонков.
63
+ */
64
+ static evictToLimit(limit: number): Promise<void>;
65
+ /** Удаляет события старше указанного возраста. */
66
+ static evictOlderThan(maxAgeMs: number, now?: number): Promise<void>;
67
+ private static _checkSupport;
68
+ private static _open;
69
+ private static _close;
70
+ private static _createSchema;
71
+ /** Обёртка над транзакцией: резолвится после успешного коммита. */
72
+ private static _runTransaction;
73
+ /** Читает запись с минимальным id, то есть самую старую в хранилище. */
74
+ private static _readOldestRecord;
75
+ /**
76
+ * Удаляет все события звонка одной транзакцией.
77
+ */
78
+ private static _deleteConversation;
79
+ }
@@ -1,9 +1,9 @@
1
1
  import { SignalingTransportType } from '../../enums/SignalingTransportStat';
2
- import StatsLogger from '../StatsLogger';
2
+ import StatEventCollector from './StatEventCollector';
3
3
  export declare class StatSignalingCommands {
4
4
  private readonly _logger;
5
5
  private trackerByCommand;
6
- constructor(logger: StatsLogger);
6
+ constructor(logger: StatEventCollector);
7
7
  mark(command: string, time: number, transport: SignalingTransportType): void;
8
8
  /** Отправляем данные в стату */
9
9
  logMetrics(): void;
@@ -0,0 +1,27 @@
1
+ import { StatQueueEntry } from './StatQueue';
2
+ /**
3
+ * Синхронный журнал умирающей вкладки поверх localStorage: транзакция
4
+ * IndexedDB из pagehide не успевает закоммититься. Следующий старт SDK
5
+ * переносит журнал в очередь. Ключ уникален на вкладку.
6
+ */
7
+ export default abstract class StatUnloadJournal {
8
+ private static _tabKey;
9
+ private static _entries;
10
+ /**
11
+ * Открывает новый журнал для этой вкладки. Без сброса пережившая pagehide
12
+ * вкладка записала бы во второй журнал уже перенесённые события.
13
+ */
14
+ static beginTabSession(): void;
15
+ static writeSync(entry: StatQueueEntry): boolean;
16
+ /**
17
+ * Переносит журналы всех закрытых вкладок в очередь. Журнал стирается
18
+ * независимо от исхода: повторные попытки дали бы дубли.
19
+ *
20
+ * @returns число перенесённых событий.
21
+ */
22
+ static drainToQueue(): Promise<number>;
23
+ /** Читает журнал и сразу удаляет его. null — ключа уже нет или хранилище недоступно. */
24
+ private static _take;
25
+ private static _storage;
26
+ private static _isValidEntry;
27
+ }
@@ -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';
@@ -39,11 +39,12 @@ export default class DirectTransport extends BaseTransport {
39
39
  private _lastBadConnection;
40
40
  private _perfStatReporter;
41
41
  private _directStatReporter;
42
+ private readonly _sdpStats;
42
43
  private readonly _debug;
43
44
  private readonly _logger;
44
45
  private readonly _statAggregator;
45
46
  private readonly _codecStatsAggregator;
46
- constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
47
+ constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
47
48
  get participantId(): ParticipantId;
48
49
  updateStatisticsInterval(): void;
49
50
  private _isDeadConnection;
@@ -72,6 +73,10 @@ export default class DirectTransport extends BaseTransport {
72
73
  private _markConnected;
73
74
  private _onConnectionStateChange;
74
75
  private _startReconnection;
76
+ /**
77
+ * Запрашивает у сигналинга переход на серверную топологию.
78
+ * Обычно это делает только мастер, `fromAnySide` снимает это ограничение.
79
+ */
75
80
  private _requestTopologySwitch;
76
81
  private _stopReconnection;
77
82
  private _startIceRestart;
@@ -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';
@@ -45,9 +45,10 @@ export default class ServerTransport extends BaseTransport {
45
45
  private readonly _debug;
46
46
  private readonly _logger;
47
47
  private readonly _statAggregator;
48
+ private readonly _sdpStats;
48
49
  private readonly _codecStatsAggregator;
49
50
  private readonly _simulcast;
50
- constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
51
+ constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
51
52
  updateStatisticsInterval(): void;
52
53
  open(observer?: boolean): void;
53
54
  close(error?: Error): void;
@@ -2,7 +2,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
2
2
  import { type DebugLogger } from '../../static/Debug';
3
3
  import type VideoSettings from '../../types/VideoSettings';
4
4
  import { MediaSource } from '../MediaSource';
5
- import StatsLogger from '../StatsLogger';
5
+ import StatEventCollector from '../stat/StatEventCollector';
6
6
  export default class SimulcastSender {
7
7
  private _pc;
8
8
  private _transceiver;
@@ -12,7 +12,7 @@ export default class SimulcastSender {
12
12
  private readonly _getCameraSettings;
13
13
  private readonly _debug;
14
14
  private readonly _logger;
15
- constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatsLogger | null);
15
+ constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatEventCollector | null);
16
16
  configureFromRemoteOffer(pc: RTCPeerConnection): Promise<void>;
17
17
  finalizeAnswer(sdp: string): string;
18
18
  sync({ force }?: {
@@ -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';
@@ -51,7 +51,7 @@ export declare class Transport extends EventEmitter {
51
51
  private readonly _onFirstMediaSent;
52
52
  private _firstMediaSentProbeStopped;
53
53
  private _vadController;
54
- constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
54
+ constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
55
55
  updateSettings(settings: ServerSettings): void;
56
56
  updateStatisticsInterval(): void;
57
57
  allocate(participantId: ParticipantId, isMaster?: boolean): void;
package/default/Api.d.ts CHANGED
@@ -14,14 +14,23 @@ export default class Api extends BaseApi {
14
14
  protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
15
15
  userId(participantId: ParticipantId): ExternalParticipantId | null;
16
16
  authorize(): Promise<void>;
17
+ /** Запрос auth.anonymLogin без побочных эффектов. Пустой токен — версия 2. */
18
+ private _anonymLogin;
17
19
  private _getAnonymLoginCacheKey;
18
20
  private _getCachedAnonymLogin;
19
21
  private _setCachedAnonymLogin;
20
22
  private _removeCachedAnonymLogin;
21
23
  private _reauthorize;
22
24
  private _applyAnonymLogin;
25
+ private _buildClientStatsData;
26
+ /** Ошибки по отдельным событиям логируются, но батч трактуется целиком. */
27
+ private _reportClientStatsItemErrors;
28
+ /** noSession = true, иначе _prepareQuery перебил бы явный session_key. */
29
+ private _sendClientStatsWith;
30
+ /** Бекенд отвечает 200 всегда: ошибки статистики лежат в теле. */
23
31
  private _sendClientStats;
24
- logClientStats(items: ClientStats[]): void;
32
+ logClientStats(items: ClientStats[]): Promise<void>;
33
+ logClientStatsWith(sessionKey: string, items: ClientStats[]): Promise<void>;
25
34
  uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
26
35
  joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
27
36
  createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, audienceMode, audioOnly, waitForAdmin, closedConversation, }?: {
@@ -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';
@@ -42,6 +42,8 @@ export default class Signaling extends BaseSignaling {
42
42
  private connected;
43
43
  private listenersReady;
44
44
  private peerId;
45
+ /** Когда началась череда падений соединения, от неё считаем *_timeout */
46
+ private reconnectStartedAt;
45
47
  private connectionMessageWaitTimer;
46
48
  private participantIdRegistry;
47
49
  private producerNotificationDataChannel;
@@ -56,7 +58,7 @@ export default class Signaling extends BaseSignaling {
56
58
  private static get WAIT_CONNECTION_DELAY();
57
59
  private static get WAIT_RESPONSE_DELAY();
58
60
  get ready(): boolean;
59
- constructor(debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
61
+ constructor(debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
60
62
  setAbortSignal(signal: AbortSignal | undefined): void;
61
63
  setEndpoint(endpoint: string): void;
62
64
  setWebTransportEndpoint(endpoint: string | null): void;
@@ -164,7 +166,8 @@ export default class Signaling extends BaseSignaling {
164
166
  private _handleCachedMessages;
165
167
  private _throwError;
166
168
  private _onError;
167
- private _serializeErrorEvent;
169
+ /** Причина ошибки для статы: короткий читаемый текст */
170
+ private _describeErrorEvent;
168
171
  private _onClose;
169
172
  private _terminate;
170
173
  private _fail;
@@ -182,10 +185,15 @@ export default class Signaling extends BaseSignaling {
182
185
  private _onTransportConnecting;
183
186
  private _onTransportFailed;
184
187
  private _onTransportReconnectScheduled;
188
+ /** Попыток восстановить соединение больше не будет: отправляем, сколько длилась череда падений */
189
+ private _logReconnectTimeout;
185
190
  private _onTransportConnectionDead;
186
191
  private _attachNotificationCallError;
187
192
  private _createSignalingCallError;
188
193
  private _getSocketType;
189
194
  private _markTransportStat;
195
+ /** Событие уходит с переданными полями, без value — уходит без value */
190
196
  private _logTransportStat;
197
+ /** value — время от метки, поставленной в _markTransportStat; метки нет — событие не отправляем */
198
+ private _logTransportStatSinceMark;
191
199
  }
@@ -0,0 +1,10 @@
1
+ /** Коды ошибок сессии API. */
2
+ declare enum SessionError {
3
+ PARAM_SESSION_EXPIRED = 102,
4
+ PARAM_SESSION_KEY = 103,
5
+ PARAM_SIGNATURE = 104,
6
+ AUTH_LOGIN = 401
7
+ }
8
+ /** Ошибки, после которых имеет смысл переавторизоваться. 401 — токен хоста. */
9
+ export declare function isSessionErrorCode(code: unknown): boolean;
10
+ export default SessionError;
package/enums/Stat.d.ts CHANGED
@@ -14,6 +14,19 @@ declare const enum Stat {
14
14
  USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
15
15
  SIGNALING_PING_SUMMARY = "signaling_ping_summary",
16
16
  SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
17
+ API_CALL = "api_call",
18
+ SDP_CREATE_OFFER = "sdp_create_offer",
19
+ SDP_CREATE_ANSWER = "sdp_create_answer",
20
+ SDP_SET_LOCAL_OFFER = "sdp_set_local_offer",
21
+ SDP_SET_LOCAL_PRANSWER = "sdp_set_local_pranswer",
22
+ SDP_SET_LOCAL_ANSWER = "sdp_set_local_answer",
23
+ SDP_SET_LOCAL_ROLLBACK = "sdp_set_local_rollback",
24
+ SDP_SET_REMOTE_OFFER = "sdp_set_remote_offer",
25
+ SDP_SET_REMOTE_PRANSWER = "sdp_set_remote_pranswer",
26
+ SDP_SET_REMOTE_ANSWER = "sdp_set_remote_answer",
27
+ SDP_SET_REMOTE_ROLLBACK = "sdp_set_remote_rollback",
28
+ SDP_GENERATED = "sdp_generated",
29
+ SDP_RECEIVED = "sdp_received",
17
30
  WEBSOCKET_CONNECTED = "websocket_connected",
18
31
  WEBSOCKET_RECONNECTED = "websocket_reconnected",
19
32
  WEBSOCKET_FAILED_PINGS = "websocket_failed_pings",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vkontakte/calls-sdk",
3
- "version": "2.8.13-dev.4ce2e1bb.0",
3
+ "version": "2.8.13-dev.56ef08c8.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",
@@ -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;
@@ -42,6 +42,22 @@ export type ParamsObject = {
42
42
  * По умолчанию `'0.0.0'`
43
43
  */
44
44
  appVersion: string;
45
+ /**
46
+ * Автоматически запускать отправку клиентской статистики при `init()`.
47
+ *
48
+ * При `false` события копятся в очереди, но не уходят в сеть, пока хост не
49
+ * вызовет `startStats()`.
50
+ *
51
+ * _По умолчанию: `true`_
52
+ */
53
+ autoStartStats: boolean;
54
+ /**
55
+ * Персистентная очередь клиентской статистики: события копятся в IndexedDB
56
+ * и уезжают пачками с подтверждением, переживая перезагрузку вкладки.
57
+ *
58
+ * _По умолчанию: `false`_
59
+ */
60
+ statQueueEnabled: boolean;
45
61
  /** @hidden */
46
62
  clientType: string;
47
63
  /** @hidden */
@@ -235,6 +251,13 @@ export type ParamsObject = {
235
251
  iceRestartWaitTime: number;
236
252
  /** @hidden */
237
253
  transportConnectionWaitTime: number;
254
+ /**
255
+ * Разрешить запрашивать переход на серверную топологию не только звонящему,
256
+ * но и принимающей стороне, если не удалось восстановить оборвавшееся p2p-соединение
257
+ *
258
+ * _По умолчанию: `false`_
259
+ */
260
+ switchTopologyOnReconnectFromAnySide: boolean;
238
261
  /**
239
262
  * Частота получения статистики в миллисекундах
240
263
  *
@@ -946,6 +969,8 @@ export default abstract class Params {
946
969
  static set platform(value: string);
947
970
  static get clientStatsPlatform(): string;
948
971
  static set clientStatsPlatform(value: string);
972
+ static get autoStartStats(): boolean;
973
+ static get statQueueEnabled(): boolean;
949
974
  static get clientType(): string;
950
975
  static set clientType(value: string);
951
976
  static get externalUserType(): string;
@@ -1018,6 +1043,7 @@ export default abstract class Params {
1018
1043
  };
1019
1044
  static get iceRestartWaitTime(): number;
1020
1045
  static get transportConnectionWaitTime(): number;
1046
+ static get switchTopologyOnReconnectFromAnySide(): boolean;
1021
1047
  static get statisticsInterval(): number;
1022
1048
  static set statisticsInterval(value: number);
1023
1049
  static get networkStatisticsInterval(): number;
@@ -1099,6 +1125,8 @@ export default abstract class Params {
1099
1125
  clientType: string;
1100
1126
  clientStatsPlatform: string;
1101
1127
  appVersion: string;
1128
+ autoStartStats: boolean;
1129
+ statQueueEnabled: boolean;
1102
1130
  consumerScreenDataChannelPacketSize: number;
1103
1131
  switchVideoAtBadNetwork: boolean;
1104
1132
  simulcast: boolean;
@@ -0,0 +1,29 @@
1
+ export type StoredSession = {
2
+ sessionKey: string;
3
+ /** Ключ окружения на момент сохранения, см. currentEndpoint(). */
4
+ endpoint: string;
5
+ savedAt: number;
6
+ };
7
+ /**
8
+ * Снимки сессий по uid на диске. Снимок может быть протухшим и переавторизации
9
+ * не подлежит, поэтому годится только для отложенных best-effort задач вроде
10
+ * досылки статистики.
11
+ */
12
+ export default abstract class SessionStore {
13
+ static remember(uid: number, session: {
14
+ sessionKey: string;
15
+ endpoint: string;
16
+ }): void;
17
+ static get(uid: number): StoredSession | null;
18
+ static forget(uid: number): void;
19
+ /** Снимок живёт столько же, сколько события, которые он мог бы дослать. */
20
+ static prune(now?: number): void;
21
+ /**
22
+ * Ключ окружения: сессия прода не должна улететь на тестовый кластер.
23
+ * Адрес нормализуется так же, как в транспорте.
24
+ */
25
+ static currentEndpoint(): string;
26
+ private static _read;
27
+ private static _write;
28
+ private static _isValid;
29
+ }
@@ -4,6 +4,7 @@ export declare const SIMULCAST_DEFAULT: {
4
4
  HEIGHT: number;
5
5
  WIDTH: number;
6
6
  BITRATE: number;
7
+ FPS: number;
7
8
  };
8
9
  export declare const SIMULCAST_SCALABILITY_MODE = "L1T2";
9
10
  export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;
@@ -2,7 +2,7 @@
2
2
  * Вспомогательный плагин для работы с WebRTC
3
3
  */
4
4
  import { IVideoDimentions } from '../types/MediaSettings';
5
- import type StatsLogger from '../classes/StatsLogger';
5
+ import type StatEventCollector from '../classes/stat/StatEventCollector';
6
6
  import { type DebugLogger } from './Debug';
7
7
  /**
8
8
  * Тип камеры мобильного устройства
@@ -85,24 +85,24 @@ declare namespace WebRTCUtils {
85
85
  * @param needAudio Нужно ли аудио
86
86
  * @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
87
87
  */
88
- function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
88
+ function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
89
89
  /**
90
90
  * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
91
91
  */
92
- function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
92
+ function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
93
93
  /**
94
94
  * Запрашивает камеру пользователя
95
95
  *
96
96
  * @param deviceId ID устройства
97
97
  * @param resolution Размеры видео
98
98
  */
99
- function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
99
+ function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
100
100
  /**
101
101
  * Запрашивает микрофон пользователя
102
102
  *
103
103
  * @param deviceId ID устройства
104
104
  */
105
- function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
105
+ function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
106
106
  /**
107
107
  * Устанавливает размер видео в стриме
108
108
  *
@@ -1,6 +1,6 @@
1
1
  import Stat from '../enums/Stat';
2
2
  export interface IEventualStatLog {
3
3
  name: Stat;
4
- value?: number | null;
4
+ value?: number;
5
5
  [k: string]: number | string | undefined | null;
6
6
  }