@vkontakte/calls-sdk 2.8.6-dev.77dd3c9d.0 → 2.8.6-dev.97c05c29.0

package/classes/Conversation.d.ts

@@ -19,7 +19,7 @@ import MediaModifiers from '../types/MediaModifiers';
 import { IVideoDimentions } from '../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
 import MuteStates from '../types/MuteStates';
-import { CompositeUserId, IGetParticipantsParameters, OkUserId, ParticipantId } from '../types/Participant';
+import { CompositeUserId, IGetParticipantsParameters, OkUserId, ParticipantId, ParticipantStateData } from '../types/Participant';
 import { ParticipantLayout } from '../types/ParticipantLayout';
 import { ParticipantListChunkParameters } from '../types/ParticipantListChunk';
 import ParticipantPriority from '../types/ParticipantPriority';
@@ -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
@@ -189,7 +192,7 @@ export default class Conversation extends EventEmitter {
      * @deprecated Use updateDisplayLayout instead
      */
     changePriorities(priorities: ParticipantPriority[]): Promise<void>;
-    changeParticipantState(state: Record<string, string>, compositeUserId?: CompositeUserId): Promise<void>;
+    changeParticipantState(state: ParticipantStateData, compositeUserId?: CompositeUserId): Promise<void>;
     putHandsDown(): Promise<void>;
     requestKeyFrame(participantStreamDescription: ParticipantStreamDescription): Promise<void | SignalingMessage>;
     requestTestMode(consumerCommand: string, producerCommand: string): Promise<void>;
@@ -249,7 +252,7 @@ export default class Conversation extends EventEmitter {
     customData(data: JSONObject, participantId?: ParticipantId | null): Promise<void>;
     createJoinLink(): Promise<string>;
     removeJoinLink(): Promise<undefined>;
-    addMovie({ movieId, gain, metadata }: IAddMovieParams): Promise<{
+    addMovie({ movieId, gain, metadata, lang }: IAddMovieParams): Promise<{
         movieId: number;
         streamType: string;
     }>;
@@ -272,7 +275,7 @@ export default class Conversation extends EventEmitter {
     setLocalResolution({ video, effect }: {
         video: IVideoDimentions;
         effect?: IVideoDimentions;
-    }): Promise<void | undefined>;
+    }): Promise<void>;
     videoEffect(effect: IEffect | null): Promise<void | undefined>;
     audioEffect(effects: string[] | null, isPreset?: boolean): Promise<void | undefined>;
     _convertExternalIdsToServerExternalIds(externalIds: ExternalId[]): SignalingMessage.ExternalId[];

package/classes/MediaSource.d.ts

@@ -5,6 +5,7 @@ import MediaSettings, { IVideoDimentions } from '../types/MediaSettings';
 import { ScreenCaptureSettings } from '../types/ScreenCaptureSettings';
 export declare const enum MediaSourceEvent {
     SOURCE_CHANGED = "SOURCE_CHANGED",
+    SOURCE_READY = "SOURCE_READY",
     TRACK_REPLACED = "TRACK_REPLACED",
     SCREEN_STATUS = "SCREEN_STATUS",
     ANIMOJI_STATUS = "ANIMOJI_STATUS"
@@ -22,6 +23,13 @@ interface AudioEffectParams {
     effects: string[];
     isPreset?: boolean;
 }
+/**
+ * тип источника (для сервера)
+ */
+export declare enum MediaSourceType {
+    CAMERA = 1,
+    SCREEN = 2
+}
 export declare class MediaSource extends EventEmitter {
     /** Стрим с камеры и микрофона пользователя */
     protected _stream: MediaStream | null;
@@ -90,6 +98,7 @@ export declare class MediaSource extends EventEmitter {
         video: IVideoDimentions;
         effect?: IVideoDimentions;
     }): Promise<void>;
+    getCameraVideoTrack(): MediaStreamTrack | null;
     updateNoiseSuppression(): Promise<void>;
     videoEffect(effect: IEffect | null): Promise<void>;
     audioEffect(audioEffectParams: AudioEffectParams | null): Promise<void>;

package/classes/ProducerCommandSerializationService.d.ts

@@ -5,6 +5,7 @@ import { EnableVideoSuspend } from '../types/EnableVideoSuspend';
 import { EnableVideoSuspendSuggest } from '../types/EnableVideoSuspendSuggest';
 import SignalingMessage from '../types/SignalingMessage';
 import { PerfStatReport } from '../types/PerfStatReporter';
+import { ChangeSimulcast } from '../types/ChangeSimulcast';
 import { SharingStatReport } from './screenshare/SharingStatReport';
 import { ParticipantIdRegistry } from './ParticipantIdRegistry';
 export declare class ProducerCommandSerializationService {
@@ -21,6 +22,7 @@ export declare class ProducerCommandSerializationService {
     serializeNetworkStatReport(sequenceNumber: number, report: NetworkStatReport): ArrayBuffer;
     serializeEnableVideoSuspend(sequenceNumber: number, params: EnableVideoSuspend): ArrayBuffer;
     serializeEnableVideoSuspendSuggest(sequenceNumber: number, params: EnableVideoSuspendSuggest): ArrayBuffer;
+    serializeChangeSimulcast(sequenceNumber: number, params: ChangeSimulcast): ArrayBuffer;
     deserializeCommandResponse(data: BufferSource | Blob): Promise<SignalingMessage | undefined>;
     private deserializeUpdateDisplayLayoutResponse;
     private deserializeReportPerfStatResponse;

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/classes/transport/ServerTransport.d.ts

@@ -35,6 +35,7 @@ export default class ServerTransport extends BaseTransport {
     private _rtpReceiversByStreamId;
     private _producerSessionId;
     private _newAudioShareTrack;
+    private _simulcastInfo;
     constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
     updateStatisticsInterval(): void;
     open(observer?: boolean): void;
@@ -44,6 +45,7 @@ export default class ServerTransport extends BaseTransport {
     allowRestart(): void;
     updateSettings(settings: ServerSettings): void;
     setAnimojiTransport(receiver: AnimojiReceiver, sender: AnimojiSender): void;
+    onCameraResolutionChanged(): Promise<void>;
     private _createPerfStatsReporter;
     private _closeConnection;
     private static _closeDataChannel;
@@ -72,6 +74,8 @@ export default class ServerTransport extends BaseTransport {
     private _detectStaleTracks;
     private _allocateConsumer;
     private _processOffer;
+    private _findFirstSimTransceiver;
+    private _setupSimulcastTransceiver;
     private _acceptProducer;
     private _handleTracks;
     private _onSignalingNotification;
@@ -82,4 +86,5 @@ export default class ServerTransport extends BaseTransport {
     private _onConnectionStateChange;
     private _onReplacedTrack;
     getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;
+    private _changeSimulcastInfo;
 }

package/classes/transport/Transport.d.ts

@@ -66,6 +66,7 @@ export declare class Transport extends EventEmitter {
     getStates(): Record<string, TransportState>;
     setAnimojiSvg(participantId: ParticipantId, svgData: AnimojiSvgData): void;
     setAnimojiFill(fill: RGBTuple | string): void;
+    onCameraResolutionChanged(): Promise<void>;
     private _setStates;
     private _setLocalState;
     private _onSignalingNotification;

package/default/Signaling.d.ts

@@ -15,11 +15,12 @@ import MediaModifiers from '../types/MediaModifiers';
 import MediaSettings from '../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
 import MuteStates from '../types/MuteStates';
-import { CompositeUserId, ParticipantId } from '../types/Participant';
+import { CompositeUserId, ParticipantId, ParticipantStateData } from '../types/Participant';
 import ParticipantLayout, { RequestKeyFrame, StopStream } from '../types/ParticipantLayout';
 import { ParticipantListChunkParameters } from '../types/ParticipantListChunk';
 import { StreamDescriptionString } from '../types/ParticipantStreamDescription';
 import { PerfStatReport } from '../types/PerfStatReporter';
+import { ChangeSimulcast } from '../types/ChangeSimulcast';
 import SignalingMessage, { GetParticipantsSignalingResponse, GetRoomsSignalingResponse, SignalingSuccessResponse } from '../types/SignalingMessage';
 import { IPublishStreamData, IRecordConfData, IStartStreamData, IStopStreamData } from '../types/Streams';
 export default class Signaling extends BaseSignaling {
@@ -85,7 +86,7 @@ export default class Signaling extends BaseSignaling {
     sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit, extraPayload?: Record<string, any>): Promise<SignalingMessage>;
     acceptCall(mediaSettings: MediaSettings): Promise<SignalingMessage>;
     changeMediaSettings(mediaSettings: MediaSettings): Promise<SignalingMessage>;
-    changeParticipantState(state: Record<string, string>, compositeUserId?: CompositeUserId): Promise<SignalingMessage>;
+    changeParticipantState(state: ParticipantStateData, compositeUserId?: CompositeUserId): Promise<SignalingMessage>;
     putHandsDown(): Promise<SignalingMessage>;
     addParticipant(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<SignalingMessage>;
@@ -132,6 +133,7 @@ export default class Signaling extends BaseSignaling {
     updateMediaModifiers(mediaModifiers: MediaModifiers): Promise<SignalingMessage>;
     enableVideoSuspend(enabled: boolean): Promise<SignalingMessage>;
     enableVideoSuspendSuggest(enabled: boolean): Promise<SignalingMessage>;
+    changeSimulcast(changeSimulcast: ChangeSimulcast): Promise<SignalingMessage>;
     changeOptions(changes: {
         [key in ConversationOption]?: boolean;
     }): Promise<SignalingMessage>;

package/enums/SignalingCommandType.d.ts

@@ -55,6 +55,7 @@ declare enum SignalingCommandType {
     GET_HAND_QUEUE = "get-hand-queue",
     ENABLE_VIDEO_SUSPEND = "enable-video-suspend",
     ENABLE_VIDEO_SUSPEND_SUGGEST = "enable-video-suspend-suggest",
-    PUT_HANDS_DOWN = "put-hands-down"
+    PUT_HANDS_DOWN = "put-hands-down",
+    CHANGE_SIMULCAST = "change-simulcast"
 }
 export default SignalingCommandType;

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.77dd3c9d.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",
@@ -16,11 +16,14 @@
   "dependencies": {
     "@vkontakte/calls-audio-effects": "1.2.8",
     "@vkontakte/calls-video-effects": "2.2.3-beta.5",
-    "@vkontakte/calls-vmoji": "1.0.10-beta.16",
+    "@vkontakte/calls-vmoji": "1.0.10-beta.17",
     "@vkontakte/libvpx": "2.0.9",
     "bit-buffer": "0.2.5",
     "messagepack": "1.1.12",
     "simple-ebml-builder": "0.2.2",
     "webrtc-adapter": "7.7.0"
-  }
+  },
+  "workspaces": [
+    "workspaces/sandbox"
+  ]
 }

package/static/Params.d.ts

@@ -843,6 +843,18 @@ export type ParamsObject = {
     switchVideoAtBadNetwork: boolean;
     /** включает деградацию фпс для видео с камеры при низком фпс с включенными вирт фонами */
     enableVideoEffectsFpsDegradation: boolean;
+    /**
+     * Включить поддержку simulcast на отправке
+     *
+     * _По умолчанию: `false`_
+     */
+    simulcast: boolean;
+    /**
+     * Не запрашивать conversation params при входе в звонок
+     *
+     * _По умолчанию: `false`_
+     */
+    skipConversationParams?: boolean;
 };
 export default abstract class Params {
     private static _params;
@@ -970,6 +982,9 @@ export default abstract class Params {
     static getScreenFrameRate(fastScreenShare: boolean): number;
     static get switchVideoAtBadNetwork(): boolean;
     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/static/SimulcastInfo.d.ts

@@ -0,0 +1,13 @@
+import { type SimulcastInfo as ISimulcastInfo } from '../types/SimulcastInfo';
+import type { VideoBitrateSettings } from '../types/VideoSettings';
+export declare const SIMULCAST_DEFAULT: {
+    HEIGHT: number;
+    WIDTH: number;
+    BITRATE: number;
+};
+export declare const SIMULCAST_SCALABILITY_MODE = "L1T2";
+export declare const MAP_RID_TO_SCALE_RESOLUTION_DOWN_BY: Record<string, number>;
+export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;
+export declare function findBitrateAsc(maxDimension: number, bitrates: VideoBitrateSettings[]): number;
+export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[]): ISimulcastInfo;
+export declare function findScaleResolutionDownBy(rid: string): number;

package/static/Utils.d.ts

@@ -61,7 +61,7 @@ declare namespace Utils {
         [key in T]?: K;
     }, obj2: {
         [key in T]?: K;
-    }): boolean;
+    }, deep?: boolean): boolean;
     function isArraysEquals<T>(arr1: T[], arr2: T[]): boolean;
     function isEmptyObject(obj: object): boolean;
     /**
@@ -74,5 +74,6 @@ declare namespace Utils {
     function objectReduce<R, T extends Object>(obj: T, callback: (acc: R, value: T[keyof T], key: keyof T) => R, initialValue: R): R;
     const setImmediate: (fn: VoidFunction) => VoidFunction;
     function isObject(obj: unknown): obj is object;
+    function patchSimulcastAnswerSdp(sdp: string, trans: RTCRtpTransceiver, width: number, height: number): string;
 }
 export default Utils;

package/static/WebRTCUtils.d.ts

@@ -127,6 +127,7 @@ declare namespace WebRTCUtils {
     function isBrokenH264Decoder(): boolean;
     /**
      * В некоторых браузерах VP9 encoder сломан
+     * В симулкасте вп9 енкодер ведет себя некорректно
      */
     function isBrokenVP9Encoder(): boolean;
     /**
@@ -142,6 +143,10 @@ declare namespace WebRTCUtils {
      * Может ли браузер делать H264 приоритетным
      */
     function canPreferH264(): boolean;
+    /**
+     * Некоторые браузеры (Firefox, Safari) некорректно поддерживают симулкаст
+     */
+    function isSimulcastSupportedByBrowser(): boolean;
     /**
      * Имя операционной системы
      */

package/types/ChangeSimulcast.d.ts

@@ -0,0 +1,6 @@
+import { MediaSourceType } from '../classes/MediaSource';
+import { SimulcastInfo } from './SimulcastInfo';
+export type ChangeSimulcast = {
+    mediaSource: MediaSourceType;
+    simulcastInfo: SimulcastInfo;
+};

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

@@ -86,3 +86,12 @@ export interface Participant {
 export interface IGetParticipantsParameters {
     externalIds: ExternalId[];
 }
+export type ParticipantStateDataKey = 'hand' | 'drat';
+export declare enum ParticipantStateDataValue {
+    OFF = "0",
+    ON = "1"
+}
+/**
+ * Список состояний в виде ключ-значение. Максимальная длина ключей и значений - 5 символов. Пустые значения будут пропущены
+ */
+export type ParticipantStateData = Partial<Record<ParticipantStateDataKey, ParticipantStateDataValue>>;

package/types/PerfStatReporter.d.ts

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

package/types/SimulcastInfo.d.ts

@@ -0,0 +1,10 @@
+export type SimulcastStreamInfo = {
+    rid: string;
+    width: number;
+    height: number;
+    fps: number;
+    bitrate: number;
+};
+export type SimulcastInfo = {
+    streams: SimulcastStreamInfo[];
+};

package/types/Statistics.d.ts

@@ -24,46 +24,199 @@ export interface ILocalIceCandidateStat extends IRemoteIceCandidateStat {
     relayProtocol: string;
     networkType: RTCNetworkType;
 }
-export type StatRtp = {
+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;
-    frameHeight?: number;
-    frameWidth?: number;
+    /**
+     * Библиотека, которая используется для кодека
+     */
+    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 = {
     timestamp: number;
     transport: StatTransport;
@@ -87,3 +240,4 @@ export type StatResult = {
         rtps: StatRtp[];
     };
 };
+export {};

package/types/VideoSettings.d.ts

@@ -25,6 +25,10 @@ export type VideoSettings = {
      * https://www.w3.org/TR/webrtc-svc/
      */
     scalabilityMode: string;
+    /**
+     * Таблица с битрейтами в зависимости от разрешения
+     */
+    bitrates?: Record<'generic' | string, VideoBitrateSettings[]>;
 };
 export default VideoSettings;
 export declare function compareVideoSettings(vs1: VideoSettings | null, vs2: VideoSettings | null): boolean;
@@ -38,3 +42,11 @@ export declare enum VideoScalability {
     L1T2 = "L1T2",
     L1T3 = "L1T3"
 }
+/**
+ * Настройка битрейта под конкретное разрешение
+ * @hidden
+ */
+export type VideoBitrateSettings = {
+    dimension: number;
+    bitrate: number;
+};

package/utils/Lz4.d.ts

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