@vkontakte/calls-sdk 2.8.11-dev.3d9bb708.0 → 2.8.11-dev.3de63af6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/CallsSDK.d.ts +49 -13
  2. package/abstract/BaseApi.d.ts +1 -2
  3. package/abstract/BaseSignaling.d.ts +1 -1
  4. package/calls-sdk.cjs.js +16 -13
  5. package/calls-sdk.esm.js +11414 -13
  6. package/classes/AudioFix.d.ts +5 -1
  7. package/classes/AudioOutput.d.ts +5 -1
  8. package/classes/Conversation.d.ts +11 -12
  9. package/classes/DebugInfo.d.ts +3 -0
  10. package/classes/MediaSource.d.ts +6 -5
  11. package/classes/ParticipantIdRegistry.d.ts +3 -0
  12. package/classes/ProducerCommandSerializationService.d.ts +3 -0
  13. package/classes/SignalingActor.d.ts +3 -1
  14. package/classes/SpeakerDetector.d.ts +2 -1
  15. package/classes/SpecListener.d.ts +5 -1
  16. package/classes/StatsLogger.d.ts +29 -0
  17. package/classes/VideoEffectsFpsLimiter.d.ts +3 -0
  18. package/classes/asr/AsrReceiver.d.ts +3 -1
  19. package/classes/codec/LibVPxDecoder.d.ts +3 -0
  20. package/classes/codec/LibVPxEncoder.d.ts +3 -1
  21. package/classes/codec/WebCodecsDecoder.d.ts +3 -0
  22. package/classes/codec/WebCodecsEncoder.d.ts +3 -1
  23. package/classes/codec/WorkerBase.d.ts +5 -0
  24. package/classes/screenshare/BaseStreamBuilder.d.ts +4 -1
  25. package/classes/screenshare/CanvasRenderer.d.ts +3 -1
  26. package/classes/screenshare/ScreenCaptureReceiver.d.ts +7 -1
  27. package/classes/screenshare/ScreenCaptureSender.d.ts +5 -1
  28. package/classes/screenshare/ScreenCongestionControl.d.ts +3 -1
  29. package/classes/screenshare/StreamBuilder.d.ts +5 -1
  30. package/classes/screenshare/TrackGeneratorRenderer.d.ts +3 -1
  31. package/classes/screenshare/WebmBuilder.d.ts +3 -1
  32. package/classes/stat/CodecStatsAggregator.d.ts +7 -7
  33. package/classes/stat/ConversationStats.d.ts +21 -0
  34. package/classes/stat/StatAggregator.d.ts +6 -6
  35. package/classes/stat/StatFirstMediaReceived.d.ts +4 -1
  36. package/classes/stat/StatPings.d.ts +9 -9
  37. package/classes/stat/StatScreenShareFirstFrame.d.ts +3 -1
  38. package/classes/stat/StatSignalingCommands.d.ts +8 -8
  39. package/classes/transport/BaseTransport.d.ts +1 -1
  40. package/classes/transport/DirectStatReporter.d.ts +3 -1
  41. package/classes/transport/DirectTransport.d.ts +9 -1
  42. package/classes/transport/PerfStatReporter.d.ts +5 -1
  43. package/classes/transport/ServerTransport.d.ts +10 -2
  44. package/classes/transport/Transport.d.ts +11 -14
  45. package/default/Api.d.ts +1 -3
  46. package/default/Signaling.d.ts +14 -2
  47. package/enums/TransportState.d.ts +10 -0
  48. package/enums/TransportTopology.d.ts +5 -0
  49. package/package.json +1 -1
  50. package/static/Debug.d.ts +27 -8
  51. package/static/External.d.ts +17 -38
  52. package/static/Params.d.ts +20 -22
  53. package/static/Utils.d.ts +3 -2
  54. package/static/WebRTCUtils.d.ts +6 -4
  55. package/types/Conversation.d.ts +1 -1
  56. package/types/PerfStatReporter.d.ts +2 -1
  57. package/types/SignalingMessage.d.ts +4 -1
  58. package/types/Statistics.d.ts +1 -1
  59. package/types/WebTransport.d.ts +1 -0
  60. package/utils/DebugStorage.d.ts +100 -1
  61. package/classes/CallRegistry.d.ts +0 -18
  62. package/classes/Logger.d.ts +0 -41
  63. package/classes/stat/EventMetricsService.d.ts +0 -9
  64. package/static/ConversationDebugLogger.d.ts +0 -13
package/static/Utils.d.ts CHANGED
@@ -3,6 +3,7 @@ import { ExternalParticipant, ExternalParticipantListMarker } from '../types/Ext
3
3
  import { CompositeUserId, OkUserId, Participant, ParticipantId, ParticipantStateMapped } from '../types/Participant';
