@vkontakte/calls-sdk 2.8.13-dev.48bea36c.0 → 2.8.13-dev.49da331a.0

package/enums/ActiveFeature.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Фичи, активные во время звонка. Уходят в метрику active_features,
+ * чтобы по ним разрезать остальную статистику: сколько фризов при включённой камере,
+ * какой битрейт при шаре и так далее.
+ *
+ * Здесь только то, что реально включено прямо сейчас, а не то, что разрешено настройками:
+ * иначе фича попадала бы в метрику у всех, кому ее просто не запретили.
+ *
+ * Сервер принимает только имена из своего списка, незнакомые отбрасывает с ошибкой.
+ * Новое имя добавляем сюда после того, как его добавят на сервере.
+ */
+declare enum ActiveFeature {
+    MICROPHONE = "MICROPHONE",
+    CAMERA = "CAMERA",
+    /** Любая шара экрана, в том числе быстрая */
+    SCREEN = "SCREEN",
+    ANIMOJI = "ANIMOJI"
+}
+export default ActiveFeature;

package/enums/Stat.d.ts

@@ -37,6 +37,8 @@ declare enum Stat {
     SDP_SET_REMOTE_ROLLBACK = "sdp_set_remote_rollback",
     SDP_GENERATED = "sdp_generated",
     SDP_RECEIVED = "sdp_received",
+    CLIENT_REQUESTED_SERVER_TOPOLOGY = "client_requested_server_topology",
+    VIDEO_ENCODER_CHANGED_BY_NETWORK_ADAPTER = "video_encoder_changed_by_network_adapter",
     WEBSOCKET_CONNECTED = "websocket_connected",
     WEBSOCKET_RECONNECTED = "websocket_reconnected",
     WEBSOCKET_FAILED_PINGS = "websocket_failed_pings",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.13-dev.48bea36c.0",
+  "version": "2.8.13-dev.49da331a.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/AuthData.d.ts

@@ -1,9 +1,16 @@
-import type { OkUserId } from '../types/Participant';
+import type { ExternalParticipantId } from '../types/ExternalId';
+import type { OkUserId, ParticipantId } from '../types/Participant';
+/** Свой участник и его внешний id */
+export type SelfExternalId = {
+    participantId: ParticipantId;
+    externalId: ExternalParticipantId;
+};
 export default abstract class AuthData {
     private static _sessionKey;
     private static _sessionSecretKey;
     private static _accessToken;
     private static _userId;
+    private static _selfExternalId;
     private static _reauthorizePromise;
     static get sessionKey(): string | undefined;
     static set sessionKey(value: string | undefined);
@@ -13,6 +20,9 @@ export default abstract class AuthData {
     static set accessToken(value: string | undefined);
     static get userId(): OkUserId | null;
     static set userId(value: OkUserId | null);
+    /** Свой участник и его внешний id из ответа auth.anonymLogin */
+    static get selfExternalId(): SelfExternalId | null;
+    static set selfExternalId(value: SelfExternalId | null);
     static isEmpty(): boolean;
     /**
      * Дедуплицирует одновременные попытки реавторизации из разных инстансов Api.

package/static/BrowserEnvironment.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Определение браузера, операционной системы и доступных возможностей.
+ */
+/**
+ * Известные браузеры
+ */
+export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
+declare namespace BrowserEnvironment {
+    /**
+     * Получение и кэширование версии операционной системы
+     */
+    function initOsVersion(warn: (...args: any[]) => void): Promise<void>;
+    /**
+     * Проверяет поддержку WebRTC браузером
+     */
+    function isBrowserSupported(): boolean;
+    /**
+     * Возвращает первую отсутствующую capability в стабильном порядке.
+     */
+    function getBrowserSupportFailure(): BrowserSupportFailure | null;
+    /**
+     * Проверяет поддержку шаринга экрана браузером
+     */
+    function isScreenCapturingSupported(): boolean;
+    /**
+     * Проверяет поддержку выбора микрофона браузером, независимо от списка устройств и разрешений.
+     * Доступен до init, не запрашивает разрешения и не захватывает медиа.
+     */
+    function canSelectAudioInput(): boolean;
+    /**
+     * Проверяет поддержку выбора аудиовыхода браузером, независимо от списка устройств и разрешений.
+     * Доступен до init, не запрашивает разрешения и не меняет аудиовыход.
+     */
+    function canSelectAudioOutput(): boolean;
+    /**
+     * В некоторых браузерах H264 decoder сломан
+     */
+    function isBrokenH264Decoder(): boolean;
+    /**
+     * В некоторых браузерах VP9 encoder сломан
+     */
+    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;
+    /**
+     * Возвращает подверсию браузера (если она есть)
+     */
+    function browserSubVersion(): string;
+    /**
+     * Браузер поддерживает захват звука при трансляции экрана
+     */
+    function isAudioShareSupported(): boolean;
+}
+export default BrowserEnvironment;

package/static/External.d.ts

@@ -515,13 +515,11 @@ declare namespace External {
      */
     function onStatistics(connection: StatResult, memory: Record<string, number>): void;
     /**
-     * Событие статистики SDK, асинхронное
+     * Событие статистики SDK
      *
      * @param data Данные события с `vcid` и `ts`
      */
     function onClientStats(data: ClientStatsEvent): void;
-    /** Синхронно сообщает хосту непериодическое событие до уничтожения звонка. */
-    function onStatsEvent(event: ClientStatsEvent): void;
     /**
      * Ошибка воспроизведения звука
      */

package/static/Params.d.ts

@@ -820,8 +820,6 @@ export type ParamsObject = {
      * @param data Данные события
      */
     onClientStats?: (data: ClientStatsEvent) => void;
-    /** Получено событие статистики SDK. */
-    onStatsEvent?: (event: ClientStatsEvent) => void;
     /**
      * Ошибка воспроизведения звука
      */

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/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;
     /**
      * Пропускная способность в битах в секунду
      */

package/classes/stat/StatUnloadJournal.d.ts

@@ -1,27 +0,0 @@
-import { StatQueueEntry } from './StatQueue';
-/**
- * Синхронный журнал умирающей вкладки поверх localStorage: транзакция
- * IndexedDB из pagehide не успевает закоммититься. Следующий старт SDK
- * переносит журнал в очередь. Ключ уникален на вкладку.
- */
-export default abstract class StatUnloadJournal {
-    private static _tabKey;
-    private static _entries;
-    /**
-     * Открывает новый журнал для этой вкладки. Без сброса пережившая pagehide
-     * вкладка записала бы во второй журнал уже перенесённые события.
-     */
-    static beginTabSession(): void;
-    static writeSync(entry: StatQueueEntry): boolean;
-    /**
-     * Переносит журналы всех закрытых вкладок в очередь. Журнал стирается
-     * независимо от исхода: повторные попытки дали бы дубли.
-     *
-     * @returns число перенесённых событий.
-     */
-    static drainToQueue(): Promise<number>;
-    /** Читает журнал и сразу удаляет его. null — ключа уже нет или хранилище недоступно. */
-    private static _take;
-    private static _storage;
-    private static _isValidEntry;
-}