@vkontakte/calls-sdk 2.8.11-dev.cb5b05f6.0 → 2.8.11-dev.d88537e0.0

package/classes/stat/StatPings.d.ts

@@ -1,17 +1,17 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
-import { TransportTopology } from '../transport/Transport';
+import StatsLogger from '../StatsLogger';
+import TransportTopology from '../../enums/TransportTopology';
 export declare class StatPings {
-    private static _instance?;
-    static create(): void;
+    private readonly _logger;
+    private trackerByTransport;
+    private lastSeen;
+    constructor(logger: StatsLogger);
     /**
      * Вызывать при входящем ping в сигналингу.
      * Будет произведен расчет времени между пингами.
      */
-    static mark(transport: SignalingTransportType): void;
+    mark(transport: SignalingTransportType): void;
     /** Отправляем данные в стату */
-    static logMetrics(topology?: TransportTopology): void;
-    static destroy(): void;
-    private trackerByTransport;
-    private lastSeen;
-    private _destroy;
+    logMetrics(topology?: TransportTopology): void;
+    destroy(): void;
 }

package/classes/stat/StatScreenShareFirstFrame.d.ts

@@ -1,7 +1,9 @@
 import { ParticipantId } from '../../types/Participant';
+import { StatAggregator } from './StatAggregator';
 export declare class StatScreenShareFirstFrame {
     protected readonly _participantId: ParticipantId;
+    private readonly _statAggregator;
     protected _firstFrameReceived: boolean;
-    constructor(participantId: ParticipantId);
+    constructor(participantId: ParticipantId, statAggregator: StatAggregator | null);
     measure(width: number, height: number): void;
 }

package/classes/stat/StatSignalingCommands.d.ts

@@ -1,12 +1,12 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
-import { TransportTopology } from '../transport/Transport';
+import StatsLogger from '../StatsLogger';
+import TransportTopology from '../../enums/TransportTopology';
 export declare class StatSignalingCommands {
-    private static _instance?;
-    static create(): void;
-    static mark(command: string, time: number, transport: SignalingTransportType): void;
-    /** Отправляем данные в стату */
-    static logMetrics(topology?: TransportTopology): void;
-    static destroy(): void;
+    private readonly _logger;
     private trackerByCommand;
-    private _destroy;
+    constructor(logger: StatsLogger);
+    mark(command: string, time: number, transport: SignalingTransportType): void;
+    /** Отправляем данные в стату */
+    logMetrics(topology?: TransportTopology): void;
+    destroy(): void;
 }

package/classes/transport/BaseTransport.d.ts

@@ -1,7 +1,7 @@
 import BaseSignaling from '../../abstract/BaseSignaling';
+import TransportState from '../../enums/TransportState';
 import EventEmitter from '../EventEmitter';
 import { MediaSource } from '../MediaSource';
