@vkontakte/calls-sdk 2.8.13-dev.7195a780.0 → 2.8.13-dev.8011fb16.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.
- package/CallsSDK.d.ts +5 -0
- package/abstract/BaseApi.d.ts +16 -18
- package/calls-sdk.cjs.js +7 -7
- package/calls-sdk.esm.js +3143 -2380
- package/classes/AudioFix.d.ts +2 -2
- package/classes/AudioOutput.d.ts +2 -2
- package/classes/ExternalIdCache.d.ts +9 -13
- package/classes/MediaSource.d.ts +6 -2
- package/classes/SpecListener.d.ts +2 -2
- package/classes/VolumesDetector.d.ts +0 -1
- package/classes/codec/LibVPxDecoder.d.ts +2 -2
- package/classes/codec/LibVPxEncoder.d.ts +2 -2
- package/classes/codec/WebCodecsDecoder.d.ts +2 -2
- package/classes/codec/WebCodecsEncoder.d.ts +2 -2
- package/classes/codec/WorkerBase.d.ts +3 -3
- package/classes/conversation/Conversation.d.ts +12 -4
- package/classes/conversation/Conversation.testUtils.d.ts +2 -0
- package/classes/conversation/DisplayLayoutRequester.d.ts +3 -1
- package/classes/screenshare/ScreenCaptureReceiver.d.ts +2 -2
- package/classes/screenshare/ScreenCaptureSender.d.ts +2 -2
- package/classes/screenshare/StreamBuilder.d.ts +3 -2
- package/classes/stat/CallLifecycleStats.d.ts +2 -2
- package/classes/stat/CodecStatsAggregator.d.ts +2 -2
- package/classes/stat/ConversationStats.d.ts +11 -2
- package/classes/stat/StatAggregator.d.ts +2 -2
- package/classes/stat/StatClock.d.ts +28 -0
- package/classes/stat/StatDrainScheduler.d.ts +92 -0
- package/classes/stat/StatEventCollector.d.ts +50 -0
- package/classes/stat/StatPings.d.ts +2 -2
- package/classes/stat/StatQueue.d.ts +79 -0
- package/classes/stat/StatSignalingCommands.d.ts +2 -2
- package/classes/stat/StatUnloadJournal.d.ts +27 -0
- package/classes/transport/DirectTransport.d.ts +6 -2
- package/classes/transport/ServerTransport.d.ts +2 -2
- package/classes/transport/SimulcastSender.d.ts +2 -2
- package/classes/transport/Transport.d.ts +2 -2
- package/default/Api.d.ts +18 -11
- package/default/Signaling.d.ts +2 -2
- package/enums/SessionError.d.ts +10 -0
- package/package.json +1 -1
- package/static/ApiTransport.d.ts +4 -0
- package/static/External.d.ts +10 -0
- package/static/Params.d.ts +48 -1
- package/static/SessionStore.d.ts +29 -0
- package/static/WebRTCUtils.d.ts +5 -5
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
/** Потолок хранения событий: и очереди на диске, и буфера в памяти вкладки. */
|
|
2
|
+
export declare const RECORD_LIMIT = 5000;
|
|
3
|
+
/** Срок жизни события в очереди. */
|
|
4
|
+
export declare const MAX_AGE_MS: number;
|
|
5
|
+
/** Произвольный набор скалярных полей события. */
|
|
6
|
+
export type StatPayload = Record<string, string | number | boolean | null>;
|
|
7
|
+
/** Запись очереди без сгенерированного ключа. */
|
|
8
|
+
export type StatQueueEntry = {
|
|
9
|
+
/** userId владельца события. Не может быть неизвестным. */
|
|
10
|
+
uid: number;
|
|
11
|
+
/** conversationId. null — событие залогировано до старта звонка. */
|
|
12
|
+
vcid: string | null;
|
|
13
|
+
/** Время записи в device-time, без коррекции по серверу. */
|
|
14
|
+
ts: number;
|
|
15
|
+
/** Поправка к серверному времени на момент записи. null — ещё не знали. */
|
|
16
|
+
delta?: number | null;
|
|
17
|
+
ev: StatPayload;
|
|
18
|
+
};
|
|
19
|
+
/** Запись очереди, прочитанная из хранилища. */
|
|
20
|
+
export type StatQueueRecord = StatQueueEntry & {
|
|
21
|
+
/** Автоинкремент. Единственный источник истины для порядка событий. */
|
|
22
|
+
id: number;
|
|
23
|
+
};
|
|
24
|
+
/**
|
|
25
|
+
* Персистентная очередь событий статистики поверх IndexedDB.
|
|
26
|
+
*
|
|
27
|
+
* База одна на origin, поэтому класс статический. Ошибки хранилища только
|
|
28
|
+
* логируются: статистика не влияет на звонок.
|
|
29
|
+
*/
|
|
30
|
+
export default abstract class StatQueue {
|
|
31
|
+
private static _db;
|
|
32
|
+
private static _dbPromise;
|
|
33
|
+
/** Имя базы. Подменяется только тестами, см. __resetForTests(). */
|
|
34
|
+
private static _dbName;
|
|
35
|
+
private static _supported;
|
|
36
|
+
private static _appendsSinceEvictCheck;
|
|
37
|
+
/** Момент последней неудачи открытия; до конца кулдауна не пробуем снова. */
|
|
38
|
+
private static _lastOpenFailureAt;
|
|
39
|
+
static isSupported(): boolean;
|
|
40
|
+
/** @returns ключ записи или null, если хранилище не приняло её. */
|
|
41
|
+
static append(entry: StatQueueEntry): Promise<number | null>;
|
|
42
|
+
/**
|
|
43
|
+
* Проставляет delta перечисленным записям, у которых её ещё нет.
|
|
44
|
+
*
|
|
45
|
+
* Ключи перечисляются явно: между своими в очередь могли лечь чужие записи,
|
|
46
|
+
* писанные другими часами.
|
|
47
|
+
*/
|
|
48
|
+
static fillDelta(ids: number[], delta: number): Promise<void>;
|
|
49
|
+
static count(): Promise<number>;
|
|
50
|
+
/**
|
|
51
|
+
* Читает самые старые события пользователя. Индекс by_uid отдаёт их в
|
|
52
|
+
* порядке автоинкрементного id, то есть в порядке записи.
|
|
53
|
+
*/
|
|
54
|
+
static readOldest(uid: number, limit: number): Promise<StatQueueRecord[]>;
|
|
55
|
+
static remove(ids: number[]): Promise<void>;
|
|
56
|
+
/** Уникальные uid, у которых есть записи. Курсор по индексу by_uid с nextunique. */
|
|
57
|
+
static listUids(): Promise<number[]>;
|
|
58
|
+
/**
|
|
59
|
+
* Приводит размер хранилища к лимиту, вынося самые старые звонки целиком:
|
|
60
|
+
* частично удалённый звонок — это неполная цепочка событий. Записи без
|
|
61
|
+
* vcid одной группой не считаются, иначе эвикшн вынес бы pre-call события
|
|
62
|
+
* сразу всех звонков.
|
|
63
|
+
*/
|
|
64
|
+
static evictToLimit(limit: number): Promise<void>;
|
|
65
|
+
/** Удаляет события старше указанного возраста. */
|
|
66
|
+
static evictOlderThan(maxAgeMs: number, now?: number): Promise<void>;
|
|
67
|
+
private static _checkSupport;
|
|
68
|
+
private static _open;
|
|
69
|
+
private static _close;
|
|
70
|
+
private static _createSchema;
|
|
71
|
+
/** Обёртка над транзакцией: резолвится после успешного коммита. */
|
|
72
|
+
private static _runTransaction;
|
|
73
|
+
/** Читает запись с минимальным id, то есть самую старую в хранилище. */
|
|
74
|
+
private static _readOldestRecord;
|
|
75
|
+
/**
|
|
76
|
+
* Удаляет все события звонка одной транзакцией.
|
|
77
|
+
*/
|
|
78
|
+
private static _deleteConversation;
|
|
79
|
+
}
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { SignalingTransportType } from '../../enums/SignalingTransportStat';
|
|
2
|
-
import
|
|
2
|
+
import StatEventCollector from './StatEventCollector';
|
|
3
3
|
export declare class StatSignalingCommands {
|
|
4
4
|
private readonly _logger;
|
|
5
5
|
private trackerByCommand;
|
|
6
|
-
constructor(logger:
|
|
6
|
+
constructor(logger: StatEventCollector);
|
|
7
7
|
mark(command: string, time: number, transport: SignalingTransportType): void;
|
|
8
8
|
/** Отправляем данные в стату */
|
|
9
9
|
logMetrics(): void;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { StatQueueEntry } from './StatQueue';
|
|
2
|
+
/**
|
|
3
|
+
* Синхронный журнал умирающей вкладки поверх localStorage: транзакция
|
|
4
|
+
* IndexedDB из pagehide не успевает закоммититься. Следующий старт SDK
|
|
5
|
+
* переносит журнал в очередь. Ключ уникален на вкладку.
|
|
6
|
+
*/
|
|
7
|
+
export default abstract class StatUnloadJournal {
|
|
8
|
+
private static _tabKey;
|
|
9
|
+
private static _entries;
|
|
10
|
+
/**
|
|
11
|
+
* Открывает новый журнал для этой вкладки. Без сброса пережившая pagehide
|
|
12
|
+
* вкладка записала бы во второй журнал уже перенесённые события.
|
|
13
|
+
*/
|
|
14
|
+
static beginTabSession(): void;
|
|
15
|
+
static writeSync(entry: StatQueueEntry): boolean;
|
|
16
|
+
/**
|
|
17
|
+
* Переносит журналы всех закрытых вкладок в очередь. Журнал стирается
|
|
18
|
+
* независимо от исхода: повторные попытки дали бы дубли.
|
|
19
|
+
*
|
|
20
|
+
* @returns число перенесённых событий.
|
|
21
|
+
*/
|
|
22
|
+
static drainToQueue(): Promise<number>;
|
|
23
|
+
/** Читает журнал и сразу удаляет его. null — ключа уже нет или хранилище недоступно. */
|
|
24
|
+
private static _take;
|
|
25
|
+
private static _storage;
|
|
26
|
+
private static _isValidEntry;
|
|
27
|
+
}
|
|
@@ -3,7 +3,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
|
|
|
3
3
|
import { type DebugLogger } from '../../static/Debug';
|
|
4
4
|
import { ParticipantId } from '../../types/Participant';
|
|
5
5
|
import ServerSettings from '../../types/ServerSettings';
|
|
6
|
-
import
|
|
6
|
+
import StatEventCollector from '../stat/StatEventCollector';
|
|
7
7
|
import { MediaSource } from '../MediaSource';
|
|
8
8
|
import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
|
|
9
9
|
import { StatAggregator } from '../stat/StatAggregator';
|
|
@@ -43,7 +43,7 @@ export default class DirectTransport extends BaseTransport {
|
|
|
43
43
|
private readonly _logger;
|
|
44
44
|
private readonly _statAggregator;
|
|
45
45
|
private readonly _codecStatsAggregator;
|
|
46
|
-
constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?:
|
|
46
|
+
constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
|
|
47
47
|
get participantId(): ParticipantId;
|
|
48
48
|
updateStatisticsInterval(): void;
|
|
49
49
|
private _isDeadConnection;
|
|
@@ -72,6 +72,10 @@ export default class DirectTransport extends BaseTransport {
|
|
|
72
72
|
private _markConnected;
|
|
73
73
|
private _onConnectionStateChange;
|
|
74
74
|
private _startReconnection;
|
|
75
|
+
/**
|
|
76
|
+
* Запрашивает у сигналинга переход на серверную топологию.
|
|
77
|
+
* Обычно это делает только мастер, `fromAnySide` снимает это ограничение.
|
|
78
|
+
*/
|
|
75
79
|
private _requestTopologySwitch;
|
|
76
80
|
private _stopReconnection;
|
|
77
81
|
private _startIceRestart;
|
|
@@ -3,7 +3,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
|
|
|
3
3
|
import { type DebugLogger } from '../../static/Debug';
|
|
4
4
|
import { ParticipantId } from '../../types/Participant';
|
|
5
5
|
import ServerSettings from '../../types/ServerSettings';
|
|
6
|
-
import
|
|
6
|
+
import StatEventCollector from '../stat/StatEventCollector';
|
|
7
7
|
import { MediaSource } from '../MediaSource';
|
|
8
8
|
import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
|
|
9
9
|
import { StatAggregator } from '../stat/StatAggregator';
|
|
@@ -47,7 +47,7 @@ export default class ServerTransport extends BaseTransport {
|
|
|
47
47
|
private readonly _statAggregator;
|
|
48
48
|
private readonly _codecStatsAggregator;
|
|
49
49
|
private readonly _simulcast;
|
|
50
|
-
constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?:
|
|
50
|
+
constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
|
|
51
51
|
updateStatisticsInterval(): void;
|
|
52
52
|
open(observer?: boolean): void;
|
|
53
53
|
close(error?: Error): void;
|
|
@@ -2,7 +2,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
|
|
|
2
2
|
import { type DebugLogger } from '../../static/Debug';
|
|
3
3
|
import type VideoSettings from '../../types/VideoSettings';
|
|
4
4
|
import { MediaSource } from '../MediaSource';
|
|
5
|
-
import
|
|
5
|
+
import StatEventCollector from '../stat/StatEventCollector';
|
|
6
6
|
export default class SimulcastSender {
|
|
7
7
|
private _pc;
|
|
8
8
|
private _transceiver;
|
|
@@ -12,7 +12,7 @@ export default class SimulcastSender {
|
|
|
12
12
|
private readonly _getCameraSettings;
|
|
13
13
|
private readonly _debug;
|
|
14
14
|
private readonly _logger;
|
|
15
|
-
constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?:
|
|
15
|
+
constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatEventCollector | null);
|
|
16
16
|
configureFromRemoteOffer(pc: RTCPeerConnection): Promise<void>;
|
|
17
17
|
finalizeAnswer(sdp: string): string;
|
|
18
18
|
sync({ force }?: {
|
|
@@ -6,7 +6,7 @@ import { type DebugLogger } from '../../static/Debug';
|
|
|
6
6
|
import { ParticipantId } from '../../types/Participant';
|
|
7
7
|
import ServerSettings from '../../types/ServerSettings';
|
|
8
8
|
import EventEmitter from '../EventEmitter';
|
|
9
|
-
import
|
|
9
|
+
import StatEventCollector from '../stat/StatEventCollector';
|
|
10
10
|
import { MediaSource } from '../MediaSource';
|
|
11
11
|
import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
|
|
12
12
|
import { StatAggregator } from '../stat/StatAggregator';
|
|
@@ -51,7 +51,7 @@ export declare class Transport extends EventEmitter {
|
|
|
51
51
|
private readonly _onFirstMediaSent;
|
|
52
52
|
private _firstMediaSentProbeStopped;
|
|
53
53
|
private _vadController;
|
|
54
|
-
constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?:
|
|
54
|
+
constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
|
|
55
55
|
updateSettings(settings: ServerSettings): void;
|
|
56
56
|
updateStatisticsInterval(): void;
|
|
57
57
|
allocate(participantId: ParticipantId, isMaster?: boolean): void;
|
package/default/Api.d.ts
CHANGED
|
@@ -5,23 +5,32 @@ import { IHangupParams } from '../types/Api';
|
|
|
5
5
|
import ConversationParams from '../types/ConversationParams';
|
|
6
6
|
import ConversationResponse from '../types/ConversationResponse';
|
|
7
7
|
import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/ExternalId';
|
|
8
|
-
import {
|
|
8
|
+
import { OkUserId, ParticipantId } from '../types/Participant';
|
|
9
9
|
import PushData from '../types/PushData';
|
|
10
10
|
export default class Api extends BaseApi {
|
|
11
11
|
private _uuid;
|
|
12
12
|
private _idCache;
|
|
13
13
|
private _callUnsafe;
|
|
14
14
|
protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
|
|
15
|
-
userId(participantId: ParticipantId): ExternalParticipantId;
|
|
15
|
+
userId(participantId: ParticipantId): ExternalParticipantId | null;
|
|
16
16
|
authorize(): Promise<void>;
|
|
17
|
+
/** Запрос auth.anonymLogin без побочных эффектов. Пустой токен — версия 2. */
|
|
18
|
+
private _anonymLogin;
|
|
17
19
|
private _getAnonymLoginCacheKey;
|
|
18
20
|
private _getCachedAnonymLogin;
|
|
19
21
|
private _setCachedAnonymLogin;
|
|
20
22
|
private _removeCachedAnonymLogin;
|
|
21
23
|
private _reauthorize;
|
|
22
24
|
private _applyAnonymLogin;
|
|
25
|
+
private _buildClientStatsData;
|
|
26
|
+
/** Ошибки по отдельным событиям логируются, но батч трактуется целиком. */
|
|
27
|
+
private _reportClientStatsItemErrors;
|
|
28
|
+
/** noSession = true, иначе _prepareQuery перебил бы явный session_key. */
|
|
29
|
+
private _sendClientStatsWith;
|
|
30
|
+
/** Бекенд отвечает 200 всегда: ошибки статистики лежат в теле. */
|
|
23
31
|
private _sendClientStats;
|
|
24
|
-
logClientStats(items: ClientStats[]): void
|
|
32
|
+
logClientStats(items: ClientStats[]): Promise<void>;
|
|
33
|
+
logClientStatsWith(sessionKey: string, items: ClientStats[]): Promise<void>;
|
|
25
34
|
uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
|
|
26
35
|
joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
|
|
27
36
|
createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, audienceMode, audioOnly, waitForAdmin, closedConversation, }?: {
|
|
@@ -47,14 +56,12 @@ export default class Api extends BaseApi {
|
|
|
47
56
|
}>;
|
|
48
57
|
getAnonymTokenByLink(joinLink: string, username?: string): Promise<string>;
|
|
49
58
|
joinConversationByLink(joinLink: string, isVideo?: boolean, observedIds?: ExternalUserId[], payload?: string): Promise<ConversationResponse>;
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
getDecorativeIdByInitialId(initialId: OkUserId | CompositeUserId | ParticipantId): OkUserId | undefined;
|
|
57
|
-
replaceByInitialIdIdIfExists(id: OkUserId | CompositeUserId | ParticipantId): OkUserId;
|
|
59
|
+
getCachedParticipantIdByExternalId(externalId: ExternalId): ParticipantId | null;
|
|
60
|
+
getCachedExternalIdByParticipantId(participantId: ParticipantId): ExternalParticipantId | null;
|
|
61
|
+
cacheExternalId(participantId: ParticipantId, externalId: ExternalParticipantId): void;
|
|
62
|
+
mapDecorativeId(decorativeId: ParticipantId, initialId: ParticipantId): void;
|
|
63
|
+
unmapDecorativeId(initialId: ParticipantId): void;
|
|
64
|
+
getDecorativeIdByInitialId(initialId: ParticipantId): ParticipantId | undefined;
|
|
58
65
|
getConversationParams(conversationId?: string): Promise<ConversationParams>;
|
|
59
66
|
getUserId(): OkUserId | null;
|
|
60
67
|
setUserId(userId: OkUserId): void;
|
package/default/Signaling.d.ts
CHANGED
|
@@ -4,7 +4,7 @@ import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
|
|
|
4
4
|
import { StatAggregator } from '../classes/stat/StatAggregator';
|
|
5
5
|
import { StatPings } from '../classes/stat/StatPings';
|
|
6
6
|
import { StatSignalingCommands } from '../classes/stat/StatSignalingCommands';
|
|
7
|
-
import
|
|
7
|
+
import StatEventCollector from '../classes/stat/StatEventCollector';
|
|
8
8
|
import ConversationFeature from '../enums/ConversationFeature';
|
|
9
9
|
import ConversationOption from '../enums/ConversationOption';
|
|
10
10
|
import MediaOption from '../enums/MediaOption';
|
|
@@ -56,7 +56,7 @@ export default class Signaling extends BaseSignaling {
|
|
|
56
56
|
private static get WAIT_CONNECTION_DELAY();
|
|
57
57
|
private static get WAIT_RESPONSE_DELAY();
|
|
58
58
|
get ready(): boolean;
|
|
59
|
-
constructor(debug?: DebugLogger, logger?:
|
|
59
|
+
constructor(debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
|
|
60
60
|
setAbortSignal(signal: AbortSignal | undefined): void;
|
|
61
61
|
setEndpoint(endpoint: string): void;
|
|
62
62
|
setWebTransportEndpoint(endpoint: string | null): void;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/** Коды ошибок сессии API. */
|
|
2
|
+
declare enum SessionError {
|
|
3
|
+
PARAM_SESSION_EXPIRED = 102,
|
|
4
|
+
PARAM_SESSION_KEY = 103,
|
|
5
|
+
PARAM_SIGNATURE = 104,
|
|
6
|
+
AUTH_LOGIN = 401
|
|
7
|
+
}
|
|
8
|
+
/** Ошибки, после которых имеет смысл переавторизоваться. 401 — токен хоста. */
|
|
9
|
+
export declare function isSessionErrorCode(code: unknown): boolean;
|
|
10
|
+
export default SessionError;
|
package/package.json
CHANGED
package/static/ApiTransport.d.ts
CHANGED
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
import { IAPIBaseUrl, IApiEnv } from '../types/Params';
|
|
2
2
|
export declare function resetApiEndpoint(): void;
|
|
3
|
+
/**
|
|
4
|
+
* Убираем слэш на конце
|
|
5
|
+
*/
|
|
6
|
+
export declare function sanitizeApiBaseUrl(url: IAPIBaseUrl): IAPIBaseUrl;
|
|
3
7
|
export declare function _resolveApiEndpoint(apiBaseUrl?: IAPIBaseUrl, apiEnv?: IApiEnv): Promise<string>;
|
|
4
8
|
export declare function sendBeakon(method: string, params?: {
|
|
5
9
|
[key: string]: any;
|
package/static/External.d.ts
CHANGED
|
@@ -638,5 +638,15 @@ declare namespace External {
|
|
|
638
638
|
* Собеседник подключился к сигналлингу
|
|
639
639
|
*/
|
|
640
640
|
function onPeerRegistered(conversationId?: string, externalIds?: ExternalId[]): void;
|
|
641
|
+
/**
|
|
642
|
+
* SDK обнаружил ошибку, после которой звонок может продолжаться.
|
|
643
|
+
*
|
|
644
|
+
* Callback предназначен для отправки ошибки в клиентский мониторинг.
|
|
645
|
+
* Его вызов не означает завершение звонка.
|
|
646
|
+
*
|
|
647
|
+
* @param error
|
|
648
|
+
* @param conversationId ID звонка
|
|
649
|
+
*/
|
|
650
|
+
function onNonFatalError(error: Error, conversationId: string | null): void;
|
|
641
651
|
}
|
|
642
652
|
export default External;
|
package/static/Params.d.ts
CHANGED
|
@@ -37,6 +37,27 @@ export type ParamsObject = {
|
|
|
37
37
|
platform: string;
|
|
38
38
|
/** @hidden */
|
|
39
39
|
clientStatsPlatform: string;
|
|
40
|
+
/**
|
|
41
|
+
* Версия приложения-хоста, уходит в статистику и сигналинг, например `'26.31.0:6822'`.
|
|
42
|
+
* По умолчанию `'0.0.0'`
|
|
43
|
+
*/
|
|
44
|
+
appVersion: string;
|
|
45
|
+
/**
|
|
46
|
+
* Автоматически запускать отправку клиентской статистики при `init()`.
|
|
47
|
+
*
|
|
48
|
+
* При `false` события копятся в очереди, но не уходят в сеть, пока хост не
|
|
49
|
+
* вызовет `startStats()`.
|
|
50
|
+
*
|
|
51
|
+
* _По умолчанию: `true`_
|
|
52
|
+
*/
|
|
53
|
+
autoStartStats: boolean;
|
|
54
|
+
/**
|
|
55
|
+
* Персистентная очередь клиентской статистики: события копятся в IndexedDB
|
|
56
|
+
* и уезжают пачками с подтверждением, переживая перезагрузку вкладки.
|
|
57
|
+
*
|
|
58
|
+
* _По умолчанию: `false`_
|
|
59
|
+
*/
|
|
60
|
+
statQueueEnabled: boolean;
|
|
40
61
|
/** @hidden */
|
|
41
62
|
clientType: string;
|
|
42
63
|
/** @hidden */
|
|
@@ -230,6 +251,13 @@ export type ParamsObject = {
|
|
|
230
251
|
iceRestartWaitTime: number;
|
|
231
252
|
/** @hidden */
|
|
232
253
|
transportConnectionWaitTime: number;
|
|
254
|
+
/**
|
|
255
|
+
* Разрешить запрашивать переход на серверную топологию не только звонящему,
|
|
256
|
+
* но и принимающей стороне, если не удалось восстановить оборвавшееся p2p-соединение
|
|
257
|
+
*
|
|
258
|
+
* _По умолчанию: `false`_
|
|
259
|
+
*/
|
|
260
|
+
switchTopologyOnReconnectFromAnySide: boolean;
|
|
233
261
|
/**
|
|
234
262
|
* Частота получения статистики в миллисекундах
|
|
235
263
|
*
|
|
@@ -911,6 +939,13 @@ export type ParamsObject = {
|
|
|
911
939
|
* Собеседник подключился к сигналлингу
|
|
912
940
|
*/
|
|
913
941
|
onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
|
|
942
|
+
/**
|
|
943
|
+
* SDK обнаружил ошибку, после которой звонок может продолжаться.
|
|
944
|
+
*
|
|
945
|
+
* Callback предназначен для отправки ошибки в клиентский мониторинг.
|
|
946
|
+
* Его вызов не означает завершение звонка.
|
|
947
|
+
*/
|
|
948
|
+
onNonFatalError?: (error: Error, conversationId: string | null) => void;
|
|
914
949
|
};
|
|
915
950
|
export default abstract class Params {
|
|
916
951
|
private static _params;
|
|
@@ -920,7 +955,13 @@ export default abstract class Params {
|
|
|
920
955
|
static getScreenFrameRate(fastScreenShare: boolean): number;
|
|
921
956
|
static get<N extends keyof ParamsObject>(name: N): ParamsObject[N];
|
|
922
957
|
static get appName(): string;
|
|
923
|
-
static get appVersion():
|
|
958
|
+
static get appVersion(): string;
|
|
959
|
+
/**
|
|
960
|
+
* Версия клиента для `client_version` в `auth.anonymLogin`. Бэкенд валидирует формат,
|
|
961
|
+
* поэтому это фиксированное значение, а не версия приложения-хоста (см. {@link Params.appVersion}).
|
|
962
|
+
* @hidden
|
|
963
|
+
*/
|
|
964
|
+
static get apiClientVersion(): number;
|
|
924
965
|
static get sdkVersion(): string;
|
|
925
966
|
static get debug(): boolean;
|
|
926
967
|
static get protocolVersion(): 5 | 6;
|
|
@@ -928,6 +969,8 @@ export default abstract class Params {
|
|
|
928
969
|
static set platform(value: string);
|
|
929
970
|
static get clientStatsPlatform(): string;
|
|
930
971
|
static set clientStatsPlatform(value: string);
|
|
972
|
+
static get autoStartStats(): boolean;
|
|
973
|
+
static get statQueueEnabled(): boolean;
|
|
931
974
|
static get clientType(): string;
|
|
932
975
|
static set clientType(value: string);
|
|
933
976
|
static get externalUserType(): string;
|
|
@@ -1000,6 +1043,7 @@ export default abstract class Params {
|
|
|
1000
1043
|
};
|
|
1001
1044
|
static get iceRestartWaitTime(): number;
|
|
1002
1045
|
static get transportConnectionWaitTime(): number;
|
|
1046
|
+
static get switchTopologyOnReconnectFromAnySide(): boolean;
|
|
1003
1047
|
static get statisticsInterval(): number;
|
|
1004
1048
|
static set statisticsInterval(value: number);
|
|
1005
1049
|
static get networkStatisticsInterval(): number;
|
|
@@ -1080,6 +1124,9 @@ export default abstract class Params {
|
|
|
1080
1124
|
movieShare: boolean;
|
|
1081
1125
|
clientType: string;
|
|
1082
1126
|
clientStatsPlatform: string;
|
|
1127
|
+
appVersion: string;
|
|
1128
|
+
autoStartStats: boolean;
|
|
1129
|
+
statQueueEnabled: boolean;
|
|
1083
1130
|
consumerScreenDataChannelPacketSize: number;
|
|
1084
1131
|
switchVideoAtBadNetwork: boolean;
|
|
1085
1132
|
simulcast: boolean;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
export type StoredSession = {
|
|
2
|
+
sessionKey: string;
|
|
3
|
+
/** Ключ окружения на момент сохранения, см. currentEndpoint(). */
|
|
4
|
+
endpoint: string;
|
|
5
|
+
savedAt: number;
|
|
6
|
+
};
|
|
7
|
+
/**
|
|
8
|
+
* Снимки сессий по uid на диске. Снимок может быть протухшим и переавторизации
|
|
9
|
+
* не подлежит, поэтому годится только для отложенных best-effort задач вроде
|
|
10
|
+
* досылки статистики.
|
|
11
|
+
*/
|
|
12
|
+
export default abstract class SessionStore {
|
|
13
|
+
static remember(uid: number, session: {
|
|
14
|
+
sessionKey: string;
|
|
15
|
+
endpoint: string;
|
|
16
|
+
}): void;
|
|
17
|
+
static get(uid: number): StoredSession | null;
|
|
18
|
+
static forget(uid: number): void;
|
|
19
|
+
/** Снимок живёт столько же, сколько события, которые он мог бы дослать. */
|
|
20
|
+
static prune(now?: number): void;
|
|
21
|
+
/**
|
|
22
|
+
* Ключ окружения: сессия прода не должна улететь на тестовый кластер.
|
|
23
|
+
* Адрес нормализуется так же, как в транспорте.
|
|
24
|
+
*/
|
|
25
|
+
static currentEndpoint(): string;
|
|
26
|
+
private static _read;
|
|
27
|
+
private static _write;
|
|
28
|
+
private static _isValid;
|
|
29
|
+
}
|
package/static/WebRTCUtils.d.ts
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* Вспомогательный плагин для работы с WebRTC
|
|
3
3
|
*/
|
|
4
4
|
import { IVideoDimentions } from '../types/MediaSettings';
|
|
5
|
-
import type
|
|
5
|
+
import type StatEventCollector from '../classes/stat/StatEventCollector';
|
|
6
6
|
import { type DebugLogger } from './Debug';
|
|
7
7
|
/**
|
|
8
8
|
* Тип камеры мобильного устройства
|
|
@@ -85,24 +85,24 @@ declare namespace WebRTCUtils {
|
|
|
85
85
|
* @param needAudio Нужно ли аудио
|
|
86
86
|
* @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
|
|
87
87
|
*/
|
|
88
|
-
function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?:
|
|
88
|
+
function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
|
|
89
89
|
/**
|
|
90
90
|
* Запрашивает трансляцию экрана пользователя с опциональным захватом звука
|
|
91
91
|
*/
|
|
92
|
-
function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?:
|
|
92
|
+
function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
|
|
93
93
|
/**
|
|
94
94
|
* Запрашивает камеру пользователя
|
|
95
95
|
*
|
|
96
96
|
* @param deviceId ID устройства
|
|
97
97
|
* @param resolution Размеры видео
|
|
98
98
|
*/
|
|
99
|
-
function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?:
|
|
99
|
+
function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
|
|
100
100
|
/**
|
|
101
101
|
* Запрашивает микрофон пользователя
|
|
102
102
|
*
|
|
103
103
|
* @param deviceId ID устройства
|
|
104
104
|
*/
|
|
105
|
-
function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?:
|
|
105
|
+
function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
|
|
106
106
|
/**
|
|
107
107
|
* Устанавливает размер видео в стриме
|
|
108
108
|
*
|