@vkontakte/calls-sdk 2.8.11-dev.aeebd796.0 → 2.8.11-dev.be993e85.0

package/static/Params.d.ts

@@ -306,6 +306,12 @@ export type ParamsObject = {
      * _По умолчанию: `30`_
      */
     videoTracksCount: number;
+    /**
+     * Минимальный интервал отправки diff для requestDisplayLayout в миллисекундах.
+     *
+     * _По умолчанию: `250`_
+     */
+    requestDisplayLayoutThrottleMs: number;
     /** @hidden */
     movieShare: boolean;
     /** @hidden */
@@ -487,6 +493,12 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     transparentAudio: boolean;
+    /**
+     * Включить получение обновлений состояния медийной сессии участников
+     *
+     * _По умолчанию: `false`_
+     */
+    enableSessionStateUpdates: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -730,6 +742,12 @@ export type ParamsObject = {
      * Получено отладочное сообщение. Работает только при выключенном режиме отладки
      */
     onDebugMessage?: (type: DebugMessageType, ...args: any[]) => void;
+    /**
+     * Получено отладочное сообщение с контекстом звонка. Работает только при выключенном режиме отладки
+     */
+    onDebugMessageWithContext?: (type: DebugMessageType, context: {
+        conversationId: string | null;
+    }, ...args: any[]) => void;
     /**
      * Статистика звонка
      */
@@ -963,6 +981,7 @@ export default abstract class Params {
     static get audioNack(): boolean;
     static get movieShare(): boolean;
     static get videoTracksCount(): number;
+    static get requestDisplayLayoutThrottleMs(): number;
     static get breakVideoPayloadTypes(): boolean;
     static get useCallsToContacts(): boolean;
     static get useParticipantListChunk(): boolean;
@@ -994,6 +1013,7 @@ export default abstract class Params {
     static get webtransport(): boolean;
     static get webtransportFF(): boolean;
     static get transparentAudio(): boolean;
+    static get enableSessionStateUpdates(): boolean;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1010,6 +1030,7 @@ export default abstract class Params {
         screenShareCongestionControl: boolean;
         screenShareCongestionControlThreshold: number;
         videoTracksCount: number;
+        requestDisplayLayoutThrottleMs: number;
         asrDataChannel: boolean;
         videoMaxHeight: number;
         videoMaxWidth: number;
@@ -1028,5 +1049,6 @@ export default abstract class Params {
         webtransport: boolean;
         webtransportFF: boolean;
         transparentAudio: boolean;
+        enableSessionStateUpdates: boolean;
     };
 }

package/static/ParticipantConnectionStatusUtils.d.ts

@@ -0,0 +1,15 @@
+import { ParticipantConnectionStatus, ParticipantSessionState } from '../types/Participant';
+import { ParticipantStatus } from './External';
+import TransportState from '../enums/TransportState';
+type StatusTransition = {
+    status: ParticipantStatus;
+    shouldNotify: boolean;
+};
+declare namespace ParticipantConnectionStatusUtils {
+    function create(status?: Partial<ParticipantConnectionStatus> | null): ParticipantConnectionStatus;
+    function fromTransportState(state?: TransportState): ParticipantStatus | null;
+    function computeEffective(status: ParticipantConnectionStatus): ParticipantStatus;
+    function setSessionState(status: ParticipantConnectionStatus, sessionState?: ParticipantSessionState): StatusTransition;
+    function setTransport(status: ParticipantConnectionStatus, transport: ParticipantStatus): StatusTransition;
+}
+export default ParticipantConnectionStatusUtils;

package/static/Utils.d.ts

@@ -3,6 +3,7 @@ import { ExternalParticipant, ExternalParticipantListMarker } from '../types/Ext
 import { CompositeUserId, OkUserId, Participant, ParticipantId, ParticipantStateMapped } from '../types/Participant';
 import SignalingMessage from '../types/SignalingMessage';
 import VideoSettings from '../types/VideoSettings';
+import { type DebugLogger } from './Debug';
 export declare const PARAMETERS_SEPARATOR = ":";
 export declare const DEVICE_IDX_PARAMETER = "d";
 /** @hidden */
@@ -36,8 +37,8 @@ declare namespace Utils {
     function delay(time: number, { signal }?: {
         signal?: AbortSignal;
     }): Promise<void>;
-    function applySettings(pc: RTCPeerConnection, videoSettings: VideoSettings, prevSettings: any): any;
-    function applyVideoTrackSettings(videoSettings: VideoSettings, s: RTCRtpSender, track: MediaStreamTrack | null, prevSettings: any, retSettings: any): void;
+    function applySettings(pc: RTCPeerConnection, videoSettings: VideoSettings, prevSettings: any, debug?: DebugLogger): any;
+    function applyVideoTrackSettings(videoSettings: VideoSettings, s: RTCRtpSender, track: MediaStreamTrack | null, prevSettings: any, retSettings: any, debug?: DebugLogger): void;
     /**
      * Проверяет, есть ли в первом массиве хотя бы один элемент из второго массива
      * @param arr Где ищем

package/static/WebRTCUtils.d.ts

@@ -2,6 +2,8 @@
  * Вспомогательный плагин для работы с WebRTC
  */
 import { IVideoDimentions } from '../types/MediaSettings';
+import type StatsLogger from '../classes/StatsLogger';
+import { type DebugLogger } from './Debug';
 /**
  * Тип камеры мобильного устройства
  */
@@ -83,24 +85,24 @@ declare namespace WebRTCUtils {
      * @param needAudio Нужно ли аудио
      * @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
      */
-    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean): Promise<MediaStream>;
+    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
      */
-    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean): Promise<MediaStream>;
+    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Запрашивает камеру пользователя
      *
      * @param deviceId ID устройства
      * @param resolution Размеры видео
      */
-    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions): Promise<MediaStream>;
+    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Запрашивает микрофон пользователя
      *
      * @param deviceId ID устройства
      */
-    function getUserAudio(deviceId?: string): Promise<MediaStream>;
+    function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Устанавливает размер видео в стриме
      *

package/types/Capabilities.d.ts

@@ -0,0 +1,24 @@
+export type TCapabilities = {
+    estimatedPerformanceIndex: number;
+    audioMix: boolean;
+    consumerUpdate: boolean;
+    producerNotificationDataChannelVersion: number;
+    producerCommandDataChannelVersion: number;
+    consumerScreenDataChannelVersion: number;
+    producerScreenDataChannelVersion: number;
+    asrDataChannelVersion: number;
+    animojiDataChannelVersion: number;
+    animojiBackendRender: boolean;
+    onDemandTracks: boolean;
+    unifiedPlan: boolean;
+    singleSession: boolean;
+    videoTracksCount: number;
+    red: boolean;
+    audioShare: boolean;
+    fastScreenShare: boolean;
+    videoSuspend: boolean;
+    simulcast: boolean;
+    consumerFastScreenShare: boolean;
+    consumerFastScreenShareQualityOnDemand: boolean;
+    transparentAudio: boolean;
+};

package/types/Conversation.d.ts

@@ -1,4 +1,4 @@
-import { TransportTopology } from '../classes/transport/Transport';
+import TransportTopology from '../enums/TransportTopology';
 import CallDirection from '../enums/CallDirection';
 import CallType from '../enums/CallType';
 import ConversationFeature from '../enums/ConversationFeature';

package/types/FastStart.d.ts

@@ -31,6 +31,7 @@ export interface FastStartParams {
     conversationId: string;
     internalParams: string;
     externalIds?: ExternalId[];
+    payload: string;
     opponentType: CallType;
     mediaOptions: MediaOption[];
     joiningAllowed?: boolean;

package/types/Participant.d.ts

@@ -44,6 +44,15 @@ export interface ParticipantStateMapped {
         ts: number;
     };
 }
+export interface ParticipantSessionState {
+    connected: boolean;
+}
+export interface ParticipantConnectionStatus {
+    transport: ParticipantStatus;
+    sessionState?: ParticipantSessionState;
+    sessionStateConnectedBySpeaker: boolean;
+    lastEffective: ParticipantStatus;
+}
 /**
  * Состояния участников звонка
  */
@@ -63,7 +72,6 @@ export interface Participant {
     externalId: ExternalParticipantId;
     mediaSettings: MediaSettings;
     state: ParticipantState;
-    status: ParticipantStatus;
     remoteStream?: MediaStream | null;
     remoteAudioTrack?: MediaStreamTrack | null;
     secondStream?: MediaStream | null;
@@ -72,6 +80,7 @@ export interface Participant {
     clientType: string;
     roles: UserRole[];
     participantState: ParticipantStateMapped;
+    connectionStatus: ParticipantConnectionStatus;
     networkRating: number;
     lastRequestedLayouts: {
         [key: StreamDescriptionString]: ParticipantLayout;

package/types/ParticipantLayout.d.ts

@@ -54,4 +54,37 @@ export type ParticipantLayout = (Layout | StopStream | RequestKeyFrame) & {
      */
     streamName?: string;
 };
+/**
+ * Запрос стрима, который клиент хочет получать для отображения.
+ */
+export type DisplayLayoutRequest = {
+    /**
+     * Внешний ID пользователя
+     */
+    uid: ExternalParticipantId | string;
+    /**
+     * Тип медиа (видео с камеры, картинка с экрана, лайв или мувик)
+     */
+    mediaType: MediaType;
+    /**
+     * Ширина окошка в котором отображается видео, в пикселях
+     */
+    width: number;
+    /**
+     * Высота окошка в котором отображается видео, в пикселях
+     */
+    height: number;
+    /**
+     * Отображать видео как CSS object-fit: cover. По умолчанию используется contain.
+     */
+    cover?: boolean;
+    /**
+     * Приоритет
+     */
+    priority?: number;
+    /**
+     * ID лайва или мувика. null для камеры или скрин-шары.
+     */
+    streamName?: string;
+};
 export default ParticipantLayout;

package/types/SignalingMessage.d.ts

@@ -1,5 +1,5 @@
 import { AnimojiVersion } from '@vkontakte/calls-vmoji';
-import { TransportTopology } from '../classes/transport/Transport';
+import TransportTopology from '../enums/TransportTopology';
 import ChatRoomEventType from '../enums/ChatRoomEventType';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
@@ -19,7 +19,7 @@ import MediaModifiers from './MediaModifiers';
 import MediaSettings from './MediaSettings';
 import { ISharedMovieInfo, ISharedMovieState, ISharedMovieStoppedInfo } from './MovieShare';
 import MuteStates from './MuteStates';
-import { CompositeUserId, OkUserId, ParticipantId, ParticipantListMarker as ParticipantParticipantListMarker, ParticipantListMarkers, ParticipantListType as ParticipantParticipantListType } from './Participant';
+import { CompositeUserId, OkUserId, ParticipantId, ParticipantListMarker as ParticipantParticipantListMarker, ParticipantListMarkers, ParticipantListType as ParticipantParticipantListType, ParticipantSessionState } from './Participant';
 import { MediaType, ParticipantStreamDescription } from './ParticipantStreamDescription';
 import { IRoomId } from './Room';
 import VideoSettings from './VideoSettings';
@@ -89,6 +89,7 @@ declare namespace SignalingMessage {
             state: Record<string, string>;
             stateUpdateTs: Record<string, number>;
         };
+        sessionState?: ParticipantSessionState;
         roles?: UserRole[];
         peerId?: PeerId;
         restricted?: boolean;
@@ -190,6 +191,7 @@ declare namespace SignalingMessage {
         deviceIdx?: number;
         peerId: PeerId;
         reason: HangupType;
+        errorCode?: string;
         markers?: ParticipantListMarkers;
     }
     export interface ClosedConversation extends Notification {
@@ -322,6 +324,13 @@ declare namespace SignalingMessage {
     export interface SpeakerChanged extends Notification {
         speaker: ParticipantId;
     }
+    export interface SessionState extends Notification {
+        connected: boolean;
+        participantId: OkUserId;
+        participantType: UserType;
+        deviceIdx?: number;
+        markers?: ParticipantListMarkers;
+    }
     export interface OptionsChanged extends Notification {
         options: ConversationOption[];
     }
@@ -366,6 +375,9 @@ declare namespace SignalingMessage {
     export interface Connection extends Notification {
         endpoint: string;
         conversation: Conversation;
+        conversationParams: {
+            serverTime: number;
+        };
         isConcurrent: boolean;
         peerId: PeerId;
         mediaModifiers: MediaModifiers;

package/types/Statistics.d.ts

@@ -1,4 +1,4 @@
-import { TransportTopology } from '../classes/transport/Transport';
+import TransportTopology from '../enums/TransportTopology';
 export type StatTransport = {
     timestamp: number;
     availableOutgoingBitrate: number;

package/types/WebTransport.d.ts

@@ -7,6 +7,8 @@ declare class WebTransportEventual {
     private readonly url;
     private readonly options;
     private readonly compression;
+    private closeRequested;
+    private closeEventEmitted;
     private encoder;
     private decoder;
     onopen: ((this: WebTransportEventual, ev: Event) => any) | null;
@@ -22,6 +24,8 @@ declare class WebTransportEventual {
     send(data: string): Promise<void>;
     private createErrorEvent;
     close(code?: number, reason?: string): void;
+    private closeConnectedTransport;
+    private emitClose;
     static isBrowserSupported(): boolean;
 }
 export { WebTransportEventual as WebTransport };

package/utils/DebugStorage.d.ts

@@ -95,10 +95,9 @@ export type DebugLogGetParams = {
 };
 export declare function add(level: string, args: any[], sessionId?: string): CurrentLogItem;
 export declare function init(): void;
-export declare function startSession(forceNew?: boolean): string;
+export declare function startConversationSession(): string;
 export declare function setConversationId(conversationId: string | null, sessionId?: string): void;
 export declare function list(): Promise<DebugLogSessionInfo[]>;
-export declare function getCurrentSession(): Promise<DebugLogSessionInfo | null>;
 export declare function get(params: DebugLogGetParams): Promise<CurrentLogItem[]>;
 export declare function getJson(params: DebugLogGetParams): Promise<string>;
 export declare function download(params: DebugLogGetParams): Promise<string>;

package/classes/stat/EventMetricsService.d.ts

@@ -1,9 +0,0 @@
-import HangupReason from '../HangupReason';
-import { TransportTopology } from '../transport/Transport';
-/**
- * Класс для работы с событийными метриками, обертка для правильной отправки событий
- */
-export declare class EventMetricsService {
-    private static correctHangupReason;
-    static sendHangupEvent(reason: HangupReason, topology?: TransportTopology): void;
-}