@vkontakte/calls-sdk 2.8.13-dev.7195a780.0 → 2.8.13-dev.7452edd3.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 (68) hide show
  1. package/CallsSDK.d.ts +40 -14
  2. package/abstract/BaseApi.d.ts +21 -19
  3. package/calls-sdk.cjs.js +7 -7
  4. package/calls-sdk.esm.js +5075 -3335
  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/ExternalIdCache.d.ts +9 -13
  9. package/classes/MediaSource.d.ts +11 -2
  10. package/classes/SpecListener.d.ts +2 -2
  11. package/classes/StatsLogger.d.ts +1 -1
  12. package/classes/VolumesDetector.d.ts +0 -1
  13. package/classes/codec/LibVPxDecoder.d.ts +2 -2
  14. package/classes/codec/LibVPxEncoder.d.ts +2 -2
  15. package/classes/codec/WebCodecsDecoder.d.ts +2 -2
  16. package/classes/codec/WebCodecsEncoder.d.ts +2 -2
  17. package/classes/codec/WorkerBase.d.ts +3 -3
  18. package/classes/conversation/Conversation.d.ts +36 -11
  19. package/classes/conversation/Conversation.testUtils.d.ts +3 -0
  20. package/classes/conversation/DisplayLayoutRequester.d.ts +3 -1
  21. package/classes/screenshare/ScreenCaptureReceiver.d.ts +2 -2
  22. package/classes/screenshare/ScreenCaptureSender.d.ts +2 -2
  23. package/classes/screenshare/StreamBuilder.d.ts +3 -2
  24. package/classes/stat/ApiCallStats.d.ts +12 -0
  25. package/classes/stat/BatteryStats.d.ts +25 -0
  26. package/classes/stat/CallLifecycleStats.d.ts +7 -2
  27. package/classes/stat/CallStatTail.d.ts +76 -0
  28. package/classes/stat/ClientResourceStats.d.ts +41 -0
  29. package/classes/stat/CodecStatsAggregator.d.ts +5 -2
  30. package/classes/stat/ConversationStats.d.ts +24 -3
  31. package/classes/stat/NetworkAdaptationStats.d.ts +35 -0
  32. package/classes/stat/PeerConnectionStats.d.ts +22 -0
  33. package/classes/stat/SdpStats.d.ts +40 -0
  34. package/classes/stat/Stat.testUtils.d.ts +17 -0
  35. package/classes/stat/StatAggregator.d.ts +12 -3
  36. package/classes/stat/StatClock.d.ts +28 -0
  37. package/classes/stat/StatDrainScheduler.d.ts +113 -0
  38. package/classes/stat/StatEventCollector.d.ts +57 -0
  39. package/classes/stat/StatPings.d.ts +6 -2
  40. package/classes/stat/StatQueue.d.ts +119 -0
  41. package/classes/stat/StatSignalingCommands.d.ts +4 -2
  42. package/classes/transport/DirectTransport.d.ts +13 -2
  43. package/classes/transport/PerfStatReporter.d.ts +7 -1
  44. package/classes/transport/ServerTransport.d.ts +6 -2
  45. package/classes/transport/SimulcastSender.d.ts +2 -2
  46. package/classes/transport/Transport.d.ts +2 -2
  47. package/default/Api.d.ts +21 -11
  48. package/default/Signaling.d.ts +11 -3
  49. package/default/SignalingTransport.d.ts +5 -1
  50. package/enums/ActiveFeature.d.ts +19 -0
  51. package/enums/SessionError.d.ts +10 -0
  52. package/enums/Stat.d.ts +26 -1
  53. package/package.json +1 -1
  54. package/static/ApiTransport.d.ts +4 -0
  55. package/static/AuthData.d.ts +11 -1
  56. package/static/BrowserEnvironment.d.ts +90 -0
  57. package/static/External.d.ts +21 -0
  58. package/static/Params.d.ts +79 -3
  59. package/static/SessionStore.d.ts +29 -0
  60. package/static/SimulcastInfo.d.ts +1 -0
  61. package/static/WebRTCUtils.d.ts +5 -76
  62. package/types/ClientStatsEvent.d.ts +12 -0
  63. package/types/FastHangup.d.ts +7 -5
  64. package/types/IEventualStatLog.d.ts +1 -1
  65. package/types/Params.d.ts +1 -1
  66. package/types/PerfStatReporter.d.ts +26 -1
  67. package/types/SignalingMessage.d.ts +1 -0
  68. package/types/Statistics.d.ts +22 -7
