@vkontakte/calls-sdk 2.8.13-dev.af6936c9.0 → 2.8.13-dev.b18b02e0.0

package/types/FastHangup.d.ts

@@ -34,13 +34,15 @@ export interface FastHangupResponse {
  *
  * `reason` и `conversationId` идут в signaling hangup.
  * `onFastHangup` заменяет Calls API `vchat.hangupConversation`, если обработчик передан
- * (явный hangup/decline или delayed hangup во время init).
- * Если обработчик не передан, API hangup не вызывается — кроме закрытия вкладки (`pagehide`),
- * где SDK всегда шлёт beacon, и delayed hangup без handler.
+ * (явный hangup/decline, включая отмену инициализации).
+ * При `hangup` без обработчика SDK отправляет Calls API beacon, если серверный ID уже известен.
+ * При `declineCall` без обработчика остаётся только signaling hangup.
+ * На закрытии вкладки (`pagehide`) SDK всегда использует beacon вместо обработчика.
  */
 export interface HangupParams {
     /**
-     * ID звонка. Если опущен — завершается текущий активный звонок.
+     * Текущий или исходный ID для локального hangup; declineCall требует текущий ID готового звонка.
+     * Без ID: активный готовый, затем первый готовый, а для hangup — также единственный готовящийся звонок.
      */
     conversationId?: string;
     /**
@@ -61,6 +63,6 @@ export interface HangupParams {
  * На `pagehide` не используется — SDK всегда отправляет `sendBeacon`.
  *
  * @param params Параметры запроса
- * @param signal AbortSignal текущего звонка, если он ещё жив на момент вызова
+ * @param signal При `hangup` — отдельный AbortSignal завершения, при `declineCall` — сигнал текущего звонка, если он есть
  */
 export type FastHangupHandler = (params: FastHangupParams, signal?: AbortSignal) => Promise<FastHangupResponse>;

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