4
4
  import SignalingMessage from '../types/SignalingMessage';
5
5
  import VideoSettings from '../types/VideoSettings';
6
+ import { type DebugLogger } from './Debug';
6
7
  export declare const PARAMETERS_SEPARATOR = ":";
7
8
  export declare const DEVICE_IDX_PARAMETER = "d";
8
9
  /** @hidden */
@@ -36,8 +37,8 @@ declare namespace Utils {
36
37
  function delay(time: number, { signal }?: {
37
38
  signal?: AbortSignal;
38
39
  }): Promise<void>;
39
- function applySettings(pc: RTCPeerConnection, videoSettings: VideoSettings, prevSettings: any): any;
40
- function applyVideoTrackSettings(videoSettings: VideoSettings, s: RTCRtpSender, track: MediaStreamTrack | null, prevSettings: any, retSettings: any): void;
40
+ function applySettings(pc: RTCPeerConnection, videoSettings: VideoSettings, prevSettings: any, debug?: DebugLogger): any;
41
+ function applyVideoTrackSettings(videoSettings: VideoSettings, s: RTCRtpSender, track: MediaStreamTrack | null, prevSettings: any, retSettings: any, debug?: DebugLogger): void;
41
42
  /**
42
43
  * Проверяет, есть ли в первом массиве хотя бы один элемент из второго массива
43
44
  * @param arr Где ищем
@@ -2,6 +2,8 @@
2
2
  * Вспомогательный плагин для работы с WebRTC
3
3
  */
4
4
  import { IVideoDimentions } from '../types/MediaSettings';
5
+ import type StatsLogger from '../classes/StatsLogger';
6
+ import { type DebugLogger } from './Debug';
5
7
  /**
6
8
  * Тип камеры мобильного устройства
7
9
  */
@@ -83,24 +85,24 @@ declare namespace WebRTCUtils {
83
85
  * @param needAudio Нужно ли аудио
84
86
  * @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
85
87
  */
86
- function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean): Promise<MediaStream>;
88
+ function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
87
89
  /**
88
90
  * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
89
91
  */
90
- function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean): Promise<MediaStream>;
92
+ function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
91
93
  /**
92
94
  * Запрашивает камеру пользователя
93
95
  *
94
96
  * @param deviceId ID устройства
95
97
  * @param resolution Размеры видео
96
98
  */
97
- function getUserVideo(deviceId?: string, resolution?: IVideoDimentions): Promise<MediaStream>;
99
+ function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
98
100
  /**
99
101
  * Запрашивает микрофон пользователя
100
102
  *
101
103
  * @param deviceId ID устройства
102
104
  */
103
- function getUserAudio(deviceId?: string): Promise<MediaStream>;
105
+ function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
104
106
  /**
105
107
  * Устанавливает размер видео в стриме
106
108
  *
@@ -1,4 +1,4 @@
1
- import { TransportTopology } from '../classes/transport/Transport';
1
+ import TransportTopology from '../enums/TransportTopology';
2
2
  import CallDirection from '../enums/CallDirection';
3
3
  import CallType from '../enums/CallType';
4
4
  import ConversationFeature from '../enums/ConversationFeature';
@@ -41,10 +41,11 @@ export interface CallStatReport {
41
41
  remote_connection_type?: RTCIceCandidateType;
42
42
  }
43
43
  export interface ICallStatLog extends Pick<CallStatReport, 'call_topology' | 'nack_sent' | 'nack_received' | 'pli_sent' | 'pli_received' | 'fir_sent' | 'fir_received' | 'frames_dropped' | 'stat_time_delta'>, Pick<Partial<CallStatReport>, 'rtt' | 'jitter_video' | 'jitter_audio' | 'interframe_delay_variance' | 'freeze_count' | 'total_freezes_duration' | 'ss_freeze_count' | 'ss_total_freezes_duration' | 'inserted_audio_samples_for_deceleration' | 'removed_audio_samples_for_acceleration' | 'concealed_audio_samples' | 'total_audio_energy' | 'local_address' | 'local_connection_type' | 'network_type' | 'transport' | 'remote_address' | 'remote_connection_type'> {
44
+ is_simulcast?: boolean;
44
45
  concealed_silent_audio_samples?: number;
45
46
  concealment_audio_avg_size?: number;
46
47
  video_loss?: number;
47
48
  audio_loss?: number;
48
49
  cpu_hardware_concurrency?: number;
49
- [k: string]: string | number | undefined;
50
+ [k: string]: string | number | boolean | undefined;
50
51
  }
@@ -1,5 +1,5 @@
1
1
  import { AnimojiVersion } from '@vkontakte/calls-vmoji';
2
- import { TransportTopology } from '../classes/transport/Transport';
2
+ import TransportTopology from '../enums/TransportTopology';
3
3
  import ChatRoomEventType from '../enums/ChatRoomEventType';
4
4
  import ConversationFeature from '../enums/ConversationFeature';
5
5
  import ConversationOption from '../enums/ConversationOption';
@@ -366,6 +366,9 @@ declare namespace SignalingMessage {
366
366
  export interface Connection extends Notification {
367
367
  endpoint: string;
368
368
  conversation: Conversation;
369
+ conversationParams: {
370
+ serverTime: number;
371
+ };
369
372
  isConcurrent: boolean;
370
373
  peerId: PeerId;
371
374
  mediaModifiers: MediaModifiers;
@@ -1,4 +1,4 @@
1
- import { TransportTopology } from '../classes/transport/Transport';
1
+ import TransportTopology from '../enums/TransportTopology';
2
2
  export type StatTransport = {
3
3
  timestamp: number;
4
4
  availableOutgoingBitrate: number;
@@ -20,6 +20,7 @@ declare class WebTransportEventual {
20
20
  private readChunks;
21
21
  private readLoop;
22
22
  send(data: string): Promise<void>;
23
+ private createErrorEvent;
23
24
  close(code?: number, reason?: string): void;
24
25
  static isBrowserSupported(): boolean;
25
26
  }
@@ -1,8 +1,107 @@
1
+ /**
2
+ * Запись отладочного лога SDK.
3
+ */
1
4
  export type CurrentLogItem = {
2
5
  readonly t: number;
3
6
  readonly l: string;
4
7
  readonly d: any[];
5
8
  readonly h: string;
6
9
  };
