@vkontakte/calls-sdk 2.8.11-dev.185dd9e4.0 → 2.8.11-dev.1cb064f7.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';
@@ -30,6 +30,7 @@ import SignalingNotification from './enums/SignalingNotification';
 import UserRole from './enums/UserRole';
 import UserType from './enums/UserType';
 import { DebugMessageType } from './static/Debug';
+import * as DebugStorage from './utils/DebugStorage';
 import { ParticipantStatus } from './static/External';
 import { JSONArray, JSONObject, JSONType } from './static/Json';
 import { ParamsObject } from './static/Params';
@@ -49,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';
@@ -66,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';
+export type { CurrentLogItem, DebugLogGetParams, DebugLogSessionInfo, DebugLogStorageStats } from './utils/DebugStorage';
 /**
  * Информация о текущем браузере
  */
@@ -265,11 +267,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>;
 /**
  * Присоединиться к активному звонку
  *
@@ -292,7 +294,7 @@ export declare function joinCallByLink(joinLink: string, mediaOptions?: MediaOpt
 /**
  * Завершить текущий разговор
  */
-export declare function hangup(): Promise<void>;
+export declare function hangup(conversationId?: string): Promise<void>;
 /**
  * Добавить собеседника в звонок
  *
@@ -340,7 +342,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>;
 /**
  * Включить/выключить передачу точек вимоджи
  *
@@ -361,13 +363,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>;
 /**
  * Изменяет размеры локального видео
  *
@@ -393,12 +395,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>;
 /**
  * Принудительно опустить руки участников в текущем сессионном зале админа
  */
@@ -410,6 +406,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>;
 /**
  * Выдать или забрать роли в звонке пользователю
  *
@@ -631,6 +633,38 @@ export declare function debug(enabled: boolean): void;
  * @param args
  */
 export declare function debugMessage(type: DebugMessageType, ...args: any[]): void;
+/**
+ * Локальные отладочные логи, сохраненные в браузере.
+ *
+ * Работает при включенном параметре `debugLog: true`.
+ * Логи хранятся в IndexedDB: последние 10 звонков, максимум 25 МБ суммарно.
+ */
+export declare const debugLogs: {
+    /**
+     * Возвращает список сохраненных локальных сессий логирования.
+     */
+    list: typeof DebugStorage.list;
+    /**
+     * Возвращает логи конкретного звонка вместе с глобальным контекстом SDK.
+     */
+    get: typeof DebugStorage.get;
+    /**
+     * Возвращает логи конкретного звонка вместе с глобальным контекстом SDK JSON-строкой.
+     */
+    getJson: typeof DebugStorage.getJson;
+    /**
+     * Скачивает логи конкретного звонка вместе с глобальным контекстом SDK JSON-файлом.
+     */
+    download: typeof DebugStorage.download;
+    /**
+     * Очищает логи конкретного звонка или все локальные логи SDK.
+     */
+    clear: typeof DebugStorage.clear;
+    /**
+     * Возвращает статистику локального хранилища логов.
+     */
+    stats: typeof DebugStorage.stats;
+};
 /**
  * Отправляет клиенские логи по conversationId на сервер OK
  * @example можно посмотреть в examples/anonym/index.html
@@ -741,9 +775,17 @@ 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;
+/**
+ * Возвращает текущее время, скорректированное на смещение относительно серверного времени.
+ * Доступно после установки соединения (начало/присоединение к звонку).
+ * Если активного звонка нет — возвращает Date.now().
+ */
+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

@@ -7,7 +7,7 @@ import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/Exte
 import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
 export type ClientStats = {
     vcid: ConversationData['id'] | null;
-    [k: string]: string | number | null;
+    [k: string]: string | number | boolean | null;
 };
 export type ClientEvent = {
     timestamp: number;

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