@vkontakte/calls-sdk 2.8.11-beta.0 → 2.8.11-dev.3d9bb708.0

package/classes/CallRegistry.d.ts

@@ -0,0 +1,18 @@
+import Conversation from './Conversation';
+export interface HoldableConversation extends Conversation {
+    id: string;
+    hold(hold: boolean): Promise<void>;
+}
+export declare class CallRegistry {
+    private _conversations;
+    private _activeId;
+    add(conversation: HoldableConversation): void;
+    remove(id: string | null): void;
+    get(id: string): HoldableConversation | undefined;
+    getActive(): HoldableConversation | null;
+    getActiveId(): string | null;
+    has(id: string): boolean;
+    getAll(): HoldableConversation[];
+    setActive(id: string): Promise<void>;
+    clear(): void;
+}

package/classes/Conversation.d.ts

@@ -16,7 +16,7 @@ import { ConversationData, ConversationOnStartParams } from '../types/Conversati
 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 MediaSettings, { IVideoDimentions } from '../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
 import MuteStates from '../types/MuteStates';
 import { CompositeUserId, IGetParticipantsParameters, ParticipantId, ParticipantStateData } from '../types/Participant';
@@ -27,6 +27,7 @@ import { ParticipantStreamDescription } from '../types/ParticipantStreamDescript
 import { ScreenCaptureSettings } from '../types/ScreenCaptureSettings';
 import SignalingMessage from '../types/SignalingMessage';
 import { WaitingHallResponse } from '../types/WaitingHall';
