@vkontakte/calls-sdk 2.8.10-dev.60145cdf.0 → 2.8.10-dev.6360a014.0

package/classes/AudioOutput.d.ts

@@ -3,7 +3,15 @@ type ParticipantAudioOutput = {
     audioElement?: HTMLAudioElement;
     audioTrack?: MediaStreamTrack;
 };
-export default class AudioOutput {
+export interface IAudioOutput {
+    add(track: MediaStreamTrack): void;
+    remove(track: MediaStreamTrack): void;
+    get volume(): number;
+    set volume(volume: number);
+    destroy(): void;
+    changeOutput(): Promise<void>;
+}
+export default class AudioOutput implements IAudioOutput {
     protected _output: ParticipantAudioOutput | null;
     private _volume;
     private readonly _features;

package/classes/Conversation.d.ts

@@ -14,6 +14,7 @@ import { IAsrStartParams, IAsrStopParams } from '../types/Asr';
 import { AudienceModeHandsResponse } from '../types/AudienceMode';
 import { ConversationData, ConversationOnStartParams } from '../types/Conversation';
 import { ExternalId, ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk, ExternalUserId } from '../types/ExternalId';
+import type { FastJoinHandler } from '../types/FastJoin';
 import MediaModifiers from '../types/MediaModifiers';
 import { IVideoDimentions } from '../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
@@ -67,7 +68,7 @@ export default class Conversation extends EventEmitter {
     static current(): Conversation | null;
     static hangupAfterInit(): void;
     static id(): string | null;
-    onStart({ opponentIds, opponentType, mediaOptions, payload, joiningAllowed, requireAuthToJoin, onlyAdminCanShareMovie, externalIds, onFastStart, }: ConversationOnStartParams): Promise<ConversationData>;
+    onStart({ opponentIds, opponentType, mediaOptions, payload, joiningAllowed, requireAuthToJoin, onlyAdminCanShareMovie, externalIds, onFastStart, conversationId, }: ConversationOnStartParams): Promise<ConversationData>;
     onJoin(joinArgs: {
         conversationId?: string;
         mediaOptions: MediaOption[];
@@ -75,6 +76,7 @@ export default class Conversation extends EventEmitter {
         joinLink?: string;
         observedIds?: ExternalUserId[];
         payload?: string;
+        onFastJoin?: FastJoinHandler;
     }): Promise<ConversationData>;
     private _onJoinPart2;
     private _extractExternalRooms;

package/classes/MediaSource.d.ts

@@ -83,7 +83,6 @@ export declare class MediaSource extends EventEmitter {
     private _changeAudioInput;
     private _changeScreen;
     private _disableScreenCapture;
-    private disableAudioShare;
     private stopAudioShareTrack;
     private _applyAudioEffect;
     protected getSilentAudioShareTrack(): MediaStreamTrack;

package/classes/TransparentAudioOutput.d.ts

@@ -0,0 +1,19 @@
+import { IAudioOutput } from './AudioOutput';
+import { StatFirstMediaReceived } from './stat/StatFirstMediaReceived';
+export default class TransparentAudioOutput implements IAudioOutput {
+    private audioTracks;
+    private audioElement;
+    private _volume;
+    private readonly _features;
+    private readonly _statFirstMediaReceived;
+    constructor(statFirstMediaReceived: StatFirstMediaReceived);
+    add(track: MediaStreamTrack): void;
+    remove(track: MediaStreamTrack): void;
+    get volume(): number;
+    set volume(volume: number);
+    protected _initAudioElement(): void;
+    protected _stopAudioElement(): void;
+    destroy(): void;
+    /** изменяем устройство для воспроизведения аудио */
+    changeOutput(): Promise<void>;
+}

package/classes/codec/LibVPxEncoder.d.ts

@@ -29,5 +29,4 @@ export default class LibVPxEncoder extends WorkerBase implements IEncoder {
     setBitrate(bitrate: number, useCbr: boolean, fps: number): void;
     isVP9(): boolean;
     destroy(): void;
-    static isBrowserSupported(): boolean;
 }

package/classes/screenshare/ScreenCaptureReceiver.d.ts

@@ -16,5 +16,4 @@ export default class ScreenCaptureReceiver {
     private _requestKeyFrame;
     close(participantId: ParticipantId): void;
     destroy(): void;
-    static isBrowserSupported(): boolean;
 }

package/classes/transport/Transport.d.ts

@@ -75,7 +75,6 @@ export declare class Transport extends EventEmitter {
     private _createServerTransport;
     private _releaseDirectTransport;
     private _releaseServerTransport;
-    private _setLocalNoiseSuppression;
     private _onDirectTransportChanged;
     private _onServerTransportChanged;
     private _onTransportActiveParticipants;

package/devtools/DevTools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * DevTools for SDK
+ * Позволяет подменять значения ручек перед инициализацией SDK
+ */
+import Params from './modules/Params';
+import type { DevToolsOptions } from './types';
+export type { DevToolsOptions };
+/**
+ * DevTools API for runtime SDK configuration
+ * Singleton class to ensure consistent state across the application
+ */
+declare class DevTools {
+    private static instance;
+    static getInstance(): DevTools;
+    readonly params: Params;
+    private storage;
+    private constructor();
+}
+declare const _default: DevTools;
+export default _default;

package/devtools/DevToolsStorage.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Storage utility for DevTools
+ * Handles persistence of DevTools options in localStorage
+ */
+import type { DevToolsOptions } from './types';
+/**
+ * Storage utility for DevTools
+ */
+export default class DevToolsStorage {
+    set(key: string, value: any): void;
+    get<T>(key: string): T | null;
+    remove(key: string): void;
+    clear(): void;
+    getAll(): DevToolsOptions;
+    private getStorage;
+}

package/devtools/index.d.ts

@@ -0,0 +1 @@
+export { default as devtools } from './DevTools';

package/devtools/modules/Params.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Params module for DevTools
+ * Позволяет подменять значения ручек перед инициализацией SDK
+ */
+import type DevToolsStorage from '../DevToolsStorage';
+import type { DevToolsOptions } from '../types';
+export type { DevToolsOptions };
+export default class Params {
+    private storage;
+    constructor(storage: DevToolsStorage);
+    /**
+     * Set an option override
+     * @param key - Option name
+     * @param value - Option value
+     * @example
+     * ```ts
+     * __CALLS_SDK.params.set('webtransport', true);
+     * ```
+     */
+    set<K extends keyof DevToolsOptions>(key: K, value: DevToolsOptions[K]): void;
+    /**
+     * Get an option override value
+     * @param key - Option name
+     * @returns Option value if override is set, null if not set
+     * @example
+     * ```ts
+     * const value = __CALLS_SDK.params.get('webtransport');
+     * ```
+     */
+    get<K extends keyof DevToolsOptions>(key: K): DevToolsOptions[K] | null;
+    /**
+     * Clear a specific option override
+     * @param key - Option name
+     * @example
+     * ```ts
+     * __CALLS_SDK.params.clear('webtransport');
+     * ```
+     */
+    clear<K extends keyof DevToolsOptions>(key: K): void;
+    /**
+     * Clear all DevTools overrides
+     * @example
+     * ```ts
+     * __CALLS_SDK.params.clearAll();
+     * ```
+     */
+    clearAll(): void;
+    /**
+     * Get all current DevTools overrides
+     * @returns Current override values
+     * @example
+     * ```ts
+     * const overrides = __CALLS_SDK.params.getAll();
+     * console.log(overrides); // { webtransport: true }
+     * ```
+     */
+    getAll(): DevToolsOptions;
+    /**
+     * Apply DevTools overrides to client options
+     * DevTools overrides take precedence over client-provided options
+     * @param clientOptions - Original client options
+     * @returns Modified options with DevTools overrides applied
+     */
+    applyOverrides<T extends DevToolsOptions>(clientOptions: T): T;
+}

package/devtools/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Type definitions for DevTools
+ */
+import type { ParamsObject } from '../static/Params';
+type Primitive = string | number | boolean;
+type PrimitiveKeys<T> = {
+    [K in keyof T]-?: Exclude<T[K], undefined> extends Primitive ? K : never;
+}[keyof T];
+export type PrimitiveParamsObject = Pick<ParamsObject, PrimitiveKeys<ParamsObject>>;
+/**
+ * Available DevTools options that can be overridden
+ * All properties are optional
+ */
+export type DevToolsOptions = Partial<PrimitiveParamsObject>;
+export {};

package/enums/HangupType.d.ts

@@ -38,6 +38,10 @@ declare enum HangupType {
      * Проблемы при работе через FastStart
      */
     FAST_START_ERROR = "FAST_START_ERROR",
+    /**
+     * Проблемы при работе через FastJoin
+     */
+    FAST_JOIN_ERROR = "FAST_JOIN_ERROR",
     /**
      * Таймаут инициализации вызова – звонок не начался
      *

package/enums/TrackId.d.ts

@@ -1,5 +1,6 @@
 export declare const enum TrackId {
     AUDIO_MIX = "audio-mix",
-    PARTICIPANT_AGNOSTIC_TRACK_PREFIX = "pat"
+    PARTICIPANT_AGNOSTIC_TRACK_PREFIX = "pat",
+    TRANSPARENT_AUDIO_TRACK_PREFIX = "ta"
 }
 export default TrackId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.10-dev.60145cdf.0",
+  "version": "2.8.10-dev.6360a014.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -15,7 +15,7 @@
   ],
   "dependencies": {
     "@vkontakte/calls-audio-effects": "1.2.8",
-    "@vkontakte/calls-video-effects": "2.2.3-beta.6",
+    "@vkontakte/calls-video-effects": "2.2.3-beta.7",
     "@vkontakte/calls-vmoji": "1.0.10-beta.17",
     "@vkontakte/libvpx": "2.0.9",
     "bit-buffer": "0.2.5",

package/static/Params.d.ts

@@ -278,42 +278,6 @@ export type ParamsObject = {
     preferVP9: boolean;
     /** @hidden */
     audioNack: boolean;
-    /**
-     * Принимать параллельно видео с камеры и трансляцию экрана от одного и того же участника.
-     * Работает только при приёме экрана через дата-канал.
-     *
-     * _По умолчанию: `true`_
-     * @deprecated
-     */
-    producerScreenTrack: boolean;
-    /**
-     * Отдавать трансляцию экрана отдельным стримом.
-     * Работает только при отправке экрана через дата-канал.
-     *
-     * _По умолчанию: `true`_
-     * @deprecated
-     */
-    consumerScreenTrack: boolean;
-    /**
-     * @hidden
-     * @deprecated
-     */
-    producerNotificationDataChannel: boolean;
-    /**
-     * @hidden
-     * @deprecated
-     */
-    producerCommandDataChannel: boolean;
-    /**
-     * @hidden
-     * @deprecated
-     */
-    consumerScreenDataChannel: boolean;
-    /**
-     * @hidden
-     * @deprecated
-     */
-    producerScreenDataChannel: boolean;
     /** @hidden */
     asrDataChannel: boolean;
     /**
@@ -390,27 +354,6 @@ export type ParamsObject = {
      * если параметр не проставлен то будет использоваться значение по умолчанию установленное на сервере
      */
     participantListChunkInitCount: number | null;
-    /**
-     * Включать RED-extension (redundancy) для групповых звонков
-     *
-     * _По умолчанию: `true`_
-     * @deprecated
-     */
-    serverAudioRed: boolean;
-    /**
-     * Включать RED-extension (redundancy) для p2p звонков
-     *
-     * _По умолчанию: `true`_
-     * @deprecated
-     */
-    p2pAudioRed: boolean;
-    /**
-     * Добавлять флаг spsPpsIdrInKeyframe для h264 кодека. В результате ключевые фреймы без sps и pps
-     * не используются как ключевые. Решает проблему с артефактами на видео в случае потерь пакетов.
-     * @hidden
-     * @deprecated
-     */
-    h264spsPpsIdrInKeyframe: boolean;
     /**
      * Разрешить вход в звонок одним пользователем с разных устройств одновременно
      *
@@ -450,6 +393,20 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     audioShare: boolean;
+    /**
+     * Включить возможность захвата звука системы при трансляции окна
+     *
+     * _По умолчанию: `false`_
+     * @hidden
+     */
+    audioShareWindowInclude: boolean;
+    /**
+     * Включить возможность захвата звука системы при трансляции всего экрана
+     *
+     * _По умолчанию: `false`_
+     * @hidden
+     */
+    audioShareSystemInclude: boolean;
     /**
      * Включить поддержку динамического контента при трансляция экрана
      *
@@ -474,10 +431,6 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     consumerFastScreenShareQualityOnDemand: boolean;
-    /**
-     * Использовать новые правила allMute для админа
-     */
-    newMuteRules: boolean;
     /**
      * Включить поддержку приостановки видео в плохой сети.
      *
@@ -527,6 +480,12 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     webtransportFF: boolean;
+    /**
+     * Включить поддержку прозрачного аудио
+     *
+     * _По умолчанию: `false`_
+     */
+    transparentAudio: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -909,6 +868,7 @@ export default abstract class Params {
     static set(data: {
         [key: string]: any;
     }): void;
+    static getScreenFrameRate(fastScreenShare: boolean): number;
     static get<N extends keyof ParamsObject>(name: N): ParamsObject[N];
     static get appName(): string;
     static get appVersion(): number;
@@ -993,20 +953,13 @@ export default abstract class Params {
     static get callStatReportEnabled(): boolean;
     static get clientEventsLoggingEnabled(): boolean;
     static get enableLogPerfStatReport(): boolean;
-    static get producerNotificationDataChannel(): boolean;
-    static get producerCommandDataChannel(): boolean;
-    static get consumerScreenDataChannel(): boolean;
-    static get producerScreenDataChannel(): boolean;
     static get asrDataChannel(): boolean;
     static get consumerScreenDataChannelPacketSize(): number;
     static get screenShareWebmBuilder(): boolean;
     static get noiseSuppression(): boolean;
-    static set noiseSuppression(value: boolean);
     static get preferH264(): boolean;
     static get preferVP9(): boolean;
     static get audioNack(): boolean;
-    static get consumerScreenTrack(): boolean;
-    static get producerScreenTrack(): boolean;
     static get movieShare(): boolean;
     static get videoTracksCount(): number;
     static get breakVideoPayloadTypes(): boolean;
@@ -1018,13 +971,12 @@ export default abstract class Params {
     static get waitForAdminInGroupCalls(): boolean;
     static get participantListChunkInitIndex(): number;
     static get participantListChunkInitCount(): number | null;
-    static get serverAudioRed(): boolean;
-    static get p2pAudioRed(): boolean;
-    static get h264spsPpsIdrInKeyframe(): boolean;
     static get filterObservers(): boolean;
     static get muteMode(): boolean;
     static get preserveAudioTracks(): boolean;
     static get audioShare(): boolean;
+    static get audioShareWindowInclude(): boolean;
+    static get audioShareSystemInclude(): boolean;
     static get fastScreenShare(): boolean;
     static get screenShareCongestionControl(): boolean;
     static get screenShareCongestionControlThreshold(): number;
@@ -1032,22 +984,20 @@ export default abstract class Params {
     static get fastScreenShareHeight(): number;
     static get consumerFastScreenShare(): boolean;
     static get consumerFastScreenShareQualityOnDemand(): boolean;
-    static get newMuteRules(): boolean;
     static get videoSuspend(): boolean;
     static get enumerateDevicesDelay(): number;
-    static getScreenFrameRate(fastScreenShare: boolean): number;
     static get switchVideoAtBadNetwork(): boolean;
     static get enableVideoEffectsFpsDegradation(): boolean;
     static get simulcast(): boolean;
-    static set simulcast(value: boolean);
     static get webtransport(): boolean;
-    static set webtransport(value: boolean);
     static get webtransportFF(): boolean;
-    static set webtransportFF(value: boolean);
+    static get transparentAudio(): boolean;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
         audioShare: boolean;
+        audioShareWindowInclude: boolean;
+        audioShareSystemInclude: boolean;
         useCallsToContacts: boolean;
         useParticipantListChunk: boolean;
         useRooms: boolean;
@@ -1068,7 +1018,6 @@ export default abstract class Params {
         callStatReportEnabled: boolean;
         joinFromMultipleDevices: boolean;
         movieShare: boolean;
-        newMuteRules: boolean;
         clientType: string;
         clientStatsPlatform: string;
         consumerScreenDataChannelPacketSize: number;
@@ -1076,5 +1025,6 @@ export default abstract class Params {
         simulcast: boolean;
         webtransport: boolean;
         webtransportFF: boolean;
+        transparentAudio: boolean;
     };
 }

package/static/Utils.d.ts

@@ -7,7 +7,7 @@ export declare const PARAMETERS_SEPARATOR = ":";
 export declare const DEVICE_IDX_PARAMETER = "d";
 /** @hidden */
 declare namespace Utils {
-    function patchLocalSDP(sdp: string, preferH264: boolean, brokenH264Decoder: boolean, preferVP9: boolean, h264spsPpsIdrInKeyframe: boolean, isAudioNack?: boolean, preferRed?: boolean): string;
+    function patchLocalSDP(sdp: string, preferH264: boolean, brokenH264Decoder: boolean, preferVP9: boolean, isAudioNack?: boolean): string;
     function patchRemoteSDP(sdp: string, oldDataChannelDescription: boolean, preferH264: boolean, brokenH264: boolean, preferVP9: boolean, brokenVP9Encoder: boolean, brokenVP9Decoder: boolean): string;
     function getPeerIdString(peerId: SignalingMessage.PeerId): string;
     function comparePeerId(peerId1: SignalingMessage.PeerId, peerId2: SignalingMessage.PeerId): boolean;

package/types/Conversation.d.ts

@@ -82,6 +82,7 @@ export type ConversationOnStartParams = {
     onlyAdminCanShareMovie?: boolean;
     externalIds?: ExternalId[];
     onFastStart?: FastStartHandler;
+    conversationId?: string;
 };
 export type StartConversationParams = {
     opponentIds?: OkUserId[];
@@ -95,4 +96,5 @@ export type StartConversationParams = {
     externalIds?: ExternalId[];
     startedTime: number;
     onFastStart?: FastStartHandler;
+    conversationId?: string;
 };

package/types/FastJoin.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Параметры для fast join
+ */
+export interface FastJoinParams {
+    joinLink: string;
+    isVideo: boolean;
+    internalParams: string;
+}
+export interface FastJoinResponse {
+    conversationId: string;
+    internalCallerParams: string;
+}
+export type FastJoinHandler = (params: FastJoinParams) => Promise<FastJoinResponse>;