@vkontakte/calls-sdk 2.8.5-dev.ee82f123.0 → 2.8.5-dev.f744eeb6.0

package/CallsSDK.d.ts

@@ -2,10 +2,10 @@
  * CallsSDK
  */
 import type { IEffect, VideoEffects } from '@vkontakte/calls-video-effects';
+import type { EffectVoiceChange } from '@vkontakte/calls-audio-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';
@@ -63,6 +63,7 @@ import { ArrayDequeue } from './utils/ArrayDequeue';
 import { ApiExternal } from './default/ApiExternal';
 import AuthData from './static/AuthData';
 import { VmojiError } from './types/Vmoji';
+import { VolumeDetector } from './classes/VolumeDetector';
 /**
  * Информация о текущем браузере
  */
@@ -193,22 +194,26 @@ 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;
 /**
- * Устанавливает библиотеку эффектов
+ * Устанавливает библиотеку видео эффектов
  *
  * @param effects Экземпляр класса `VideoEffects` из `@vkontakte/calls-video-effects`
  */
 export declare function setVideoEffects(effects: VideoEffects): void;
+/**
+ * Устанавливает библиотеку аудио эффектов
+ *
+ * @param effects Экземпляр класса `EffectVoiceChange` из `@vkontakte/calls-audio-effects`
+ */
+export declare function setAudioEffects(effects: EffectVoiceChange): void;
 /**
  * Устанавливает библиотеку вимоджи
  *
  * @param vmoji Экземпляр класса `Vmoji` из `@vkontakte/calls-vmoji`
- * @param sdk Экземпляр модуля `@vkontakte/calls-vmoji`, нужен для проброски дебаг сообщений
+ * @param sdk Экземпляр модуля `@vkontakte/calls-sdk`, нужен для проброски дебаг сообщений
  */
-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;
 /**
  * Инициализирует библиотеку
  *
@@ -418,6 +423,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>;
 /**
  * Включить/выключить опции звонка
  *
@@ -509,7 +521,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
@@ -606,6 +618,12 @@ export declare function debugMessage(type: DebugMessageType, ...args: any[]): vo
  * @param effect
  */
 export declare function changeVideoEffect(effect: IEffect | null): Promise<void>;
+/**
+ * Эффект локального аудио
+ *
+ * @param effect
+ */
+export declare function changeAudioEffect(effects: string[], isPreset?: boolean): Promise<void>;
 /**
  * Позволяет установить кастомный стрим для аудио
  *
@@ -624,6 +642,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;
 /**
  * Получить состояние зала ожидания
  *
@@ -695,5 +719,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, 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, VolumeDetector, };

package/abstract/BaseApi.d.ts

@@ -28,7 +28,6 @@ export type LogItem = {
     uid: OkUserId | null;
 };
 export default abstract class BaseApi {
-    abstract init(): void;
     abstract authorize(): Promise<void>;
     abstract userId(participantId: ParticipantId): Promise<ExternalParticipantId>;
     abstract createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, createConversationParameters?: {
@@ -75,5 +74,6 @@ export default abstract class BaseApi {
     hangupConversation(conversationId: string): void;
     sendUserFeedbackStats(conversationId: string, userResponse: number, reason?: string, groupCallUsersCount?: number): void;
     removeHistoryRecords(recordIds: number[]): Promise<void>;
+    getServerTime(): Promise<number>;
     cleanup(): void;
 }

package/abstract/BaseSignaling.d.ts

@@ -43,7 +43,7 @@ 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: Record<string, string>, compositeUserId?: CompositeUserId): Promise<SignalingMessage>;
@@ -91,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>;
@@ -105,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>;