@vkontakte/calls-sdk 2.8.12-beta.11 → 2.8.12-beta.13

package/classes/MediaSource.d.ts

@@ -58,6 +58,8 @@ export declare class MediaSource extends EventEmitter {
     private readonly _videoEffectsFpsLimiter?;
     private readonly _debug;
     private readonly _logger;
+    private _cameraTrackSetAt;
+    private _cameraMuteRecoveredAt;
     constructor(debug?: DebugLogger, logger?: StatsLogger | null);
     get cameraVideoTrack(): MediaStreamTrack | null;
     set cameraVideoTrack(track: MediaStreamTrack | null);
@@ -97,6 +99,8 @@ export declare class MediaSource extends EventEmitter {
     protected getSilentAudioShareTrack(): MediaStreamTrack;
     protected getBlackScreenShareTrack(): MediaStreamTrack;
     protected _replaceLocalTrack(newTrack: MediaStreamTrack, sendTrack?: MediaStreamTrack): Promise<void>;
+    protected _replaceTrack(oldTrack: MediaStreamTrack, newTrack: MediaStreamTrack, sendTrack?: MediaStreamTrack): Promise<void>;
+    protected _addLocalTrack(newTrack: MediaStreamTrack, sendTrack?: MediaStreamTrack): Promise<void>;
     private _setEffect;
     private _stopEffect;
     destroy(): void;

package/classes/conversation/Conversation.d.ts

@@ -5,6 +5,7 @@ import BaseLogger from '../../abstract/BaseLogger';
 import { AddParticipantParams } from '../../abstract/BaseSignaling';
 import ConversationFeature from '../../enums/ConversationFeature';
 import ConversationOption from '../../enums/ConversationOption';
+import type ClientHangupReason from '../../enums/ClientHangupReason';
 import MediaOption from '../../enums/MediaOption';
 import UpdateDisplayLayoutErrorReason from '../../enums/UpdateDisplayLayoutErrorReason';
 import UserRole from '../../enums/UserRole';
@@ -104,8 +105,8 @@ export default class Conversation extends EventEmitter {
     private _getMainRoomParticipants;
     private _decodeExternalConversationParams;
     accept(mediaOptions: MediaOption[]): Promise<ConversationData>;
-    decline(): Promise<void>;
-    hangup(): Promise<void>;
+    decline(reason?: ClientHangupReason): Promise<void>;
+    hangup(reason?: ClientHangupReason): Promise<void>;
     addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<void>;
     addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<void>;
@@ -115,6 +116,7 @@ export default class Conversation extends EventEmitter {
     private _allocateParticipantTransport;
     private _cleanupRegistry;
     private _emitHangupOnce;
+    private _sendHangupApi;
     private _close;
     destroy(): void;
     private _destroy;

package/classes/stat/StatAggregator.d.ts

@@ -4,9 +4,13 @@ import StatsLogger from '../StatsLogger';
 export declare class StatAggregator {
     private readonly _logger;
     private readonly _eventualLogs;
+    private _lastCallStatContext;
     constructor(logger: StatsLogger);
     logCallStat(params: ICallStatLog): void;
     /** @link https://wiki.odkl.ru/pages/viewpage.action?pageId=100892588 */
     logEventualStat(params: IEventualStatLog): void;
     destroy(): void;
+    private _getCallStatContext;
+    private _flushEventualStats;
+    private _logEventualStat;
 }

package/classes/transport/ServerTransport.d.ts

@@ -43,6 +43,7 @@ export default class ServerTransport extends BaseTransport {
     private _producerSessionId;
     private _newAudioShareTrack;
     private _simulcastInfo;
+    private _isSimulcastNegotiated;
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;

package/classes/transport/Transport.d.ts

@@ -50,6 +50,7 @@ export declare class Transport extends EventEmitter {
     private readonly _codecStatsAggregator;
     private readonly _onFirstMediaSent;
     private _firstMediaSentProbeStopped;
+    private _vadController;
     constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
     updateSettings(settings: ServerSettings): void;
     updateStatisticsInterval(): void;
@@ -96,6 +97,8 @@ export declare class Transport extends EventEmitter {
     private _onAnimojiStream;
     /** Обработчик, досылающий MediaSourceEvent.SOURCE_CHANGED событие до аллокации транспортов */
     private _onAnimojiStatus;
+    private _createVad;
+    private _updateVadTrack;
     private _createAnimojiTransport;
     private _removeAnimojiTransport;
     getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;

package/default/Api.d.ts

@@ -1,6 +1,7 @@
 import BaseApi, { ClientStats } from '../abstract/BaseApi';
 import CallType from '../enums/CallType';
 import HangupType from '../enums/HangupType';
+import { IHangupParams } from '../types/Api';
 import ConversationParams from '../types/ConversationParams';
 import ConversationResponse from '../types/ConversationResponse';
 import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/ExternalId';
@@ -17,7 +18,9 @@ export default class Api extends BaseApi {
     private _getCachedAnonymLogin;
     private _setCachedAnonymLogin;
     private _removeCachedAnonymLogin;
+    private _reauthorize;
     private _applyAnonymLogin;
+    private _sendClientStats;
     logClientStats(items: ClientStats[]): void;
     uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
     joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
@@ -55,7 +58,7 @@ export default class Api extends BaseApi {
     getConversationParams(conversationId?: string): Promise<ConversationParams>;
     getUserId(): OkUserId | null;
     setUserId(userId: OkUserId): void;
-    hangupConversation(conversationId: string, reason?: HangupType): void;
+    hangupConversation(conversationId: string, reason?: HangupType, params?: Partial<IHangupParams>): void;
     removeHistoryRecords(recordIds: number[]): Promise<void>;
     cleanup(): void;
     getServerTime(): Promise<number>;

package/default/ApiExternal.d.ts

@@ -1,3 +1,4 @@
+import { IHangupParams } from '../types/Api';
 import { IAPIBaseUrl, IApiEnv } from '../types/Params';
 export declare class ApiExternal {
     private readonly _uuid;
@@ -8,5 +9,5 @@ export declare class ApiExternal {
     private _sessionKey;
     constructor(apiEvn: IApiEnv, apiKey: string, callToken: string, baseApiUrl?: IAPIBaseUrl);
     authorize(): Promise<boolean>;
-    hangupConversation(conversationId: string): Promise<void>;
+    hangupConversation(conversationId: string, params?: Partial<IHangupParams>): Promise<void>;
 }

package/default/Signaling.d.ts

@@ -70,7 +70,7 @@ export default class Signaling extends BaseSignaling {
     connect(connectionType: SignalingConnectionType): Promise<SignalingMessage.Connection>;
     getNextCommandSequenceNumber(): number;
     hangup(reason: string): Promise<SignalingMessage>;
-    sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidate): Promise<SignalingMessage>;
+    sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidateInit): Promise<SignalingMessage>;
     requestTestMode(consumerCommand: string, producerCommand: string | null): Promise<SignalingMessage>;
     sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit, extraPayload?: Record<string, any>): Promise<SignalingMessage>;
     acceptCall(mediaSettings: MediaSettings): Promise<SignalingMessage>;

package/enums/ClientHangupReason.d.ts

@@ -0,0 +1,7 @@
+import HangupType from './HangupType';
+/**
+ * Причины завершения звонка, которые клиент может передать в {@link hangup}/{@link declineCall}
+ * и пробросить в сигналинг без маппинга.
+ */
+export type ClientHangupReason = HangupType.HUNGUP | HangupType.CANCELED | HangupType.REJECTED | HangupType.BUSY | HangupType.MISSED | HangupType.CALL_TIMEOUT;
+export default ClientHangupReason;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.12-beta.11",
+  "version": "2.8.12-beta.13",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -14,7 +14,7 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/calls-audio-effects": "1.2.8",
+    "@vkontakte/calls-audio-effects": "1.4.1",
     "@vkontakte/calls-video-effects": "2.2.3-beta.7",
     "@vkontakte/calls-vmoji": "1.0.10-beta.17",
     "@vkontakte/libvpx": "2.0.9",
@@ -22,6 +22,6 @@
     "fflate": "^0.8.2",
     "messagepack": "1.1.12",
     "simple-ebml-builder": "0.2.2",
-    "webrtc-adapter": "7.7.0"
+    "webrtc-adapter": "9.0.5"
   }
 }

package/static/ApiTransport.d.ts

@@ -7,4 +7,7 @@ export declare function sendBeakon(method: string, params?: {
 export declare function request(method: string, params?: {
     [key: string]: any;
 }, noSession?: boolean, customEndpoint?: string): Promise<any>;
+export declare function requestKeepalive(method: string, params?: {
+    [key: string]: any;
+}, noSession?: boolean): Promise<any>;
 export declare function sendFormData(url: string, data: FormData): Promise<void>;

package/static/Params.d.ts

@@ -1,5 +1,5 @@
 import type { VideoEffects } from '@vkontakte/calls-video-effects';
-import type { EffectVoiceChange } from '@vkontakte/calls-audio-effects';
+import type { EffectVoiceChange, VadControllerOptions, VadLib } from '@vkontakte/calls-audio-effects';
 import type * as Vmoji from '@vkontakte/calls-vmoji';
 import { IAsrData } from '../types/Asr';
 import { ConversationData } from '../types/Conversation';
@@ -193,6 +193,14 @@ export type ParamsObject = {
      * Можно установить позднее методом `setAudioEffects`
      */
     audioEffects: EffectVoiceChange | null;
+    /**
+     * Namespace библиотеки VAD из `@vkontakte/calls-audio-effects`.
+     *
+     * Можно установить методом `setVad`
+     */
+    vad: VadLib | null;
+    /** Настройки VAD (threshold, hangoverMs, enabled) */
+    vadOptions: VadControllerOptions;
     /**
      * Максимальная ширина видео в пикселях для видео эффекта
      *
@@ -505,6 +513,16 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     enableSessionStateUpdates: boolean;
+    /**
+     * Использовать `<audio>` вместо `<video>` для воспроизведения звука в desktop Safari
+     * @hidden
+     */
+    safariAudioElement: boolean;
+    /**
+     * Отправлять пустой ICE candidate (end-of-candidates) удалённому пиру
+     * @hidden
+     */
+    forwardEmptyIceCandidate: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -960,6 +978,10 @@ export default abstract class Params {
     static get displaySurface(): DisplayCaptureSurfaceType;
     static get audioEffects(): EffectVoiceChange | null;
     static set audioEffects(value: EffectVoiceChange | null);
+    static get vad(): VadLib | null;
+    static set vad(value: VadLib | null);
+    static get vadOptions(): VadControllerOptions;
+    static set vadOptions(value: VadControllerOptions);
     static get videoEffects(): VideoEffects | null;
     static set videoEffects(value: VideoEffects | null);
     static get videoEffectMaxWidth(): number;
@@ -1027,6 +1049,8 @@ export default abstract class Params {
     static get waitForRecordResponse(): boolean;
     static get transparentAudio(): boolean;
     static get enableSessionStateUpdates(): boolean;
+    static get safariAudioElement(): boolean;
+    static get forwardEmptyIceCandidate(): boolean;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1063,5 +1087,7 @@ export default abstract class Params {
         waitForRecordResponse: boolean;
         transparentAudio: boolean;
         enableSessionStateUpdates: boolean;
+        safariAudioElement: boolean;
+        forwardEmptyIceCandidate: boolean;
     };
 }

package/static/Utils.d.ts

@@ -9,7 +9,7 @@ export declare const DEVICE_IDX_PARAMETER = "d";
 /** @hidden */
 declare namespace Utils {
     function patchLocalSDP(sdp: string, preferH264: boolean, brokenH264Decoder: boolean, preferVP9: boolean, isAudioNack?: boolean): string;
-    function patchRemoteSDP(sdp: string, oldDataChannelDescription: boolean, preferH264: boolean, brokenH264: boolean, preferVP9: boolean, brokenVP9Encoder: boolean, brokenVP9Decoder: boolean): string;
+    function patchRemoteSDP(sdp: string, preferH264: boolean, brokenH264: boolean, preferVP9: boolean, brokenVP9Encoder: boolean, brokenVP9Decoder: boolean): string;
     function getPeerIdString(peerId: SignalingMessage.PeerId): string;
     function comparePeerId(peerId1: SignalingMessage.PeerId, peerId2: SignalingMessage.PeerId): boolean;
     function getPeerConnectionHostInfo(pc: RTCPeerConnection): Promise<{

package/static/WebRTCUtils.d.ts

@@ -20,7 +20,7 @@ export declare enum FacingMode {
 /**
  * Известные браузеры
  */
-export type BrowserName = 'IE' | 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
+export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
 declare namespace WebRTCUtils {
     /**
      * До вызова этого метода бесполезно опрашивать другие публичные методы.
@@ -143,17 +143,14 @@ declare namespace WebRTCUtils {
      * В некоторых браузерах VP9 decoder сломан
      */
     function isBrokenVP9Decoder(): boolean;
-    /**
-     * Изменился формат описания датаканала в SDP
-     * @link https://blog.mozilla.org/webrtc/how-to-avoid-data-channel-breaking/
-     */
-    function isOldDataChannelDescription(): boolean;
     /**
      * Может ли браузер делать H264 приоритетным
      */
     function canPreferH264(): boolean;
     /**
-     * Некоторые браузеры (Firefox, Safari) некорректно поддерживают симулкаст
+     * Поддержка simulcast браузером.
+     * Safari корректно поддерживает simulcast начиная с версии 18.
+     * Firefox поддерживает simulcast с VP8 начиная с версии 134.
      */
     function isSimulcastSupportedByBrowser(): boolean;
     /**

package/types/Api.d.ts

@@ -0,0 +1,9 @@
+import HangupType from '../enums/HangupType';
+export interface IHangupParams {
+    conversationId: string;
+    reason: HangupType;
+    anonymToken?: string;
+    peerId?: string;
+    application_key?: string;
+    session_key?: string;
+}

package/types/SignalingMessage.d.ts

@@ -188,6 +188,7 @@ declare namespace SignalingMessage {
         peerId: PeerId;
         mediaSettings: Partial<MediaSettings>;
         capabilities?: string;
+        externalId?: ExternalId;
     }
     export interface Hungup extends Notification {
         participantId: OkUserId;

package/utils/NavigatorPermissions.d.ts

@@ -2,8 +2,8 @@ type Device = 'camera' | 'microphone';
 type PermissionStatusState = typeof PermissionStatus.prototype.state;
 type EventListener = (name: Device, state: PermissionStatusState) => void;
 export declare class NavigatorPermissions {
-    private _cameraPermissionStatus;
-    private _microphonePermissionStatus;
+    private _cameraPermissionStatus?;
+    private _microphonePermissionStatus?;
     private _listener;
     static isSupported(): boolean;
     init(listener: EventListener): Promise<void>;