@vkontakte/calls-sdk 2.8.13-dev.89692622.0 → 2.8.13-dev.8d49bb21.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 (45) hide show
  1. package/CallsSDK.d.ts +31 -12
  2. package/abstract/BaseApi.d.ts +1 -1
  3. package/calls-sdk.cjs.js +7 -7
  4. package/calls-sdk.esm.js +3083 -2300
  5. package/classes/AudioOutput.d.ts +2 -0
  6. package/classes/CallRegistry.d.ts +17 -4
  7. package/classes/MediaSource.d.ts +10 -0
  8. package/classes/StatsLogger.d.ts +1 -1
  9. package/classes/conversation/Conversation.d.ts +24 -7
  10. package/classes/conversation/Conversation.testUtils.d.ts +1 -0
  11. package/classes/stat/BatteryStats.d.ts +25 -0
  12. package/classes/stat/CallLifecycleStats.d.ts +4 -1
  13. package/classes/stat/CallStatTail.d.ts +65 -0
  14. package/classes/stat/ClientResourceStats.d.ts +41 -0
  15. package/classes/stat/CodecStatsAggregator.d.ts +4 -1
  16. package/classes/stat/ConversationStats.d.ts +13 -8
  17. package/classes/stat/NetworkAdaptationStats.d.ts +35 -0
  18. package/classes/stat/PeerConnectionStats.d.ts +22 -0
  19. package/classes/stat/SdpStats.d.ts +2 -1
  20. package/classes/stat/Stat.testUtils.d.ts +17 -0
  21. package/classes/stat/StatAggregator.d.ts +3 -1
  22. package/classes/stat/StatDrainScheduler.d.ts +34 -13
  23. package/classes/stat/StatEventCollector.d.ts +7 -12
  24. package/classes/stat/StatPings.d.ts +5 -1
  25. package/classes/stat/StatQueue.d.ts +42 -3
  26. package/classes/stat/StatSignalingCommands.d.ts +3 -1
  27. package/classes/transport/DirectTransport.d.ts +6 -0
  28. package/classes/transport/PerfStatReporter.d.ts +7 -1
  29. package/classes/transport/ServerTransport.d.ts +3 -0
  30. package/default/Api.d.ts +3 -0
  31. package/default/SignalingTransport.d.ts +5 -1
  32. package/enums/ActiveFeature.d.ts +19 -0
  33. package/enums/Stat.d.ts +9 -0
  34. package/package.json +3 -3
  35. package/static/AuthData.d.ts +11 -1
  36. package/static/BrowserEnvironment.d.ts +90 -0
  37. package/static/External.d.ts +4 -0
  38. package/static/Params.d.ts +24 -2
  39. package/static/WebRTCUtils.d.ts +0 -71
  40. package/types/ClientStatsEvent.d.ts +2 -1
  41. package/types/FastHangup.d.ts +7 -5
  42. package/types/PerfStatReporter.d.ts +26 -1
  43. package/types/SignalingMessage.d.ts +1 -0
  44. package/types/Statistics.d.ts +22 -7
  45. package/classes/stat/StatUnloadJournal.d.ts +0 -27
@@ -2,7 +2,8 @@ import BaseApi from '../../abstract/BaseApi';
2
2
  import BaseLogger from '../../abstract/BaseLogger';
3
3
  import StatLog from '../../enums/StatLog';
4
4
  import TransportTopology from '../../enums/TransportTopology';