@@ -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
  *
@@ -638,5 +649,15 @@ declare namespace External {
638
649
  * Собеседник подключился к сигналлингу
639
650
  */
640
651
  function onPeerRegistered(conversationId?: string, externalIds?: ExternalId[]): void;
652
+ /**
653
+ * SDK обнаружил ошибку, после которой звонок может продолжаться.
654
+ *
655
+ * Callback предназначен для отправки ошибки в клиентский мониторинг.
656
+ * Его вызов не означает завершение звонка.
657
+ *
658
+ * @param error
659
+ * @param conversationId ID звонка
660
+ */
661
+ function onNonFatalError(error: Error, conversationId: string | null): void;
641
662
  }
642
663
  export default External;
@@ -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';
@@ -37,6 +38,27 @@ export type ParamsObject = {
37
38
  platform: string;
38
39
  /** @hidden */
39
40
  clientStatsPlatform: string;
41
+ /**
42
+ * Версия приложения-хоста, уходит в статистику и сигналинг, например `'26.31.0:6822'`.
43
+ * По умолчанию `'0.0.0'`
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;
40
62
  /** @hidden */
41
63
  clientType: string;
42
64
  /** @hidden */
@@ -93,6 +115,8 @@ export type ParamsObject = {
93
115
  /** @hidden */
94
116
  signalingReconnectMaxCount: number;
95
117
  /** @hidden */
118
+ signalingReconnectMaxDuration: number;
119
+ /** @hidden */
96
120
  waitConnectionDelay: number;
97
121
  /** @hidden */
98
122
  waitResponseDelay: number;
@@ -230,6 +254,13 @@ export type ParamsObject = {
230
254
  iceRestartWaitTime: number;
231
255
  /** @hidden */
232
256
  transportConnectionWaitTime: number;
257
+ /**
258
+ * Разрешить запрашивать переход на серверную топологию не только звонящему,
259
+ * но и принимающей стороне, если не удалось восстановить оборвавшееся p2p-соединение
260
+ *
261
+ * _По умолчанию: `false`_
262
+ */
263
+ switchTopologyOnReconnectFromAnySide: boolean;
233
264
  /**
234
265
  * Частота получения статистики в миллисекундах
235
266
  *
@@ -269,6 +300,13 @@ export type ParamsObject = {
269
300
  perfStatReportEnabled: boolean;
270
301
  /** @hidden */
271
302
  callStatReportEnabled: boolean;
303
+ /**
304
+ * Отправлять событие статистики ice_candidate_gathering_failed
305
+ *
306
+ * _По умолчанию: `false`_
307
+ * @hidden
308
+ */
309
+ iceCandidateErrorStatEnabled: boolean;
272
310
  /**
273
311
  * Отдавать приоритет кодеку H264 для исходящего видео
274
312
  *
@@ -524,7 +562,9 @@ export type ParamsObject = {
524
562
  */
525
563
  forwardEmptyIceCandidate: boolean;
526
564
  /**
527
- * Получен локальный стрим с камеры/микрофона
565
+ * Получен локальный стрим с камеры/микрофона, в том числе до подключения сигналинга.
566
+ * Повторяется после изменения видео (включение, выключение, смена камеры).
567
+ * Повторное событие может содержать тот же MediaStream с обновлёнными треками.
528
568
  */
529
569
  onLocalStream?: (stream: MediaStream | null, mediaSettings: MediaSettings, conversationId?: string) => void;
530
570
  /**
@@ -706,7 +746,8 @@ export type ParamsObject = {
706
746
  onLocalVolume?: (volume: number, isMicEnabled: boolean) => void;
707
747
  onJoinStatus?: (available: boolean, chatId: string, conversationId?: string) => void;
708
748
  /**
709
- * Звонок был завершен
749
+ * Звонок завершён локально. При hangup callback планируется сразу, ровно один раз, без ожидания сети.
750
+ * Доставляется асинхронно; Promise hangup отдельно ждёт известную SDK работу по завершению.
710
751
  */
711
752
  onHangup?: (type: HangupReason | Error, conversationId: string | null) => void;
712
753
  /**
@@ -776,6 +817,12 @@ export type ParamsObject = {
776
817
  * Статистика звонка
777
818
  */
778
819
  onStatistics?: (stats: {}) => void;
820
+ /**
821
+ * Событие статистики SDK: те же данные, что уходят в статистику звонков, плюс `vcid` и `ts`
822
+ *
823
+ * @param data Данные события
824
+ */
825
+ onClientStats?: (data: ClientStatsEvent) => void;
779
826
  /**
780
827
  * Ошибка воспроизведения звука
781
828
  */
@@ -889,6 +936,13 @@ export type ParamsObject = {
889
936
  * @param bandwidth текущая полоса пропускания, kbps
890
937
  */
891
938
  onVideoSuspendSuggest?: (bandwidth: number, conversationId?: string) => void;
939
+ /**
940
+ * Первое подключение к сигналингу или переподключение успешно применено к состоянию звонка.
941
+ * Звонок зарегистрирован под conversationId, локальное управление доступно, в том числе в зале ожидания.
942
+ * Событие не означает принятие звонка собеседником или готовность WebRTC.
943
+ * Callback вызывается асинхронно; к моменту вызова звонок может уже завершиться.
944
+ */
945
+ onSignalingConnected?: (conversationId: string) => void;
892
946
  /**
893
947
  * Одобрено повышение пользователя в зале ожидания/зале в режиме Audience
894
948
  *
@@ -911,6 +965,13 @@ export type ParamsObject = {
911
965
  * Собеседник подключился к сигналлингу
912
966
  */
913
967
  onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
968
+ /**
969
+ * SDK обнаружил ошибку, после которой звонок может продолжаться.
970
+ *
971
+ * Callback предназначен для отправки ошибки в клиентский мониторинг.
972
+ * Его вызов не означает завершение звонка.
973
+ */
974
+ onNonFatalError?: (error: Error, conversationId: string | null) => void;
914
975
  };
915
976
  export default abstract class Params {
916
977
  private static _params;
@@ -920,7 +981,13 @@ export default abstract class Params {
920
981
  static getScreenFrameRate(fastScreenShare: boolean): number;
921
982
  static get<N extends keyof ParamsObject>(name: N): ParamsObject[N];
922
983
  static get appName(): string;
923
- static get appVersion(): number;
984
+ static get appVersion(): string;
985
+ /**
986
+ * Версия клиента для `client_version` в `auth.anonymLogin`. Бэкенд валидирует формат,
987
+ * поэтому это фиксированное значение, а не версия приложения-хоста (см. {@link Params.appVersion}).
988
+ * @hidden
989
+ */
990
+ static get apiClientVersion(): number;
924
991
  static get sdkVersion(): string;
925
992
  static get debug(): boolean;
926
993
  static get protocolVersion(): 5 | 6;
@@ -928,6 +995,8 @@ export default abstract class Params {
928
995
  static set platform(value: string);
929
996
  static get clientStatsPlatform(): string;
930
997
  static set clientStatsPlatform(value: string);
998
+ static get autoStartStats(): boolean;
999
+ static get statQueueEnabled(): boolean;
931
1000
  static get clientType(): string;
932
1001
  static set clientType(value: string);
933
1002
  static get externalUserType(): string;
@@ -957,6 +1026,7 @@ export default abstract class Params {
957
1026
  static get signalingReconnectDelay(): number;
958
1027
  static get signalingReconnectMaxDelay(): number;
959
1028
  static get signalingReconnectMaxCount(): number;
1029
+ static get signalingReconnectMaxDuration(): number;
960
1030
  static get waitConnectionDelay(): number;
961
1031
  static get waitResponseDelay(): number;
962
1032
  static get waitMessageDelay(): number;
@@ -1000,11 +1070,13 @@ export default abstract class Params {
1000
1070
  };
1001
1071
  static get iceRestartWaitTime(): number;
1002
1072
  static get transportConnectionWaitTime(): number;
1073
+ static get switchTopologyOnReconnectFromAnySide(): boolean;
1003
1074
  static get statisticsInterval(): number;
1004
1075
  static set statisticsInterval(value: number);
1005
1076
  static get networkStatisticsInterval(): number;
1006
1077
  static get perfStatReportEnabled(): boolean;
1007
1078
  static get callStatReportEnabled(): boolean;
1079
+ static get iceCandidateErrorStatEnabled(): boolean;
1008
1080
  static get enableLogPerfStatReport(): boolean;
1009
1081
  static get asrDataChannel(): boolean;
1010
1082
  static get consumerScreenDataChannelPacketSize(): number;
@@ -1076,10 +1148,14 @@ export default abstract class Params {
1076
1148
  videoSuspend: boolean;
1077
1149
  debugLog: boolean;
1078
1150
  callStatReportEnabled: boolean;
1151
+ iceCandidateErrorStatEnabled: boolean;
1079
1152
  joinFromMultipleDevices: boolean;
1080
1153
  movieShare: boolean;
1081
1154
  clientType: string;
1082
1155
  clientStatsPlatform: string;
1156
+ appVersion: string;
1157
+ autoStartStats: boolean;
1158
+ statQueueEnabled: boolean;
1083
1159
  consumerScreenDataChannelPacketSize: number;
1084
1160
  switchVideoAtBadNetwork: boolean;
1085
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
+ };
@@ -34,13 +34,15 @@ export interface FastHangupResponse {
34
34
  *
35
35
  * `reason` и `conversationId` идут в signaling hangup.
36
36
  * `onFastHangup` заменяет Calls API `vchat.hangupConversation`, если обработчик передан
37
- * (явный hangup/decline или delayed hangup во время init).
38
- * Если обработчик не передан, API hangup не вызывается — кроме закрытия вкладки (`pagehide`),
39
- * где SDK всегда шлёт beacon, и delayed hangup без handler.
37
+ * (явный hangup/decline, включая отмену инициализации).
38
+ * При `hangup` без обработчика SDK отправляет Calls API beacon, если серверный ID уже известен.
39
+ * При `declineCall` без обработчика остаётся только signaling hangup.
40
+ * На закрытии вкладки (`pagehide`) SDK всегда использует beacon вместо обработчика.
40
41
  */
41
42
  export interface HangupParams {
42
43
  /**
43
- * ID звонка. Если опущен — завершается текущий активный звонок.
44
+ * Текущий или исходный ID для локального hangup; declineCall требует текущий ID готового звонка.
45
+ * Без ID: активный готовый, затем первый готовый, а для hangup — также единственный готовящийся звонок.
44
46
  */
45
47
  conversationId?: string;
46
48
  /**
@@ -61,6 +63,6 @@ export interface HangupParams {
61
63
  * На `pagehide` не используется — SDK всегда отправляет `sendBeacon`.
62
64
  *
63
65
  * @param params Параметры запроса
64
- * @param signal AbortSignal текущего звонка, если он ещё жив на момент вызова
66
+ * @param signal При `hangup` — отдельный AbortSignal завершения, при `declineCall` — сигнал текущего звонка, если он есть
65
67
  */
66
68
  export type FastHangupHandler = (params: FastHangupParams, signal?: AbortSignal) => Promise<FastHangupResponse>;
@@ -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
  }
package/types/Params.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export type IApiEnv = 'AUTO' | 'PROD' | 'CALLS' | 'PROD_OK' | 'TEST' | 'VIDEOTEST' | 'CALLSTEST' | 'CALLS_BETA' | 'CALLS_BENDER' | 'CALLS_MAMES' | 'CALLS_MARS' | string;
1
+ export type IApiEnv = 'AUTO' | 'PROD' | 'CALLS' | 'PROD_OK' | 'TEST' | 'VIDEOTEST' | 'CALLSTEST' | 'CALLS_BETA' | 'CALLS_BENDER' | 'CALLS_MAMES' | 'CALLS_MARS' | 'CALLS_CHELSEA' | 'CALLS_KERZH' | string;
2
2
  export type IAPIBaseUrl = string | null;
@@ -40,8 +40,33 @@ export interface ICallStatLog extends Pick<CallStatReport, 'call_topology' | 'na
40
40
  is_simulcast?: boolean;
41
41
  concealed_silent_audio_samples?: number;
42
42
  concealment_audio_avg_size?: number;
43
+ /** Потери исходящего видео: 100 * ΣΔpacketsLost / (ΣΔpacketsLost + ΣΔpacketsSent), по парам SSRC со свежим RR */
43
44
  video_loss?: number;
45
+ /** Потери исходящего аудио: 100 * ΣΔpacketsLost / (ΣΔpacketsLost + ΣΔpacketsSent), по парам SSRC со свежим RR */
44
46
  audio_loss?: number;
47
+ /** Потери входящего видео за период, в процентах */
48
+ in_video_loss?: number;
49
+ /** Потери входящего аудио за период, в процентах */
50
+ in_audio_loss?: number;
51
+ /** Байты, отправленные по исходящим аудио потокам за период, включая шару звука */
52
+ audio_bytes_sent?: number;
53
+ /** Уровень исходящего звука в шкале 16-битного PCM, от 0 до 32767 */
54
+ audio_level?: number;
55
+ /** Битрейт исходящего видео без ретрансмитов, кибибит/с */
56
+ br_encode?: number;
57
+ /** Битрейт отправки видео камеры, кибибит/с */
58
+ br_transmit?: number;
59
+ /** Битрейт ретрансмитов видео камеры, кибибит/с */
60
+ br_retransmit?: number;
61
+ /** Кадры камеры, закодированные энкодером за период */
62
+ frames_encoded?: number;
45
63
  cpu_hardware_concurrency?: number;
46
- [k: string]: string | number | boolean | undefined;
64
+ audio_tracks?: number;
65
+ /** Максимум участников за интервал между отправками */
66
+ participants_max?: number;
67
+ /** Фичи, включенные в любой момент интервала */
68
+ active_features?: string[];
69
+ /** Максимальная площадь окна приложения за интервал, в мегапикселях */
70
+ app_total_area_mpx_max?: number;
71
+ [k: string]: string | string[] | number | boolean | undefined;
47
72
  }
@@ -198,6 +198,7 @@ declare namespace SignalingMessage {
198
198
  reason: HangupType;
199
199
  errorCode?: string;
200
200
  markers?: ParticipantListMarkers;
201
+ externalId?: ExternalId;
201
202
  }
202
203
  export interface ClosedConversation extends Notification {
203
204
  reason: HangupType;
@@ -36,8 +36,14 @@ interface StatRtpOutboundVideo {
36
36
  framesSent?: number;
37
37
  framesPerSecond?: number;
38
38
  targetBitrate?: number;
39
+ /**
40
+ * Общее количество кадров, закодированных энкодером
41
+ */
42
+ framesEncoded?: number;
39
43
  }
40
44
  export interface StatRtp extends StatRtpOutboundVideo {
45
+ /** Время измерения, для remote-inbound-rtp — время получения RTCP Receiver Report */
46
+ timestamp: number;
41
47
  /**
42
48
  * Уникальный идентификатор источника синхронизации RTP
43
49
  */
@@ -65,6 +71,10 @@ export interface StatRtp extends StatRtpOutboundVideo {
65
71
  * Общее количество байтов, отправленных по этому потоку
66
72
  */
67
73
  bytesSent: number;
74
+ /**
75
+ * Общее количество байтов, отправленных повторно (ретрансмиты) по этому потоку
76
+ */
77
+ retransmittedBytesSent?: number;
68
78
  /**
69
79
  * Общее количество байтов заголовков, полученных по этому потоку
70
80
  */
@@ -73,6 +83,11 @@ export interface StatRtp extends StatRtpOutboundVideo {
73
83
  * Общее количество байтов заголовков, отправленных по этому потоку
74
84
  */
75
85
  headerBytesSent: number;
86
+ /**
87
+ * Уровень звука исходящего аудио потока в момент снятия статистики, от 0 до 1.
88
+ * Берется из media-source, у входящих потоков его нет.
89
+ */
90
+ audioLevel?: number;
76
91
  /**
77
92
  * Среднее значение джиттера в секундах
78
93
  * Джиттер — это вариация задержки в получении пакетов данных.
@@ -81,19 +96,15 @@ export interface StatRtp extends StatRtpOutboundVideo {
81
96
  /**
82
97
  * Общее количество потерянных пакетов
83
98
  */
84
- packetsLost: number;
99
+ packetsLost?: number;
85
100
  /**
86
101
  * Общее количество полученных пакетов
87
102
  */
88
- packetsReceived: number;
103
+ packetsReceived?: number;
89
104
  /**
90
105
  * Общее количество отправленных пакетов
91
106
  */
92
- packetsSent: number;
93
- /**
94
- * Доля потерянных пакетов
95
- */
96
- fractionLost: number;
107
+ packetsSent?: number;
97
108
  /**
98
109
  * Количество Picture Loss Indication (PLI) сообщений
99
110
  * PLI — это сообщения, указывающие на потерю кадров изображения.
@@ -113,6 +124,10 @@ export interface StatRtp extends StatRtpOutboundVideo {
113
124
  * Идентификатор пользователя, связанный с этим потоком
114
125
  */
115
126
  userId?: string;
127
+ /**
128
+ * Поток демонстрации экрана (быстрая шара), а не камеры
129
+ */
130
+ isScreenShare?: boolean;
116
131
  /**
117
132
  * Пропускная способность в битах в секунду
118
133
  */