7
- export declare function add(level: string, args: any[]): void;
10
+ /**
11
+ * Информация о сохраненной локальной сессии логирования.
12
+ */
13
+ export type DebugLogSessionInfo = {
14
+ /**
15
+ * Внутренний id локальной сессии логирования.
16
+ */
17
+ readonly sessionId: string;
18
+ /**
19
+ * Id звонка. Может быть null, если звонок не успел стартовать.
20
+ */
21
+ readonly conversationId: string | null;
22
+ /**
23
+ * Время первой записи в ms.
24
+ */
25
+ readonly startTime: number;
26
+ /**
27
+ * Время последней записи в ms.
28
+ */
29
+ readonly endTime: number;
30
+ /**
31
+ * Время последнего обновления в ms.
32
+ */
33
+ readonly updatedAt: number;
34
+ /**
35
+ * Размер сохраненных данных в байтах.
36
+ */
37
+ readonly bytes: number;
38
+ /**
39
+ * Количество записей лога.
40
+ */
41
+ readonly entriesCount: number;
42
+ };
43
+ /**
44
+ * Статистика локального хранилища отладочных логов.
45
+ */
46
+ export type DebugLogStorageStats = {
47
+ /**
48
+ * Доступен ли IndexedDB для сохранения логов.
49
+ */
50
+ readonly supported: boolean;
51
+ /**
52
+ * Количество сохраненных звонков.
53
+ */
54
+ readonly callsCount: number;
55
+ /**
56
+ * Количество локальных сессий логирования.
57
+ */
58
+ readonly sessionsCount: number;
59
+ /**
60
+ * Размер сохраненных логов SDK в байтах.
61
+ */
62
+ readonly usedBytes: number;
63
+ /**
64
+ * Максимальный размер DebugStorage в байтах.
65
+ */
66
+ readonly maxBytes: number;
67
+ /**
68
+ * Максимальное количество звонков в DebugStorage.
69
+ */
70
+ readonly maxCalls: number;
71
+ /**
72
+ * Общая квота браузерного хранилища, если доступна.
73
+ */
74
+ readonly quotaBytes?: number;
75
+ /**
76
+ * Использование браузерного хранилища, если доступно.
77
+ */
78
+ readonly usageBytes?: number;
79
+ };
80
+ /**
81
+ * Параметры чтения или очистки локальных логов.
82
+ */
83
+ export type DebugLogGetParams = {
84
+ /**
85
+ * Id звонка. Вернет все локальные сессии с этим conversationId.
86
+ */
87
+ readonly conversationId: string;
88
+ readonly sessionId?: never;
89
+ } | {
90
+ /**
91
+ * Внутренний id локальной сессии из debugLogs.list().
92
+ */
93
+ readonly sessionId: string;
94
+ readonly conversationId?: never;
95
+ };
96
+ export declare function add(level: string, args: any[], sessionId?: string): CurrentLogItem;
8
97
  export declare function init(): void;
