@vkontakte/calls-sdk 2.8.12-dev.615122b3.0 → 2.8.12-dev.68a694c3.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 +27 -7
- package/abstract/BaseApi.d.ts +6 -9
- package/abstract/BaseSignaling.d.ts +6 -5
- package/calls-sdk.cjs.js +10 -10
- package/calls-sdk.esm.js +2980 -2065
- package/classes/AudioFix.d.ts +2 -2
- package/classes/AudioOutput.d.ts +2 -2
- package/classes/CallRegistry.d.ts +5 -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} +47 -36
- 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} +4 -4
- 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/CallFinishClassifier.d.ts +11 -0
- package/classes/stat/CallLifecycleStats.d.ts +3 -8
- package/classes/stat/CodecStatsAggregator.d.ts +2 -2
- package/classes/stat/ConversationStats.d.ts +5 -4
- package/classes/stat/StatAggregator.d.ts +6 -2
- package/classes/stat/StatDrainScheduler.d.ts +16 -0
- package/classes/stat/StatEventCollector.d.ts +37 -0
- package/classes/stat/StatPings.d.ts +2 -2
- package/classes/stat/StatQueue.d.ts +39 -0
- package/classes/stat/StatSignalingCommands.d.ts +2 -2
- package/classes/stat/StatUnloadJournal.d.ts +25 -0
- package/classes/transport/DirectTransport.d.ts +3 -2
- package/classes/transport/ServerTransport.d.ts +3 -2
- package/classes/transport/Transport.d.ts +5 -2
- package/default/Api.d.ts +14 -4
- package/default/ApiExternal.d.ts +2 -1
- package/default/Signaling.d.ts +13 -16
- package/default/SignalingTransport.d.ts +7 -1
- package/enums/ClientHangupReason.d.ts +7 -0
- package/enums/HangupType.d.ts +0 -1
- 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/AuthData.d.ts +10 -0
- package/static/External.d.ts +1 -1
- package/static/Params.d.ts +28 -2
- package/static/Utils.d.ts +1 -1
- package/static/WebRTCUtils.d.ts +13 -12
- package/types/Api.d.ts +9 -0
- package/types/FastHangup.d.ts +66 -0
- package/types/SignalingMessage.d.ts +5 -1
- package/types/WebTransport.d.ts +14 -15
- package/utils/IceServers.d.ts +2 -0
- package/utils/NavigatorPermissions.d.ts +2 -2
- package/classes/StatsLogger.d.ts +0 -41
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { StatItem } from '../../types/Statistics';
|
|
2
|
-
import
|
|
2
|
+
import StatEventCollector from './StatEventCollector';
|
|
3
3
|
import TransportTopology from '../../enums/TransportTopology';
|
|
4
4
|
export type CodecKind = 'audio' | 'video';
|
|
5
5
|
/**
|
|
@@ -11,7 +11,7 @@ export declare class CodecStatsAggregator {
|
|
|
11
11
|
private readonly _logger;
|
|
12
12
|
private readonly _codecUsages;
|
|
13
13
|
private readonly getCurrentTransportTopology;
|
|
14
|
-
constructor(logger:
|
|
14
|
+
constructor(logger: StatEventCollector, getCurrentTransportTopology: () => TransportTopology | undefined);
|
|
15
15
|
reportUsage(stat: StatItem): void;
|
|
16
16
|
private saveUsage;
|
|
17
17
|
private report;
|
|
@@ -1,21 +1,22 @@
|
|
|
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
|
+
/** Вызывается из pagehide-обработчика: события финиша должны пережить смерть вкладки. */
|
|
19
|
+
prepareForUnload(): void;
|
|
19
20
|
logHangup(reason: HangupReason): void;
|
|
20
21
|
flushCallMetrics(): void;
|
|
21
22
|
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,16 @@
|
|
|
1
|
+
import BaseApi from '../../abstract/BaseApi';
|
|
2
|
+
export declare function setApi(value: BaseApi): void;
|
|
3
|
+
/**
|
|
4
|
+
* Один цикл отправки.
|
|
5
|
+
*
|
|
6
|
+
* @returns true, если очередь могла остаться непустой и имеет смысл повторить.
|
|
7
|
+
*/
|
|
8
|
+
export declare function drainOnce(): Promise<boolean>;
|
|
9
|
+
/** Вызывается коллектором после записи события в очередь. */
|
|
10
|
+
export declare function notifyAppended(): void;
|
|
11
|
+
/**
|
|
12
|
+
* Запускает шедулер. Один дрейн на старте подбирает хвосты, оставленные
|
|
13
|
+
* прошлыми сессиями и закрытыми вкладками.
|
|
14
|
+
*/
|
|
15
|
+
export declare function start(value: BaseApi): void;
|
|
16
|
+
export declare function stop(): void;
|
|
@@ -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,39 @@
|
|
|
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
|
+
export declare function isSupported(): boolean;
|
|
19
|
+
export declare function append(entry: StatQueueEntry): Promise<boolean>;
|
|
20
|
+
export declare function count(): Promise<number>;
|
|
21
|
+
/**
|
|
22
|
+
* Читает самые старые события пользователя.
|
|
23
|
+
*
|
|
24
|
+
* Записи индекса с одинаковым ключом упорядочены по первичному ключу, а
|
|
25
|
+
* первичный ключ здесь — автоинкрементный id, поэтому выборка по индексу
|
|
26
|
+
* by_uid возвращает события в порядке записи без дополнительной сортировки.
|
|
27
|
+
*/
|
|
28
|
+
export declare function readOldest(uid: number, limit: number): Promise<StatQueueRecord[]>;
|
|
29
|
+
export declare function remove(ids: number[]): Promise<void>;
|
|
30
|
+
/**
|
|
31
|
+
* Приводит размер хранилища к лимиту, удаляя самые старые звонки целиком.
|
|
32
|
+
*
|
|
33
|
+
* Частично удалённый звонок — это ровно та неполная цепочка событий, ради
|
|
34
|
+
* устранения которой заведена задача, поэтому звонок выносится по vcid
|
|
35
|
+
* одной транзакцией. Записи без vcid (события до старта звонка) нельзя
|
|
36
|
+
* трактовать как одну группу: иначе один эвикшн вынес бы pre-call события
|
|
37
|
+
* сразу всех звонков.
|
|
38
|
+
*/
|
|
39
|
+
export declare function evictToLimit(limit: number): Promise<void>;
|
|
@@ -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,25 @@
|
|
|
1
|
+
import * as StatQueue from './StatQueue';
|
|
2
|
+
/**
|
|
3
|
+
* Синхронный журнал умирающей вкладки.
|
|
4
|
+
*
|
|
5
|
+
* Транзакция IndexedDB, начатая в pagehide-обработчике, не успевает
|
|
6
|
+
* закоммититься при перезагрузке или навигации: браузер сносит документ,
|
|
7
|
+
* не дав движку базы завершить запись (подтверждено экспериментом,
|
|
8
|
+
* см. docs/superpowers/pagehide-demo). Из синхронных хранилищ на этот момент
|
|
9
|
+
* доступен только localStorage, поэтому события финиша складываются сюда,
|
|
10
|
+
* а при следующем старте SDK переносятся в очередь drainToQueue().
|
|
11
|
+
*
|
|
12
|
+
* Ключ уникален на вкладку: две вкладки, умирающие одновременно, не затирают
|
|
13
|
+
* журналы друг друга.
|
|
14
|
+
*/
|
|
15
|
+
export declare function writeSync(entry: StatQueue.StatQueueEntry): boolean;
|
|
16
|
+
/**
|
|
17
|
+
* Переносит журналы всех закрытых вкладок в очередь IndexedDB.
|
|
18
|
+
*
|
|
19
|
+
* Журнал стирается независимо от исхода переноса: это best-effort страховка,
|
|
20
|
+
* повторные попытки при неработающем IndexedDB дали бы дубли без шанса на
|
|
21
|
+
* успех. Статистика никогда не влияет на звонок.
|
|
22
|
+
*
|
|
23
|
+
* @returns число перенесённых событий.
|
|
24
|
+
*/
|
|
25
|
+
export declare function drainToQueue(): Promise<number>;
|
|
@@ -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;
|
|
@@ -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,11 +43,12 @@ export default class ServerTransport extends BaseTransport {
|
|
|
43
43
|
private _producerSessionId;
|
|
44
44
|
private _newAudioShareTrack;
|
|
45
45
|
private _simulcastInfo;
|
|
46
|
+
private _isSimulcastNegotiated;
|
|
46
47
|
private readonly _debug;
|
|
47
48
|
private readonly _logger;
|
|
48
49
|
private readonly _statAggregator;
|
|
49
50
|
private readonly _codecStatsAggregator;
|
|
50
|
-
constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?:
|
|
51
|
+
constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
|
|
51
52
|
updateStatisticsInterval(): void;
|
|
52
53
|
open(observer?: boolean): void;
|
|
53
54
|
close(error?: Error): void;
|
|
@@ -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,25 +1,35 @@
|
|
|
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';
|
|
7
8
|
import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
|
|
8
9
|
import PushData from '../types/PushData';
|
|
9
10
|
export default class Api extends BaseApi {
|
|
10
|
-
private _userId;
|
|
11
11
|
private _uuid;
|
|
12
12
|
private _idCache;
|
|
13
13
|
private _callUnsafe;
|
|
14
|
-
protected _call(method: string, data?: any, noSession?: boolean): Promise<any>;
|
|
14
|
+
protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
|
|
15
15
|
userId(participantId: ParticipantId): ExternalParticipantId;
|
|
16
16
|
authorize(): Promise<void>;
|
|
17
17
|
private _getAnonymLoginCacheKey;
|
|
18
18
|
private _getCachedAnonymLogin;
|
|
19
19
|
private _setCachedAnonymLogin;
|
|
20
20
|
private _removeCachedAnonymLogin;
|
|
21
|
+
private _reauthorize;
|
|
21
22
|
private _applyAnonymLogin;
|
|
22
|
-
|
|
23
|
+
/**
|
|
24
|
+
* Бекенд присылает 200 в любой ситуации, нужно читать тело.
|
|
25
|
+
* В теле есть ошибки если есть проблемы со статой.
|
|
26
|
+
*
|
|
27
|
+
* Ошибки по отдельным событиям логируются, но не влияют на результат:
|
|
28
|
+
* батч трактуется целиком, иначе одно всегда отвергаемое событие
|
|
29
|
+
* залипило бы очередь навсегда.
|
|
30
|
+
*/
|
|
31
|
+
private _sendClientStats;
|
|
32
|
+
logClientStats(items: ClientStats[]): Promise<void>;
|
|
23
33
|
uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
|
|
24
34
|
joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
|
|
25
35
|
createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, audienceMode, audioOnly, waitForAdmin, closedConversation, }?: {
|
|
@@ -56,7 +66,7 @@ export default class Api extends BaseApi {
|
|
|
56
66
|
getConversationParams(conversationId?: string): Promise<ConversationParams>;
|
|
57
67
|
getUserId(): OkUserId | null;
|
|
58
68
|
setUserId(userId: OkUserId): void;
|
|
59
|
-
hangupConversation(conversationId: string, reason?: HangupType): void;
|
|
69
|
+
hangupConversation(conversationId: string, reason?: HangupType, params?: Partial<IHangupParams>): void;
|
|
60
70
|
removeHistoryRecords(recordIds: number[]): Promise<void>;
|
|
61
71
|
cleanup(): void;
|
|
62
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
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
import BaseSignaling, { AddParticipantParams } from '../abstract/BaseSignaling';
|
|
2
|
-
import StatsLogger from '../classes/StatsLogger';
|
|
3
2
|
import { ParticipantIdRegistry } from '../classes/ParticipantIdRegistry';
|
|
4
3
|
import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
|
|
5
4
|
import { StatAggregator } from '../classes/stat/StatAggregator';
|
|
6
5
|
import { StatPings } from '../classes/stat/StatPings';
|
|
7
6
|
import { StatSignalingCommands } from '../classes/stat/StatSignalingCommands';
|
|
8
|
-
import
|
|
7
|
+
import StatEventCollector from '../classes/stat/StatEventCollector';
|
|
9
8
|
import ConversationFeature from '../enums/ConversationFeature';
|
|
10
9
|
import ConversationOption from '../enums/ConversationOption';
|
|
11
10
|
import MediaOption from '../enums/MediaOption';
|
|
12
11
|
import SignalingConnectionType from '../enums/SignalingConnectionType';
|
|
12
|
+
import TransportTopology from '../enums/TransportTopology';
|
|
13
13
|
import UserRole from '../enums/UserRole';
|
|
14
14
|
import { type DebugLogger } from '../static/Debug';
|
|
15
15
|
import { JSONObject } from '../static/Json';
|
|
@@ -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,21 @@ 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;
|
|
72
67
|
/**
|
|
73
68
|
* Open a connection with a signaling server
|
|
74
69
|
*/
|
|
75
70
|
connect(connectionType: SignalingConnectionType): Promise<SignalingMessage.Connection>;
|
|
76
71
|
getNextCommandSequenceNumber(): number;
|
|
77
|
-
hangup(reason: string): Promise<SignalingMessage
|
|
78
|
-
sendCandidate(participantId: ParticipantId, candidate:
|
|
72
|
+
hangup(reason: string): Promise<SignalingMessage>;
|
|
73
|
+
sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidateInit): Promise<SignalingMessage>;
|
|
79
74
|
requestTestMode(consumerCommand: string, producerCommand: string | null): Promise<SignalingMessage>;
|
|
80
75
|
sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit, extraPayload?: Record<string, any>): Promise<SignalingMessage>;
|
|
81
76
|
acceptCall(mediaSettings: MediaSettings): Promise<SignalingMessage>;
|
|
@@ -138,10 +133,7 @@ export default class Signaling extends BaseSignaling {
|
|
|
138
133
|
acceptPromotion(reject?: boolean): Promise<SignalingMessage>;
|
|
139
134
|
feedback(key: string): Promise<SignalingMessage>;
|
|
140
135
|
getHandQueue(): Promise<SignalingMessage>;
|
|
141
|
-
|
|
142
|
-
* Close a connection with a signaling server
|
|
143
|
-
*/
|
|
144
|
-
close(): void;
|
|
136
|
+
dispose(cause?: Error): void;
|
|
145
137
|
/**
|
|
146
138
|
* Этот метод нужен т.к. после получения сообщения "connected" устанавливается транспорт
|
|
147
139
|
* и подписывается на сигналинг. Данные приходят очень быстро и транспорт пропускает
|
|
@@ -173,20 +165,25 @@ export default class Signaling extends BaseSignaling {
|
|
|
173
165
|
private _onError;
|
|
174
166
|
private _serializeErrorEvent;
|
|
175
167
|
private _onClose;
|
|
176
|
-
private
|
|
168
|
+
private _terminate;
|
|
169
|
+
private _fail;
|
|
177
170
|
private _isRecordCommand;
|
|
178
171
|
private _resolvePendingRecordCommands;
|
|
179
172
|
private _handleCommandResponse;
|
|
180
173
|
private _handleCommandsQueue;
|
|
181
174
|
private _startResponseTimer;
|
|
175
|
+
private _resolveCommandWithoutResponse;
|
|
182
176
|
private _serializeBinary;
|
|
183
177
|
private _serializeJson;
|
|
184
178
|
private _convertDisplayLayout;
|
|
185
179
|
private _waitConnectionMessage;
|
|
186
180
|
private _stopWaitConnectionMessage;
|
|
181
|
+
private _onTransportConnecting;
|
|
187
182
|
private _onTransportFailed;
|
|
188
183
|
private _onTransportReconnectScheduled;
|
|
189
184
|
private _onTransportConnectionDead;
|
|
185
|
+
private _attachNotificationCallError;
|
|
186
|
+
private _createSignalingCallError;
|
|
190
187
|
private _getSocketType;
|
|
191
188
|
private _markTransportStat;
|
|
192
189
|
private _logTransportStat;
|
|
@@ -9,13 +9,19 @@ export declare enum SignalingTransportFailure {
|
|
|
9
9
|
export type SignalingTransportFailedEvent = {
|
|
10
10
|
failure: SignalingTransportFailure;
|
|
11
11
|
message: string;
|
|
12
|
+
source: SignalingTransportType;
|
|
12
13
|
remote?: boolean;
|
|
13
14
|
};
|
|
14
15
|
export type SignalingTransportReconnectEvent = {
|
|
15
16
|
count: number;
|
|
16
17
|
delay: number;
|
|
17
18
|
};
|
|
19
|
+
export type SignalingTransportConnectingEvent = {
|
|
20
|
+
connectionType: SignalingConnectionType;
|
|
21
|
+
source: SignalingTransportType;
|
|
22
|
+
};
|
|
18
23
|
export type SignalingTransportHandlers = {
|
|
24
|
+
onConnecting: (event: SignalingTransportConnectingEvent) => void;
|
|
19
25
|
onOpen: () => void;
|
|
20
26
|
onMessage: (event: MessageEvent) => void;
|
|
21
27
|
onError: (event: Event) => void;
|
|
@@ -51,7 +57,7 @@ export default class SignalingTransport {
|
|
|
51
57
|
resetReconnectCount(): void;
|
|
52
58
|
connect(connectionType: SignalingConnectionType): void;
|
|
53
59
|
close(code?: number): void;
|
|
54
|
-
send(data: string | ArrayBuffer): void
|
|
60
|
+
send(data: string | ArrayBuffer): Promise<void>;
|
|
55
61
|
private _connect;
|
|
56
62
|
private _connectWebTransport;
|
|
57
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;
|
package/enums/HangupType.d.ts
CHANGED
|
@@ -20,7 +20,6 @@ declare enum HangupType {
|
|
|
20
20
|
CALLER_IS_REJECTED = "CALLER_IS_REJECTED",
|
|
21
21
|
UNKNOWN_ERROR = "UNKNOWN_ERROR",
|
|
22
22
|
UNSUPPORTED = "UNSUPPORTED",
|
|
23
|
-
OLD_VERSION = "OLD_VERSION",
|
|
24
23
|
SERVICE_DISABLED = "SERVICE_DISABLED",
|
|
25
24
|
SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
|
|
26
25
|
EXTERNAL_API_ERROR = "EXTERNAL_API_ERROR",
|
package/enums/Stat.d.ts
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vkontakte/calls-sdk",
|
|
3
|
-
"version": "2.8.12-dev.
|
|
3
|
+
"version": "2.8.12-dev.68a694c3.0",
|
|
4
4
|
"author": "vk.com",
|
|
5
5
|
"description": "Library for video calls based on the vk.com platform",
|
|
6
6
|
"homepage": "https://vk.com",
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
"**/*.d.ts"
|
|
15
15
|
],
|
|
16
16
|
"dependencies": {
|
|
17
|
-
"@vkontakte/calls-audio-effects": "1.
|
|
17
|
+
"@vkontakte/calls-audio-effects": "1.4.1",
|
|
18
18
|
"@vkontakte/calls-video-effects": "2.2.3-beta.7",
|
|
19
19
|
"@vkontakte/calls-vmoji": "1.0.10-beta.17",
|
|
20
20
|
"@vkontakte/libvpx": "2.0.9",
|
|
@@ -22,6 +22,6 @@
|
|
|
22
22
|
"fflate": "^0.8.2",
|
|
23
23
|
"messagepack": "1.1.12",
|
|
24
24
|
"simple-ebml-builder": "0.2.2",
|
|
25
|
-
"webrtc-adapter": "
|
|
25
|
+
"webrtc-adapter": "9.0.5"
|
|
26
26
|
}
|
|
27
27
|
}
|
package/static/ApiTransport.d.ts
CHANGED
|
@@ -7,4 +7,7 @@ export declare function sendBeakon(method: string, params?: {
|
|
|
7
7
|
export declare function request(method: string, params?: {
|
|
8
8
|
[key: string]: any;
|
|
9
9
|
}, noSession?: boolean, customEndpoint?: string): Promise<any>;
|
|
10
|
+
export declare function requestKeepalive(method: string, params?: {
|
|
11
|
+
[key: string]: any;
|
|
12
|
+
}, noSession?: boolean): Promise<any>;
|
|
10
13
|
export declare function sendFormData(url: string, data: FormData): Promise<void>;
|
package/static/AuthData.d.ts
CHANGED
|
@@ -1,12 +1,22 @@
|
|
|
1
|
+
import type { OkUserId } from '../types/Participant';
|
|
1
2
|
export default abstract class AuthData {
|
|
2
3
|
private static _sessionKey;
|
|
3
4
|
private static _sessionSecretKey;
|
|
4
5
|
private static _accessToken;
|
|
6
|
+
private static _userId;
|
|
7
|
+
private static _reauthorizePromise;
|
|
5
8
|
static get sessionKey(): string | undefined;
|
|
6
9
|
static set sessionKey(value: string | undefined);
|
|
7
10
|
static get sessionSecretKey(): string | undefined;
|
|
8
11
|
static set sessionSecretKey(value: string | undefined);
|
|
9
12
|
static get accessToken(): string | undefined;
|
|
10
13
|
static set accessToken(value: string | undefined);
|
|
14
|
+
static get userId(): OkUserId | null;
|
|
15
|
+
static set userId(value: OkUserId | null);
|
|
11
16
|
static isEmpty(): boolean;
|
|
17
|
+
/**
|
|
18
|
+
* Дедуплицирует одновременные попытки реавторизации из разных инстансов Api.
|
|
19
|
+
* Первый вызов выполняет authorizeFn, остальные ждут того же промиса.
|
|
20
|
+
*/
|
|
21
|
+
static reauthorize(authorizeFn: () => Promise<void>): Promise<void>;
|
|
12
22
|
}
|
package/static/External.d.ts
CHANGED
|
@@ -637,6 +637,6 @@ declare namespace External {
|
|
|
637
637
|
/**
|
|
638
638
|
* Собеседник подключился к сигналлингу
|
|
639
639
|
*/
|
|
640
|
-
function onPeerRegistered(conversationId?: string): void;
|
|
640
|
+
function onPeerRegistered(conversationId?: string, externalIds?: ExternalId[]): void;
|
|
641
641
|
}
|
|
642
642
|
export default External;
|