@vkontakte/calls-sdk 2.8.13-dev.3b07b09d.0 → 2.8.13-dev.3f06c117.0

package/static/Params.d.ts

@@ -2,6 +2,7 @@ import type { VideoEffects } from '@vkontakte/calls-video-effects';
 import type { EffectVoiceChange, VadControllerOptions, VadLib } from '@vkontakte/calls-audio-effects';
 import type * as Vmoji from '@vkontakte/calls-vmoji';
 import { IAsrData } from '../types/Asr';
+import { ClientStatsEvent } from '../types/ClientStatsEvent';
 import { ConversationData } from '../types/Conversation';
 import HangupReason from '../classes/HangupReason';
 import { MediaTrackKind } from '../classes/MediaSource';
@@ -37,25 +38,23 @@ export type ParamsObject = {
     platform: string;
     /** @hidden */
     clientStatsPlatform: string;
+    /**
+     * Версия приложения-хоста, уходит в статистику и сигналинг, например `'26.31.0:6822'`.
+     * По умолчанию `'0.0.0'`
+     */
+    appVersion: string;
     /**
      * Автоматически запускать отправку клиентской статистики при `init()`.
      *
-     * Если `false`, события звонков продолжают копиться в IndexedDB, но в сеть
-     * не уходят, пока хост не вызовет `startStats()`. Так хост может прогреть
-     * приложение, не нагружая сеть. До старта неактивен и fallback прямой
-     * отправки при недоступном хранилище. Если `startStats()` не вызвать
-     * никогда, очередь дорастёт до лимита и начнёт вытеснять старые звонки.
+     * При `false` события копятся в очереди, но не уходят в сеть, пока хост не
+     * вызовет `startStats()`.
      *
      * _По умолчанию: `true`_
      */
     autoStartStats: boolean;
     /**
-     * Персистентная очередь клиентской статистики.
-     *
-     * Включённая — события копятся в IndexedDB и уезжают пачками с
-     * подтверждением, переживая перезагрузку вкладки. Выключенная возвращает
-     * старую схему: накопление в памяти, отправка раз в три секунды без
-     * подтверждения, всё несохранённое теряется вместе с вкладкой.
+     * Персистентная очередь клиентской статистики: события копятся в IndexedDB
+     * и уезжают пачками с подтверждением, переживая перезагрузку вкладки.
      *
      * _По умолчанию: `false`_
      */
@@ -63,6 +62,8 @@ export type ParamsObject = {
     /** @hidden */
     clientType: string;
     /** @hidden */
+    useSelfExternalUserId: boolean;
+    /** @hidden */
     externalUserType: string;
     /** @hidden */
     device: string;
@@ -116,6 +117,8 @@ export type ParamsObject = {
     /** @hidden */
     signalingReconnectMaxCount: number;
     /** @hidden */
+    signalingReconnectMaxDuration: number;
+    /** @hidden */
     waitConnectionDelay: number;
     /** @hidden */
     waitResponseDelay: number;
@@ -253,6 +256,13 @@ export type ParamsObject = {
     iceRestartWaitTime: number;
     /** @hidden */
     transportConnectionWaitTime: number;
+    /**
+     * Разрешить запрашивать переход на серверную топологию не только звонящему,
+     * но и принимающей стороне, если не удалось восстановить оборвавшееся p2p-соединение
+     *
+     * _По умолчанию: `false`_
+     */
+    switchTopologyOnReconnectFromAnySide: boolean;
     /**
      * Частота получения статистики в миллисекундах
      *
@@ -292,6 +302,13 @@ export type ParamsObject = {
     perfStatReportEnabled: boolean;
     /** @hidden */
     callStatReportEnabled: boolean;
+    /**
+     * Отправлять событие статистики ice_candidate_gathering_failed
+     *
+     * _По умолчанию: `false`_
+     * @hidden
+     */
+    iceCandidateErrorStatEnabled: boolean;
     /**
      * Отдавать приоритет кодеку H264 для исходящего видео
      *
@@ -799,6 +816,12 @@ export type ParamsObject = {
      * Статистика звонка
      */
     onStatistics?: (stats: {}) => void;
+    /**
+     * Событие статистики SDK: те же данные, что уходят в статистику звонков, плюс `vcid` и `ts`
+     *
+     * @param data Данные события
+     */
+    onClientStats?: (data: ClientStatsEvent) => void;
     /**
      * Ошибка воспроизведения звука
      */
@@ -950,7 +973,13 @@ export default abstract class Params {
     static getScreenFrameRate(fastScreenShare: boolean): number;
     static get<N extends keyof ParamsObject>(name: N): ParamsObject[N];
     static get appName(): string;
-    static get appVersion(): number;
+    static get appVersion(): string;
+    /**
+     * Версия клиента для `client_version` в `auth.anonymLogin`. Бэкенд валидирует формат,
+     * поэтому это фиксированное значение, а не версия приложения-хоста (см. {@link Params.appVersion}).
+     * @hidden
+     */
+    static get apiClientVersion(): number;
     static get sdkVersion(): string;
     static get debug(): boolean;
     static get protocolVersion(): 5 | 6;
@@ -962,6 +991,7 @@ export default abstract class Params {
     static get statQueueEnabled(): boolean;
     static get clientType(): string;
     static set clientType(value: string);
+    static get useSelfExternalUserId(): boolean;
     static get externalUserType(): string;
     static set externalUserType(value: string);
     static get device(): string;
@@ -989,6 +1019,7 @@ export default abstract class Params {
     static get signalingReconnectDelay(): number;
     static get signalingReconnectMaxDelay(): number;
     static get signalingReconnectMaxCount(): number;
+    static get signalingReconnectMaxDuration(): number;
     static get waitConnectionDelay(): number;
     static get waitResponseDelay(): number;
     static get waitMessageDelay(): number;
@@ -1032,11 +1063,13 @@ export default abstract class Params {
     };
     static get iceRestartWaitTime(): number;
     static get transportConnectionWaitTime(): number;
+    static get switchTopologyOnReconnectFromAnySide(): boolean;
     static get statisticsInterval(): number;
     static set statisticsInterval(value: number);
     static get networkStatisticsInterval(): number;
     static get perfStatReportEnabled(): boolean;
     static get callStatReportEnabled(): boolean;
+    static get iceCandidateErrorStatEnabled(): boolean;
     static get enableLogPerfStatReport(): boolean;
     static get asrDataChannel(): boolean;
     static get consumerScreenDataChannelPacketSize(): number;
@@ -1108,10 +1141,12 @@ export default abstract class Params {
         videoSuspend: boolean;
         debugLog: boolean;
         callStatReportEnabled: boolean;
+        iceCandidateErrorStatEnabled: boolean;
         joinFromMultipleDevices: boolean;
         movieShare: boolean;
         clientType: string;
         clientStatsPlatform: string;
+        appVersion: string;
         autoStartStats: boolean;
         statQueueEnabled: boolean;
         consumerScreenDataChannelPacketSize: number;

package/static/SessionStore.d.ts

@@ -5,15 +5,9 @@ export type StoredSession = {
     savedAt: number;
 };
 /**
- * Снимки сессий по uid на диске. В памяти сессия текущего пользователя —
- * AuthData; здесь — то, что SDK видел раньше.
- *
- * Это снимок: он может быть протухшим, переавторизовать его извне нельзя.
- * Годится только для отложенных best-effort задач (например, досылка
- * статистики). Живые запросы звонка им подписывать нельзя.
- *
- * Хранится только session_key: секрет сессии транспорту не нужен, а токен
- * хоста незачем — протухший снимок не переавторизуется, а выбрасывается.
+ * Снимки сессий по uid на диске. Снимок может быть протухшим и переавторизации
+ * не подлежит, поэтому годится только для отложенных best-effort задач вроде
+ * досылки статистики.
  */
 export default abstract class SessionStore {
     static remember(uid: number, session: {
@@ -22,14 +16,11 @@ export default abstract class SessionStore {
     }): void;
     static get(uid: number): StoredSession | null;
     static forget(uid: number): void;
-    /** Удаляет записи старше MAX_AGE_MS. */
+    /** Снимок живёт столько же, сколько события, которые он мог бы дослать. */
     static prune(now?: number): void;
     /**
      * Ключ окружения: сессия прода не должна улететь на тестовый кластер.
-     * Синхронный, в отличие от резолва endpoint в транспорте.
-     *
-     * Адрес нормализуется так же, как в транспорте: иначе снимок, сделанный
-     * при apiBaseUrl со слэшем на конце, не совпал бы сам с собой.
+     * Адрес нормализуется так же, как в транспорте.
      */
     static currentEndpoint(): string;
     private static _read;

package/static/SimulcastInfo.d.ts

@@ -4,6 +4,7 @@ export declare const SIMULCAST_DEFAULT: {
     HEIGHT: number;
     WIDTH: number;
     BITRATE: number;
+    FPS: number;
 };
 export declare const SIMULCAST_SCALABILITY_MODE = "L1T2";
 export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;

package/static/WebRTCUtils.d.ts

@@ -17,10 +17,6 @@ export declare enum FacingMode {
      */
     ENVIRONMENT = "environment"
 }
-/**
- * Известные браузеры
- */
-export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
 declare namespace WebRTCUtils {
     /**
      * До вызова этого метода бесполезно опрашивать другие публичные методы.
@@ -118,76 +114,9 @@ declare namespace WebRTCUtils {
      * Возвращает фейковый видео mediaTrack
      */
     function getBlackMediaTrack(width?: number, height?: number): MediaStreamTrack;
-    /**
-     * Проверяет поддержку WebRTC браузером
-     */
-    function isBrowserSupported(): boolean;
-    /**
-     * Возвращает первую отсутствующую capability в стабильном порядке.
-     */
-    function getBrowserSupportFailure(): BrowserSupportFailure | null;
-    /**
-     * Проверяет поддержку шаринга экрана браузером
-     */
-    function isScreenCapturingSupported(): boolean;
-    /**
-     * В некоторых браузерах H264 decoder сломан
-     */
-    function isBrokenH264Decoder(): boolean;
-    /**
-     * В некоторых браузерах VP9 encoder сломан
-     * В симулкасте вп9 енкодер ведет себя некорректно
-     */
-    function isBrokenVP9Encoder(): boolean;
-    /**
-     * В некоторых браузерах VP9 decoder сломан
-     */
-    function isBrokenVP9Decoder(): boolean;
-    /**
-     * Может ли браузер делать H264 приоритетным
-     */
-    function canPreferH264(): boolean;
-    /**
-     * Поддержка simulcast браузером.
-     * Safari корректно поддерживает simulcast начиная с версии 18.
-     * Firefox поддерживает simulcast с VP8 начиная с версии 134.
-     */
-    function isSimulcastSupportedByBrowser(): boolean;
-    /**
-     * Имя операционной системы
-     */
-    function os(): string;
-    /**
-     * Версия операционной системы
-     */
-    function osVersion(): number | null | undefined;
-    /**
-     * Мобильный браузер или нет
-     */
-    function isMobile(): boolean;
-    /**
-     * Имя браузера
-     */
-    function browserName(): BrowserName | string;
-    /**
-     * Версия браузера
-     */
-    function browserVersion(): string;
-    /**
-     * Если браузер основан на хроме - возвращает версию
-     */
-    function baseChromeVersion(): number;
     /**
      * Возвращает AudioContext
      */
     function getAudioContext(): AudioContext;
-    /**
-     * Возвращает подверсию браузера (если она есть)
-     */
-    function browserSubVersion(): string;
-    /**
-     * Браузер поддерживает захват звука при трансляции экрана
-     */
-    function isAudioShareSupported(): boolean;
 }
 export default WebRTCUtils;

package/types/ClientStatsEvent.d.ts

@@ -0,0 +1,12 @@
+import { StatPayload } from '../classes/stat/StatQueue';
+/**
+ * Событие статистики SDK, которое получает `onClientStats`
+ */
+export type ClientStatsEvent = StatPayload & {
+    /** Имя события из `Stat`. У периодической статистики звонка его нет */
+    name?: string;
+    /** ID звонка, `null` — пока он неизвестен */
+    vcid: string | null;
+    /** Время события, мс */
+    ts: number;
+};

package/types/IEventualStatLog.d.ts

@@ -1,6 +1,6 @@
 import Stat from '../enums/Stat';
 export interface IEventualStatLog {
     name: Stat;
-    value?: number | null;
+    value?: number;
     [k: string]: number | string | undefined | null;
 }

package/types/Params.d.ts

@@ -1,2 +1,2 @@
-export type IApiEnv = 'AUTO' | 'PROD' | 'CALLS' | 'PROD_OK' | 'TEST' | 'VIDEOTEST' | 'CALLSTEST' | 'CALLS_BETA' | 'CALLS_BENDER' | 'CALLS_MAMES' | 'CALLS_MARS' | string;
+export type IApiEnv = 'AUTO' | 'PROD' | 'CALLS' | 'PROD_OK' | 'TEST' | 'VIDEOTEST' | 'CALLSTEST' | 'CALLS_BETA' | 'CALLS_BENDER' | 'CALLS_MAMES' | 'CALLS_MARS' | 'CALLS_CHELSEA' | 'CALLS_KERZH' | string;
 export type IAPIBaseUrl = string | null;

package/types/PerfStatReporter.d.ts

@@ -40,8 +40,33 @@ export interface ICallStatLog extends Pick<CallStatReport, 'call_topology' | 'na
     is_simulcast?: boolean;
     concealed_silent_audio_samples?: number;
     concealment_audio_avg_size?: number;
+    /** Потери исходящего видео: 100 * ΣΔpacketsLost / (ΣΔpacketsLost + ΣΔpacketsSent), по парам SSRC со свежим RR */
     video_loss?: number;
+    /** Потери исходящего аудио: 100 * ΣΔpacketsLost / (ΣΔpacketsLost + ΣΔpacketsSent), по парам SSRC со свежим RR */
     audio_loss?: number;
+    /** Потери входящего видео за период, в процентах */
+    in_video_loss?: number;
+    /** Потери входящего аудио за период, в процентах */
+    in_audio_loss?: number;
+    /** Байты, отправленные по исходящим аудио потокам за период, включая шару звука */
+    audio_bytes_sent?: number;
+    /** Уровень исходящего звука в шкале 16-битного PCM, от 0 до 32767 */
+    audio_level?: number;
+    /** Битрейт исходящего видео без ретрансмитов, кибибит/с */
+    br_encode?: number;
+    /** Битрейт отправки видео камеры, кибибит/с */
+    br_transmit?: number;
+    /** Битрейт ретрансмитов видео камеры, кибибит/с */
+    br_retransmit?: number;
+    /** Кадры камеры, закодированные энкодером за период */
+    frames_encoded?: number;
     cpu_hardware_concurrency?: number;
-    [k: string]: string | number | boolean | undefined;
+    audio_tracks?: number;
+    /** Максимум участников за интервал между отправками */
+    participants_max?: number;
+    /** Фичи, включенные в любой момент интервала */
+    active_features?: string[];
+    /** Максимальная площадь окна приложения за интервал, в мегапикселях */
+    app_total_area_mpx_max?: number;
+    [k: string]: string | string[] | number | boolean | undefined;
 }

package/types/SignalingMessage.d.ts

@@ -198,6 +198,7 @@ declare namespace SignalingMessage {
         reason: HangupType;
         errorCode?: string;
         markers?: ParticipantListMarkers;
+        externalId?: ExternalId;
     }
     export interface ClosedConversation extends Notification {
         reason: HangupType;

package/types/Statistics.d.ts

@@ -36,8 +36,14 @@ interface StatRtpOutboundVideo {
     framesSent?: number;
     framesPerSecond?: number;
     targetBitrate?: number;
+    /**
+     * Общее количество кадров, закодированных энкодером
+     */
+    framesEncoded?: number;
 }
 export interface StatRtp extends StatRtpOutboundVideo {
+    /** Время измерения, для remote-inbound-rtp — время получения RTCP Receiver Report */
+    timestamp: number;
     /**
      * Уникальный идентификатор источника синхронизации RTP
      */
@@ -65,6 +71,10 @@ export interface StatRtp extends StatRtpOutboundVideo {
      * Общее количество байтов, отправленных по этому потоку
      */
     bytesSent: number;
+    /**
+     * Общее количество байтов, отправленных повторно (ретрансмиты) по этому потоку
+     */
+    retransmittedBytesSent?: number;
     /**
      * Общее количество байтов заголовков, полученных по этому потоку
      */
@@ -73,6 +83,11 @@ export interface StatRtp extends StatRtpOutboundVideo {
      * Общее количество байтов заголовков, отправленных по этому потоку
      */
     headerBytesSent: number;
+    /**
+     * Уровень звука исходящего аудио потока в момент снятия статистики, от 0 до 1.
+     * Берется из media-source, у входящих потоков его нет.
+     */
+    audioLevel?: number;
     /**
      * Среднее значение джиттера в секундах
      * Джиттер — это вариация задержки в получении пакетов данных.
@@ -81,19 +96,15 @@ export interface StatRtp extends StatRtpOutboundVideo {
     /**
      * Общее количество потерянных пакетов
      */
-    packetsLost: number;
+    packetsLost?: number;
     /**
      * Общее количество полученных пакетов
      */
-    packetsReceived: number;
+    packetsReceived?: number;
     /**
      * Общее количество отправленных пакетов
      */
-    packetsSent: number;
-    /**
-     * Доля потерянных пакетов
-     */
-    fractionLost: number;
+    packetsSent?: number;
     /**
      * Количество Picture Loss Indication (PLI) сообщений
      * PLI — это сообщения, указывающие на потерю кадров изображения.
@@ -113,6 +124,10 @@ export interface StatRtp extends StatRtpOutboundVideo {
      * Идентификатор пользователя, связанный с этим потоком
      */
     userId?: string;
+    /**
+     * Поток демонстрации экрана (быстрая шара), а не камеры
+     */
+    isScreenShare?: boolean;
     /**
      * Пропускная способность в битах в секунду
      */