5
- type ClientStatsPayload = Record<string, string | number | boolean | undefined | null>;
5
+ import { StatQueueEntry } from './StatQueue';
6
+ export type ClientStatsPayload = Record<string, string | string[] | number | boolean | undefined | null>;
6
7
  export type LogClientStatsOptions = {
7
8
  /** Время наступления события. По умолчанию — момент записи. */
8
9
  occurredAt?: number;
@@ -26,25 +27,19 @@ export default class StatEventCollector extends BaseLogger {
26
27
  private readonly _externalLogger;
27
28
  private readonly _conversationIdProvider;
28
29
  private readonly _topologyProvider;
29
- private _unloadMode;
30
30
  /** Старая схема: не null, когда ручка выключена, тогда очередь не используется. */
31
31
  private readonly _legacy;
32
32
  constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
33
33
  log(name: StatLog, value?: string, immediately?: boolean): void;
34
+ logClientStats(data: ClientStatsPayload, options?: LogClientStatsOptions): void;
34
35
  /**
35
- * Переключает коллектор на синхронный localStorage-журнал: асинхронная
36
- * запись в IndexedDB не переживает pagehide.
37
- */
38
- enterUnloadMode(): void;
39
- /**
40
- * Вкладка пережила pagehide (bfcache, отменённая навигация): возвращаемся
41
- * на очередь и переносим в неё уже записанное в журнал.
36
+ * Собирает запись очереди, никуда её не записывая и не вызывая onClientStats.
37
+ * null — старая схема, uid неизвестен или в памяти ждут события без uid.
42
38
  */
43
- exitUnloadMode(): void;
44
- logClientStats(data: ClientStatsPayload, options?: LogClientStatsOptions): void;
39
+ buildEntry(data: ClientStatsPayload, options?: LogClientStatsOptions): StatQueueEntry | null;
45
40
  destroy(): void;
41
+ private _makeEntry;
46
42
  private _store;
47
43
  private _getConversationId;
48
44
  private _getCallTopology;
49
45
  }
50
- export {};
@@ -1,5 +1,5 @@
1
1
  import { SignalingTransportType } from '../../enums/SignalingTransportStat';
2
- import StatEventCollector from './StatEventCollector';
2
+ import StatEventCollector, { ClientStatsPayload } from './StatEventCollector';
3
3
  export declare class StatPings {
4
4
  private readonly _logger;
5
5
  private trackerByTransport;
@@ -12,5 +12,9 @@ export declare class StatPings {
12
12
  mark(transport: SignalingTransportType): void;
13
13
  /** Отправляем данные в стату */
14
14
  logMetrics(): void;
15
+ /** Сводки на текущий момент, без отправки и без сброса. */
16
+ summaries(): ClientStatsPayload[];
17
+ /** Сбрасываем baseline после скрытия страницы, чтобы фоновой простой не стал интервалом ping. */
18
+ resetBaseline(): void;
15
19
  destroy(): void;
16
20
  }
@@ -2,8 +2,8 @@
2
2
  export declare const RECORD_LIMIT = 5000;
3
3
  /** Срок жизни события в очереди. */
4
4
  export declare const MAX_AGE_MS: number;
5
- /** Произвольный набор скалярных полей события. */
6
- export type StatPayload = Record<string, string | number | boolean | null>;
5
+ /** Произвольный набор полей события: скаляры и списки строк. */
6
+ export type StatPayload = Record<string, string | string[] | number | boolean | null>;
7
7
  /** Запись очереди без сгенерированного ключа. */
8
8
  export type StatQueueEntry = {
9
9
  /** userId владельца события. Не может быть неизвестным. */
@@ -21,6 +21,19 @@ export type StatQueueRecord = StatQueueEntry & {
21
21
  /** Автоинкремент. Единственный источник истины для порядка событий. */
22
22
  id: number;
23
23
  };
24
+ /**
25
+ * Хвост идущего звонка: события, которые уйдут, если вкладка умрёт, не
26
+ * закончив звонок, — call_finish с причиной terminated и итоги звонка.
27
+ */
28
+ export type StatTail = {
29
+ /** `<id вкладки>.<conversationId>` */
30
+ key: string;
31
+ uid: number;
32
+ vcid: string;
33
+ /** Время финиша в хвосте, device-time. */
34
+ ts: number;
35
+ entries: StatQueueEntry[];
36
+ };
24
37
  /**
25
38
  * Персистентная очередь событий статистики поверх IndexedDB.
26
39
  *
@@ -39,6 +52,25 @@ export default abstract class StatQueue {
39
52
  static isSupported(): boolean;
40
53
  /** @returns ключ записи или null, если хранилище не приняло её. */
41
54
  static append(entry: StatQueueEntry): Promise<number | null>;
55
+ /** Создаёт или перезаписывает хвост звонка. @returns false — хранилище недоступно. */
56
+ static putTail(tail: StatTail): Promise<boolean>;
57
+ /**
58
+ * Обновляет хвост, только если он ещё лежит: пропавший хвост забрала
59
+ * другая вкладка, воскрешать его нельзя.
60
+ */
61
+ static updateTail(tail: StatTail): Promise<'updated' | 'missing' | 'failed'>;
62
+ /** Удаляет хвост. 'missing' — его уже забрала другая вкладка. */
63
+ static removeTail(key: string): Promise<'removed' | 'missing' | 'failed'>;
64
+ static listTailKeys(): Promise<string[]>;
65
+ /**
66
+ * Переносит хвост в очередь одной транзакцией. Если у звонка этого
67
+ * пользователя call_finish уже есть, хвост просто удаляется.
68
+ *
69
+ * @returns 'added' — события хвоста в очереди, 'exists' — финиш уже был,
70
+ * 'expired' — хвост старше MAX_AGE_MS и удалён, 'missing' — хвоста нет,
71
+ * 'failed' — хранилище недоступно.
72
+ */
73
+ static adoptTail(key: string): Promise<'added' | 'exists' | 'expired' | 'missing' | 'failed'>;
42
74
  /**
43
75
  * Проставляет delta перечисленным записям, у которых её ещё нет.
44
76
  *
@@ -66,10 +98,17 @@ export default abstract class StatQueue {
66
98
  static evictOlderThan(maxAgeMs: number, now?: number): Promise<void>;
67
99
  private static _checkSupport;
68
100
  private static _open;
101
+ /** Раз в EVICT_CHECK_EVERY записей подрезает хранилище до лимита. */
102
+ private static _countAppend;
69
103
  private static _close;
104
+ /** Создаёт недостающие таблицы: и новую базу, и базу версии 1 с событиями. */
70
105
  private static _createSchema;
71
- /** Обёртка над транзакцией: резолвится после успешного коммита. */
106
+ /**
107
+ * Обёртка над транзакцией: резолвится после успешного коммита. body
108
+ * получает первую из таблиц и саму транзакцию — для остальных.
109
+ */
72
110
  private static _runTransaction;
111
+ private static _request;
73
112
  /** Читает запись с минимальным id, то есть самую старую в хранилище. */
74
113
  private static _readOldestRecord;
75
114
  /**
@@ -1,5 +1,5 @@
1
1
  import { SignalingTransportType } from '../../enums/SignalingTransportStat';
2
- import StatEventCollector from './StatEventCollector';
2
+ import StatEventCollector, { ClientStatsPayload } from './StatEventCollector';
3
3
  export declare class StatSignalingCommands {
4
4
  private readonly _logger;
5
5
  private trackerByCommand;
@@ -7,5 +7,7 @@ export declare class StatSignalingCommands {
7
7
  mark(command: string, time: number, transport: SignalingTransportType): void;
8
8
  /** Отправляем данные в стату */
9
9
  logMetrics(): void;
10
+ /** Сводки на текущий момент, без отправки и без сброса. */
11
+ summaries(): ClientStatsPayload[];
10
12
  destroy(): void;
11
13
  }
@@ -31,6 +31,10 @@ export default class DirectTransport extends BaseTransport {
31
31
  private _lastStat;
32
32
  private _fingerprint;
33
33
  private _neverConnected;
34
+ private _connectionStartedAt;
35
+ private _connectionLostAt;
36
+ /** Запросили переход на серверную топологию, не дождавшись первого подключения p2p */
37
+ private _serverRequestedOnNoConnection;
34
38
  private _serverSettings;
35
39
  private _prevConsumerSettings;
36
40
  private _networkLimitsForVideo;
@@ -40,6 +44,8 @@ export default class DirectTransport extends BaseTransport {
40
44
  private _perfStatReporter;
41
45
  private _directStatReporter;
42
46
  private readonly _sdpStats;
47
+ private readonly _peerConnectionStats;
48
+ private readonly _networkAdaptationStats;
43
49
  private readonly _debug;
44
50
  private readonly _logger;
45
51
  private readonly _statAggregator;
@@ -8,8 +8,11 @@ export default class PerfStatReporter extends EventEmitter {
8
8
  private _previousPerfStatReportTimestamp;
9
9
  private _previousNetworkStatReportTimestamp;
10
10
  private _previousCallStatReportTimestamp;
11
- private _previousCallStatReport;
11
+ private _previousCounters;
12
12
  private _previousRemoteInboundRtps;
13
+ private _previousInboundRtps;
14
+ private _previousOutboundRtps;
15
+ private _previousCandidatePair;
13
16
  private _screenShareStats;
14
17
  private _signaling;
15
18
  private readonly _directTopology;
@@ -22,7 +25,10 @@ export default class PerfStatReporter extends EventEmitter {
22
25
  private reportPerfStats;
23
26
  private reportNetworkStats;
24
27
  private _reportCallStats;
28
+ private _reportCandidatePair;
29
+ private _calculateRemotePacketLoss;
25
30
  private _calculatePacketLoss;
31
+ private _calculateOutboundDeltas;
26
32
  private _handleScreenSharingStat;
27
33
  private _handleTransportStateChanged;
28
34
  }
@@ -46,6 +46,7 @@ export default class ServerTransport extends BaseTransport {
46
46
  private readonly _logger;
47
47
  private readonly _statAggregator;
48
48
  private readonly _sdpStats;
49
+ private readonly _peerConnectionStats;
49
50
  private readonly _codecStatsAggregator;
50
51
  private readonly _simulcast;
51
52
  constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
@@ -82,6 +83,8 @@ export default class ServerTransport extends BaseTransport {
82
83
  private _startSettingsInterval;
83
84
  private _stopSettingsInterval;
84
85
  private _collectStat;
86
+ /** mid потока быстрой шары, чтобы отделить его от камеры в статистике */
87
+ private _getScreenShareMid;
85
88
  private _reportStats;
86
89
  private _detectStaleTracks;
87
90
  private _allocateConsumer;
package/default/Api.d.ts CHANGED
@@ -10,6 +10,7 @@ import PushData from '../types/PushData';
10
10
  export default class Api extends BaseApi {
11
11
  private _uuid;
12
12
  private _idCache;
13
+ constructor();
13
14
  private _callUnsafe;
14
15
  protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
15
16
  userId(participantId: ParticipantId): ExternalParticipantId | null;
@@ -22,6 +23,8 @@ export default class Api extends BaseApi {
22
23
  private _removeCachedAnonymLogin;
23
24
  private _reauthorize;
24
25
  private _applyAnonymLogin;
26
+ /** Кладёт в кеш id соответствие своего участника из auth.anonymLogin */
27
+ private _cacheSelfExternalId;
25
28
  private _buildClientStatsData;
26
29
  /** Ошибки по отдельным событиям логируются, но батч трактуется целиком. */
27
30
  private _reportClientStatsItemErrors;
@@ -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;
package/enums/Stat.d.ts CHANGED
@@ -18,6 +18,13 @@ declare enum Stat {
18
18
  SIGNALING_PING_SUMMARY = "signaling_ping_summary",
19
19
  SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
20
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",
21
28
  SDP_CREATE_OFFER = "sdp_create_offer",
22
29
  SDP_CREATE_ANSWER = "sdp_create_answer",
23
30
  SDP_SET_LOCAL_OFFER = "sdp_set_local_offer",
@@ -30,6 +37,8 @@ declare enum Stat {
30
37
  SDP_SET_REMOTE_ROLLBACK = "sdp_set_remote_rollback",
31
38
  SDP_GENERATED = "sdp_generated",
32
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",
33
42
  WEBSOCKET_CONNECTED = "websocket_connected",
34
43
  WEBSOCKET_RECONNECTED = "websocket_reconnected",
35
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.89692622.0",
3
+ "version": "2.8.13-dev.8d49bb21.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,9 +14,9 @@
14
14
  "**/*.d.ts"
15
15
  ],
16
16
  "dependencies": {
17
- "@vkontakte/calls-audio-effects": "1.4.1",
17
+ "@vkontakte/calls-audio-effects": "1.5.0",
18
18
  "@vkontakte/calls-video-effects": "2.2.3-beta.7",
19
- "@vkontakte/calls-vmoji": "1.0.10-beta.17",
19
+ "@vkontakte/calls-vmoji": "1.0.10",
20
20
  "@vkontakte/libvpx": "2.0.9",
21
21
  "bit-buffer": "0.2.5",
22
22
  "fflate": "^0.8.2",
@@ -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;
@@ -635,6 +635,10 @@ declare namespace External {
635
635
  */
636
636
  function onParticipantIdChanged(prevId: ExternalParticipantId, newId: ExternalParticipantId, conversationId?: string): void;
637
637
  function onVideoSuspendSuggest(bandwidth: number, conversationId?: string): void;
638
+ /**
639
+ * Успешно применено первое подключение к сигналингу или переподключение.
640
+ */
641
+ function onSignalingConnected(conversationId: string): void;
638
642
  /**
639
643
  * Одобрено повышение пользователя в зеле ожидания/зале в режиме Audience
640
644
  *
@@ -115,6 +115,8 @@ export type ParamsObject = {
115
115
  /** @hidden */
116
116
  signalingReconnectMaxCount: number;
117
117
  /** @hidden */
118
+ signalingReconnectMaxDuration: number;
119
+ /** @hidden */
118
120
  waitConnectionDelay: number;
119
121
  /** @hidden */
120
122
  waitResponseDelay: number;
@@ -298,6 +300,13 @@ export type ParamsObject = {
298
300
  perfStatReportEnabled: boolean;
299
301
  /** @hidden */
300
302
  callStatReportEnabled: boolean;
303
+ /**
304
+ * Отправлять событие статистики ice_candidate_gathering_failed
305
+ *
306
+ * _По умолчанию: `false`_
307
+ * @hidden
308
+ */
309
+ iceCandidateErrorStatEnabled: boolean;
301
310
  /**
302
311
  * Отдавать приоритет кодеку H264 для исходящего видео
303
312
  *
@@ -553,7 +562,9 @@ export type ParamsObject = {
553
562
  */
554
563
  forwardEmptyIceCandidate: boolean;
555
564
  /**
556
- * Получен локальный стрим с камеры/микрофона
565
+ * Получен локальный стрим с камеры/микрофона, в том числе до подключения сигналинга.
566
+ * Повторяется после изменения видео (включение, выключение, смена камеры).
567
+ * Повторное событие может содержать тот же MediaStream с обновлёнными треками.
557
568
  */
558
569
  onLocalStream?: (stream: MediaStream | null, mediaSettings: MediaSettings, conversationId?: string) => void;
559
570
  /**
@@ -735,7 +746,8 @@ export type ParamsObject = {
735
746
  onLocalVolume?: (volume: number, isMicEnabled: boolean) => void;
736
747
  onJoinStatus?: (available: boolean, chatId: string, conversationId?: string) => void;
737
748
  /**
738
- * Звонок был завершен
749
+ * Звонок завершён локально. При hangup callback планируется сразу, ровно один раз, без ожидания сети.
750
+ * Доставляется асинхронно; Promise hangup отдельно ждёт известную SDK работу по завершению.
739
751
  */
740
752
  onHangup?: (type: HangupReason | Error, conversationId: string | null) => void;
741
753
  /**
@@ -924,6 +936,13 @@ export type ParamsObject = {
924
936
  * @param bandwidth текущая полоса пропускания, kbps
925
937
  */
926
938
  onVideoSuspendSuggest?: (bandwidth: number, conversationId?: string) => void;
939
+ /**
940
+ * Первое подключение к сигналингу или переподключение успешно применено к состоянию звонка.
941
+ * Звонок зарегистрирован под conversationId, локальное управление доступно, в том числе в зале ожидания.
942
+ * Событие не означает принятие звонка собеседником или готовность WebRTC.
943
+ * Callback вызывается асинхронно; к моменту вызова звонок может уже завершиться.
944
+ */
945
+ onSignalingConnected?: (conversationId: string) => void;
927
946
  /**
928
947
  * Одобрено повышение пользователя в зале ожидания/зале в режиме Audience
929
948
  *
@@ -1007,6 +1026,7 @@ export default abstract class Params {
1007
1026
  static get signalingReconnectDelay(): number;
1008
1027
  static get signalingReconnectMaxDelay(): number;
1009
1028
  static get signalingReconnectMaxCount(): number;
1029
+ static get signalingReconnectMaxDuration(): number;
1010
1030
  static get waitConnectionDelay(): number;
1011
1031
  static get waitResponseDelay(): number;
1012
1032
  static get waitMessageDelay(): number;
@@ -1056,6 +1076,7 @@ export default abstract class Params {
1056
1076
  static get networkStatisticsInterval(): number;
1057
1077
  static get perfStatReportEnabled(): boolean;
1058
1078
  static get callStatReportEnabled(): boolean;
1079
+ static get iceCandidateErrorStatEnabled(): boolean;
1059
1080
  static get enableLogPerfStatReport(): boolean;
1060
1081
  static get asrDataChannel(): boolean;
1061
1082
  static get consumerScreenDataChannelPacketSize(): number;
@@ -1127,6 +1148,7 @@ export default abstract class Params {
1127
1148
  videoSuspend: boolean;
1128
1149
  debugLog: boolean;
1129
1150
  callStatReportEnabled: boolean;
1151
+ iceCandidateErrorStatEnabled: boolean;
1130
1152
  joinFromMultipleDevices: boolean;
1131
1153
  movieShare: boolean;
1132
1154
  clientType: string;
@@ -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
  * До вызова этого метода бесполезно опрашивать другие публичные методы.
@@ -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;
@@ -1,7 +1,8 @@
1
+ import { StatPayload } from '../classes/stat/StatQueue';
1
2
  /**
2
3
  * Событие статистики SDK, которое получает `onClientStats`
3
4
  */
4
- export type ClientStatsEvent = Record<string, string | number | boolean | null> & {
5
+ export type ClientStatsEvent = StatPayload & {
5
6
  /** Имя события из `Stat`. У периодической статистики звонка его нет */
6
7
  name?: string;
7
8
  /** ID звонка, `null` — пока он неизвестен */