@vkontakte/calls-sdk 2.8.13-dev.c9243c68.0 → 2.8.13-dev.d26e27ad.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 +2121 -1391
- 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 +2 -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 +7 -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 +2 -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 +2 -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 +40 -1
- package/static/SessionStore.d.ts +29 -0
- package/static/SimulcastInfo.d.ts +1 -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;
|
|
@@ -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 */
|
|
@@ -911,6 +932,13 @@ export type ParamsObject = {
|
|
|
911
932
|
* Собеседник подключился к сигналлингу
|
|
912
933
|
*/
|
|
913
934
|
onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
|
|
935
|
+
/**
|
|
936
|
+
* SDK обнаружил ошибку, после которой звонок может продолжаться.
|
|
937
|
+
*
|
|
938
|
+
* Callback предназначен для отправки ошибки в клиентский мониторинг.
|
|
939
|
+
* Его вызов не означает завершение звонка.
|
|
940
|
+
*/
|
|
941
|
+
onNonFatalError?: (error: Error, conversationId: string | null) => void;
|
|
914
942
|
};
|
|
915
943
|
export default abstract class Params {
|
|
916
944
|
private static _params;
|
|
@@ -920,7 +948,13 @@ export default abstract class Params {
|
|
|
920
948
|
static getScreenFrameRate(fastScreenShare: boolean): number;
|
|
921
949
|
static get<N extends keyof ParamsObject>(name: N): ParamsObject[N];
|
|
922
950
|
static get appName(): string;
|
|
923
|
-
static get appVersion():
|
|
951
|
+
static get appVersion(): string;
|
|
952
|
+
/**
|
|
953
|
+
* Версия клиента для `client_version` в `auth.anonymLogin`. Бэкенд валидирует формат,
|
|
954
|
+
* поэтому это фиксированное значение, а не версия приложения-хоста (см. {@link Params.appVersion}).
|
|
955
|
+
* @hidden
|
|
956
|
+
*/
|
|
957
|
+
static get apiClientVersion(): number;
|
|
924
958
|
static get sdkVersion(): string;
|
|
925
959
|
static get debug(): boolean;
|
|
926
960
|
static get protocolVersion(): 5 | 6;
|
|
@@ -928,6 +962,8 @@ export default abstract class Params {
|
|
|
928
962
|
static set platform(value: string);
|
|
929
963
|
static get clientStatsPlatform(): string;
|
|
930
964
|
static set clientStatsPlatform(value: string);
|
|
965
|
+
static get autoStartStats(): boolean;
|
|
966
|
+
static get statQueueEnabled(): boolean;
|
|
931
967
|
static get clientType(): string;
|
|
932
968
|
static set clientType(value: string);
|
|
933
969
|
static get externalUserType(): string;
|
|
@@ -1080,6 +1116,9 @@ export default abstract class Params {
|
|
|
1080
1116
|
movieShare: boolean;
|
|
1081
1117
|
clientType: string;
|
|
1082
1118
|
clientStatsPlatform: string;
|
|
1119
|
+
appVersion: string;
|
|
1120
|
+
autoStartStats: boolean;
|
|
1121
|
+
statQueueEnabled: boolean;
|
|
1083
1122
|
consumerScreenDataChannelPacketSize: number;
|
|
1084
1123
|
switchVideoAtBadNetwork: boolean;
|
|
1085
1124
|
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
|
+
}
|
|
@@ -4,6 +4,7 @@ export declare const SIMULCAST_DEFAULT: {
|
|
|
4
4
|
HEIGHT: number;
|
|
5
5
|
WIDTH: number;
|
|
6
6
|
BITRATE: number;
|
|
7
|
+
FPS: number;
|
|
7
8
|
};
|
|
8
9
|
export declare const SIMULCAST_SCALABILITY_MODE = "L1T2";
|
|
9
10
|
export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;
|
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
|
*
|