98
+ export declare function startConversationSession(): string;
99
+ export declare function setConversationId(conversationId: string | null, sessionId?: string): void;
100
+ export declare function list(): Promise<DebugLogSessionInfo[]>;
101
+ export declare function get(params: DebugLogGetParams): Promise<CurrentLogItem[]>;
102
+ export declare function getJson(params: DebugLogGetParams): Promise<string>;
103
+ export declare function download(params: DebugLogGetParams): Promise<string>;
104
+ export declare function clear(params?: DebugLogGetParams): Promise<void>;
105
+ export declare function stats(): Promise<DebugLogStorageStats>;
106
+ export declare function getAllJson(): Promise<string>;
107
+ export declare function downloadAll(): Promise<string>;
@@ -1,18 +0,0 @@
1
- import Conversation from './Conversation';
2
- export interface HoldableConversation extends Conversation {
3
- id: string;
4
- hold(hold: boolean): Promise<void>;
5
- }
6
- export declare class CallRegistry {
7
- private _conversations;
8
- private _activeId;
9
- add(conversation: HoldableConversation): void;
10
- remove(id: string | null): void;
11
- get(id: string): HoldableConversation | undefined;
12
- getActive(): HoldableConversation | null;
13
- getActiveId(): string | null;
14
- has(id: string): boolean;
15
- getAll(): HoldableConversation[];
16
- setActive(id: string): Promise<void>;
17
- clear(): void;
18
- }
@@ -1,41 +0,0 @@
1
- import BaseApi from '../abstract/BaseApi';
2
- import BaseLogger from '../abstract/BaseLogger';
3
- import StatLog from '../enums/StatLog';
4
- /**
5
- * Класс отвечает за отправку различной информации в сервис статистики (события, статистика и подобное)
6
- */
7
- export default class Logger extends BaseLogger {
8
- private static _instance;
9
- private static _conversationIdProvider;
10
- static setConversationIdProvider(provider: () => string | null): void;
11
- static create(api: BaseApi, externalLogger: BaseLogger | null): void;
12
- static log(name: StatLog, value?: string, immediately?: boolean): void;
13
- static logCustom(name: StatLog, params: Record<string, string | number>, immediately?: boolean): void;
14
- static logClientStats(params: Record<string, string | number | undefined | null>, immediately?: boolean): void;
15
- static logClientEvent(params: Record<string, string | number | undefined | null>, immediately?: boolean): void;
16
- static destroy(): void;
17
- private readonly _externalLogger;
18
- private readonly _api;
19
- private readonly _batchInterval;
20
- private _batchedLogItems;
21
- private _batchedClientStats;
22
- private _batchedClientEvents;
23
- private _batchTimeout;
24
- private _serverTimeDelta;
25
- constructor(api: BaseApi, externalLogger: BaseLogger | null);
26
- log(name: StatLog, value?: string, immediately?: boolean): void;
27
- logCustom(name: string, params: Record<string, string | number>, immediately?: boolean): void;
28
- logClientStats(data: Record<string, string | number | undefined | null>, immediately?: boolean): void;
29
- logClientEvent(data: Record<string, string | number | undefined | null>, immediately?: boolean): void;
30
- destroy(): void;
31
- private _logInternal;
32
- private _getConversationId;
33
- private _sendBatch;
34
- private _startTimeout;
35
- private _stopTimeout;
36
- private _sendLogItems;
37
- private _sendClientStats;
38
- private _sendClientEvents;
39
- private _calculateServerTimeDelta;
40
- private _now;
41
- }
@@ -1,9 +0,0 @@
1
- import HangupReason from '../HangupReason';
2
- import { TransportTopology } from '../transport/Transport';
3
- /**
4
- * Класс для работы с событийными метриками, обертка для правильной отправки событий
5
- */
6
- export declare class EventMetricsService {
7
- private static correctHangupReason;
8
- static sendHangupEvent(reason: HangupReason, topology?: TransportTopology): void;
9
- }
@@ -1,13 +0,0 @@
1
- import { CurrentLogItem } from '../utils/DebugStorage';
2
- export declare class ConversationDebugLogger {
3
- private static _list;
4
- private static _conversationId;
5
- static get startTime(): number;
6
- static get endTime(): number;
7
- static startSession(): void;
8
- static get conversationId(): string | null;
9
- static set conversationId(conversationId: string | null);
10
- static add(item: CurrentLogItem): void;
11
- private static _createContextLogs;
12
- static collectLogs(): CurrentLogItem[];
13
- }