@vkontakte/calls-sdk 2.8.13-dev.af6936c9.0 → 2.8.13-dev.b18b02e0.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 (66) hide show
  1. package/CallsSDK.d.ts +40 -14
  2. package/abstract/BaseApi.d.ts +13 -9
  3. package/calls-sdk.cjs.js +7 -7
  4. package/calls-sdk.esm.js +4588 -3069
  5. package/classes/AudioFix.d.ts +2 -2
  6. package/classes/AudioOutput.d.ts +5 -3
  7. package/classes/CallRegistry.d.ts +17 -4
  8. package/classes/MediaSource.d.ts +11 -2
  9. package/classes/SpecListener.d.ts +2 -2
  10. package/classes/StatsLogger.d.ts +1 -1
  11. package/classes/codec/LibVPxDecoder.d.ts +2 -2
  12. package/classes/codec/LibVPxEncoder.d.ts +2 -2
  13. package/classes/codec/WebCodecsDecoder.d.ts +2 -2
  14. package/classes/codec/WebCodecsEncoder.d.ts +2 -2
  15. package/classes/codec/WorkerBase.d.ts +3 -3
  16. package/classes/conversation/Conversation.d.ts +25 -7
  17. package/classes/conversation/Conversation.testUtils.d.ts +1 -0
  18. package/classes/screenshare/ScreenCaptureReceiver.d.ts +2 -2
  19. package/classes/screenshare/ScreenCaptureSender.d.ts +2 -2
  20. package/classes/screenshare/StreamBuilder.d.ts +2 -2
  21. package/classes/stat/ApiCallStats.d.ts +12 -0
  22. package/classes/stat/BatteryStats.d.ts +25 -0
  23. package/classes/stat/CallLifecycleStats.d.ts +2 -2
  24. package/classes/stat/ClientResourceStats.d.ts +41 -0
  25. package/classes/stat/CodecStatsAggregator.d.ts +2 -2
  26. package/classes/stat/ConversationStats.d.ts +20 -3
  27. package/classes/stat/NetworkAdaptationStats.d.ts +35 -0
  28. package/classes/stat/PeerConnectionStats.d.ts +22 -0
  29. package/classes/stat/SdpStats.d.ts +40 -0
  30. package/classes/stat/Stat.testUtils.d.ts +10 -0
  31. package/classes/stat/StatAggregator.d.ts +12 -3
  32. package/classes/stat/StatClock.d.ts +28 -0
  33. package/classes/stat/StatDrainScheduler.d.ts +92 -0
  34. package/classes/stat/StatEventCollector.d.ts +50 -0
  35. package/classes/stat/StatPings.d.ts +4 -2
  36. package/classes/stat/StatQueue.d.ts +79 -0
  37. package/classes/stat/StatSignalingCommands.d.ts +2 -2
  38. package/classes/stat/StatUnloadJournal.d.ts +27 -0
  39. package/classes/transport/DirectTransport.d.ts +13 -2
  40. package/classes/transport/PerfStatReporter.d.ts +7 -1
  41. package/classes/transport/ServerTransport.d.ts +6 -2
  42. package/classes/transport/SimulcastSender.d.ts +2 -2
  43. package/classes/transport/Transport.d.ts +5 -4
  44. package/classes/transport/VadGate.d.ts +37 -0
  45. package/default/Api.d.ts +13 -1
  46. package/default/Signaling.d.ts +11 -3
  47. package/default/SignalingTransport.d.ts +5 -1
  48. package/enums/ActiveFeature.d.ts +19 -0
  49. package/enums/SessionError.d.ts +10 -0
  50. package/enums/Stat.d.ts +26 -1
  51. package/package.json +1 -1
  52. package/static/ApiTransport.d.ts +4 -0
  53. package/static/AuthData.d.ts +11 -1
  54. package/static/BrowserEnvironment.d.ts +90 -0
  55. package/static/External.d.ts +11 -0
  56. package/static/Params.d.ts +59 -2
  57. package/static/SessionStore.d.ts +29 -0
  58. package/static/SimulcastInfo.d.ts +1 -0
  59. package/static/WebRTCUtils.d.ts +5 -76
  60. package/types/ClientStatsEvent.d.ts +12 -0
  61. package/types/FastHangup.d.ts +7 -5
  62. package/types/IEventualStatLog.d.ts +1 -1
  63. package/types/Params.d.ts +1 -1
  64. package/types/PerfStatReporter.d.ts +26 -1
  65. package/types/SignalingMessage.d.ts +1 -0
  66. package/types/Statistics.d.ts +22 -7
