@vkontakte/calls-sdk 2.8.12-dev.773596bc.0 → 2.8.12-dev.7afbc576.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 +36 -4
- package/abstract/BaseApi.d.ts +7 -10
- package/abstract/BaseSignaling.d.ts +10 -5
- package/calls-sdk.cjs.js +7 -13
- package/calls-sdk.esm.js +3377 -2832
- package/classes/AudioFix.d.ts +2 -2
- package/classes/AudioOutput.d.ts +2 -2
- package/classes/CallRegistry.d.ts +1 -1
- package/classes/ExternalIdCache.d.ts +1 -0
- package/classes/MediaSource.d.ts +6 -2
- package/classes/SpecListener.d.ts +2 -2
- 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.d.ts → conversation/Conversation.d.ts} +50 -37
- package/classes/conversation/Conversation.testUtils.d.ts +148 -0
- package/classes/{ConversationResponseValidator.d.ts → conversation/ConversationResponseValidator.d.ts} +1 -1
- package/classes/{DisplayLayoutRequester.d.ts → conversation/DisplayLayoutRequester.d.ts} +5 -5
- package/classes/conversation/index.d.ts +1 -0
- package/classes/screenshare/ScreenCaptureReceiver.d.ts +2 -2
- package/classes/screenshare/ScreenCaptureSender.d.ts +2 -2
- package/classes/screenshare/StreamBuilder.d.ts +2 -2
- package/classes/stat/CallLifecycleStats.d.ts +2 -6
- package/classes/stat/CodecStatsAggregator.d.ts +2 -2
- package/classes/stat/ConversationStats.d.ts +11 -4
- package/classes/stat/StatAggregator.d.ts +6 -2
- package/classes/stat/StatDrainScheduler.d.ts +78 -0
- package/classes/stat/StatEventCollector.d.ts +37 -0
- package/classes/stat/StatPings.d.ts +2 -2
- package/classes/stat/StatQueue.d.ts +61 -0
- package/classes/stat/StatSignalingCommands.d.ts +2 -2
- package/classes/stat/StatUnloadJournal.d.ts +30 -0
- package/classes/transport/DirectTransport.d.ts +3 -2
- package/classes/transport/PerfStatReporter.d.ts +2 -0
- package/classes/transport/ServerTransport.d.ts +3 -6
- package/classes/transport/SimulcastSender.d.ts +31 -0
- package/classes/transport/Transport.d.ts +5 -2
- package/default/Api.d.ts +14 -3
- package/default/ApiExternal.d.ts +2 -1
- package/default/Signaling.d.ts +11 -15
- package/default/SignalingTransport.d.ts +6 -1
- package/enums/ClientHangupReason.d.ts +7 -0
- package/enums/SessionError.d.ts +10 -0
- package/enums/Stat.d.ts +0 -1
- package/package.json +3 -3
- package/static/ApiTransport.d.ts +3 -0
- package/static/External.d.ts +1 -1
- package/static/Params.d.ts +42 -2
- package/static/ParticipantConnectionStatusUtils.d.ts +1 -0
- package/static/Sdp.d.ts +3 -0
- package/static/SignalingCapabilities.d.ts +1 -1
- package/static/SimulcastInfo.d.ts +5 -3
- package/static/Utils.d.ts +1 -2
- package/static/WebRTCUtils.d.ts +9 -12
- package/types/Api.d.ts +9 -0
- package/types/Capabilities.d.ts +1 -0
- package/types/FastHangup.d.ts +66 -0
- package/types/Participant.d.ts +1 -0
- package/types/PerfStatReporter.d.ts +0 -4
- package/types/SignalingCommand.d.ts +2 -0
- package/types/SignalingMessage.d.ts +1 -0
- package/utils/IceServers.d.ts +2 -0
- package/utils/NavigatorPermissions.d.ts +2 -2
- package/utils/SerializeLatest.d.ts +5 -0
- package/classes/StatsLogger.d.ts +0 -41
|
@@ -1,21 +1,28 @@
|
|
|
1
|
-
import BaseApi from '../../abstract/BaseApi';
|
|
2
1
|
import BaseLogger from '../../abstract/BaseLogger';
|
|
3
2
|
import TransportTopology from '../../enums/TransportTopology';
|
|
4
3
|
import HangupReason from '../HangupReason';
|
|
5
|
-
import
|
|
4
|
+
import StatEventCollector from './StatEventCollector';
|
|
6
5
|
import { CallLifecycleStats } from './CallLifecycleStats';
|
|
7
6
|
import { CodecStatsAggregator } from './CodecStatsAggregator';
|
|
8
7
|
import { StatAggregator } from './StatAggregator';
|
|
9
8
|
import { StatPings } from './StatPings';
|
|
10
9
|
import { StatSignalingCommands } from './StatSignalingCommands';
|
|
11
10
|
export declare class ConversationStats {
|
|
12
|
-
readonly logger:
|
|
11
|
+
readonly logger: StatEventCollector;
|
|
13
12
|
readonly lifecycle: CallLifecycleStats;
|
|
14
13
|
readonly statAggregator: StatAggregator;
|
|
15
14
|
readonly codecStatsAggregator: CodecStatsAggregator;
|
|
16
15
|
readonly pings: StatPings;
|
|
17
16
|
readonly signalingCommands: StatSignalingCommands;
|
|
18
|
-
constructor(
|
|
17
|
+
constructor(externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);
|
|
18
|
+
/**
|
|
19
|
+
* Вызывается из pagehide-обработчика: события финиша должны пережить смерть вкладки.
|
|
20
|
+
*
|
|
21
|
+
* Сводки пингов и команд сбрасываем здесь же: обычный путь делает это в
|
|
22
|
+
* flushCallMetrics(), а destroy() их только очищает. Если flushCallMetrics()
|
|
23
|
+
* уже отработал, трекеры пусты и повторной записи не будет.
|
|
24
|
+
*/
|
|
25
|
+
prepareForUnload(): void;
|
|
19
26
|
logHangup(reason: HangupReason): void;
|
|
20
27
|
flushCallMetrics(): void;
|
|
21
28
|
destroy(): void;
|
|
@@ -1,12 +1,16 @@
|
|
|
1
1
|
import { ICallStatLog } from '../../types/PerfStatReporter';
|
|
2
2
|
import { IEventualStatLog } from '../../types/IEventualStatLog';
|
|
3
|
-
import
|
|
3
|
+
import StatEventCollector from './StatEventCollector';
|
|
4
4
|
export declare class StatAggregator {
|
|
5
5
|
private readonly _logger;
|
|
6
6
|
private readonly _eventualLogs;
|
|
7
|
-
|
|
7
|
+
private _lastCallStatContext;
|
|
8
|
+
constructor(logger: StatEventCollector);
|
|
8
9
|
logCallStat(params: ICallStatLog): void;
|
|
9
10
|
/** @link https://wiki.odkl.ru/pages/viewpage.action?pageId=100892588 */
|
|
10
11
|
logEventualStat(params: IEventualStatLog): void;
|
|
11
12
|
destroy(): void;
|
|
13
|
+
private _getCallStatContext;
|
|
14
|
+
private _flushEventualStats;
|
|
15
|
+
private _logEventualStat;
|
|
12
16
|
}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import BaseApi from '../../abstract/BaseApi';
|
|
2
|
+
import { StatQueueEntry } from './StatQueue';
|
|
3
|
+
/**
|
|
4
|
+
* Отправитель очереди статистики: один на вкладку.
|
|
5
|
+
*
|
|
6
|
+
* Живёт от CallsSDK.init() и не завязан на активный звонок. Держит машину
|
|
7
|
+
* состояний триггеров, забирает батч под Web Lock, отправляет и удаляет
|
|
8
|
+
* отправленное.
|
|
9
|
+
*/
|
|
10
|
+
export default abstract class StatDrainScheduler {
|
|
11
|
+
private static _api;
|
|
12
|
+
private static _serverTimeDelta;
|
|
13
|
+
private static _state;
|
|
14
|
+
private static _timer;
|
|
15
|
+
private static _localCount;
|
|
16
|
+
static setApi(value: BaseApi): void;
|
|
17
|
+
/**
|
|
18
|
+
* Запускает шедулер. Один дрейн на старте подбирает хвосты, оставленные
|
|
19
|
+
* прошлыми сессиями и закрытыми вкладками.
|
|
20
|
+
*/
|
|
21
|
+
static start(value: BaseApi): void;
|
|
22
|
+
static stop(): void;
|
|
23
|
+
/** Вызывается коллектором после записи события в очередь. */
|
|
24
|
+
static notifyAppended(): void;
|
|
25
|
+
/**
|
|
26
|
+
* Один цикл отправки.
|
|
27
|
+
*
|
|
28
|
+
* @returns true, если очередь могла остаться непустой и имеет смысл повторить.
|
|
29
|
+
*/
|
|
30
|
+
static drainOnce(): Promise<boolean>;
|
|
31
|
+
/**
|
|
32
|
+
* FALLBACK: прямая отправка в обход очереди.
|
|
33
|
+
*
|
|
34
|
+
* Вызывается коллектором только когда событие не удалось положить в
|
|
35
|
+
* IndexedDB: SecurityError в cross-site iframe с заблокированным сторонним
|
|
36
|
+
* хранилищем, зависший open в Safari, переполненная квота. Событие уходит
|
|
37
|
+
* одним запросом без подтверждения и без повтора — это уровень доставки
|
|
38
|
+
* старого StatsLogger, а не гарантия очереди. Для пользователей с рабочим
|
|
39
|
+
* хранилищем этот путь не используется никогда.
|
|
40
|
+
*
|
|
41
|
+
* Событие чужого пользователя не отправляется: запрос уходит под текущей
|
|
42
|
+
* сессией, а очередь партиционирована по владельцу именно ради этого.
|
|
43
|
+
*/
|
|
44
|
+
static sendDirect(entry: StatQueueEntry): Promise<void>;
|
|
45
|
+
private static _currentUserId;
|
|
46
|
+
/**
|
|
47
|
+
* Взаимное исключение между вкладками одного origin.
|
|
48
|
+
*
|
|
49
|
+
* IndexedDB коммитит транзакцию, как только опустеет очередь её запросов на
|
|
50
|
+
* текущем тике event loop, поэтому держать транзакцию открытой на время
|
|
51
|
+
* отправки невозможно: чтение и удаление обязаны быть разными транзакциями.
|
|
52
|
+
* Всё время запроса записи видны другим вкладкам, и без внешней блокировки
|
|
53
|
+
* соседняя вкладка отправила бы тот же батч повторно.
|
|
54
|
+
*
|
|
55
|
+
* Web Lock удерживается на всё время колбэка, включая сеть, и снимается
|
|
56
|
+
* браузером автоматически при закрытии или падении вкладки.
|
|
57
|
+
*/
|
|
58
|
+
private static _withLock;
|
|
59
|
+
/**
|
|
60
|
+
* Ретраятся ошибки, в которых виновато не содержимое батча: сетевой сбой,
|
|
61
|
+
* таймаут, 5xx, троттлинг http-429 и ошибка сессии. Сессию транспорт чинит
|
|
62
|
+
* сам одной реавторизацией с повтором (Api._sendClientStats), но если и она
|
|
63
|
+
* не помогла, сырая ошибка {error_code} долетает сюда — авторизация может
|
|
64
|
+
* восстановиться позже, удалять из-за неё батч нельзя.
|
|
65
|
+
*
|
|
66
|
+
* Всё остальное считается непроходимым и приводит к удалению батча. Без этого
|
|
67
|
+
* одно событие, которое сервер отвергает всегда, залипило бы очередь навсегда:
|
|
68
|
+
* каждый тик читал бы тот же батч, получал ту же ошибку и ничего не удалял,
|
|
69
|
+
* пока эвикшн не начал бы выбрасывать свежие звонки.
|
|
70
|
+
*/
|
|
71
|
+
private static _isSessionError;
|
|
72
|
+
private static _isRetryable;
|
|
73
|
+
private static _getServerTimeDelta;
|
|
74
|
+
private static _toClientStats;
|
|
75
|
+
private static _clearTimer;
|
|
76
|
+
private static _arm;
|
|
77
|
+
private static _drain;
|
|
78
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import BaseLogger from '../../abstract/BaseLogger';
|
|
2
|
+
import StatLog from '../../enums/StatLog';
|
|
3
|
+
import TransportTopology from '../../enums/TransportTopology';
|
|
4
|
+
type ClientStatsPayload = Record<string, string | number | boolean | undefined | null>;
|
|
5
|
+
export type LogClientStatsOptions = {
|
|
6
|
+
/** Время наступления события. По умолчанию — момент записи. */
|
|
7
|
+
occurredAt?: number;
|
|
8
|
+
/** Явный conversationId. По умолчанию берётся из провайдера. */
|
|
9
|
+
conversationId?: string | null;
|
|
10
|
+
};
|
|
11
|
+
/**
|
|
12
|
+
* Собирает событие статистики и кладёт его в персистентную очередь.
|
|
13
|
+
*
|
|
14
|
+
* Инстанс на звонок: держит провайдеры conversationId и топологии и ссылку
|
|
15
|
+
* на внешний логгер хоста. Отправкой занимается StatDrainScheduler.
|
|
16
|
+
*/
|
|
17
|
+
export default class StatEventCollector extends BaseLogger {
|
|
18
|
+
private readonly _externalLogger;
|
|
19
|
+
private readonly _conversationIdProvider;
|
|
20
|
+
private readonly _topologyProvider;
|
|
21
|
+
private _unloadMode;
|
|
22
|
+
constructor(externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
|
|
23
|
+
log(name: StatLog, value?: string, immediately?: boolean): void;
|
|
24
|
+
/**
|
|
25
|
+
* Переключает коллектор на синхронный localStorage-журнал.
|
|
26
|
+
*
|
|
27
|
+
* Вызывается из pagehide-обработчика: асинхронная запись в IndexedDB не
|
|
28
|
+
* переживает перезагрузку или навигацию, а журнал переносится в очередь
|
|
29
|
+
* при следующем старте SDK.
|
|
30
|
+
*/
|
|
31
|
+
enterUnloadMode(): void;
|
|
32
|
+
logClientStats(data: ClientStatsPayload, options?: LogClientStatsOptions): void;
|
|
33
|
+
destroy(): void;
|
|
34
|
+
private _getConversationId;
|
|
35
|
+
private _getCallTopology;
|
|
36
|
+
}
|
|
37
|
+
export {};
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import { SignalingTransportType } from '../../enums/SignalingTransportStat';
|
|
2
|
-
import
|
|
2
|
+
import StatEventCollector from './StatEventCollector';
|
|
3
3
|
export declare class StatPings {
|
|
4
4
|
private readonly _logger;
|
|
5
5
|
private trackerByTransport;
|
|
6
6
|
private lastSeen;
|
|
7
|
-
constructor(logger:
|
|
7
|
+
constructor(logger: StatEventCollector);
|
|
8
8
|
/**
|
|
9
9
|
* Вызывать при входящем ping в сигналингу.
|
|
10
10
|
* Будет произведен расчет времени между пингами.
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/** Произвольный набор скалярных полей события. */
|
|
2
|
+
export type StatPayload = Record<string, string | number | boolean | null>;
|
|
3
|
+
/** Запись очереди без сгенерированного ключа. */
|
|
4
|
+
export type StatQueueEntry = {
|
|
5
|
+
/** userId владельца события. Не может быть неизвестным. */
|
|
6
|
+
uid: number;
|
|
7
|
+
/** conversationId. null — событие залогировано до старта звонка. */
|
|
8
|
+
vcid: string | null;
|
|
9
|
+
/** Время записи в device-time, без коррекции по серверу. */
|
|
10
|
+
ts: number;
|
|
11
|
+
ev: StatPayload;
|
|
12
|
+
};
|
|
13
|
+
/** Запись очереди, прочитанная из хранилища. */
|
|
14
|
+
export type StatQueueRecord = StatQueueEntry & {
|
|
15
|
+
/** Автоинкремент. Единственный источник истины для порядка событий. */
|
|
16
|
+
id: number;
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* Персистентная очередь событий статистики поверх IndexedDB.
|
|
20
|
+
*
|
|
21
|
+
* База одна на origin, её делят все звонки и все вкладки, поэтому класс
|
|
22
|
+
* статический: второго экземпляра быть не может. Любая ошибка хранилища
|
|
23
|
+
* только логируется — статистика никогда не влияет на звонок.
|
|
24
|
+
*/
|
|
25
|
+
export default abstract class StatQueue {
|
|
26
|
+
private static _db;
|
|
27
|
+
private static _dbPromise;
|
|
28
|
+
private static _supported;
|
|
29
|
+
private static _appendsSinceEvictCheck;
|
|
30
|
+
static isSupported(): boolean;
|
|
31
|
+
static append(entry: StatQueueEntry): Promise<boolean>;
|
|
32
|
+
static count(): Promise<number>;
|
|
33
|
+
/**
|
|
34
|
+
* Читает самые старые события пользователя.
|
|
35
|
+
*
|
|
36
|
+
* Записи индекса с одинаковым ключом упорядочены по первичному ключу, а
|
|
37
|
+
* первичный ключ здесь — автоинкрементный id, поэтому выборка по индексу
|
|
38
|
+
* by_uid возвращает события в порядке записи без дополнительной сортировки.
|
|
39
|
+
*/
|
|
40
|
+
static readOldest(uid: number, limit: number): Promise<StatQueueRecord[]>;
|
|
41
|
+
static remove(ids: number[]): Promise<void>;
|
|
42
|
+
/**
|
|
43
|
+
* Приводит размер хранилища к лимиту, удаляя самые старые звонки целиком.
|
|
44
|
+
*
|
|
45
|
+
* Частично удалённый звонок — это ровно та неполная цепочка событий, ради
|
|
46
|
+
* устранения которой заведена задача, поэтому звонок выносится по vcid
|
|
47
|
+
* одной транзакцией. Записи без vcid (события до старта звонка) нельзя
|
|
48
|
+
* трактовать как одну группу: иначе один эвикшн вынес бы pre-call события
|
|
49
|
+
* сразу всех звонков.
|
|
50
|
+
*/
|
|
51
|
+
static evictToLimit(limit: number): Promise<void>;
|
|
52
|
+
private static _checkSupport;
|
|
53
|
+
private static _open;
|
|
54
|
+
private static _close;
|
|
55
|
+
private static _createSchema;
|
|
56
|
+
/** Обёртка над транзакцией: резолвится после успешного коммита. */
|
|
57
|
+
private static _runTransaction;
|
|
58
|
+
/** Читает запись с минимальным id, то есть самую старую в хранилище. */
|
|
59
|
+
private static _readOldestRecord;
|
|
60
|
+
private static _readIdsByConversation;
|
|
61
|
+
}
|
|
@@ -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,30 @@
|
|
|
1
|
+
import { StatQueueEntry } from './StatQueue';
|
|
2
|
+
/**
|
|
3
|
+
* Синхронный журнал умирающей вкладки.
|
|
4
|
+
*
|
|
5
|
+
* Транзакция IndexedDB, начатая в pagehide-обработчике, не успевает
|
|
6
|
+
* закоммититься при перезагрузке или навигации: браузер сносит документ,
|
|
7
|
+
* не дав движку базы завершить запись. Из синхронных хранилищ на этот момент
|
|
8
|
+
* доступен только localStorage, поэтому события финиша складываются сюда,
|
|
9
|
+
* а при следующем старте SDK переносятся в очередь drainToQueue().
|
|
10
|
+
*
|
|
11
|
+
* Ключ уникален на вкладку: две вкладки, умирающие одновременно, не затирают
|
|
12
|
+
* журналы друг друга.
|
|
13
|
+
*/
|
|
14
|
+
export default abstract class StatUnloadJournal {
|
|
15
|
+
private static _tabKey;
|
|
16
|
+
private static _entries;
|
|
17
|
+
static writeSync(entry: StatQueueEntry): boolean;
|
|
18
|
+
/**
|
|
19
|
+
* Переносит журналы всех закрытых вкладок в очередь IndexedDB.
|
|
20
|
+
*
|
|
21
|
+
* Журнал стирается независимо от исхода переноса: это best-effort страховка,
|
|
22
|
+
* повторные попытки при неработающем IndexedDB дали бы дубли без шанса на
|
|
23
|
+
* успех. Статистика никогда не влияет на звонок.
|
|
24
|
+
*
|
|
25
|
+
* @returns число перенесённых событий.
|
|
26
|
+
*/
|
|
27
|
+
static drainToQueue(): Promise<number>;
|
|
28
|
+
private static _storage;
|
|
29
|
+
private static _isValidEntry;
|
|
30
|
+
}
|
|
@@ -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;
|
|
@@ -57,6 +57,7 @@ export default class DirectTransport extends BaseTransport {
|
|
|
57
57
|
private _disposePeerConnection;
|
|
58
58
|
setAnimojiTransport(receiver: AnimojiReceiver, sender: AnimojiSender): void;
|
|
59
59
|
close(error?: Error): void;
|
|
60
|
+
private _finishClose;
|
|
60
61
|
private _setState;
|
|
61
62
|
private _onSignalingNotification;
|
|
62
63
|
private _handleTransmittedData;
|
|
@@ -9,6 +9,7 @@ export default class PerfStatReporter extends EventEmitter {
|
|
|
9
9
|
private _previousNetworkStatReportTimestamp;
|
|
10
10
|
private _previousCallStatReportTimestamp;
|
|
11
11
|
private _previousCallStatReport;
|
|
12
|
+
private _previousRemoteInboundRtps;
|
|
12
13
|
private _screenShareStats;
|
|
13
14
|
private _signaling;
|
|
14
15
|
private readonly _directTopology;
|
|
@@ -21,6 +22,7 @@ export default class PerfStatReporter extends EventEmitter {
|
|
|
21
22
|
private reportPerfStats;
|
|
22
23
|
private reportNetworkStats;
|
|
23
24
|
private _reportCallStats;
|
|
25
|
+
private _calculatePacketLoss;
|
|
24
26
|
private _handleScreenSharingStat;
|
|
25
27
|
private _handleTransportStateChanged;
|
|
26
28
|
}
|
|
@@ -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';
|
|
@@ -42,12 +42,12 @@ export default class ServerTransport extends BaseTransport {
|
|
|
42
42
|
private _rtpReceiversByStreamId;
|
|
43
43
|
private _producerSessionId;
|
|
44
44
|
private _newAudioShareTrack;
|
|
45
|
-
private _simulcastInfo;
|
|
46
45
|
private readonly _debug;
|
|
47
46
|
private readonly _logger;
|
|
48
47
|
private readonly _statAggregator;
|
|
49
48
|
private readonly _codecStatsAggregator;
|
|
50
|
-
|
|
49
|
+
private readonly _simulcast;
|
|
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;
|
|
@@ -85,8 +85,6 @@ export default class ServerTransport extends BaseTransport {
|
|
|
85
85
|
private _detectStaleTracks;
|
|
86
86
|
private _allocateConsumer;
|
|
87
87
|
private _processOffer;
|
|
88
|
-
private _findFirstSimTransceiver;
|
|
89
|
-
private _setupSimulcastTransceiver;
|
|
90
88
|
private _acceptProducer;
|
|
91
89
|
private _replaceScreenShareTrack;
|
|
92
90
|
private _handleTracks;
|
|
@@ -101,7 +99,6 @@ export default class ServerTransport extends BaseTransport {
|
|
|
101
99
|
private _onReplacedTrack;
|
|
102
100
|
private _onSourcesChanged;
|
|
103
101
|
getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;
|
|
104
|
-
private _changeSimulcastInfo;
|
|
105
102
|
private _monitorRtpShare;
|
|
106
103
|
private _startMonitorRtpShareInterval;
|
|
107
104
|
private _stopMonitorRtpShareInterval;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import BaseSignaling from '../../abstract/BaseSignaling';
|
|
2
|
+
import { type DebugLogger } from '../../static/Debug';
|
|
3
|
+
import type VideoSettings from '../../types/VideoSettings';
|
|
4
|
+
import { MediaSource } from '../MediaSource';
|
|
5
|
+
import StatEventCollector from '../stat/StatEventCollector';
|
|
6
|
+
export default class SimulcastSender {
|
|
7
|
+
private _pc;
|
|
8
|
+
private _transceiver;
|
|
9
|
+
private _currentSimulcastInfo;
|
|
10
|
+
private readonly _signaling;
|
|
11
|
+
private readonly _mediaSource;
|
|
12
|
+
private readonly _getCameraSettings;
|
|
13
|
+
private readonly _debug;
|
|
14
|
+
private readonly _logger;
|
|
15
|
+
constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatEventCollector | null);
|
|
16
|
+
configureFromRemoteOffer(pc: RTCPeerConnection): Promise<void>;
|
|
17
|
+
finalizeAnswer(sdp: string): string;
|
|
18
|
+
sync({ force }?: {
|
|
19
|
+
force?: boolean;
|
|
20
|
+
}): Promise<void>;
|
|
21
|
+
replaceTrack(track: MediaStreamTrack): boolean;
|
|
22
|
+
reset(): void;
|
|
23
|
+
private _findTransceiver;
|
|
24
|
+
private _findMediaSection;
|
|
25
|
+
private _getConfig;
|
|
26
|
+
private _getTrackConfig;
|
|
27
|
+
private _applyConfig;
|
|
28
|
+
private _applyCurrentMediaState;
|
|
29
|
+
private _syncReplacedTrack;
|
|
30
|
+
private _changeSimulcast;
|
|
31
|
+
}
|
|
@@ -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';
|
|
@@ -50,7 +50,8 @@ export declare class Transport extends EventEmitter {
|
|
|
50
50
|
private readonly _codecStatsAggregator;
|
|
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?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
|
|
54
55
|
updateSettings(settings: ServerSettings): void;
|
|
55
56
|
updateStatisticsInterval(): void;
|
|
56
57
|
allocate(participantId: ParticipantId, isMaster?: boolean): void;
|
|
@@ -96,6 +97,8 @@ export declare class Transport extends EventEmitter {
|
|
|
96
97
|
private _onAnimojiStream;
|
|
97
98
|
/** Обработчик, досылающий MediaSourceEvent.SOURCE_CHANGED событие до аллокации транспортов */
|
|
98
99
|
private _onAnimojiStatus;
|
|
100
|
+
private _createVad;
|
|
101
|
+
private _updateVadTrack;
|
|
99
102
|
private _createAnimojiTransport;
|
|
100
103
|
private _removeAnimojiTransport;
|
|
101
104
|
getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;
|
package/default/Api.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import BaseApi, { ClientStats } from '../abstract/BaseApi';
|
|
2
2
|
import CallType from '../enums/CallType';
|
|
3
3
|
import HangupType from '../enums/HangupType';
|
|
4
|
+
import { IHangupParams } from '../types/Api';
|
|
4
5
|
import ConversationParams from '../types/ConversationParams';
|
|
5
6
|
import ConversationResponse from '../types/ConversationResponse';
|
|
6
7
|
import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/ExternalId';
|
|
@@ -11,14 +12,24 @@ export default class Api extends BaseApi {
|
|
|
11
12
|
private _idCache;
|
|
12
13
|
private _callUnsafe;
|
|
13
14
|
protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
|
|
14
|
-
userId(participantId: ParticipantId):
|
|
15
|
+
userId(participantId: ParticipantId): ExternalParticipantId;
|
|
15
16
|
authorize(): Promise<void>;
|
|
16
17
|
private _getAnonymLoginCacheKey;
|
|
17
18
|
private _getCachedAnonymLogin;
|
|
18
19
|
private _setCachedAnonymLogin;
|
|
19
20
|
private _removeCachedAnonymLogin;
|
|
21
|
+
private _reauthorize;
|
|
20
22
|
private _applyAnonymLogin;
|
|
21
|
-
|
|
23
|
+
/**
|
|
24
|
+
* Бекенд присылает 200 в любой ситуации, нужно читать тело.
|
|
25
|
+
* В теле есть ошибки если есть проблемы со статой.
|
|
26
|
+
*
|
|
27
|
+
* Ошибки по отдельным событиям логируются, но не влияют на результат:
|
|
28
|
+
* батч трактуется целиком, иначе одно всегда отвергаемое событие
|
|
29
|
+
* залипило бы очередь навсегда.
|
|
30
|
+
*/
|
|
31
|
+
private _sendClientStats;
|
|
32
|
+
logClientStats(items: ClientStats[]): Promise<void>;
|
|
22
33
|
uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
|
|
23
34
|
joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
|
|
24
35
|
createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, audienceMode, audioOnly, waitForAdmin, closedConversation, }?: {
|
|
@@ -55,7 +66,7 @@ export default class Api extends BaseApi {
|
|
|
55
66
|
getConversationParams(conversationId?: string): Promise<ConversationParams>;
|
|
56
67
|
getUserId(): OkUserId | null;
|
|
57
68
|
setUserId(userId: OkUserId): void;
|
|
58
|
-
hangupConversation(conversationId: string, reason?: HangupType): void;
|
|
69
|
+
hangupConversation(conversationId: string, reason?: HangupType, params?: Partial<IHangupParams>): void;
|
|
59
70
|
removeHistoryRecords(recordIds: number[]): Promise<void>;
|
|
60
71
|
cleanup(): void;
|
|
61
72
|
getServerTime(): Promise<number>;
|
package/default/ApiExternal.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { IHangupParams } from '../types/Api';
|
|
1
2
|
import { IAPIBaseUrl, IApiEnv } from '../types/Params';
|
|
2
3
|
export declare class ApiExternal {
|
|
3
4
|
private readonly _uuid;
|
|
@@ -8,5 +9,5 @@ export declare class ApiExternal {
|
|
|
8
9
|
private _sessionKey;
|
|
9
10
|
constructor(apiEvn: IApiEnv, apiKey: string, callToken: string, baseApiUrl?: IAPIBaseUrl);
|
|
10
11
|
authorize(): Promise<boolean>;
|
|
11
|
-
hangupConversation(conversationId: string): Promise<void>;
|
|
12
|
+
hangupConversation(conversationId: string, params?: Partial<IHangupParams>): Promise<void>;
|
|
12
13
|
}
|
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';
|
|
@@ -35,13 +35,13 @@ export default class Signaling extends BaseSignaling {
|
|
|
35
35
|
private datachannelCommandsQueue;
|
|
36
36
|
private incomingCache;
|
|
37
37
|
private responseHandlers;
|
|
38
|
+
private disposed;
|
|
38
39
|
private connectionType;
|
|
39
40
|
private conversationResolve;
|
|
40
41
|
private conversationReject;
|
|
41
42
|
private connected;
|
|
42
43
|
private listenersReady;
|
|
43
44
|
private peerId;
|
|
44
|
-
private conversationId;
|
|
45
45
|
private connectionMessageWaitTimer;
|
|
46
46
|
private participantIdRegistry;
|
|
47
47
|
private producerNotificationDataChannel;
|
|
@@ -56,26 +56,22 @@ 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;
|
|
63
|
-
setConversationId(conversationId: string): void;
|
|
64
63
|
setParticipantIdRegistry(participantIdRegistry: ParticipantIdRegistry): void;
|
|
65
64
|
setProducerNotificationDataChannel(dataChannel: RTCDataChannel): void;
|
|
66
65
|
setProducerCommandDataChannel(dataChannel: RTCDataChannel): void;
|
|
67
66
|
useCommandDataChannel(status: boolean): void;
|
|
68
|
-
|
|
69
|
-
* Free used resources
|
|
70
|
-
*/
|
|
71
|
-
cleanup(): void;
|
|
67
|
+
resetProducerConnection(cause?: Error): void;
|
|
72
68
|
/**
|
|
73
69
|
* Open a connection with a signaling server
|
|
74
70
|
*/
|
|
75
71
|
connect(connectionType: SignalingConnectionType): Promise<SignalingMessage.Connection>;
|
|
76
72
|
getNextCommandSequenceNumber(): number;
|
|
77
|
-
hangup(reason: string): Promise<SignalingMessage
|
|
78
|
-
sendCandidate(participantId: ParticipantId, candidate:
|
|
73
|
+
hangup(reason: string): Promise<SignalingMessage>;
|
|
74
|
+
sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidateInit): Promise<SignalingMessage>;
|
|
79
75
|
requestTestMode(consumerCommand: string, producerCommand: string | null): Promise<SignalingMessage>;
|
|
80
76
|
sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit, extraPayload?: Record<string, any>): Promise<SignalingMessage>;
|
|
81
77
|
acceptCall(mediaSettings: MediaSettings): Promise<SignalingMessage>;
|
|
@@ -138,10 +134,7 @@ export default class Signaling extends BaseSignaling {
|
|
|
138
134
|
acceptPromotion(reject?: boolean): Promise<SignalingMessage>;
|
|
139
135
|
feedback(key: string): Promise<SignalingMessage>;
|
|
140
136
|
getHandQueue(): Promise<SignalingMessage>;
|
|
141
|
-
|
|
142
|
-
* Close a connection with a signaling server
|
|
143
|
-
*/
|
|
144
|
-
close(): void;
|
|
137
|
+
dispose(cause?: Error): void;
|
|
145
138
|
/**
|
|
146
139
|
* Этот метод нужен т.к. после получения сообщения "connected" устанавливается транспорт
|
|
147
140
|
* и подписывается на сигналинг. Данные приходят очень быстро и транспорт пропускает
|
|
@@ -173,17 +166,20 @@ export default class Signaling extends BaseSignaling {
|
|
|
173
166
|
private _onError;
|
|
174
167
|
private _serializeErrorEvent;
|
|
175
168
|
private _onClose;
|
|
176
|
-
private
|
|
169
|
+
private _terminate;
|
|
170
|
+
private _fail;
|
|
177
171
|
private _isRecordCommand;
|
|
178
172
|
private _resolvePendingRecordCommands;
|
|
179
173
|
private _handleCommandResponse;
|
|
180
174
|
private _handleCommandsQueue;
|
|
181
175
|
private _startResponseTimer;
|
|
176
|
+
private _resolveCommandWithoutResponse;
|
|
182
177
|
private _serializeBinary;
|
|
183
178
|
private _serializeJson;
|
|
184
179
|
private _convertDisplayLayout;
|
|
185
180
|
private _waitConnectionMessage;
|
|
186
181
|
private _stopWaitConnectionMessage;
|
|
182
|
+
private _onTransportConnecting;
|
|
187
183
|
private _onTransportFailed;
|
|
188
184
|
private _onTransportReconnectScheduled;
|
|
189
185
|
private _onTransportConnectionDead;
|
|
@@ -16,7 +16,12 @@ export type SignalingTransportReconnectEvent = {
|
|
|
16
16
|
count: number;
|
|
17
17
|
delay: number;
|
|
18
18
|
};
|
|
19
|
+
export type SignalingTransportConnectingEvent = {
|
|
20
|
+
connectionType: SignalingConnectionType;
|
|
21
|
+
source: SignalingTransportType;
|
|
22
|
+
};
|
|
19
23
|
export type SignalingTransportHandlers = {
|
|
24
|
+
onConnecting: (event: SignalingTransportConnectingEvent) => void;
|
|
20
25
|
onOpen: () => void;
|
|
21
26
|
onMessage: (event: MessageEvent) => void;
|
|
22
27
|
onError: (event: Event) => void;
|
|
@@ -52,7 +57,7 @@ export default class SignalingTransport {
|
|
|
52
57
|
resetReconnectCount(): void;
|
|
53
58
|
connect(connectionType: SignalingConnectionType): void;
|
|
54
59
|
close(code?: number): void;
|
|
55
|
-
send(data: string | ArrayBuffer): void
|
|
60
|
+
send(data: string | ArrayBuffer): Promise<void>;
|
|
56
61
|
private _connect;
|
|
57
62
|
private _connectWebTransport;
|
|
58
63
|
private _connectWebSocket;
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import HangupType from './HangupType';
|
|
2
|
+
/**
|
|
3
|
+
* Причины завершения звонка, которые клиент может передать в {@link hangup}/{@link declineCall}
|
|
4
|
+
* и пробросить в сигналинг без маппинга.
|
|
5
|
+
*/
|
|
6
|
+
export type ClientHangupReason = HangupType.HUNGUP | HangupType.CANCELED | HangupType.REJECTED | HangupType.BUSY | HangupType.MISSED | HangupType.CALL_TIMEOUT;
|
|
7
|
+
export default ClientHangupReason;
|