-import { TransportState } from './Transport';
 export default abstract class BaseTransport extends EventEmitter {
     protected readonly _signaling: BaseSignaling;
     protected readonly _mediaSource: MediaSource;

package/classes/transport/DirectStatReporter.d.ts

@@ -1,4 +1,5 @@
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { type DebugLogger } from '../../static/Debug';
 import { StatResult } from '../../types/Statistics';
 import EventEmitter from '../EventEmitter';
 import { WeightedAverage } from '../stat/WeightedAverage';
@@ -30,7 +31,8 @@ export default class DirectStatReporter extends EventEmitter {
     private readonly _networkLimits;
     private _lastStatSentTimestamp;
     private _currentState;
-    constructor(signaling: BaseSignaling);
+    private readonly _debug;
+    constructor(signaling: BaseSignaling, debug?: DebugLogger);
     private _calcRttRating;
     private _calcLossRating;
     private _calcBitrateRating;

package/classes/transport/DirectTransport.d.ts

@@ -1,8 +1,12 @@
 import type { AnimojiReceiver, AnimojiSender } from '@vkontakte/calls-vmoji';
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
+import StatsLogger from '../StatsLogger';
 import { MediaSource } from '../MediaSource';
+import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
+import { StatAggregator } from '../stat/StatAggregator';
 import BaseTransport from './BaseTransport';
 export default class DirectTransport extends BaseTransport {
     private readonly _participantId;
@@ -34,7 +38,11 @@ export default class DirectTransport extends BaseTransport {
     private _lastBadConnection;
     private _perfStatReporter;
     private _directStatReporter;
-    constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _codecStatsAggregator;
+    constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
     get participantId(): ParticipantId;
     updateStatisticsInterval(): void;
     private _isDeadConnection;

package/classes/transport/PerfStatReporter.d.ts

@@ -1,5 +1,7 @@
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { type DebugLogger } from '../../static/Debug';
 import EventEmitter from '../EventEmitter';
+import { StatAggregator } from '../stat/StatAggregator';
 import DirectTransport from './DirectTransport';
 import ServerTransport from './ServerTransport';
 export default class PerfStatReporter extends EventEmitter {
@@ -10,7 +12,9 @@ export default class PerfStatReporter extends EventEmitter {
     private _screenShareStats;
     private _signaling;
     private readonly _directTopology;
-    constructor(transport: ServerTransport | DirectTransport, signaling: BaseSignaling, directTopology?: boolean);
+    private readonly _debug;
+    private readonly _statAggregator;
+    constructor(transport: ServerTransport | DirectTransport, signaling: BaseSignaling, statAggregator?: StatAggregator | null, directTopology?: boolean, debug?: DebugLogger);
     destroy(): void;
     static getEstimatedPerformanceIndex(): number;
     private _handleStats;

package/classes/transport/ServerTransport.d.ts

@@ -1,8 +1,12 @@
 import type { AnimojiReceiver, AnimojiSender } from '@vkontakte/calls-vmoji';
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
+import StatsLogger from '../StatsLogger';
 import { MediaSource } from '../MediaSource';
+import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
+import { StatAggregator } from '../stat/StatAggregator';
 import BaseTransport from './BaseTransport';
 export default class ServerTransport extends BaseTransport {
     private _producerNotification;
@@ -39,7 +43,11 @@ export default class ServerTransport extends BaseTransport {
     private _producerSessionId;
     private _newAudioShareTrack;
     private _simulcastInfo;
-    constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _codecStatsAggregator;
+    constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
     updateStatisticsInterval(): void;
     open(observer?: boolean): void;
     close(error?: Error): void;
@@ -88,7 +96,7 @@ export default class ServerTransport extends BaseTransport {
     private _onAsrTranscription;
     private _onProducerUpdated;
     private _onAddTrack;
-    static _onSignalingStateChange(pc: RTCPeerConnection, event: any): void;
+    private _onSignalingStateChange;
     private _onConnectionStateChange;
     private _onReplacedTrack;
     private _onSourcesChanged;

package/classes/transport/Transport.d.ts

@@ -1,9 +1,15 @@
 import type { AnimojiSvgData, RGBTuple } from '@vkontakte/calls-vmoji';
 import BaseSignaling from '../../abstract/BaseSignaling';
+import TransportState from '../../enums/TransportState';
+import TransportTopology from '../../enums/TransportTopology';
+import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
 import EventEmitter from '../EventEmitter';
+import StatsLogger from '../StatsLogger';
 import { MediaSource } from '../MediaSource';
+import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
+import { StatAggregator } from '../stat/StatAggregator';
 export declare const enum TransportEvent {
     REMOTE_TRACK_ADDED = "REMOTE_TRACK_ADDED",
     REMOTE_TRACK_REMOVED = "REMOTE_TRACK_REMOVED",
@@ -23,19 +29,6 @@ export declare const enum TransportEvent {
     ANIMOJI_ERROR = "ANIMOJI_ERROR",
     SCREEN_SHARING_STAT = "SCREEN_SHARING_STAT"
 }
-export declare const enum TransportState {
-    IDLE = "IDLE",
-    OPENED = "OPENED",
-    CONNECTING = "CONNECTING",
-    RECONNECTING = "RECONNECTING",
-    CONNECTED = "CONNECTED",
-    CLOSED = "CLOSED",
-    FAILED = "FAILED"
-}
-export declare const enum TransportTopology {
-    DIRECT = "DIRECT",
-    SERVER = "SERVER"
-}
 export declare class Transport extends EventEmitter {
     private readonly _signaling;
     private readonly _mediaSource;
@@ -51,7 +44,12 @@ export declare class Transport extends EventEmitter {
     private _localState;
     private _animojiReceiver;
     private _animojiSender;
-    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _codecStatsAggregator;
+    private _vadController;
+    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
     updateSettings(settings: ServerSettings): void;
     updateStatisticsInterval(): void;
     allocate(participantId: ParticipantId, isMaster?: boolean): void;
@@ -92,6 +90,8 @@ export declare class Transport extends EventEmitter {
     private _onAnimojiStream;
     /** Обработчик, досылающий MediaSourceEvent.SOURCE_CHANGED событие до аллокации транспортов */
     private _onAnimojiStatus;
+    private _createVad;
+    private _updateVadTrack;
     private _createAnimojiTransport;
     private _removeAnimojiTransport;
     getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;

package/default/Api.d.ts

@@ -1,4 +1,4 @@
-import BaseApi, { ClientEvent, ClientStats, LogItem } from '../abstract/BaseApi';
+import BaseApi, { ClientEvent, ClientStats } from '../abstract/BaseApi';
 import CallType from '../enums/CallType';
 import HangupType from '../enums/HangupType';
 import ConversationParams from '../types/ConversationParams';
@@ -8,14 +8,11 @@ import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
 export default class Api extends BaseApi {
     private _userId;
     private _uuid;
-    private _externalUidsCache;
-    private _decorativeIdToInitialId;
-    private _initialIdToDecorativeId;
+    private _idCache;
     private _callUnsafe;
     protected _call(method: string, data?: any, noSession?: boolean): Promise<any>;
     userId(participantId: ParticipantId): Promise<ExternalParticipantId>;
     authorize(): Promise<void>;
-    log(items: LogItem[]): void;
     logClientStats(items: ClientStats[]): void;
     logClientEvents(items: ClientEvent[]): void;
     uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
@@ -26,7 +23,7 @@ export default class Api extends BaseApi {
         audioOnly?: boolean;
         waitForAdmin?: boolean;
         closedConversation?: boolean;
-    }, speakerIds?: OkUserId[]): Promise<ConversationResponse>;
+    }, externalIds?: ExternalId[]): Promise<ConversationResponse>;
     startConversation(conversationId: string, ids?: OkUserId[], type?: CallType, isVideo?: boolean, payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, waitForAdmin }?: {
         onlyAdminCanShareMovie?: boolean;
         waitForAdmin?: boolean;
@@ -43,19 +40,13 @@ export default class Api extends BaseApi {
     }>;
     getAnonymTokenByLink(joinLink: string, username?: string): Promise<string>;
     joinConversationByLink(joinLink: string, isVideo?: boolean, observedIds?: ExternalUserId[], payload?: string): Promise<ConversationResponse>;
-    /**
-     * NB: Не сохраняет порядок возвращаемых ID
-     * Этот метод принимает именно ExternalId, т.к. для OkUserId не принципиально наличие deviceIdx
-     * @hidden
-     */
-    getOkIdsByExternalIds(externalIds: ExternalId[]): Promise<OkUserId[]>;
-    getParticipantIdsByExternalIds(externalIds: ExternalId[]): Promise<Map<ExternalId, ParticipantId>>;
     /**
      * NB: Не сохраняет порядок возвращаемых ID
      * @hidden
      */
     getExternalIdsByOkIds(uids: OkUserId[]): Promise<ExternalParticipantId[]>;
     getCachedOkIdByExternalId(externalId: ExternalId): ParticipantId | null;
+    getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
     cacheExternalId(participantId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
     mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, initialId: OkUserId | CompositeUserId | ParticipantId): void;
     unmapDecorativeId(initialId: OkUserId | CompositeUserId | ParticipantId): void;
@@ -65,7 +56,6 @@ export default class Api extends BaseApi {
     getUserId(): OkUserId | null;
     setUserId(userId: OkUserId): void;
     hangupConversation(conversationId: string, reason?: HangupType): void;
-    sendUserFeedbackStats(conversationId: string, userResponse: number, reason?: string, groupCallUsersCount?: number): void;
     removeHistoryRecords(recordIds: number[]): Promise<void>;
     cleanup(): void;
     private _getExternalIdsByOkIds;

package/default/Signaling.d.ts

@@ -1,13 +1,18 @@
 import BaseSignaling, { AddParticipantParams } from '../abstract/BaseSignaling';
+import StatsLogger from '../classes/StatsLogger';
 import { ParticipantIdRegistry } from '../classes/ParticipantIdRegistry';
 import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
-import { TransportTopology } from '../classes/transport/Transport';
+import { StatAggregator } from '../classes/stat/StatAggregator';
+import { StatPings } from '../classes/stat/StatPings';
+import { StatSignalingCommands } from '../classes/stat/StatSignalingCommands';
+import TransportTopology from '../enums/TransportTopology';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
 import MediaOption from '../enums/MediaOption';
 import SignalingCommandType from '../enums/SignalingCommandType';
 import SignalingConnectionType from '../enums/SignalingConnectionType';
 import UserRole from '../enums/UserRole';
+import { type DebugLogger } from '../static/Debug';
 import { JSONObject } from '../static/Json';
 import { IAsrStartParams, IAsrStopParams } from '../types/Asr';
 import { ChangeSimulcast } from '../types/ChangeSimulcast';
@@ -22,7 +27,7 @@ import { ParticipantListChunkParameters } from '../types/ParticipantListChunk';
 import { StreamDescriptionString } from '../types/ParticipantStreamDescription';
 import { PerfStatReport } from '../types/PerfStatReporter';
 import SignalingMessage, { GetParticipantsSignalingResponse, GetRoomsSignalingResponse, SignalingSuccessResponse } from '../types/SignalingMessage';
-import { IPublishStreamData, IRecordConfData, IStartStreamData, IStopStreamData } from '../types/Streams';
+import { IPublishStreamData, IStartStreamData, IStopStreamData } from '../types/Streams';
 export default class Signaling extends BaseSignaling {
     private socket;
     protected sequence: number;
@@ -39,7 +44,6 @@ export default class Signaling extends BaseSignaling {
     protected conversationReject: Function | null;
     private connected;
     private listenersReady;
-    private postfix;
     protected peerId: number | null;
     protected conversationId: string | null;
     private reconnectTimer;
@@ -50,12 +54,18 @@ export default class Signaling extends BaseSignaling {
     private producerCommandDataChannel;
     private producerCommandDataChannelEnabled;
     private producerCommandSerializationService;
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _pings;
+    private readonly _signalingCommands;
     private static get RECONNECT_DELAY();
     private static get RECONNECT_MAX_DELAY();
     private static get RECONNECT_MAX_COUNT();
     private static get WAIT_CONNECTION_DELAY();
     private static get WAIT_RESPONSE_DELAY();
     private static get WAIT_MESSAGE_DELAY();
+    constructor(debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, pings?: StatPings | null, signalingCommands?: StatSignalingCommands | null);
     get ready(): boolean;
     setEndpoint(endpoint: string): void;
     setWebTransportEndpoint(endpoint: string | null): void;
@@ -120,7 +130,6 @@ export default class Signaling extends BaseSignaling {
     startStream(data: IStartStreamData): Promise<SignalingMessage>;
     stopStream(data?: IStopStreamData): Promise<SignalingMessage>;
     publishStream(data?: IPublishStreamData): Promise<SignalingMessage>;
-    recordSetConf(conf?: IRecordConfData): Promise<SignalingMessage>;
     getRecordStatus(): Promise<SignalingMessage>;
     switchTopology(topology: TransportTopology, force?: boolean): Promise<SignalingMessage>;
     requestRealloc(): Promise<SignalingMessage>;
@@ -164,6 +173,7 @@ export default class Signaling extends BaseSignaling {
     startAsr(params: IAsrStartParams): Promise<SignalingMessage>;
     stopAsr(params?: IAsrStopParams): Promise<SignalingMessage>;
     requestAsr(request: boolean): Promise<SignalingMessage>;
+    private _buildUrl;
     protected _connect(connectionType: SignalingConnectionType, useWebTransport: boolean): void;
     protected _disconnect(code?: number): void;
     private _onOpen;
@@ -173,6 +183,7 @@ export default class Signaling extends BaseSignaling {
     protected _handleCachedMessages(): void;
     private _throwError;
     private _onError;
+    private _serializeErrorEvent;
     protected _onClose(event: CloseEvent): void;
     protected _closeSocket(error?: Error | null): void;
     protected _reconnect(): void;

package/enums/TransportState.d.ts

@@ -0,0 +1,10 @@
+declare const enum TransportState {
+    IDLE = "IDLE",
+    OPENED = "OPENED",
+    CONNECTING = "CONNECTING",
+    RECONNECTING = "RECONNECTING",
+    CONNECTED = "CONNECTED",
+    CLOSED = "CLOSED",
+    FAILED = "FAILED"
+}
+export default TransportState;

package/enums/TransportTopology.d.ts

@@ -0,0 +1,5 @@
+declare const enum TransportTopology {
+    DIRECT = "DIRECT",
+    SERVER = "SERVER"
+}
+export default TransportTopology;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.11-dev.cb5b05f6.0",
+  "version": "2.8.11-dev.d88537e0.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -14,7 +14,7 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/calls-audio-effects": "1.2.8",
+    "@vkontakte/calls-audio-effects": "1.2.10-dev.12fb226c.0",
     "@vkontakte/calls-video-effects": "2.2.3-beta.7",
     "@vkontakte/calls-vmoji": "1.0.10-beta.17",
     "@vkontakte/libvpx": "2.0.9",

package/static/Debug.d.ts

@@ -7,14 +7,33 @@ export declare enum DebugMessageType {
     WARN = "WARN",
     ERROR = "ERROR"
 }
+export type DebugMessageContext = {
+    readonly sessionId: string | null;
+    readonly conversationId: string | null;
+};
+export type DebugLogger = {
+    debug(...args: any[]): void;
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+};
+export type DebugSessionLogger = DebugLogger & {
+    readonly sessionId: string | null;
+    readonly conversationId: string | null;
+    setConversationId(conversationId: string | null): void;
+};
 declare namespace Debug {
-    let debug: Function;
-    let log: Function;
-    let warn: Function;
-    let error: Function;
-    function enabled(): boolean;
-    function toggle(enable: boolean): void;
-    function send(type: DebugMessageType, ...args: any[]): void;
-    function test(tag: string, ...args: any[]): void;
+    type ContextProvider = () => DebugMessageContext;
+    export function debug(...args: any[]): void;
+    export function log(...args: any[]): void;
+    export function warn(...args: any[]): void;
+    export function error(...args: any[]): void;
+    export function enabled(): boolean;
+    export function toggle(enable: boolean): void;
+    export function send(type: DebugMessageType, ...args: any[]): void;
+    export function createLogger(getContext: ContextProvider): DebugLogger;
+    export function createSessionLogger(initialConversationId?: string | null): DebugSessionLogger;
+    export function test(tag: string, ...args: any[]): void;
+    export {};
 }
 export default Debug;

package/static/External.d.ts

@@ -446,6 +446,9 @@ declare namespace External {
      * @param args
      */
     function onDebugMessage(type: DebugMessageType, ...args: any[]): void;
+    function onDebugMessageWithContext(type: DebugMessageType, context: {
+        conversationId: string | null;
+    }, ...args: any[]): void;
     /**
      * Статистика звонка
      *

package/static/Params.d.ts

@@ -1,5 +1,5 @@
 import type { VideoEffects } from '@vkontakte/calls-video-effects';
-import type { EffectVoiceChange } from '@vkontakte/calls-audio-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 { ConversationData } from '../types/Conversation';
@@ -188,6 +188,14 @@ export type ParamsObject = {
      * Можно установить позднее методом `setAudioEffects`
      */
     audioEffects: EffectVoiceChange | null;
+    /**
+     * Namespace библиотеки VAD из `@vkontakte/calls-audio-effects`.
+     *
+     * Можно установить методом `setVad`
+     */
+    vad: VadLib | null;
+    /** Настройки VAD (threshold, hangoverMs, enabled) */
+    vadOptions: VadControllerOptions;
     /**
      * Максимальная ширина видео в пикселях для видео эффекта
      *
@@ -306,6 +314,12 @@ export type ParamsObject = {
      * _По умолчанию: `30`_
      */
     videoTracksCount: number;
+    /**
+     * Минимальный интервал отправки diff для requestDisplayLayout в миллисекундах.
+     *
+     * _По умолчанию: `250`_
+     */
+    requestDisplayLayoutThrottleMs: number;
     /** @hidden */
     movieShare: boolean;
     /** @hidden */
@@ -730,6 +744,12 @@ export type ParamsObject = {
      * Получено отладочное сообщение. Работает только при выключенном режиме отладки
      */
     onDebugMessage?: (type: DebugMessageType, ...args: any[]) => void;
+    /**
+     * Получено отладочное сообщение с контекстом звонка. Работает только при выключенном режиме отладки
+     */
+    onDebugMessageWithContext?: (type: DebugMessageType, context: {
+        conversationId: string | null;
+    }, ...args: any[]) => void;
     /**
      * Статистика звонка
      */
@@ -929,6 +949,10 @@ export default abstract class Params {
     static get displaySurface(): DisplayCaptureSurfaceType;
     static get audioEffects(): EffectVoiceChange | null;
     static set audioEffects(value: EffectVoiceChange | null);
+    static get vad(): VadLib | null;
+    static set vad(value: VadLib | null);
+    static get vadOptions(): VadControllerOptions;
+    static set vadOptions(value: VadControllerOptions);
     static get videoEffects(): VideoEffects | null;
     static set videoEffects(value: VideoEffects | null);
     static get videoEffectMaxWidth(): number;
@@ -963,6 +987,7 @@ export default abstract class Params {
     static get audioNack(): boolean;
     static get movieShare(): boolean;
     static get videoTracksCount(): number;
+    static get requestDisplayLayoutThrottleMs(): number;
     static get breakVideoPayloadTypes(): boolean;
     static get useCallsToContacts(): boolean;
     static get useParticipantListChunk(): boolean;
@@ -1010,6 +1035,7 @@ export default abstract class Params {
         screenShareCongestionControl: boolean;
         screenShareCongestionControlThreshold: number;
         videoTracksCount: number;
+        requestDisplayLayoutThrottleMs: number;
         asrDataChannel: boolean;
         videoMaxHeight: number;
         videoMaxWidth: number;

package/static/Utils.d.ts

@@ -3,6 +3,7 @@ import { ExternalParticipant, ExternalParticipantListMarker } from '../types/Ext
 import { CompositeUserId, OkUserId, Participant, ParticipantId, ParticipantStateMapped } from '../types/Participant';
 import SignalingMessage from '../types/SignalingMessage';
 import VideoSettings from '../types/VideoSettings';
+import { type DebugLogger } from './Debug';
 export declare const PARAMETERS_SEPARATOR = ":";
 export declare const DEVICE_IDX_PARAMETER = "d";
 /** @hidden */
@@ -36,8 +37,8 @@ declare namespace Utils {
     function delay(time: number, { signal }?: {
         signal?: AbortSignal;
     }): Promise<void>;
-    function applySettings(pc: RTCPeerConnection, videoSettings: VideoSettings, prevSettings: any): any;
-    function applyVideoTrackSettings(videoSettings: VideoSettings, s: RTCRtpSender, track: MediaStreamTrack | null, prevSettings: any, retSettings: any): void;
+    function applySettings(pc: RTCPeerConnection, videoSettings: VideoSettings, prevSettings: any, debug?: DebugLogger): any;
+    function applyVideoTrackSettings(videoSettings: VideoSettings, s: RTCRtpSender, track: MediaStreamTrack | null, prevSettings: any, retSettings: any, debug?: DebugLogger): void;
     /**
      * Проверяет, есть ли в первом массиве хотя бы один элемент из второго массива
      * @param arr Где ищем

package/static/WebRTCUtils.d.ts

@@ -2,6 +2,8 @@
  * Вспомогательный плагин для работы с WebRTC
  */
 import { IVideoDimentions } from '../types/MediaSettings';
+import type StatsLogger from '../classes/StatsLogger';
+import { type DebugLogger } from './Debug';
 /**
  * Тип камеры мобильного устройства
  */
@@ -75,6 +77,7 @@ declare namespace WebRTCUtils {
      * Проверяет получены ли разрешения, необходимые для текущего звонка
      */
     function hasPermissions(needVideo?: boolean): boolean;
+    function releaseFirefoxMicrophonePermissionWarmup(): void;
     /**
      * Запрашивает камеру и микрофон пользователя
      *
@@ -82,24 +85,24 @@ declare namespace WebRTCUtils {
      * @param needAudio Нужно ли аудио
      * @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
      */
-    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean): Promise<MediaStream>;
+    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
      */
-    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean): Promise<MediaStream>;
+    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Запрашивает камеру пользователя
      *
      * @param deviceId ID устройства
      * @param resolution Размеры видео
      */
-    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions): Promise<MediaStream>;
+    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Запрашивает микрофон пользователя
      *
      * @param deviceId ID устройства
      */
-    function getUserAudio(deviceId?: string): Promise<MediaStream>;
+    function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Устанавливает размер видео в стриме
      *

package/types/Conversation.d.ts

@@ -1,4 +1,4 @@
-import { TransportTopology } from '../classes/transport/Transport';
+import TransportTopology from '../enums/TransportTopology';
 import CallDirection from '../enums/CallDirection';
 import CallType from '../enums/CallType';
 import ConversationFeature from '../enums/ConversationFeature';

package/types/FastStart.d.ts

@@ -31,6 +31,7 @@ export interface FastStartParams {
     conversationId: string;
     internalParams: string;
     externalIds?: ExternalId[];
+    payload: string;
     opponentType: CallType;
     mediaOptions: MediaOption[];
     joiningAllowed?: boolean;

package/types/ParticipantLayout.d.ts

@@ -54,4 +54,37 @@ export type ParticipantLayout = (Layout | StopStream | RequestKeyFrame) & {
      */
     streamName?: string;
 };
+/**
+ * Запрос стрима, который клиент хочет получать для отображения.
+ */
+export type DisplayLayoutRequest = {
+    /**
+     * Внешний ID пользователя
+     */
+    uid: ExternalParticipantId | string;
+    /**
+     * Тип медиа (видео с камеры, картинка с экрана, лайв или мувик)
+     */
+    mediaType: MediaType;
+    /**
+     * Ширина окошка в котором отображается видео, в пикселях
+     */
+    width: number;
+    /**
+     * Высота окошка в котором отображается видео, в пикселях
+     */
+    height: number;
+    /**
+     * Отображать видео как CSS object-fit: cover. По умолчанию используется contain.
+     */
+    cover?: boolean;
+    /**
+     * Приоритет
+     */
+    priority?: number;
+    /**
+     * ID лайва или мувика. null для камеры или скрин-шары.
+     */
+    streamName?: string;
+};
 export default ParticipantLayout;