@@ -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
  }
@@ -4,6 +4,7 @@ import { DebugLogger } from '../static/Debug';
4
4
  export declare enum SignalingTransportFailure {
5
5
  EMPTY_ENDPOINT = "EMPTY_ENDPOINT",
6
6
  NETWORK_ERROR = "NETWORK_ERROR",
7
+ RECONNECT_TIMEOUT = "RECONNECT_TIMEOUT",
7
8
  ABORTED = "ABORTED"
8
9
  }
9
10
  export type SignalingTransportFailedEvent = {
@@ -40,6 +41,7 @@ export default class SignalingTransport {
40
41
  private connectionType;
41
42
  private reconnectCount;
42
43
  private reconnectTimer;
44
+ private reconnectDeadlineTimer;
43
45
  private doctorTimer;
44
46
  private forceWebSocket;
45
47
  private abortSignal;
@@ -54,7 +56,7 @@ export default class SignalingTransport {
54
56
  setPeerId(peerId: number | null): void;
55
57
  setLastStamp(lastStamp: number): void;
56
58
  setAbortSignal(signal?: AbortSignal): void;
57
- resetReconnectCount(): void;
59
+ onConnectionRestored(): void;
58
60
  connect(connectionType: SignalingConnectionType): void;
59
61
  close(code?: number): void;
60
62
  send(data: string | ArrayBuffer): Promise<void>;
@@ -70,6 +72,8 @@ export default class SignalingTransport {
70
72
  private _onClose;
71
73
  private _disconnect;
72
74
  private _scheduleReconnect;
75
+ private _startReconnectDeadline;
76
+ private _stopReconnectDeadline;
73
77
  private _getReconnectDelay;
74
78
  private _startDoctor;
75
79
  private _stopDoctor;
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Фичи, активные во время звонка. Уходят в метрику active_features,
3
+ * чтобы по ним разрезать остальную статистику: сколько фризов при включённой камере,
4
+ * какой битрейт при шаре и так далее.
5
+ *
6
+ * Здесь только то, что реально включено прямо сейчас, а не то, что разрешено настройками:
7
+ * иначе фича попадала бы в метрику у всех, кому ее просто не запретили.
8
+ *
9
+ * Сервер принимает только имена из своего списка, незнакомые отбрасывает с ошибкой.
10
+ * Новое имя добавляем сюда после того, как его добавят на сервере.
11
+ */
12
+ declare enum ActiveFeature {
13
+ MICROPHONE = "MICROPHONE",
14
+ CAMERA = "CAMERA",
15
+ /** Любая шара экрана, в том числе быстрая */
16
+ SCREEN = "SCREEN",
17
+ ANIMOJI = "ANIMOJI"
18
+ }
19
+ export default ActiveFeature;
@@ -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
@@ -1,4 +1,7 @@
1
- declare const enum Stat {
1
+ /**
2
+ * Имена событий статистики — поле `name` в данных `onClientStats`
3
+ */
4
+ declare enum Stat {
2
5
  CALL_INIT = "call_init",
3
6
  CALL_START = "call_start",
4
7
  CALL_ACCEPTED_OUTGOING = "call_accepted_outgoing",
@@ -14,6 +17,28 @@ declare const enum Stat {
14
17
  USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
15
18
  SIGNALING_PING_SUMMARY = "signaling_ping_summary",
16
19
  SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
20
+ API_CALL = "api_call",
21
+ CONNECTION_STATE_CHANGED = "connection_state_changed",
22
+ SIGNALING_STATE_CHANGED = "signaling_state_changed",
23
+ GATHERING_STATE_CHANGED = "gathering_state_changed",
24
+ ICE_RESTART = "ice_restart",
25
+ ICE_CANDIDATES_CHANGED = "ice_candidates_changed",
26
+ ICE_CANDIDATE_GATHERING_FAILED = "ice_candidate_gathering_failed",
27
+ ICE_CANDIDATE_ADD_FAILED = "ice_candidate_add_failed",
28
+ SDP_CREATE_OFFER = "sdp_create_offer",
29
+ SDP_CREATE_ANSWER = "sdp_create_answer",
30
+ SDP_SET_LOCAL_OFFER = "sdp_set_local_offer",
31
+ SDP_SET_LOCAL_PRANSWER = "sdp_set_local_pranswer",
32
+ SDP_SET_LOCAL_ANSWER = "sdp_set_local_answer",
33
+ SDP_SET_LOCAL_ROLLBACK = "sdp_set_local_rollback",
34
+ SDP_SET_REMOTE_OFFER = "sdp_set_remote_offer",
35
+ SDP_SET_REMOTE_PRANSWER = "sdp_set_remote_pranswer",
36
+ SDP_SET_REMOTE_ANSWER = "sdp_set_remote_answer",
37
+ SDP_SET_REMOTE_ROLLBACK = "sdp_set_remote_rollback",
38
+ SDP_GENERATED = "sdp_generated",
39
+ SDP_RECEIVED = "sdp_received",
40
+ CLIENT_REQUESTED_SERVER_TOPOLOGY = "client_requested_server_topology",
41
+ VIDEO_ENCODER_CHANGED_BY_NETWORK_ADAPTER = "video_encoder_changed_by_network_adapter",
17
42
  WEBSOCKET_CONNECTED = "websocket_connected",
18
43
  WEBSOCKET_RECONNECTED = "websocket_reconnected",
19
44
  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.af6936c9.0",
3
+ "version": "2.8.13-dev.b18b02e0.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;
@@ -1,9 +1,16 @@
1
- import type { OkUserId } from '../types/Participant';
1
+ import type { ExternalParticipantId } from '../types/ExternalId';
2
+ import type { OkUserId, ParticipantId } from '../types/Participant';
3
+ /** Свой участник и его внешний id */
4
+ export type SelfExternalId = {
5
+ participantId: ParticipantId;
6
+ externalId: ExternalParticipantId;
7
+ };
2
8
  export default abstract class AuthData {
3
9
  private static _sessionKey;
4
10
  private static _sessionSecretKey;
5
11
  private static _accessToken;
6
12
  private static _userId;
13
+ private static _selfExternalId;
7
14
  private static _reauthorizePromise;
8
15
  static get sessionKey(): string | undefined;
9
16
  static set sessionKey(value: string | undefined);
@@ -13,6 +20,9 @@ export default abstract class AuthData {
13
20
  static set accessToken(value: string | undefined);
14
21
  static get userId(): OkUserId | null;
15
22
  static set userId(value: OkUserId | null);
23
+ /** Свой участник и его внешний id из ответа auth.anonymLogin */
24
+ static get selfExternalId(): SelfExternalId | null;
25
+ static set selfExternalId(value: SelfExternalId | null);
16
26
  static isEmpty(): boolean;
17
27
  /**
18
28
  * Дедуплицирует одновременные попытки реавторизации из разных инстансов Api.
@@ -0,0 +1,90 @@
1
+ /**
2
+ * Определение браузера, операционной системы и доступных возможностей.
3
+ */
4
+ /**
5
+ * Известные браузеры
6
+ */
7
+ export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
8
+ declare namespace BrowserEnvironment {
9
+ /**
10
+ * Получение и кэширование версии операционной системы
11
+ */
12
+ function initOsVersion(warn: (...args: any[]) => void): Promise<void>;
13
+ /**
14
+ * Проверяет поддержку WebRTC браузером
15
+ */
16
+ function isBrowserSupported(): boolean;
17
+ /**
18
+ * Возвращает первую отсутствующую capability в стабильном порядке.
19
+ */
20
+ function getBrowserSupportFailure(): BrowserSupportFailure | null;
21
+ /**
22
+ * Проверяет поддержку шаринга экрана браузером
23
+ */
24
+ function isScreenCapturingSupported(): boolean;
25
+ /**
26
+ * Проверяет поддержку выбора микрофона браузером, независимо от списка устройств и разрешений.
27
+ * Доступен до init, не запрашивает разрешения и не захватывает медиа.
28
+ */
29
+ function canSelectAudioInput(): boolean;
30
+ /**
31
+ * Проверяет поддержку выбора аудиовыхода браузером, независимо от списка устройств и разрешений.
32
+ * Доступен до init, не запрашивает разрешения и не меняет аудиовыход.
33
+ */
34
+ function canSelectAudioOutput(): boolean;
35
+ /**
36
+ * В некоторых браузерах H264 decoder сломан
37
+ */
38
+ function isBrokenH264Decoder(): boolean;
39
+ /**
40
+ * В некоторых браузерах VP9 encoder сломан
41
+ */
42
+ function isBrokenVP9Encoder(): boolean;
43
+ /**
44
+ * В некоторых браузерах VP9 decoder сломан
45
+ */
46
+ function isBrokenVP9Decoder(): boolean;
47
+ /**
48
+ * Может ли браузер делать H264 приоритетным
49
+ */
50
+ function canPreferH264(): boolean;
51
+ /**
52
+ * Поддержка simulcast браузером.
53
+ * Safari корректно поддерживает simulcast начиная с версии 18.
54
+ * Firefox поддерживает simulcast с VP8 начиная с версии 134.
55
+ */
56
+ function isSimulcastSupportedByBrowser(): boolean;
57
+ /**
58
+ * Имя операционной системы
59
+ */
60
+ function os(): string;
61
+ /**
62
+ * Версия операционной системы
63
+ */
64
+ function osVersion(): number | null | undefined;
65
+ /**
66
+ * Мобильный браузер или нет
67
+ */
68
+ function isMobile(): boolean;
69
+ /**
70
+ * Имя браузера
71
+ */
72
+ function browserName(): BrowserName | string;
73
+ /**
74
+ * Версия браузера
75
+ */
76
+ function browserVersion(): string;
77
+ /**
78
+ * Если браузер основан на хроме - возвращает версию
79
+ */
80
+ function baseChromeVersion(): number;
81
+ /**
82
+ * Возвращает подверсию браузера (если она есть)
83
+ */
84
+ function browserSubVersion(): string;
85
+ /**
86
+ * Браузер поддерживает захват звука при трансляции экрана
87
+ */
88
+ function isAudioShareSupported(): boolean;
89
+ }
90
+ export default BrowserEnvironment;
@@ -1,4 +1,5 @@
1
1
  import { IAsrData } from '../types/Asr';
2
+ import { ClientStatsEvent } from '../types/ClientStatsEvent';
2
3
  import { ConversationData } from '../types/Conversation';
3
4
  import HangupReason from '../classes/HangupReason';
4
5
  import { MediaTrackKind } from '../classes/MediaSource';
@@ -513,6 +514,12 @@ declare namespace External {
513
514
  * @param memory Статистика памяти
514
515
  */
515
516
  function onStatistics(connection: StatResult, memory: Record<string, number>): void;
517
+ /**
518
+ * Событие статистики SDK
519
+ *
520
+ * @param data Данные события с `vcid` и `ts`
521
+ */
522
+ function onClientStats(data: ClientStatsEvent): void;
516
523
  /**
517
524
  * Ошибка воспроизведения звука
518
525
  */
@@ -628,6 +635,10 @@ declare namespace External {
628
635
  */
629
636
  function onParticipantIdChanged(prevId: ExternalParticipantId, newId: ExternalParticipantId, conversationId?: string): void;
630
637
  function onVideoSuspendSuggest(bandwidth: number, conversationId?: string): void;
638
+ /**
639
+ * Успешно применено первое подключение к сигналингу или переподключение.
640
+ */
641
+ function onSignalingConnected(conversationId: string): void;
631
642
  /**
632
643
  * Одобрено повышение пользователя в зеле ожидания/зале в режиме Audience
633
644
  *
@@ -2,6 +2,7 @@ import type { VideoEffects } from '@vkontakte/calls-video-effects';
2
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
+ import { ClientStatsEvent } from '../types/ClientStatsEvent';
5
6
  import { ConversationData } from '../types/Conversation';
6
7
  import HangupReason from '../classes/HangupReason';
7
8
  import { MediaTrackKind } from '../classes/MediaSource';
@@ -42,6 +43,22 @@ export type ParamsObject = {
42
43
  * По умолчанию `'0.0.0'`
43
44
  */
44
45
  appVersion: string;
46
+ /**
47
+ * Автоматически запускать отправку клиентской статистики при `init()`.
48
+ *
49
+ * При `false` события копятся в очереди, но не уходят в сеть, пока хост не
50
+ * вызовет `startStats()`.
51
+ *
52
+ * _По умолчанию: `true`_
53
+ */
54
+ autoStartStats: boolean;
55
+ /**
56
+ * Персистентная очередь клиентской статистики: события копятся в IndexedDB
57
+ * и уезжают пачками с подтверждением, переживая перезагрузку вкладки.
58
+ *
59
+ * _По умолчанию: `false`_
60
+ */
61
+ statQueueEnabled: boolean;
45
62
  /** @hidden */
46
63
  clientType: string;
47
64
  /** @hidden */
@@ -98,6 +115,8 @@ export type ParamsObject = {
98
115
  /** @hidden */
99
116
  signalingReconnectMaxCount: number;
100
117
  /** @hidden */
118
+ signalingReconnectMaxDuration: number;
119
+ /** @hidden */
101
120
  waitConnectionDelay: number;
102
121
  /** @hidden */
103
122
  waitResponseDelay: number;
@@ -235,6 +254,13 @@ export type ParamsObject = {
235
254
  iceRestartWaitTime: number;
236
255
  /** @hidden */
237
256
  transportConnectionWaitTime: number;
257
+ /**
258
+ * Разрешить запрашивать переход на серверную топологию не только звонящему,
259
+ * но и принимающей стороне, если не удалось восстановить оборвавшееся p2p-соединение
260
+ *
261
+ * _По умолчанию: `false`_
262
+ */
263
+ switchTopologyOnReconnectFromAnySide: boolean;
238
264
  /**
239
265
  * Частота получения статистики в миллисекундах
240
266
  *
@@ -274,6 +300,13 @@ export type ParamsObject = {
274
300
  perfStatReportEnabled: boolean;
275
301
  /** @hidden */
276
302
  callStatReportEnabled: boolean;
303
+ /**
304
+ * Отправлять событие статистики ice_candidate_gathering_failed
305
+ *
306
+ * _По умолчанию: `false`_
307
+ * @hidden
308
+ */
309
+ iceCandidateErrorStatEnabled: boolean;
277
310
  /**
278
311
  * Отдавать приоритет кодеку H264 для исходящего видео
279
312
  *
@@ -529,7 +562,9 @@ export type ParamsObject = {
529
562
  */
530
563
  forwardEmptyIceCandidate: boolean;
531
564
  /**
532
- * Получен локальный стрим с камеры/микрофона
565
+ * Получен локальный стрим с камеры/микрофона, в том числе до подключения сигналинга.
566
+ * Повторяется после изменения видео (включение, выключение, смена камеры).
567
+ * Повторное событие может содержать тот же MediaStream с обновлёнными треками.
533
568
  */
534
569
  onLocalStream?: (stream: MediaStream | null, mediaSettings: MediaSettings, conversationId?: string) => void;
535
570
  /**
@@ -711,7 +746,8 @@ export type ParamsObject = {
711
746
  onLocalVolume?: (volume: number, isMicEnabled: boolean) => void;
712
747
  onJoinStatus?: (available: boolean, chatId: string, conversationId?: string) => void;
713
748
  /**
714
- * Звонок был завершен
749
+ * Звонок завершён локально. При hangup callback планируется сразу, ровно один раз, без ожидания сети.
750
+ * Доставляется асинхронно; Promise hangup отдельно ждёт известную SDK работу по завершению.
715
751
  */
716
752
  onHangup?: (type: HangupReason | Error, conversationId: string | null) => void;
717
753
  /**
@@ -781,6 +817,12 @@ export type ParamsObject = {
781
817
  * Статистика звонка
782
818
  */
783
819
  onStatistics?: (stats: {}) => void;
820
+ /**
821
+ * Событие статистики SDK: те же данные, что уходят в статистику звонков, плюс `vcid` и `ts`
822
+ *
823
+ * @param data Данные события
824
+ */
825
+ onClientStats?: (data: ClientStatsEvent) => void;
784
826
  /**
785
827
  * Ошибка воспроизведения звука
786
828
  */
@@ -894,6 +936,13 @@ export type ParamsObject = {
894
936
  * @param bandwidth текущая полоса пропускания, kbps
895
937
  */
896
938
  onVideoSuspendSuggest?: (bandwidth: number, conversationId?: string) => void;
939
+ /**
940
+ * Первое подключение к сигналингу или переподключение успешно применено к состоянию звонка.
941
+ * Звонок зарегистрирован под conversationId, локальное управление доступно, в том числе в зале ожидания.
942
+ * Событие не означает принятие звонка собеседником или готовность WebRTC.
943
+ * Callback вызывается асинхронно; к моменту вызова звонок может уже завершиться.
944
+ */
945
+ onSignalingConnected?: (conversationId: string) => void;
897
946
  /**
898
947
  * Одобрено повышение пользователя в зале ожидания/зале в режиме Audience
899
948
  *
@@ -946,6 +995,8 @@ export default abstract class Params {
946
995
  static set platform(value: string);
947
996
  static get clientStatsPlatform(): string;
948
997
  static set clientStatsPlatform(value: string);
998
+ static get autoStartStats(): boolean;
999
+ static get statQueueEnabled(): boolean;
949
1000
  static get clientType(): string;
950
1001
  static set clientType(value: string);
951
1002
  static get externalUserType(): string;
@@ -975,6 +1026,7 @@ export default abstract class Params {
975
1026
  static get signalingReconnectDelay(): number;
976
1027
  static get signalingReconnectMaxDelay(): number;
977
1028
  static get signalingReconnectMaxCount(): number;
1029
+ static get signalingReconnectMaxDuration(): number;
978
1030
  static get waitConnectionDelay(): number;
979
1031
  static get waitResponseDelay(): number;
980
1032
  static get waitMessageDelay(): number;
@@ -1018,11 +1070,13 @@ export default abstract class Params {
1018
1070
  };
1019
1071
  static get iceRestartWaitTime(): number;
1020
1072
  static get transportConnectionWaitTime(): number;
1073
+ static get switchTopologyOnReconnectFromAnySide(): boolean;
1021
1074
  static get statisticsInterval(): number;
1022
1075
  static set statisticsInterval(value: number);
1023
1076
  static get networkStatisticsInterval(): number;
1024
1077
  static get perfStatReportEnabled(): boolean;
1025
1078
  static get callStatReportEnabled(): boolean;
1079
+ static get iceCandidateErrorStatEnabled(): boolean;
1026
1080
  static get enableLogPerfStatReport(): boolean;
1027
1081
  static get asrDataChannel(): boolean;
1028
1082
  static get consumerScreenDataChannelPacketSize(): number;
@@ -1094,11 +1148,14 @@ export default abstract class Params {
1094
1148
  videoSuspend: boolean;
1095
1149
  debugLog: boolean;
1096
1150
  callStatReportEnabled: boolean;
1151
+ iceCandidateErrorStatEnabled: boolean;
1097
1152
  joinFromMultipleDevices: boolean;
1098
1153
  movieShare: boolean;
1099
1154
  clientType: string;
1100
1155
  clientStatsPlatform: string;
1101
1156
  appVersion: string;
1157
+ autoStartStats: boolean;
1158
+ statQueueEnabled: boolean;
1102
1159
  consumerScreenDataChannelPacketSize: number;
1103
1160
  switchVideoAtBadNetwork: boolean;
1104
1161
  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
  * Тип камеры мобильного устройства
@@ -17,10 +17,6 @@ export declare enum FacingMode {
17
17
  */
18
18
  ENVIRONMENT = "environment"
19
19
  }
20
- /**
21
- * Известные браузеры
22
- */
23
- export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
24
20
  declare namespace WebRTCUtils {
25
21
  /**
26
22
  * До вызова этого метода бесполезно опрашивать другие публичные методы.
@@ -85,24 +81,24 @@ declare namespace WebRTCUtils {
85
81
  * @param needAudio Нужно ли аудио
86
82
  * @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
87
83
  */
88
- function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
84
+ function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
89
85
  /**
90
86
  * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
91
87
  */
92
- function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
88
+ function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
93
89
  /**
94
90
  * Запрашивает камеру пользователя
95
91
  *
96
92
  * @param deviceId ID устройства
97
93
  * @param resolution Размеры видео
98
94
  */
99
- function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
95
+ function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
100
96
  /**
101
97
  * Запрашивает микрофон пользователя
102
98
  *
103
99
  * @param deviceId ID устройства
104
100
  */
105
- function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
101
+ function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
106
102
  /**
107
103
  * Устанавливает размер видео в стриме
108
104
  *
@@ -118,76 +114,9 @@ declare namespace WebRTCUtils {
118
114
  * Возвращает фейковый видео mediaTrack
119
115
  */
120
116
  function getBlackMediaTrack(width?: number, height?: number): MediaStreamTrack;
121
- /**
122
- * Проверяет поддержку WebRTC браузером
123
- */
124
- function isBrowserSupported(): boolean;
125
- /**
126
- * Возвращает первую отсутствующую capability в стабильном порядке.
127
- */
128
- function getBrowserSupportFailure(): BrowserSupportFailure | null;
129
- /**
130
- * Проверяет поддержку шаринга экрана браузером
131
- */
132
- function isScreenCapturingSupported(): boolean;
133
- /**
134
- * В некоторых браузерах H264 decoder сломан
135
- */
136
- function isBrokenH264Decoder(): boolean;
137
- /**
138
- * В некоторых браузерах VP9 encoder сломан
139
- * В симулкасте вп9 енкодер ведет себя некорректно
140
- */
141
- function isBrokenVP9Encoder(): boolean;
142
- /**
143
- * В некоторых браузерах VP9 decoder сломан
144
- */
145
- function isBrokenVP9Decoder(): boolean;
146
- /**
147
- * Может ли браузер делать H264 приоритетным
148
- */
149
- function canPreferH264(): boolean;
150
- /**
151
- * Поддержка simulcast браузером.
152
- * Safari корректно поддерживает simulcast начиная с версии 18.
153
- * Firefox поддерживает simulcast с VP8 начиная с версии 134.
154
- */
155
- function isSimulcastSupportedByBrowser(): boolean;
156
- /**
157
- * Имя операционной системы
158
- */
159
- function os(): string;
160
- /**
161
- * Версия операционной системы
162
- */
163
- function osVersion(): number | null | undefined;
164
- /**
165
- * Мобильный браузер или нет
166
- */
167
- function isMobile(): boolean;
168
- /**
169
- * Имя браузера
170
- */
171
- function browserName(): BrowserName | string;
172
- /**
173
- * Версия браузера
174
- */
175
- function browserVersion(): string;
176
- /**
177
- * Если браузер основан на хроме - возвращает версию
178
- */
179
- function baseChromeVersion(): number;
180
117
  /**
181
118
  * Возвращает AudioContext
182
119
  */
183
120
  function getAudioContext(): AudioContext;
184
- /**
185
- * Возвращает подверсию браузера (если она есть)
186
- */
187
- function browserSubVersion(): string;
188
- /**
189
- * Браузер поддерживает захват звука при трансляции экрана
190
- */
191
- function isAudioShareSupported(): boolean;
192
121
  }
193
122
  export default WebRTCUtils;
@@ -0,0 +1,12 @@
1
+ import { StatPayload } from '../classes/stat/StatQueue';
2
+ /**
3
+ * Событие статистики SDK, которое получает `onClientStats`
4
+ */
5
+ export type ClientStatsEvent = StatPayload & {
6
+ /** Имя события из `Stat`. У периодической статистики звонка его нет */
7
+ name?: string;
8
+ /** ID звонка, `null` — пока он неизвестен */
9
+ vcid: string | null;
10
+ /** Время события, мс */
11
+ ts: number;
12
+ };