@vkontakte/calls-sdk 2.8.5-dev.1925f9b.0 → 2.8.5-dev.2b864c42.0

package/CallsSDK.d.ts

@@ -5,7 +5,7 @@ import type { IEffect, VideoEffects } from '@vkontakte/calls-video-effects';
 import type * as Vmoji from '@vkontakte/calls-vmoji';
 import BaseApi from './abstract/BaseApi';
 import BaseLogger from './abstract/BaseLogger';
-import BaseSignaling, { AddParticipantParams } from './abstract/BaseSignaling';
+import { AddParticipantParams } from './abstract/BaseSignaling';
 import HangupReason, { HangupReasonData } from './classes/HangupReason';
 import { MediaTrackKind } from './classes/MediaSource';
 import { AudienceModeHandsResponse } from './types/AudienceMode';
@@ -48,7 +48,7 @@ import { IVideoDimentions, MediaSettings } from './types/MediaSettings';
 import { IAddMovieParams, IMovieMetaData, IMoviePreview, IOnRemoteMovieData, ISharedMovieInfo, ISharedMovieState, ISharedMovieStateResponse, ISharedMovieStoppedInfo, IUpdateMovieData } from './types/MovieShare';
 import MuteStates, { IMuteParticipantInternalParams, IMuteParticipantParams } from './types/MuteStates';
 import { IApiEnv } from './types/Params';
-import { CompositeUserId, IGetParticipantsParameters, OkUserId, ParticipantId, ParticipantListMarker, ParticipantListMarkers, ParticipantListType, ParticipantStateMapped } from './types/Participant';
+import { CompositeUserId, IGetParticipantsParameters, OkUserId, ParticipantId, ParticipantListMarker, ParticipantListMarkers, ParticipantListType, ParticipantsStateList, ParticipantStateMapped } from './types/Participant';
 import ParticipantLayout, { Layout, RequestKeyFrame, StopStream } from './types/ParticipantLayout';
 import { ParticipantListChunkParameters } from './types/ParticipantListChunk';
 import ParticipantPriority from './types/ParticipantPriority';
@@ -194,7 +194,6 @@ export declare const utils: {
     participantMarkerCompare: typeof Utils.participantMarkerCompare;
 };
 export declare function setApi(api: BaseApi): void;
-export declare function setSignalingFactory(signalingFactory: () => BaseSignaling): void;
 export declare function setLogger(logger: BaseLogger): void;
 /**
  * Устанавливает библиотеку эффектов
@@ -208,7 +207,7 @@ export declare function setVideoEffects(effects: VideoEffects): void;
  * @param vmoji Экземпляр класса `Vmoji` из `@vkontakte/calls-vmoji`
  * @param sdk Экземпляр модуля `@vkontakte/calls-vmoji`, нужен для проброски дебаг сообщений
  */
-export declare function setVmoji(vmoji: typeof Vmoji, sdk?: Parameters<typeof Vmoji.setSDK>[0] | null, renderingOptions?: Vmoji.RenderingOptions | null): void;
+export declare function setVmoji(vmoji: typeof Vmoji, sdk?: Parameters<typeof Vmoji.setSDK>[0] | null, renderingOptions?: Partial<Vmoji.RenderingOptions>, protocolVersion?: Vmoji.AnimojiVersion): void;
 /**
  * Инициализирует библиотеку
  *
@@ -368,8 +367,13 @@ export declare function changePriorities(priorities: ParticipantPriority[]): Pro
  * Изменяет состояния пользователя в звонке (например, "поднять руку" или "отошёл")
  *
  * @param state Список состояний в виде ключ-значение. Максимальная длина ключей и значений - 5 символов. Пустые значения будут пропущены
+ * @param externalId Внешний ID пользователя
+ */
+export declare function changeParticipantState(state: Record<string, string>, externalId?: ExternalId): Promise<void>;
+/**
+ * Принудительно опустить руки участников в текущем сессионном зале админа
  */
-export declare function changeParticipantState(state: Record<string, string>): Promise<void>;
+export declare function putHandsDown(): Promise<void>;
 /**
  * Изменяет лейаут.
  * Также сообщает серверу каких участников звонка стримить на этот клиент
@@ -413,6 +417,13 @@ export declare function setMediaModifiers(mediaModifiers: MediaModifiers): Promi
  * @param enabled true - включить, false - отключить
  */
 export declare function enableVideoSuspend(enabled: boolean): Promise<void>;
