@vkontakte/calls-sdk 2.8.11-dev.af7eda54.0 → 2.8.11-dev.b9508cee.0

package/CallsSDK.d.ts

@@ -9,7 +9,7 @@ import { AddParticipantParams } from './abstract/BaseSignaling';
 import HangupReason, { HangupReasonData, CustomError } from './classes/HangupReason';
 import { MediaTrackKind } from './classes/MediaSource';
 import { AudienceModeHandsResponse } from './types/AudienceMode';
-import { TransportTopology } from './classes/transport/Transport';
+import TransportTopology from './enums/TransportTopology';
 import Api from './default/Api';
 import Signaling from './default/Signaling';
 import CallDirection from './enums/CallDirection';
@@ -50,7 +50,7 @@ import { IAddMovieParams, IMovieMetaData, IMoviePreview, IOnRemoteMovieData, ISh
 import MuteStates, { IMuteParticipantInternalParams, IMuteParticipantParams } from './types/MuteStates';
 import { IAPIBaseUrl, IApiEnv } from './types/Params';
 import { CompositeUserId, IGetParticipantsParameters, OkUserId, ParticipantId, ParticipantListMarker, ParticipantListMarkers, ParticipantListType, ParticipantsStateList, ParticipantStateMapped, ParticipantStateData, ParticipantStateDataKey, ParticipantStateDataValue } from './types/Participant';
-import ParticipantLayout, { Layout, RequestKeyFrame, StopStream } from './types/ParticipantLayout';
+import ParticipantLayout, { DisplayLayoutRequest, Layout, RequestKeyFrame, StopStream } from './types/ParticipantLayout';
 import { ParticipantListChunkParameters } from './types/ParticipantListChunk';
 import ParticipantPriority from './types/ParticipantPriority';
 import { MediaType, ParticipantStreamDescription } from './types/ParticipantStreamDescription';
@@ -67,6 +67,7 @@ import { VmojiError } from './types/Vmoji';
 import { VolumeDetector } from './classes/VolumeDetector';
 import { FastStartHandler, FastStartParams } from './types/FastStart';
 import { FastJoinHandler, FastJoinParams, FastJoinResponse } from './types/FastJoin';
+import PushData from './types/PushData';
 export type { CurrentLogItem, DebugLogGetParams, DebugLogSessionInfo, DebugLogStorageStats } from './utils/DebugStorage';
 /**
  * Информация о текущем браузере
@@ -255,6 +256,7 @@ export declare function callInternal(ids: OkUserId[], type: CallType | undefined
  */
 export declare function processPush(conversationId: string, conversationParams?: string): Promise<void>;
 export declare function processPushInternal(conversationId: string, type?: UserType, peerId?: number, conversationParams?: string, wsEndpoint?: string, userId?: number): Promise<void>;
+export declare function getInbounds(): Promise<PushData[]>;
 /**
  * Авторизоваться для совершения звонков
  *
@@ -267,11 +269,11 @@ export declare function authorize(authToken?: string, apiBaseUrl?: IAPIBaseUrl):
  *
  * @param mediaOptions Нужно ли включать камеру и микрофон
  */
-export declare function acceptCall(mediaOptions?: MediaOption[]): Promise<ConversationData>;
+export declare function acceptCall(mediaOptions?: MediaOption[], conversationId?: string): Promise<ConversationData>;
 /**
  * Отклонить входящий звонок
  */
-export declare function declineCall(): Promise<void>;
+export declare function declineCall(conversationId?: string): Promise<void>;
 /**
  * Присоединиться к активному звонку
  *
@@ -294,7 +296,7 @@ export declare function joinCallByLink(joinLink: string, mediaOptions?: MediaOpt
 /**
  * Завершить текущий разговор
  */
-export declare function hangup(): Promise<void>;
+export declare function hangup(conversationId?: string): Promise<void>;
 /**
  * Добавить собеседника в звонок
  *
@@ -342,7 +344,7 @@ export declare function changeDevice(kind: MediaDeviceKind, deviceId: string): P
  *      state Включить или выключить захват экрана
  *      settings Параметры захваты экрана
  */
-export declare function captureScreen(stateOrSettings: boolean | ScreenCaptureSettings): Promise<void>;
+export declare function captureScreen(stateOrSettings: boolean | ScreenCaptureSettings, conversationId?: string): Promise<void>;
 /**
  * Включить/выключить передачу точек вимоджи
  *
@@ -363,13 +365,13 @@ export declare function setVideoStream(stream: MediaStream, isScreen?: boolean):
  *
  * @param enabled
  */
-export declare function toggleLocalVideo(enabled: boolean): Promise<void>;
+export declare function toggleLocalVideo(enabled: boolean, conversationId?: string): Promise<void>;
 /**
  * Включить или выключить свой микрофон
  *
  * @param enabled
  */
-export declare function toggleLocalAudio(enabled: boolean): Promise<void>;
+export declare function toggleLocalAudio(enabled: boolean, conversationId?: string): Promise<void>;
 /**
  * Изменяет размеры локального видео
  *
@@ -395,12 +397,6 @@ export declare function changePriorities(priorities: ParticipantPriority[]): Pro
  * @param externalId Внешний ID пользователя
  */
 export declare function changeParticipantState(state: ParticipantStateData, externalId?: ExternalId): Promise<void>;
-/**
- * Ставит звонок на удержание
- *
- * @param hold - true/false
- */
-export declare function hold(hold: boolean): Promise<void>;
 /**
  * Принудительно опустить руки участников в текущем сессионном зале админа
  */
@@ -412,6 +408,12 @@ export declare function putHandsDown(): Promise<void>;
  * @param layout Список приоритетов
  */
 export declare function updateDisplayLayout(layout: ParticipantLayout[]): Promise<void>;
+/**
+ * Запрашивает стримы, которые клиент хочет получать для отображения.
+ *
+ * @param requests Полный список стримов, которые должны приходить на клиент
+ */
+export declare function requestDisplayLayout(requests: DisplayLayoutRequest[]): Promise<void>;
 /**
  * Выдать или забрать роли в звонке пользователю
  *
@@ -645,15 +647,15 @@ export declare const debugLogs: {
      */
     list: typeof DebugStorage.list;
     /**
-     * Возвращает логи конкретного звонка.
+     * Возвращает логи конкретного звонка вместе с глобальным контекстом SDK.
      */
     get: typeof DebugStorage.get;
     /**
-     * Возвращает логи конкретного звонка JSON-строкой.
+     * Возвращает логи конкретного звонка вместе с глобальным контекстом SDK JSON-строкой.
      */
     getJson: typeof DebugStorage.getJson;
     /**
-     * Скачивает логи конкретного звонка JSON-файлом.
+     * Скачивает логи конкретного звонка вместе с глобальным контекстом SDK JSON-файлом.
      */
     download: typeof DebugStorage.download;
     /**
@@ -742,16 +744,7 @@ export declare function acceptPromotion(reject?: boolean): Promise<void>;
 export declare function getParticipantListChunk(participantListChunkParameters: ParticipantListChunkParameters): Promise<ExternalParticipantListChunk>;
 export declare function getParticipants(parameters: IGetParticipantsParameters): Promise<ExternalParticipant[]>;
 export declare function feedback(key: string): Promise<SignalingMessage>;
-export declare function userFeedbackStats(userResponse: number, reason?: string, groupCallUsersCount?: number): void;
-/**
- * Логирует клиентское событие статистики
- *
- * @param eventType Тип события
- * @param eventData Дополнительные данные события
- * @param immediatelty Отправить ли событие немедленно
- */
-export declare function logClientEvent(eventType: string, eventData?: Record<string, string | number | boolean>, immediately?: boolean): void;
-export declare function enableFeatureForRoles(feature: ConversationFeature, roles: UserRole[]): Promise<void>;
+export declare function enableFeatureForRoles(feature: ConversationFeature, roles: UserRole[], conversationId?: string): Promise<void>;
 /**
  * Удаляет записи истории звонков
  *
@@ -775,6 +768,8 @@ export declare function stopUrlSharing(): Promise<void>;
 export declare function sendTestCommand(name: string, params?: any): void;
 export declare function startAnalyzingAudio(expectAudio: boolean, expectedActiveTracks?: number | null, expectedTrackFrequencies?: number[] | null): void;
 export declare function stopAnalyzingAudio(): void;
+export declare function switchCall(conversationId: string): Promise<void>;
+export declare function getActiveCallId(): string | null;
 /**
  * Возвращает текущее время, скорректированное на смещение относительно серверного времени.
  * Доступно после установки соединения (начало/присоединение к звонку).
@@ -785,5 +780,5 @@ export declare function getSyncedTime(): number;
  * Версия SDK
  */
 export declare function version(): string;
-export type { AddParticipantParams, AudienceModeHandsResponse, BrowserName, CompositeUserId, ConversationData, ConversationParams, ConversationResponse, CustomError, ExternalId, ExternalParticipant, ExternalParticipantListChunk, ExternalParticipantListMarker, ExternalParticipantListMarkers as ExternalParticipantMarkers, ExternalParticipantId, GetParticipantsSignalingResponse, GetRoomsSignalingResponse, HangupReasonData, IApiEnv, IAPIBaseUrl, IAsrStartParams, IAsrStopParams, IAsrData, IceServer, JSONArray, JSONObject, JSONType, Layout, MediaModifiers, MediaSettings, MuteStates, OkUserId, ParamsObject, ParticipantId, ParticipantLayout, ParticipantListMarkers, ParticipantListType, ParticipantPriority, ParticipantsStateList, ParticipantStateData, ParticipantStateDataKey, ParticipantStateMapped, ParticipantStreamDescription, ParticipantListChunkParameters, ParticipantListMarker, RequestKeyFrame, Rooms, IGetParticipantsParameters, ScreenCaptureSettings, SignalingMessage, StatResult, StopStream, WaitingHallResponse, IMovieMetaData, IVideoDimentions, IFeedbackExternal, ISharedMovieInfo, ISharedMovieStoppedInfo, ISharedMovieState, ISharedMovieStateResponse, IAddMovieParams, IOnRemoteMovieData, IMoviePreview, IRoomId, Room, RoomsUpdate, RoomParticipantUpdate, IUpdateMovieData, IFeaturesPerRole, IMuteParticipantParams, IMuteParticipantInternalParams, IStartStreamData, IStopStreamData, IPublishStreamData, VmojiError, FastStartHandler, FastStartParams, FastJoinHandler, FastJoinParams, FastJoinResponse, };
+export type { AddParticipantParams, AudienceModeHandsResponse, BrowserName, CompositeUserId, ConversationData, ConversationParams, ConversationResponse, CustomError, ExternalId, ExternalParticipant, ExternalParticipantListChunk, ExternalParticipantListMarker, ExternalParticipantListMarkers as ExternalParticipantMarkers, ExternalParticipantId, DisplayLayoutRequest, GetParticipantsSignalingResponse, GetRoomsSignalingResponse, HangupReasonData, IApiEnv, IAPIBaseUrl, IAsrStartParams, IAsrStopParams, IAsrData, IceServer, JSONArray, JSONObject, JSONType, Layout, MediaModifiers, MediaSettings, MuteStates, OkUserId, ParamsObject, ParticipantId, ParticipantLayout, ParticipantListMarkers, ParticipantListType, ParticipantPriority, ParticipantsStateList, ParticipantStateData, ParticipantStateDataKey, ParticipantStateMapped, ParticipantStreamDescription, ParticipantListChunkParameters, ParticipantListMarker, RequestKeyFrame, Rooms, IGetParticipantsParameters, ScreenCaptureSettings, SignalingMessage, StatResult, StopStream, WaitingHallResponse, IMovieMetaData, IVideoDimentions, IFeedbackExternal, ISharedMovieInfo, ISharedMovieStoppedInfo, ISharedMovieState, ISharedMovieStateResponse, IAddMovieParams, IOnRemoteMovieData, IMoviePreview, IRoomId, Room, RoomsUpdate, RoomParticipantUpdate, IUpdateMovieData, IFeaturesPerRole, IMuteParticipantParams, IMuteParticipantInternalParams, IStartStreamData, IStopStreamData, IPublishStreamData, VmojiError, FastStartHandler, FastStartParams, FastJoinHandler, FastJoinParams, FastJoinResponse, };
 export { Api, AuthData, BaseLogger, CallDirection, CallType, ChatRoomEventType, ConversationOption, DebugMessageType, ExternalIdType, FacingMode, FatalError, HangupReason, HangupType, MediaOption, MediaTrackKind, MediaType, MuteState, ParticipantState, ParticipantStateDataValue, ParticipantStatus, RecordRole, Signaling, SignalingCommandType, SignalingConnectionType, SignalingNotification, UserRole, UserType, TransportTopology, RoomsEventType, ConversationFeature, ArrayDequeue, ApiExternal, VolumeDetector, };

package/abstract/BaseApi.d.ts

@@ -5,6 +5,7 @@ import ConversationParams from '../types/ConversationParams';
 import ConversationResponse from '../types/ConversationResponse';
 import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/ExternalId';
 import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
+import PushData from '../types/PushData';
 export type ClientStats = {
     vcid: ConversationData['id'] | null;
     [k: string]: string | number | boolean | null;
@@ -68,14 +69,10 @@ export default abstract class BaseApi {
      * method: vchat.clientStats
      */
     logClientStats(items: ClientStats[]): void;
-    /**
-     * method: vchat.clientEvents
-     */
-    logClientEvents(items: ClientEvent[]): void;
     abstract uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
-    abstract getExternalIdsByOkIds(uids: OkUserId[]): Promise<ExternalParticipantId[]>;
     getCachedOkIdByExternalId(externalId: ExternalId): ParticipantId | null;
     getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
+    getCachedExternalIdByOkId(okId: OkUserId): ExternalParticipantId | null;
     cacheExternalId(compositeId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
     mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, okId: OkUserId | CompositeUserId): void;
     unmapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId): void;
@@ -85,4 +82,5 @@ export default abstract class BaseApi {
     removeHistoryRecords(recordIds: number[]): Promise<void>;
     getServerTime(): Promise<number>;
     cleanup(): void;
+    getInbounds(): Promise<PushData[]>;
 }

package/abstract/BaseSignaling.d.ts

@@ -1,9 +1,10 @@
 import EventEmitter from '../classes/EventEmitter';
 import { ParticipantIdRegistry } from '../classes/ParticipantIdRegistry';
+import { TCapabilities } from '../types/Capabilities';
 import { StreamDescriptionString } from '../types/ParticipantStreamDescription';
 import { PerfStatReport } from '../types/PerfStatReporter';
 import { NetworkStatReport } from '../types/NetworkStatReport';
-import { TransportTopology } from '../classes/transport/Transport';
+import TransportTopology from '../enums/TransportTopology';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
 import MediaOption from '../enums/MediaOption';
@@ -61,14 +62,12 @@ export default abstract class BaseSignaling extends EventEmitter {
     abstract sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidate): Promise<SignalingMessage>;
     abstract changeMediaSettings(mediaSettings: MediaSettings): Promise<SignalingMessage>;
     abstract changeParticipantState(state: ParticipantStateData, compositeUserId?: CompositeUserId): Promise<SignalingMessage>;
-    abstract hold(hold: boolean): Promise<SignalingMessage>;
+    abstract hold(hold: boolean, capabilities?: TCapabilities): Promise<SignalingMessage>;
     abstract putHandsDown(): Promise<SignalingMessage>;
     abstract addParticipant(externalIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
     abstract addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
     abstract removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<SignalingMessage>;
-    abstract allocateConsumer(description: RTCSessionDescription | null, capabilities: {
-        [key: string]: number | boolean | string;
-    }): Promise<SignalingMessage>;
+    abstract allocateConsumer(description: RTCSessionDescription | null, capabilities: TCapabilities): Promise<SignalingMessage>;
     abstract acceptProducer(description: RTCSessionDescriptionInit, ssrcs: string[], sessionId: string): Promise<SignalingMessage>;
     /**
      * @deprecated Use updateDisplayLayout instead