@vkontakte/calls-sdk 2.8.6-dev.7a7707c0.0 → 2.8.6-dev.97c05c29.0

package/classes/Conversation.d.ts

@@ -78,13 +78,15 @@ export default class Conversation extends EventEmitter {
     private _onJoinPart2;
     private _extractExternalRooms;
     private _extractExternalRoomsData;
-    onPush(conversationId: string, type?: UserType, peerId?: number): Promise<void>;
+    onPush(conversationId: string, type?: UserType, peerId?: number, conversationParams?: string): Promise<void>;
     private _isInWaitingHall;
     private _isRestricted;
     private _isAudienceMode;
     private _isAudienceModeListener;
     private _acceptConcurrent;
     private _getMainRoomParticipants;
+    private _decodeExternalConversationParams;
+    private _logCallStartEvent;
     accept(mediaOptions: MediaOption[]): Promise<ConversationData>;
     decline(): Promise<void>;
     hangup(): Promise<void>;
@@ -96,6 +98,7 @@ export default class Conversation extends EventEmitter {
     private _close;
     destroy(): void;
     private _getConversationParams;
+    private _setConversationParams;
     private _addGeoParamsToEndpoint;
     /**
      * @throws ErrorEvent

package/classes/stat/CodecStatsAggregator.d.ts

@@ -0,0 +1,19 @@
+import { StatItem } from '../../types/Statistics';
+import { TransportTopology } from '../transport/Transport';
+export type CodecKind = 'audio' | 'video';
+/**
+ * Собирает стату по использованию кодеков в webrtc
+ * Каждый раз когда обновляется кодек или завершается звонок,
+ * отправляется репорт об использовании кодеков
+ */
+export declare class CodecStatsAggregator {
+    private static _instance;
+    private readonly _codecUsages;
+    private getCurrentTransportTopology;
+    static create(getCurrentTransportTopology: () => TransportTopology | undefined): void;
+    static reportUsage(stat: StatItem): void;
+    private saveUsage;
+    private report;
+    static destroy(): void;
+    private _destroy;
+}

package/classes/stat/EventMetricsService.d.ts

@@ -0,0 +1,9 @@
+import HangupReason from '../HangupReason';
+import { TransportTopology } from '../transport/Transport';
+/**
+ * Класс для работы с событийными метриками, обертка для правильной отправки событий
+ */
+export declare class EventMetricsService {
+    private static correctHangupReason;
+    static sendHangupEvent(reason: HangupReason, topology?: TransportTopology): void;
+}

package/enums/Stat.d.ts

@@ -7,6 +7,7 @@ declare const enum Stat {
     ICE_RESTART = "callIceRestart",
     PUSH = "callPush",
     OUTGOING_CALL = "callStart",
+    CALL_FINISH = "call_finish",
     OUTGOING_MULTIPARTY_CALL = "callStartMultiparty",
     JOIN_CONVERSATION = "callJoinConversation",
     ACCEPTED_OUTGOING = "callAcceptedOutgoing",
@@ -14,6 +15,7 @@ declare const enum Stat {
     DECLINE_INCOMING = "callDeclineIncoming",
     ACCEPT_CONCURRENT = "callAcceptConcurrent",
     HANGUP = "callHangup",
+    CODEC_USAGE = "codec_usage",
     MEDIA_STATUS = "callMediaStatus",
     DEVICE_CHANGED = "callDeviceChanged",
     SOCKET_ACTION = "callSocketAction",
@@ -35,6 +37,7 @@ declare const enum Stat {
     FIRST_MEDIA_RECEIVED = "first_media_received",
     CALL_EVENTUAL_STAT = "callEventualStat",
     CALL_DECLINED_OR_HANGED_LOCALLY = "CallDeclinedOrHangedLocally",
-    USER_FEEDBACK_RECEIVED = "UserFeedbackReceived"
+    USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
+    CALL_START = "call_start"
 }
 export default Stat;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.6-dev.7a7707c0.0",
+  "version": "2.8.6-dev.97c05c29.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -22,5 +22,8 @@
     "messagepack": "1.1.12",
     "simple-ebml-builder": "0.2.2",
     "webrtc-adapter": "7.7.0"
-  }
+  },
+  "workspaces": [
+    "workspaces/sandbox"
+  ]
 }

package/static/Params.d.ts

@@ -849,6 +849,12 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     simulcast: boolean;
+    /**
+     * Не запрашивать conversation params при входе в звонок
+     *
+     * _По умолчанию: `false`_
+     */
+    skipConversationParams?: boolean;
 };
 export default abstract class Params {
     private static _params;
@@ -978,6 +984,7 @@ export default abstract class Params {
     static get enableVideoEffectsFpsDegradation(): boolean;
     static get simulcast(): boolean;
     static set simulcast(value: boolean);
+    static get skipConversationParams(): boolean | undefined;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;

package/types/ConversationParams.d.ts

@@ -10,6 +10,17 @@ type ConversationParams = {
     isp_as_org?: string;
     loc_cc?: string;
     loc_reg?: string;
-    external_user_type: string;
+    external_user_type?: string;
+};
+export type ExternalConversationParams = {
+    et: number;
+    iv: boolean;
+    srcp: string;
+    stne: string;
+    tkn: string;
+    trne: string;
+    trnp: string;
+    trnu: string;
+    wse: string;
 };
 export default ConversationParams;

package/types/ConversationResponse.d.ts

@@ -1,4 +1,5 @@
 import HangupType from '../enums/HangupType';
+import IceServer from './IceServer';
 /**
  * Начальные данные создания звонка
  * @hidden
@@ -27,5 +28,9 @@ type ConversationResponse = {
      * Порядковый номер, присвоенный устройству при входе в звонок
      */
     device_idx?: number;
+    turn_server?: IceServer;
+    stun_server?: IceServer;
+    client_type?: string;
+    token: string;
 };
 export default ConversationResponse;

package/types/Participant.d.ts

@@ -94,4 +94,4 @@ export declare enum ParticipantStateDataValue {
 /**
  * Список состояний в виде ключ-значение. Максимальная длина ключей и значений - 5 символов. Пустые значения будут пропущены
  */
-export type ParticipantStateData = Record<ParticipantStateDataKey, ParticipantStateDataValue>;
+export type ParticipantStateData = Partial<Record<ParticipantStateDataKey, ParticipantStateDataValue>>;

package/types/PerfStatReporter.d.ts

@@ -45,6 +45,6 @@ export interface ICallStatLog extends Pick<CallStatReport, 'call_topology' | 'na
     concealment_audio_avg_size?: number;
     video_loss?: number;
     audio_loss?: number;
-    hardware_concurrency?: number;
+    cpu_hardware_concurrency?: number;
     [k: string]: string | number | undefined;
 }

package/types/Statistics.d.ts

@@ -27,47 +27,194 @@ export interface ILocalIceCandidateStat extends IRemoteIceCandidateStat {
 interface StatRtpOutboundVideo {
     frameHeight?: number;
     frameWidth?: number;
+    /**
+     * Идентификатор потока RTP (RID).
+     *
+     * Используется для идентификации различных потоков видео (например, simulcast) в сессиях WebRTC.
+     */
     rid?: string;
     framesSent?: number;
     framesPerSecond?: number;
     targetBitrate?: number;
 }
 export interface StatRtp extends StatRtpOutboundVideo {
+    /**
+     * Уникальный идентификатор источника синхронизации RTP
+     */
     ssrc: number;
+    /**
+     * Идентификатор медиалинии (MID)
+     *
+     * Используется для уникальной идентификации медиалинии в рамках WebRTC-сессии.
+     * MID помогает сопоставлять медиапотоки с их соответствующими трансиверами.
+     */
+    mid?: string;
+    /**
+     * Тип статистики (например, inbound-rtp, outbound-rtp)
+     */
     type: string;
+    /**
+     * Тип медиа (например, audio, video)
+     */
     kind: string;
+    /**
+     * Общее количество байтов, полученных по этому потоку
+     */
     bytesReceived: number;
+    /**
+     * Общее количество байтов, отправленных по этому потоку
+     */
     bytesSent: number;
+    /**
+     * Общее количество байтов заголовков, полученных по этому потоку
+     */
     headerBytesReceived: number;
+    /**
+     * Общее количество байтов заголовков, отправленных по этому потоку
+     */
     headerBytesSent: number;
+    /**
+     * Среднее значение джиттера в секундах
+     * Джиттер — это вариация задержки в получении пакетов данных.
+     */
     jitter: number;
+    /**
+     * Общее количество потерянных пакетов
+     */
     packetsLost: number;
+    /**
+     * Общее количество полученных пакетов
+     */
     packetsReceived: number;
+    /**
+     * Общее количество отправленных пакетов
+     */
     packetsSent: number;
+    /**
+     * Доля потерянных пакетов
+     */
     fractionLost: number;
+    /**
+     * Количество Picture Loss Indication (PLI) сообщений
+     * PLI — это сообщения, указывающие на потерю кадров изображения.
+     */
     pliCount: number;
+    /**
+     * Количество Full Intra Request (FIR) сообщений
+     * FIR — это запросы на отправку полного внутрикодированного кадра.
+     */
     firCount: number;
+    /**
+     * Количество Negative ACKnowledgement (NACK) сообщений
+     * NACK — это сообщения, указывающие на потерю пакетов данных.
+     */
     nackCount: number;
+    /**
+     * Идентификатор пользователя, связанный с этим потоком
+     */
     userId?: string;
+    /**
+     * Пропускная способность в битах в секунду
+     */
     bandwidth?: number;
+    /**
+     * Процент потерянных пакетов
+     */
     packetLoss?: number;
+    /**
+     * Частота дискретизации в герцах
+     * Частота дискретизации определяет качество звука.
+     */
     clockRate?: number;
+    /**
+     * Название кодека
+     * @example audio/opus, video/vp8
+     */
     mimeType?: string;
+    /**
+     * Библиотека, которая используется для кодека
+     */
+    encoderImplementation?: string;
+    /**
+     * Библиотека, которая используется для декодера
+     */
+    decoderImplementation?: string;
+    /**
+     * Параметры кодека, есть только у audio кодеков
+     */
+    sdpFmtpLine?: string;
+    /**
+     * Общее количество декодированных кадров
+     */
     framesDecoded?: number;
+    /**
+     * Общее количество полученных кадров
+     */
     framesReceived?: number;
+    /**
+     * Общее количество отброшенных кадров
+     */
     framesDropped?: number;
+    /**
+     * Изменение количества отброшенных кадров
+     */
     framesDroppedDelta?: number;
+    /**
+     * Изменение задержки между кадрами
+     */
     interframeDelayVariance?: number;
+    /**
+     * Общее количество полученных аудиосэмплов
+     */
     totalSamplesReceived?: number;
+    /**
+     * Общее время кодирования видео в секундах.
+     *
+     * Показывает, сколько времени было потрачено на кодирование видео кадров.
+     * Не применяется для аудио.
+     */
+    totalEncodeTime?: number;
+    /**
+     * Общее количество замаскированных сэмплов
+     */
     concealedSamples?: number;
+    /**
+     * Количество вставленных сэмплов для замедления
+     */
     insertedSamplesForDeceleration?: number;
+    /**
+     * Количество удаленных сэмплов для ускорения
+     */
     removedSamplesForAcceleration?: number;
+    /**
+     * Количество замаскированных беззвучных сэмплов
+     */
     silentConcealedSamples?: number;
+    /**
+     * Количество событий маскировки
+     */
     concealmentEvents?: number;
+    /**
+     * Общее количество аудиоэнергии
+     * Аудиоэнергия — это мера мощности аудиосигнала.
+     */
     totalAudioEnergy?: number;
+    /**
+     * Общее время замерзания в секундах
+     */
     totalFreezesDuration: number;
+    /**
+     * Изменение общего времени замерзания
+     * Время замерзания — это период, в течение которого поток временно останавливается.
+     */
     totalFreezesDurationDelta?: number;
+    /**
+     * Количество событий замерзания
+     */
     freezeCount: number;
+    /**
+     * Изменение количества событий замерзания
+     */
     freezeCountDelta?: number;
 }
 export type StatItem = {

package/utils/Lz4.d.ts

@@ -0,0 +1 @@
+export declare function lz4Decompress(input: Uint8Array, outputLength: number): Uint8Array;