+/**
+ * Режим, при котором будет предложено включить автоматическое
+ * отключение приёма видео в условиях плохого соединения
+ *
+ * @param enabled true - включить, false - отключить
+ */
+export declare function enableVideoSuspendSuggest(enabled: boolean): Promise<void>;
 /**
  * Включить/выключить опции звонка
  *
@@ -504,7 +515,7 @@ export declare function forceRelayPolicy(enabled: boolean): void;
  * @param groupId
  * @param roomId
  */
-export declare function startStream(isRecord?: boolean, name?: string | null, movieId?: string | null, privacy?: 'PUBLIC' | 'FRIENDS' | 'DIRECT_LINK', groupId?: string | null, roomId?: number | null, externalAccessKey?: string | null): Promise<undefined>;
+export declare function startStream(isRecord?: boolean, name?: string | null, movieId?: string | null, privacy?: 'PUBLIC' | 'FRIENDS' | 'DIRECT_LINK', groupId?: string | null, roomId?: number | null): Promise<undefined>;
 /**
  * Завершить трансляцию звонка
  * @param roomId
@@ -619,6 +630,12 @@ export declare function setAudioStream(stream: MediaStream): Promise<void>;
  * нужен только в случае присвоения участнику чужого аватара
  */
 export declare function setVmojiSvg(svg: string | ArrayBuffer, externalId?: ExternalId | null, customKey?: string | null): Promise<void>;
+/**
+ * Позволяет установить цвет фона собственного vmoji
+ *
+ * @param {(RGBTuple|string)} fill - цвет в виде rgb-кортежа или hex-кода
+ */
+export declare function setVmojiFill(fill: Vmoji.RGBTuple | string): void;
 /**
  * Получить состояние зала ожидания
  *
@@ -656,6 +673,14 @@ export declare function getParticipantListChunk(participantListChunkParameters:
 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>;
 /**
  * Удаляет записи истории звонков
@@ -682,5 +707,5 @@ export declare function sendTestCommand(name: string, params?: any): void;
  * Версия SDK
  */
 export declare function version(): string;
-export type { AddParticipantParams, AudienceModeHandsResponse, BrowserName, CompositeUserId, ConversationData, ConversationParams, ConversationResponse, ExternalId, ExternalParticipant, ExternalParticipantListChunk, ExternalParticipantListMarker, ExternalParticipantListMarkers as ExternalParticipantMarkers, ExternalParticipantId, GetParticipantsSignalingResponse, GetRoomsSignalingResponse, HangupReasonData, IApiEnv, IAsrStartParams, IAsrStopParams, IAsrData, IceServer, JSONArray, JSONObject, JSONType, Layout, MediaModifiers, MediaSettings, MuteStates, OkUserId, ParamsObject, ParticipantId, ParticipantLayout, ParticipantListMarkers, ParticipantListType, ParticipantPriority, 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, };
-export { Api, AuthData, BaseApi, BaseLogger, BaseSignaling, CallDirection, CallType, ChatRoomEventType, ConversationOption, DebugMessageType, ExternalIdType, FacingMode, FatalError, HangupReason, HangupType, MediaOption, MediaTrackKind, MediaType, MuteState, ParticipantState, ParticipantStatus, RecordRole, Signaling, SignalingCommandType, SignalingConnectionType, SignalingNotification, UserRole, UserType, TransportTopology, RoomsEventType, ConversationFeature, ArrayDequeue, ApiExternal, };
+export type { AddParticipantParams, AudienceModeHandsResponse, BrowserName, CompositeUserId, ConversationData, ConversationParams, ConversationResponse, ExternalId, ExternalParticipant, ExternalParticipantListChunk, ExternalParticipantListMarker, ExternalParticipantListMarkers as ExternalParticipantMarkers, ExternalParticipantId, GetParticipantsSignalingResponse, GetRoomsSignalingResponse, HangupReasonData, IApiEnv, IAsrStartParams, IAsrStopParams, IAsrData, IceServer, JSONArray, JSONObject, JSONType, Layout, MediaModifiers, MediaSettings, MuteStates, OkUserId, ParamsObject, ParticipantId, ParticipantLayout, ParticipantListMarkers, ParticipantListType, ParticipantPriority, ParticipantsStateList, 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, };
+export { Api, AuthData, BaseApi, BaseLogger, CallDirection, CallType, ChatRoomEventType, ConversationOption, DebugMessageType, ExternalIdType, FacingMode, FatalError, HangupReason, HangupType, MediaOption, MediaTrackKind, MediaType, MuteState, ParticipantState, ParticipantStatus, RecordRole, Signaling, SignalingCommandType, SignalingConnectionType, SignalingNotification, UserRole, UserType, TransportTopology, RoomsEventType, ConversationFeature, ArrayDequeue, ApiExternal, };