+import { CallRegistry } from './CallRegistry';
 import EventEmitter from './EventEmitter';
 export default class Conversation extends EventEmitter {
     private readonly _api;
@@ -49,10 +50,8 @@ export default class Conversation extends EventEmitter {
     private _lastSignalledActiveSpeakerId;
     private _isRealTimeAsrRequested;
     private _serverSettings;
-    private static _current;
-    private static _activationMutex;
-    private static _delayedHangup;
-    private static _abortController;
+    private _delayedHangup;
+    private _abortController;
     private readonly _onUnload;
     private readonly _audioOutput;
     private _lastStalled;
@@ -69,6 +68,10 @@ export default class Conversation extends EventEmitter {
     static current(): Conversation | null;
     static hangupAfterInit(): void;
     static id(): string | null;
+    get id(): string;
+    get externalId(): ExternalParticipantId | undefined;
+    get mediaSettings(): MediaSettings | undefined;
+    get isCallHeld(): boolean;
     onStart({ opponentIds, opponentType, mediaOptions, payload, joiningAllowed, requireAuthToJoin, onlyAdminCanShareMovie, externalIds, onFastStart, conversationId, }: ConversationOnStartParams): Promise<ConversationData>;
     onJoin(joinArgs: {
         conversationId?: string;
@@ -402,6 +405,10 @@ export default class Conversation extends EventEmitter {
     private _getParticipants;
     private _getParticipant;
 }
+declare const _callRegistry: CallRegistry;
+export { _callRegistry };
+declare function _resetPendingInstance(): void;
+export { _resetPendingInstance };
 export declare class UpdateDisplayLayoutError extends Error {
     readonly participantErrors: {
         externalId: ExternalParticipantId;

package/classes/MediaSource.d.ts

@@ -45,6 +45,7 @@ export declare class MediaSource extends EventEmitter {
     /** Трек аудио эффектов. Не изменяется на протяжении всего времени */
     private _audioEffectsTrack;
     private _mediaSettings;
+    private _lastMediaSettings;
     private _videoStatusOnScreenCapturingEnabled;
     private _effect;
     private _audioEffectParams;
@@ -63,7 +64,7 @@ export declare class MediaSource extends EventEmitter {
     getSendAudioTrack(): MediaStreamTrack | null;
     get isAnimojiRequested(): boolean;
     addTrackToPeerConnection(pc: RTCPeerConnection, observer: boolean, noDataChannel: boolean): void;
-    getMediaSettings(): MediaSettings;
+    get mediaSettings(): MediaSettings;
     changeDevice(kind: MediaDeviceKind): Promise<void>;
     /**
      * Установка кастомного стрима для видео, например внешний шаринг экрана
@@ -91,6 +92,8 @@ export declare class MediaSource extends EventEmitter {
     private _setEffect;
     private _stopEffect;
     destroy(): void;
+    stopLocalMedia(): void;
+    resumeLocalMedia(): Promise<void>;
     toggleScreenCapturing(settings: ScreenCaptureSettings): Promise<void>;
     disableScreenCapturing(): Promise<void>;
     private videoTrackMuteHandler;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.11-beta.0",
+  "version": "2.8.11-dev.3d9bb708.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/External.d.ts

@@ -47,8 +47,9 @@ declare namespace External {
      *
      * @param stream
      * @param mediaSettings
+     * @param conversationId ID звонка
      */
-    function onLocalStream(stream: MediaStream | null, mediaSettings: MediaSettings): void;
+    function onLocalStream(stream: MediaStream | null, mediaSettings: MediaSettings, conversationId?: string): void;
     /**
      * Локальный стрим с экрана добавлен/удалён
      *
@@ -80,16 +81,18 @@ declare namespace External {
      * Изменился статус локального соединения
      *
      * @param status
+     * @param conversationId ID звонка
      */
-    function onLocalStatus(status: ParticipantStatus): void;
+    function onLocalStatus(status: ParticipantStatus, conversationId?: string): void;
     /**
      * Получен стрим собеседника.
      * Если сервер закончил стримить собеседника, вместо стрима будет передан null
      *
      * @param userId
      * @param stream
+     * @param conversationId ID звонка
      */
-    function onRemoteStream(userId: ExternalParticipantId, stream: MediaStream | null): void;
+    function onRemoteStream(userId: ExternalParticipantId, stream: MediaStream | null, conversationId?: string): void;
     /**
      * Получен стрим лайв от собеседника.
      * Если сервер закончил стримить собеседника, вместо стрима будет передан null
@@ -126,8 +129,9 @@ declare namespace External {
      *
      * @param userId
      * @param stream
+     * @param conversationId ID звонка
      */
-    function onRemoteScreenStream(userId: ExternalParticipantId, stream: MediaStream | null): void;
+    function onRemoteScreenStream(userId: ExternalParticipantId, stream: MediaStream | null, conversationId?: string): void;
     /**
      * Получен стрим вимоджи собеседника.
      * Если сервер закончил стримить собеседника, вместо стрима будет передан null
@@ -152,8 +156,9 @@ declare namespace External {
      * @param muteStates Состояние устройств при входе в звонок
      * @param participants Список участников звонка
      * @param rooms Список сессионных залов в звонке
+     * @param conversationId ID звонка
      */
-    function onConversation(userId: ExternalParticipantId, mediaModifiers: MediaModifiers, muteStates: MuteStates, participants: ExternalParticipant[], rooms?: Rooms): void;
+    function onConversation(userId: ExternalParticipantId, mediaModifiers: MediaModifiers, muteStates: MuteStates, participants: ExternalParticipant[], rooms?: Rooms, conversationId?: string): void;
     /**
      * Постраничные данные про участников при начале звонка
      * @param chunk
@@ -219,15 +224,17 @@ declare namespace External {
      *
      * @param userId
      * @param markers
+     * @param conversationId ID звонка
      */
-    function onParticipantAdded(userId: ExternalId, markers: ExternalParticipantListMarkers | null): void;
+    function onParticipantAdded(userId: ExternalId, markers: ExternalParticipantListMarkers | null, conversationId?: string): void;
     /**
      * Участник подключился
      *
      * @param userId
      * @param markers
+     * @param conversationId ID звонка
      */
-    function onParticipantJoined(userId: ExternalId, markers: ExternalParticipantListMarkers | null): void;
+    function onParticipantJoined(userId: ExternalId, markers: ExternalParticipantListMarkers | null, conversationId?: string): void;
     function onLocalParticipantState(participantState: ParticipantStateMapped, global?: boolean): void;
     /**
      * Изменились данные состояний собеседника
@@ -250,8 +257,9 @@ declare namespace External {
      * @param userIds
      * @param status
      * @param data
+     * @param conversationId ID звонка
      */
-    function onRemoteStatus(userIds: ExternalParticipantId[], status: ParticipantStatus, data?: any): void;
+    function onRemoteStatus(userIds: ExternalParticipantId[], status: ParticipantStatus, data?: any, conversationId?: string): void;
     /**
      * Разрешения на доступы были запрошены в браузере
      */
@@ -268,23 +276,26 @@ declare namespace External {
      *
      * @param userId
      * @param markers
+     * @param conversationId ID звонка
      */
-    function onRemoteRemoved(userId: ExternalParticipantId, markers: ExternalParticipantListMarkers | null): void;
+    function onRemoteRemoved(userId: ExternalParticipantId, markers: ExternalParticipantListMarkers | null, conversationId?: string): void;
     /**
      * Изменилось состояние звонка
      *
      * @param isCallActive Активен ли сейчас звонок
      * @param canAddParticipants Можно ли добавлять собеседников
      * @param conversation Информация о звонке
+     * @param conversationId ID звонка
      */
-    function onCallState(isCallActive: boolean, canAddParticipants: boolean, conversation: ConversationData): void;
+    function onCallState(isCallActive: boolean, canAddParticipants: boolean, conversation: ConversationData, conversationId?: string): void;
     /**
      * Изменилось состояние камеры или микрофона
      *
      * @param mediaOption Тип устройства
      * @param enabled Включено или выключено
+     * @param conversationId ID звонка
      */
-    function onDeviceSwitched(mediaOption: MediaOption, enabled: boolean): void;
+    function onDeviceSwitched(mediaOption: MediaOption, enabled: boolean, conversationId?: string): void;
     /**
      * Изменились состояния устройств пользователя или разрешения включать камеру/микрофон
      *
@@ -339,21 +350,34 @@ declare namespace External {
     function onOptionsChanged(options: ConversationOption[]): void;
     /**
      * Входящий звонок был принят мной
+     *
+     * @param conversationId ID звонка
+     */
+    function onCallAccepted(conversationId?: string): void;
+    /**
+     * Входящий звонок получен во время активного звонка
+     *
+     * @param conversationId ID звонка
+     * @param externalId
+     * @param mediaSettings
      */
-    function onCallAccepted(): void;
+    function onIncomingCall(conversationId: string, externalId: ExternalParticipantId | undefined, mediaSettings: MediaSettings | undefined): void;
     /**
      * Исходящий звонок был принят кем-то
+     *
      * @param userId
      * @param capabilities
+     * @param conversationId ID звонка
      */
-    function onAcceptedCall(userId: ExternalId, capabilities: ParticipantCapabilities): void;
+    function onAcceptedCall(userId: ExternalId, capabilities: ParticipantCapabilities, conversationId?: string): void;
     function onRateNeeded(): void;
     /**
      * Изменился говорящий в звонке
      *
      * @param userId
+     * @param conversationId ID звонка
      */
-    function onSpeakerChanged(userId: ExternalParticipantId): void;
+    function onSpeakerChanged(userId: ExternalParticipantId, conversationId?: string): void;
     /**
      * Громкость собеседников
      *

package/static/Params.d.ts

@@ -490,7 +490,7 @@ export type ParamsObject = {
     /**
      * Получен локальный стрим с камеры/микрофона
      */
-    onLocalStream?: (stream: MediaStream | null, mediaSettings: MediaSettings) => void;
+    onLocalStream?: (stream: MediaStream | null, mediaSettings: MediaSettings, conversationId?: string) => void;
     /**
      * Локальный стрим изменился
      */
@@ -510,12 +510,12 @@ export type ParamsObject = {
     /**
      * Изменился статус локального соединения
      */
-    onLocalStatus?: (status: ParticipantStatus) => void;
+    onLocalStatus?: (status: ParticipantStatus, conversationId?: string) => void;
     /**
      * Получен стрим собеседника.
      * Если сервер закончил стримить собеседника, вместо стрима будет передан null
      */
-    onRemoteStream?: (userId: ExternalParticipantId, stream: MediaStream | null) => void;
+    onRemoteStream?: (userId: ExternalParticipantId, stream: MediaStream | null, conversationId?: string) => void;
     /**
      * Cтрим собеседника приостановлен/возобновлен.
      */
@@ -524,7 +524,7 @@ export type ParamsObject = {
      * Получен стрим с экрана собеседника.
      * Если сервер закончил стримить экран собеседника, вместо стрима будет передан null
      */
-    onRemoteScreenStream?: (userId: ExternalParticipantId, stream: MediaStream | null) => void;
+    onRemoteScreenStream?: (userId: ExternalParticipantId, stream: MediaStream | null, conversationId?: string) => void;
     /**
      * Получен стрим вимоджи собеседника.
      * Если сервер закончил стримить вимоджи собеседника, вместо стрима будет передан null
@@ -551,7 +551,7 @@ export type ParamsObject = {
     /**
      * Начат звонок
      */
-    onConversation?: (userId: ExternalParticipantId, mediaModifiers: MediaModifiers, muteStates: MuteStates, participants: ExternalParticipant[], rooms?: Rooms) => void;
+    onConversation?: (userId: ExternalParticipantId, mediaModifiers: MediaModifiers, muteStates: MuteStates, participants: ExternalParticipant[], rooms?: Rooms, conversationId?: string) => void;
     /**
      * Начальный список участников для постраничного звонка
      */
@@ -583,11 +583,11 @@ export type ParamsObject = {
     /**
      * Добавили участника
      */
-    onParticipantAdded?: (userId: ExternalParticipantId, markers: ExternalParticipantListMarkers | null) => void;
+    onParticipantAdded?: (userId: ExternalParticipantId, markers: ExternalParticipantListMarkers | null, conversationId?: string) => void;
     /**
      * Участник присоединился к звонку
      */
-    onParticipantJoined?: (userId: ExternalParticipantId, markers: ExternalParticipantListMarkers) => void;
+    onParticipantJoined?: (userId: ExternalParticipantId, markers: ExternalParticipantListMarkers, conversationId?: string) => void;
     /**
      * Получены данные по изменению локальных состояний со стороны админа
      * Например, принудительно опущена рука
@@ -607,7 +607,7 @@ export type ParamsObject = {
     /**
      * Изменился статус соединения собеседников
      */
-    onRemoteStatus?: (userIds: ExternalParticipantId[], status: ParticipantStatus, data: any) => void;
+    onRemoteStatus?: (userIds: ExternalParticipantId[], status: ParticipantStatus, data: any, conversationId?: string) => void;
     /**
      * Разрешения на доступы были запрошены в браузере
      */
@@ -619,15 +619,15 @@ export type ParamsObject = {
     /**
      * Пользователь отключился от звонка
      */
-    onRemoteRemoved?: (userId: ExternalParticipantId, markers: ExternalParticipantListMarkers | null) => void;
+    onRemoteRemoved?: (userId: ExternalParticipantId, markers: ExternalParticipantListMarkers | null, conversationId?: string) => void;
     /**
      * Изменилось состояние звонка
      */
-    onCallState?: (isCallActive: boolean, canAddParticipants: boolean, conversation: ConversationData) => void;
+    onCallState?: (isCallActive: boolean, canAddParticipants: boolean, conversation: ConversationData, conversationId?: string) => void;
     /**
      * Изменилось состояние камеры или микрофона
      */
-    onDeviceSwitched?: (mediaOption: MediaOption, enabled: boolean) => void;
+    onDeviceSwitched?: (mediaOption: MediaOption, enabled: boolean, conversationId?: string) => void;
     /**
      * Изменились состояния устройств пользователя или разрешения включать камеру/микрофон
      */
@@ -656,7 +656,7 @@ export type ParamsObject = {
     /**
      * Изменился говорящий в звонке
      */
-    onSpeakerChanged?: (userId: ExternalParticipantId) => void;
+    onSpeakerChanged?: (userId: ExternalParticipantId, conversationId?: string) => void;
     /**
      * Громкость собеседников
      */
@@ -676,12 +676,12 @@ export type ParamsObject = {
     /**
      * Входящий звонок был принят мной
      */
-    onCallAccepted?: () => void;
+    onCallAccepted?: (conversationId?: string) => void;
     /**
      * Исходящий звонок был принят кем-то
      * @param userId
      */
-    onAcceptedCall?: (userId: ExternalParticipantId, capabilities: ParticipantCapabilities) => void;
+    onAcceptedCall?: (userId: ExternalParticipantId, capabilities: ParticipantCapabilities, conversationId?: string) => void;
     /**
      * Список устройств изменился
      */
@@ -859,6 +859,14 @@ export type ParamsObject = {
      * @param demoted участник разжалован
      */
     onPromoted?: (demoted: boolean) => void;
+    /**
+     * Входящий звонок получен во время активного звонка
+     *
+     * @param conversationId ID звонка
+     * @param externalId Внешний ID вызывающего
+     * @param mediaSettings Настройки медиа
+     */
+    onIncomingCall?: (conversationId: string, externalId: ExternalParticipantId | undefined, mediaSettings: MediaSettings | undefined) => void;
     /**
      * Собеседник подключился к сигналлингу
      */