@vkontakte/calls-sdk 2.8.13-dev.0b862caf.0 → 2.8.13-dev.2857d9d9.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 +12 -8
- package/calls-sdk.cjs.js +7 -7
- package/calls-sdk.esm.js +2068 -1288
- package/classes/AudioFix.d.ts +2 -2
- package/classes/AudioOutput.d.ts +3 -3
- package/classes/MediaSource.d.ts +6 -2
- package/classes/SpecListener.d.ts +2 -2
- package/classes/VolumesDetector.d.ts +0 -1
- package/classes/codec/LibVPxDecoder.d.ts +2 -2
- package/classes/codec/LibVPxEncoder.d.ts +2 -2
- package/classes/codec/WebCodecsDecoder.d.ts +2 -2
- package/classes/codec/WebCodecsEncoder.d.ts +2 -2
- package/classes/codec/WorkerBase.d.ts +3 -3
- package/classes/conversation/Conversation.d.ts +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/ApiCallStats.d.ts +12 -0
- package/classes/stat/CallLifecycleStats.d.ts +2 -2
- package/classes/stat/CodecStatsAggregator.d.ts +2 -2
- package/classes/stat/ConversationStats.d.ts +14 -2
- package/classes/stat/PeerConnectionStats.d.ts +19 -0
- package/classes/stat/StatAggregator.d.ts +10 -3
- 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 +7 -2
- package/classes/transport/PerfStatReporter.d.ts +2 -0
- package/classes/transport/ServerTransport.d.ts +3 -2
- package/classes/transport/SimulcastSender.d.ts +2 -2
- package/classes/transport/Transport.d.ts +2 -2
- package/default/Api.d.ts +10 -1
- package/default/Signaling.d.ts +11 -3
- package/default/SignalingTransport.d.ts +1 -5
- package/enums/SessionError.d.ts +10 -0
- package/enums/Stat.d.ts +8 -0
- package/package.json +1 -1
- package/static/ApiTransport.d.ts +4 -0
- package/static/Params.d.ts +50 -4
- package/static/SessionStore.d.ts +29 -0
- package/static/SimulcastInfo.d.ts +1 -0
- package/static/WebRTCUtils.d.ts +5 -5
- package/types/IEventualStatLog.d.ts +1 -1
|
@@ -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';
|
|
@@ -39,11 +39,12 @@ export default class DirectTransport extends BaseTransport {
|
|
|
39
39
|
private _lastBadConnection;
|
|
40
40
|
private _perfStatReporter;
|
|
41
41
|
private _directStatReporter;
|
|
42
|
+
private readonly _peerConnectionStats;
|
|
42
43
|
private readonly _debug;
|
|
43
44
|
private readonly _logger;
|
|
44
45
|
private readonly _statAggregator;
|
|
45
46
|
private readonly _codecStatsAggregator;
|
|
46
|
-
constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?:
|
|
47
|
+
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
48
|
get participantId(): ParticipantId;
|
|
48
49
|
updateStatisticsInterval(): void;
|
|
49
50
|
private _isDeadConnection;
|
|
@@ -72,6 +73,10 @@ export default class DirectTransport extends BaseTransport {
|
|
|
72
73
|
private _markConnected;
|
|
73
74
|
private _onConnectionStateChange;
|
|
74
75
|
private _startReconnection;
|
|
76
|
+
/**
|
|
77
|
+
* Запрашивает у сигналинга переход на серверную топологию.
|
|
78
|
+
* Обычно это делает только мастер, `fromAnySide` снимает это ограничение.
|
|
79
|
+
*/
|
|
75
80
|
private _requestTopologySwitch;
|
|
76
81
|
private _stopReconnection;
|
|
77
82
|
private _startIceRestart;
|
|
@@ -10,6 +10,7 @@ export default class PerfStatReporter extends EventEmitter {
|
|
|
10
10
|
private _previousCallStatReportTimestamp;
|
|
11
11
|
private _previousCallStatReport;
|
|
12
12
|
private _previousRemoteInboundRtps;
|
|
13
|
+
private _previousCandidatePair;
|
|
13
14
|
private _screenShareStats;
|
|
14
15
|
private _signaling;
|
|
15
16
|
private readonly _directTopology;
|
|
@@ -22,6 +23,7 @@ export default class PerfStatReporter extends EventEmitter {
|
|
|
22
23
|
private reportPerfStats;
|
|
23
24
|
private reportNetworkStats;
|
|
24
25
|
private _reportCallStats;
|
|
26
|
+
private _reportCandidatePair;
|
|
25
27
|
private _calculatePacketLoss;
|
|
26
28
|
private _handleScreenSharingStat;
|
|
27
29
|
private _handleTransportStateChanged;
|
|
@@ -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';
|
|
@@ -45,9 +45,10 @@ export default class ServerTransport extends BaseTransport {
|
|
|
45
45
|
private readonly _debug;
|
|
46
46
|
private readonly _logger;
|
|
47
47
|
private readonly _statAggregator;
|
|
48
|
+
private readonly _peerConnectionStats;
|
|
48
49
|
private readonly _codecStatsAggregator;
|
|
49
50
|
private readonly _simulcast;
|
|
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;
|
|
@@ -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
|
@@ -14,14 +14,23 @@ export default class Api extends BaseApi {
|
|
|
14
14
|
protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
|
|
15
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, }?: {
|
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';
|
|
@@ -42,6 +42,8 @@ export default class Signaling extends BaseSignaling {
|
|
|
42
42
|
private connected;
|
|
43
43
|
private listenersReady;
|
|
44
44
|
private peerId;
|
|
45
|
+
/** Когда началась череда падений соединения, от неё считаем *_timeout */
|
|
46
|
+
private reconnectStartedAt;
|
|
45
47
|
private connectionMessageWaitTimer;
|
|
46
48
|
private participantIdRegistry;
|
|
47
49
|
private producerNotificationDataChannel;
|
|
@@ -56,7 +58,7 @@ export default class Signaling extends BaseSignaling {
|
|
|
56
58
|
private static get WAIT_CONNECTION_DELAY();
|
|
57
59
|
private static get WAIT_RESPONSE_DELAY();
|
|
58
60
|
get ready(): boolean;
|
|
59
|
-
constructor(debug?: DebugLogger, logger?:
|
|
61
|
+
constructor(debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
|
|
60
62
|
setAbortSignal(signal: AbortSignal | undefined): void;
|
|
61
63
|
setEndpoint(endpoint: string): void;
|
|
62
64
|
setWebTransportEndpoint(endpoint: string | null): void;
|
|
@@ -164,7 +166,8 @@ export default class Signaling extends BaseSignaling {
|
|
|
164
166
|
private _handleCachedMessages;
|
|
165
167
|
private _throwError;
|
|
166
168
|
private _onError;
|
|
167
|
-
|
|
169
|
+
/** Причина ошибки для статы: короткий читаемый текст */
|
|
170
|
+
private _describeErrorEvent;
|
|
168
171
|
private _onClose;
|
|
169
172
|
private _terminate;
|
|
170
173
|
private _fail;
|
|
@@ -182,10 +185,15 @@ export default class Signaling extends BaseSignaling {
|
|
|
182
185
|
private _onTransportConnecting;
|
|
183
186
|
private _onTransportFailed;
|
|
184
187
|
private _onTransportReconnectScheduled;
|
|
188
|
+
/** Попыток восстановить соединение больше не будет: отправляем, сколько длилась череда падений */
|
|
189
|
+
private _logReconnectTimeout;
|
|
185
190
|
private _onTransportConnectionDead;
|
|
186
191
|
private _attachNotificationCallError;
|
|
187
192
|
private _createSignalingCallError;
|
|
188
193
|
private _getSocketType;
|
|
189
194
|
private _markTransportStat;
|
|
195
|
+
/** Событие уходит с переданными полями, без value — уходит без value */
|
|
190
196
|
private _logTransportStat;
|
|
197
|
+
/** value — время от метки, поставленной в _markTransportStat; метки нет — событие не отправляем */
|
|
198
|
+
private _logTransportStatSinceMark;
|
|
191
199
|
}
|
|
@@ -4,7 +4,6 @@ import { DebugLogger } from '../static/Debug';
|
|
|
4
4
|
export declare enum SignalingTransportFailure {
|
|
5
5
|
EMPTY_ENDPOINT = "EMPTY_ENDPOINT",
|
|
6
6
|
NETWORK_ERROR = "NETWORK_ERROR",
|
|
7
|
-
RECONNECT_TIMEOUT = "RECONNECT_TIMEOUT",
|
|
8
7
|
ABORTED = "ABORTED"
|
|
9
8
|
}
|
|
10
9
|
export type SignalingTransportFailedEvent = {
|
|
@@ -41,7 +40,6 @@ export default class SignalingTransport {
|
|
|
41
40
|
private connectionType;
|
|
42
41
|
private reconnectCount;
|
|
43
42
|
private reconnectTimer;
|
|
44
|
-
private reconnectDeadlineTimer;
|
|
45
43
|
private doctorTimer;
|
|
46
44
|
private forceWebSocket;
|
|
47
45
|
private abortSignal;
|
|
@@ -56,7 +54,7 @@ export default class SignalingTransport {
|
|
|
56
54
|
setPeerId(peerId: number | null): void;
|
|
57
55
|
setLastStamp(lastStamp: number): void;
|
|
58
56
|
setAbortSignal(signal?: AbortSignal): void;
|
|
59
|
-
|
|
57
|
+
resetReconnectCount(): void;
|
|
60
58
|
connect(connectionType: SignalingConnectionType): void;
|
|
61
59
|
close(code?: number): void;
|
|
62
60
|
send(data: string | ArrayBuffer): Promise<void>;
|
|
@@ -72,8 +70,6 @@ export default class SignalingTransport {
|
|
|
72
70
|
private _onClose;
|
|
73
71
|
private _disconnect;
|
|
74
72
|
private _scheduleReconnect;
|
|
75
|
-
private _startReconnectDeadline;
|
|
76
|
-
private _stopReconnectDeadline;
|
|
77
73
|
private _getReconnectDelay;
|
|
78
74
|
private _startDoctor;
|
|
79
75
|
private _stopDoctor;
|
|
@@ -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/enums/Stat.d.ts
CHANGED
|
@@ -14,6 +14,14 @@ declare const enum Stat {
|
|
|
14
14
|
USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
|
|
15
15
|
SIGNALING_PING_SUMMARY = "signaling_ping_summary",
|
|
16
16
|
SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
|
|
17
|
+
API_CALL = "api_call",
|
|
18
|
+
CONNECTION_STATE_CHANGED = "connection_state_changed",
|
|
19
|
+
SIGNALING_STATE_CHANGED = "signaling_state_changed",
|
|
20
|
+
GATHERING_STATE_CHANGED = "gathering_state_changed",
|
|
21
|
+
ICE_RESTART = "ice_restart",
|
|
22
|
+
ICE_CANDIDATES_CHANGED = "ice_candidates_changed",
|
|
23
|
+
ICE_CANDIDATE_GATHERING_FAILED = "ice_candidate_gathering_failed",
|
|
24
|
+
ICE_CANDIDATE_ADD_FAILED = "ice_candidate_add_failed",
|
|
17
25
|
WEBSOCKET_CONNECTED = "websocket_connected",
|
|
18
26
|
WEBSOCKET_RECONNECTED = "websocket_reconnected",
|
|
19
27
|
WEBSOCKET_FAILED_PINGS = "websocket_failed_pings",
|
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/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 */
|
|
@@ -93,8 +114,6 @@ export type ParamsObject = {
|
|
|
93
114
|
/** @hidden */
|
|
94
115
|
signalingReconnectMaxCount: number;
|
|
95
116
|
/** @hidden */
|
|
96
|
-
signalingReconnectMaxDuration: number;
|
|
97
|
-
/** @hidden */
|
|
98
117
|
waitConnectionDelay: number;
|
|
99
118
|
/** @hidden */
|
|
100
119
|
waitResponseDelay: number;
|
|
@@ -232,6 +251,13 @@ export type ParamsObject = {
|
|
|
232
251
|
iceRestartWaitTime: number;
|
|
233
252
|
/** @hidden */
|
|
234
253
|
transportConnectionWaitTime: number;
|
|
254
|
+
/**
|
|
255
|
+
* Разрешить запрашивать переход на серверную топологию не только звонящему,
|
|
256
|
+
* но и принимающей стороне, если не удалось восстановить оборвавшееся p2p-соединение
|
|
257
|
+
*
|
|
258
|
+
* _По умолчанию: `false`_
|
|
259
|
+
*/
|
|
260
|
+
switchTopologyOnReconnectFromAnySide: boolean;
|
|
235
261
|
/**
|
|
236
262
|
* Частота получения статистики в миллисекундах
|
|
237
263
|
*
|
|
@@ -271,6 +297,13 @@ export type ParamsObject = {
|
|
|
271
297
|
perfStatReportEnabled: boolean;
|
|
272
298
|
/** @hidden */
|
|
273
299
|
callStatReportEnabled: boolean;
|
|
300
|
+
/**
|
|
301
|
+
* Отправлять событие статистики ice_candidate_gathering_failed
|
|
302
|
+
*
|
|
303
|
+
* _По умолчанию: `false`_
|
|
304
|
+
* @hidden
|
|
305
|
+
*/
|
|
306
|
+
iceCandidateErrorStatEnabled: boolean;
|
|
274
307
|
/**
|
|
275
308
|
* Отдавать приоритет кодеку H264 для исходящего видео
|
|
276
309
|
*
|
|
@@ -929,7 +962,13 @@ export default abstract class Params {
|
|
|
929
962
|
static getScreenFrameRate(fastScreenShare: boolean): number;
|
|
930
963
|
static get<N extends keyof ParamsObject>(name: N): ParamsObject[N];
|
|
931
964
|
static get appName(): string;
|
|
932
|
-
static get appVersion():
|
|
965
|
+
static get appVersion(): string;
|
|
966
|
+
/**
|
|
967
|
+
* Версия клиента для `client_version` в `auth.anonymLogin`. Бэкенд валидирует формат,
|
|
968
|
+
* поэтому это фиксированное значение, а не версия приложения-хоста (см. {@link Params.appVersion}).
|
|
969
|
+
* @hidden
|
|
970
|
+
*/
|
|
971
|
+
static get apiClientVersion(): number;
|
|
933
972
|
static get sdkVersion(): string;
|
|
934
973
|
static get debug(): boolean;
|
|
935
974
|
static get protocolVersion(): 5 | 6;
|
|
@@ -937,6 +976,8 @@ export default abstract class Params {
|
|
|
937
976
|
static set platform(value: string);
|
|
938
977
|
static get clientStatsPlatform(): string;
|
|
939
978
|
static set clientStatsPlatform(value: string);
|
|
979
|
+
static get autoStartStats(): boolean;
|
|
980
|
+
static get statQueueEnabled(): boolean;
|
|
940
981
|
static get clientType(): string;
|
|
941
982
|
static set clientType(value: string);
|
|
942
983
|
static get externalUserType(): string;
|
|
@@ -966,7 +1007,6 @@ export default abstract class Params {
|
|
|
966
1007
|
static get signalingReconnectDelay(): number;
|
|
967
1008
|
static get signalingReconnectMaxDelay(): number;
|
|
968
1009
|
static get signalingReconnectMaxCount(): number;
|
|
969
|
-
static get signalingReconnectMaxDuration(): number;
|
|
970
1010
|
static get waitConnectionDelay(): number;
|
|
971
1011
|
static get waitResponseDelay(): number;
|
|
972
1012
|
static get waitMessageDelay(): number;
|
|
@@ -1010,11 +1050,13 @@ export default abstract class Params {
|
|
|
1010
1050
|
};
|
|
1011
1051
|
static get iceRestartWaitTime(): number;
|
|
1012
1052
|
static get transportConnectionWaitTime(): number;
|
|
1053
|
+
static get switchTopologyOnReconnectFromAnySide(): boolean;
|
|
1013
1054
|
static get statisticsInterval(): number;
|
|
1014
1055
|
static set statisticsInterval(value: number);
|
|
1015
1056
|
static get networkStatisticsInterval(): number;
|
|
1016
1057
|
static get perfStatReportEnabled(): boolean;
|
|
1017
1058
|
static get callStatReportEnabled(): boolean;
|
|
1059
|
+
static get iceCandidateErrorStatEnabled(): boolean;
|
|
1018
1060
|
static get enableLogPerfStatReport(): boolean;
|
|
1019
1061
|
static get asrDataChannel(): boolean;
|
|
1020
1062
|
static get consumerScreenDataChannelPacketSize(): number;
|
|
@@ -1086,10 +1128,14 @@ export default abstract class Params {
|
|
|
1086
1128
|
videoSuspend: boolean;
|
|
1087
1129
|
debugLog: boolean;
|
|
1088
1130
|
callStatReportEnabled: boolean;
|
|
1131
|
+
iceCandidateErrorStatEnabled: boolean;
|
|
1089
1132
|
joinFromMultipleDevices: boolean;
|
|
1090
1133
|
movieShare: boolean;
|
|
1091
1134
|
clientType: string;
|
|
1092
1135
|
clientStatsPlatform: string;
|
|
1136
|
+
appVersion: string;
|
|
1137
|
+
autoStartStats: boolean;
|
|
1138
|
+
statQueueEnabled: boolean;
|
|
1093
1139
|
consumerScreenDataChannelPacketSize: number;
|
|
1094
1140
|
switchVideoAtBadNetwork: boolean;
|
|
1095
1141
|
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
|
*
|