package/abstract/BaseApi.d.ts

@@ -8,6 +8,13 @@ export type ClientStats = {
     vcid: ConversationData['id'] | null;
     [k: string]: string | number | null;
 };
+export type ClientEvent = {
+    timestamp: number;
+    call_topology: 'D' | 'S';
+    event_type: string;
+    vcid: ConversationData['id'] | null;
+    [k: string]: string | number | boolean | null;
+};
 export type LogItem = {
     count?: number;
     custom: ClientStats;
@@ -52,6 +59,10 @@ export default abstract class BaseApi {
      * method: vchat.clientStats
      */
     logClientStats(items: ClientStats[]): void;
+    /**
+     * method: vchat.clientEvents
+     */
+    logClientEvents(items: ClientEvent[]): void;
     abstract getOkIdsByExternalIds(externalIds: ExternalId[]): Promise<OkUserId[]>;
     abstract getParticipantIdsByExternalIds(externalIds: ExternalId[]): Promise<Map<ExternalId, ParticipantId>>;
     abstract getExternalIdsByOkIds(uids: OkUserId[]): Promise<ExternalParticipantId[]>;

package/abstract/BaseSignaling.d.ts

@@ -43,12 +43,11 @@ export default abstract class BaseSignaling extends EventEmitter {
     abstract close(): void;
     abstract hangup(reason: string): Promise<SignalingMessage | void>;
     abstract acceptCall(mediaSettings: MediaSettings): Promise<SignalingMessage>;
-    abstract sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit): Promise<SignalingMessage>;
+    abstract sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit, extraPayload?: Record<string, any>): Promise<SignalingMessage>;
     abstract sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidate): Promise<SignalingMessage>;
     abstract changeMediaSettings(mediaSettings: MediaSettings): Promise<SignalingMessage>;
-    abstract changeParticipantState(state: {
-        [key: string]: string;
-    }): Promise<SignalingMessage>;
+    abstract changeParticipantState(state: Record<string, string>, compositeUserId?: CompositeUserId): Promise<SignalingMessage>;
+    abstract putHandsDown(): Promise<SignalingMessage>;
     abstract addParticipant(participantId: CompositeUserId, params?: AddParticipantParams): Promise<SignalingMessage>;
     abstract removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<SignalingMessage>;
     abstract allocateConsumer(description: RTCSessionDescription | null, capabilities: {
@@ -92,6 +91,7 @@ export default abstract class BaseSignaling extends EventEmitter {
     abstract pinParticipant(participantId: ParticipantId, unpin: boolean, roomId: number | null): Promise<SignalingMessage>;
     abstract updateMediaModifiers(mediaModifiers: MediaModifiers): Promise<SignalingMessage>;
     abstract enableVideoSuspend(enabled: boolean): Promise<SignalingMessage>;
+    abstract enableVideoSuspendSuggest(enabled: boolean): Promise<SignalingMessage>;
     abstract changeOptions(changes: {
         [key in ConversationOption]?: boolean;
     }): Promise<SignalingMessage>;
@@ -106,6 +106,7 @@ export default abstract class BaseSignaling extends EventEmitter {
     abstract useCommandDataChannel(status: boolean): void;
     abstract getParticipantListChunk(participantListChunkParameters: ParticipantListChunkParameters): Promise<SignalingMessage>;
     abstract getParticipants(externalIds: SignalingMessage.ExternalId[]): Promise<GetParticipantsSignalingResponse>;
+    abstract getPeerId(): number | null;
     abstract startAsr(params: IAsrStartParams): Promise<SignalingMessage>;
     abstract stopAsr(params?: IAsrStopParams): Promise<SignalingMessage>;
     abstract requestAsr(request: boolean): Promise<SignalingMessage>;