@vkontakte/calls-sdk 2.8.13-dev.41a8e3bd.0 → 2.8.13-dev.47735529.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 +35 -12
- package/abstract/BaseApi.d.ts +13 -9
- package/calls-sdk.cjs.js +7 -7
- package/calls-sdk.esm.js +4266 -2781
- package/classes/AudioFix.d.ts +2 -2
- package/classes/AudioOutput.d.ts +5 -3
- package/classes/MediaSource.d.ts +9 -2
- package/classes/SpecListener.d.ts +2 -2
- package/classes/StatsLogger.d.ts +1 -1
- 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 +9 -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/ApiCallStats.d.ts +12 -0
- package/classes/stat/BatteryStats.d.ts +25 -0
- package/classes/stat/CallLifecycleStats.d.ts +11 -2
- package/classes/stat/ClientResourceStats.d.ts +41 -0
- package/classes/stat/CodecStatsAggregator.d.ts +2 -2
- package/classes/stat/ConversationStats.d.ts +22 -3
- package/classes/stat/NetworkAdaptationStats.d.ts +35 -0
- package/classes/stat/PeerConnectionStats.d.ts +22 -0
- package/classes/stat/ProvisionalFinish.d.ts +37 -0
- package/classes/stat/ProvisionalFinishStore.d.ts +104 -0
- package/classes/stat/SdpStats.d.ts +2 -0
- package/classes/stat/Stat.testUtils.d.ts +10 -0
- package/classes/stat/StatAggregator.d.ts +12 -3
- package/classes/stat/StatClock.d.ts +28 -0
- package/classes/stat/StatDrainScheduler.d.ts +102 -0
- package/classes/stat/StatEventCollector.d.ts +58 -0
- package/classes/stat/StatPings.d.ts +4 -2
- package/classes/stat/StatQueue.d.ts +90 -0
- package/classes/stat/StatSignalingCommands.d.ts +2 -2
- package/classes/stat/StatUnloadJournal.d.ts +27 -0
- package/classes/transport/DirectTransport.d.ts +12 -2
- package/classes/transport/PerfStatReporter.d.ts +7 -1
- package/classes/transport/ServerTransport.d.ts +5 -2
- package/classes/transport/SimulcastSender.d.ts +2 -2
- package/classes/transport/Transport.d.ts +2 -2
- package/default/Api.d.ts +13 -1
- package/default/Signaling.d.ts +11 -3
- package/default/SignalingTransport.d.ts +5 -1
- package/enums/ActiveFeature.d.ts +19 -0
- package/enums/SessionError.d.ts +10 -0
- package/enums/Stat.d.ts +14 -1
- package/package.json +1 -1
- package/static/ApiTransport.d.ts +4 -0
- package/static/AuthData.d.ts +11 -1
- package/static/BrowserEnvironment.d.ts +90 -0
- package/static/External.d.ts +7 -0
- package/static/Params.d.ts +47 -0
- package/static/SessionStore.d.ts +29 -0
- package/static/SimulcastInfo.d.ts +1 -0
- package/static/WebRTCUtils.d.ts +5 -76
- package/types/ClientStatsEvent.d.ts +12 -0
- package/types/IEventualStatLog.d.ts +1 -1
- package/types/Params.d.ts +1 -1
- package/types/PerfStatReporter.d.ts +26 -1
- package/types/SignalingMessage.d.ts +1 -0
- package/types/Statistics.d.ts +22 -7
package/default/Api.d.ts
CHANGED
|
@@ -10,18 +10,30 @@ import PushData from '../types/PushData';
|
|
|
10
10
|
export default class Api extends BaseApi {
|
|
11
11
|
private _uuid;
|
|
12
12
|
private _idCache;
|
|
13
|
+
constructor();
|
|
13
14
|
private _callUnsafe;
|
|
14
15
|
protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
|
|
15
16
|
userId(participantId: ParticipantId): ExternalParticipantId | null;
|
|
16
17
|
authorize(): Promise<void>;
|
|
18
|
+
/** Запрос auth.anonymLogin без побочных эффектов. Пустой токен — версия 2. */
|
|
19
|
+
private _anonymLogin;
|
|
17
20
|
private _getAnonymLoginCacheKey;
|
|
18
21
|
private _getCachedAnonymLogin;
|
|
19
22
|
private _setCachedAnonymLogin;
|
|
20
23
|
private _removeCachedAnonymLogin;
|
|
21
24
|
private _reauthorize;
|
|
22
25
|
private _applyAnonymLogin;
|
|
26
|
+
/** Кладёт в кеш id соответствие своего участника из auth.anonymLogin */
|
|
27
|
+
private _cacheSelfExternalId;
|
|
28
|
+
private _buildClientStatsData;
|
|
29
|
+
/** Ошибки по отдельным событиям логируются, но батч трактуется целиком. */
|
|
30
|
+
private _reportClientStatsItemErrors;
|
|
31
|
+
/** noSession = true, иначе _prepareQuery перебил бы явный session_key. */
|
|
32
|
+
private _sendClientStatsWith;
|
|
33
|
+
/** Бекенд отвечает 200 всегда: ошибки статистики лежат в теле. */
|
|
23
34
|
private _sendClientStats;
|
|
24
|
-
logClientStats(items: ClientStats[]): void
|
|
35
|
+
logClientStats(items: ClientStats[]): Promise<void>;
|
|
36
|
+
logClientStatsWith(sessionKey: string, items: ClientStats[]): Promise<void>;
|
|
25
37
|
uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
|
|
26
38
|
joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
|
|
27
39
|
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,6 +4,7 @@ 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",
|
|
7
8
|
ABORTED = "ABORTED"
|
|
8
9
|
}
|
|
9
10
|
export type SignalingTransportFailedEvent = {
|
|
@@ -40,6 +41,7 @@ export default class SignalingTransport {
|
|
|
40
41
|
private connectionType;
|
|
41
42
|
private reconnectCount;
|
|
42
43
|
private reconnectTimer;
|
|
44
|
+
private reconnectDeadlineTimer;
|
|
43
45
|
private doctorTimer;
|
|
44
46
|
private forceWebSocket;
|
|
45
47
|
private abortSignal;
|
|
@@ -54,7 +56,7 @@ export default class SignalingTransport {
|
|
|
54
56
|
setPeerId(peerId: number | null): void;
|
|
55
57
|
setLastStamp(lastStamp: number): void;
|
|
56
58
|
setAbortSignal(signal?: AbortSignal): void;
|
|
57
|
-
|
|
59
|
+
onConnectionRestored(): void;
|
|
58
60
|
connect(connectionType: SignalingConnectionType): void;
|
|
59
61
|
close(code?: number): void;
|
|
60
62
|
send(data: string | ArrayBuffer): Promise<void>;
|
|
@@ -70,6 +72,8 @@ export default class SignalingTransport {
|
|
|
70
72
|
private _onClose;
|
|
71
73
|
private _disconnect;
|
|
72
74
|
private _scheduleReconnect;
|
|
75
|
+
private _startReconnectDeadline;
|
|
76
|
+
private _stopReconnectDeadline;
|
|
73
77
|
private _getReconnectDelay;
|
|
74
78
|
private _startDoctor;
|
|
75
79
|
private _stopDoctor;
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Фичи, активные во время звонка. Уходят в метрику active_features,
|
|
3
|
+
* чтобы по ним разрезать остальную статистику: сколько фризов при включённой камере,
|
|
4
|
+
* какой битрейт при шаре и так далее.
|
|
5
|
+
*
|
|
6
|
+
* Здесь только то, что реально включено прямо сейчас, а не то, что разрешено настройками:
|
|
7
|
+
* иначе фича попадала бы в метрику у всех, кому ее просто не запретили.
|
|
8
|
+
*
|
|
9
|
+
* Сервер принимает только имена из своего списка, незнакомые отбрасывает с ошибкой.
|
|
10
|
+
* Новое имя добавляем сюда после того, как его добавят на сервере.
|
|
11
|
+
*/
|
|
12
|
+
declare enum ActiveFeature {
|
|
13
|
+
MICROPHONE = "MICROPHONE",
|
|
14
|
+
CAMERA = "CAMERA",
|
|
15
|
+
/** Любая шара экрана, в том числе быстрая */
|
|
16
|
+
SCREEN = "SCREEN",
|
|
17
|
+
ANIMOJI = "ANIMOJI"
|
|
18
|
+
}
|
|
19
|
+
export default ActiveFeature;
|
|
@@ -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
|
@@ -1,4 +1,7 @@
|
|
|
1
|
-
|
|
1
|
+
/**
|
|
2
|
+
* Имена событий статистики — поле `name` в данных `onClientStats`
|
|
3
|
+
*/
|
|
4
|
+
declare enum Stat {
|
|
2
5
|
CALL_INIT = "call_init",
|
|
3
6
|
CALL_START = "call_start",
|
|
4
7
|
CALL_ACCEPTED_OUTGOING = "call_accepted_outgoing",
|
|
@@ -14,6 +17,14 @@ declare const enum Stat {
|
|
|
14
17
|
USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
|
|
15
18
|
SIGNALING_PING_SUMMARY = "signaling_ping_summary",
|
|
16
19
|
SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
|
|
20
|
+
API_CALL = "api_call",
|
|
21
|
+
CONNECTION_STATE_CHANGED = "connection_state_changed",
|
|
22
|
+
SIGNALING_STATE_CHANGED = "signaling_state_changed",
|
|
23
|
+
GATHERING_STATE_CHANGED = "gathering_state_changed",
|
|
24
|
+
ICE_RESTART = "ice_restart",
|
|
25
|
+
ICE_CANDIDATES_CHANGED = "ice_candidates_changed",
|
|
26
|
+
ICE_CANDIDATE_GATHERING_FAILED = "ice_candidate_gathering_failed",
|
|
27
|
+
ICE_CANDIDATE_ADD_FAILED = "ice_candidate_add_failed",
|
|
17
28
|
SDP_CREATE_OFFER = "sdp_create_offer",
|
|
18
29
|
SDP_CREATE_ANSWER = "sdp_create_answer",
|
|
19
30
|
SDP_SET_LOCAL_OFFER = "sdp_set_local_offer",
|
|
@@ -26,6 +37,8 @@ declare const enum Stat {
|
|
|
26
37
|
SDP_SET_REMOTE_ROLLBACK = "sdp_set_remote_rollback",
|
|
27
38
|
SDP_GENERATED = "sdp_generated",
|
|
28
39
|
SDP_RECEIVED = "sdp_received",
|
|
40
|
+
CLIENT_REQUESTED_SERVER_TOPOLOGY = "client_requested_server_topology",
|
|
41
|
+
VIDEO_ENCODER_CHANGED_BY_NETWORK_ADAPTER = "video_encoder_changed_by_network_adapter",
|
|
29
42
|
WEBSOCKET_CONNECTED = "websocket_connected",
|
|
30
43
|
WEBSOCKET_RECONNECTED = "websocket_reconnected",
|
|
31
44
|
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/AuthData.d.ts
CHANGED
|
@@ -1,9 +1,16 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { ExternalParticipantId } from '../types/ExternalId';
|
|
2
|
+
import type { OkUserId, ParticipantId } from '../types/Participant';
|
|
3
|
+
/** Свой участник и его внешний id */
|
|
4
|
+
export type SelfExternalId = {
|
|
5
|
+
participantId: ParticipantId;
|
|
6
|
+
externalId: ExternalParticipantId;
|
|
7
|
+
};
|
|
2
8
|
export default abstract class AuthData {
|
|
3
9
|
private static _sessionKey;
|
|
4
10
|
private static _sessionSecretKey;
|
|
5
11
|
private static _accessToken;
|
|
6
12
|
private static _userId;
|
|
13
|
+
private static _selfExternalId;
|
|
7
14
|
private static _reauthorizePromise;
|
|
8
15
|
static get sessionKey(): string | undefined;
|
|
9
16
|
static set sessionKey(value: string | undefined);
|
|
@@ -13,6 +20,9 @@ export default abstract class AuthData {
|
|
|
13
20
|
static set accessToken(value: string | undefined);
|
|
14
21
|
static get userId(): OkUserId | null;
|
|
15
22
|
static set userId(value: OkUserId | null);
|
|
23
|
+
/** Свой участник и его внешний id из ответа auth.anonymLogin */
|
|
24
|
+
static get selfExternalId(): SelfExternalId | null;
|
|
25
|
+
static set selfExternalId(value: SelfExternalId | null);
|
|
16
26
|
static isEmpty(): boolean;
|
|
17
27
|
/**
|
|
18
28
|
* Дедуплицирует одновременные попытки реавторизации из разных инстансов Api.
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Определение браузера, операционной системы и доступных возможностей.
|
|
3
|
+
*/
|
|
4
|
+
/**
|
|
5
|
+
* Известные браузеры
|
|
6
|
+
*/
|
|
7
|
+
export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
|
|
8
|
+
declare namespace BrowserEnvironment {
|
|
9
|
+
/**
|
|
10
|
+
* Получение и кэширование версии операционной системы
|
|
11
|
+
*/
|
|
12
|
+
function initOsVersion(warn: (...args: any[]) => void): Promise<void>;
|
|
13
|
+
/**
|
|
14
|
+
* Проверяет поддержку WebRTC браузером
|
|
15
|
+
*/
|
|
16
|
+
function isBrowserSupported(): boolean;
|
|
17
|
+
/**
|
|
18
|
+
* Возвращает первую отсутствующую capability в стабильном порядке.
|
|
19
|
+
*/
|
|
20
|
+
function getBrowserSupportFailure(): BrowserSupportFailure | null;
|
|
21
|
+
/**
|
|
22
|
+
* Проверяет поддержку шаринга экрана браузером
|
|
23
|
+
*/
|
|
24
|
+
function isScreenCapturingSupported(): boolean;
|
|
25
|
+
/**
|
|
26
|
+
* Проверяет поддержку выбора микрофона браузером, независимо от списка устройств и разрешений.
|
|
27
|
+
* Доступен до init, не запрашивает разрешения и не захватывает медиа.
|
|
28
|
+
*/
|
|
29
|
+
function canSelectAudioInput(): boolean;
|
|
30
|
+
/**
|
|
31
|
+
* Проверяет поддержку выбора аудиовыхода браузером, независимо от списка устройств и разрешений.
|
|
32
|
+
* Доступен до init, не запрашивает разрешения и не меняет аудиовыход.
|
|
33
|
+
*/
|
|
34
|
+
function canSelectAudioOutput(): boolean;
|
|
35
|
+
/**
|
|
36
|
+
* В некоторых браузерах H264 decoder сломан
|
|
37
|
+
*/
|
|
38
|
+
function isBrokenH264Decoder(): boolean;
|
|
39
|
+
/**
|
|
40
|
+
* В некоторых браузерах VP9 encoder сломан
|
|
41
|
+
*/
|
|
42
|
+
function isBrokenVP9Encoder(): boolean;
|
|
43
|
+
/**
|
|
44
|
+
* В некоторых браузерах VP9 decoder сломан
|
|
45
|
+
*/
|
|
46
|
+
function isBrokenVP9Decoder(): boolean;
|
|
47
|
+
/**
|
|
48
|
+
* Может ли браузер делать H264 приоритетным
|
|
49
|
+
*/
|
|
50
|
+
function canPreferH264(): boolean;
|
|
51
|
+
/**
|
|
52
|
+
* Поддержка simulcast браузером.
|
|
53
|
+
* Safari корректно поддерживает simulcast начиная с версии 18.
|
|
54
|
+
* Firefox поддерживает simulcast с VP8 начиная с версии 134.
|
|
55
|
+
*/
|
|
56
|
+
function isSimulcastSupportedByBrowser(): boolean;
|
|
57
|
+
/**
|
|
58
|
+
* Имя операционной системы
|
|
59
|
+
*/
|
|
60
|
+
function os(): string;
|
|
61
|
+
/**
|
|
62
|
+
* Версия операционной системы
|
|
63
|
+
*/
|
|
64
|
+
function osVersion(): number | null | undefined;
|
|
65
|
+
/**
|
|
66
|
+
* Мобильный браузер или нет
|
|
67
|
+
*/
|
|
68
|
+
function isMobile(): boolean;
|
|
69
|
+
/**
|
|
70
|
+
* Имя браузера
|
|
71
|
+
*/
|
|
72
|
+
function browserName(): BrowserName | string;
|
|
73
|
+
/**
|
|
74
|
+
* Версия браузера
|
|
75
|
+
*/
|
|
76
|
+
function browserVersion(): string;
|
|
77
|
+
/**
|
|
78
|
+
* Если браузер основан на хроме - возвращает версию
|
|
79
|
+
*/
|
|
80
|
+
function baseChromeVersion(): number;
|
|
81
|
+
/**
|
|
82
|
+
* Возвращает подверсию браузера (если она есть)
|
|
83
|
+
*/
|
|
84
|
+
function browserSubVersion(): string;
|
|
85
|
+
/**
|
|
86
|
+
* Браузер поддерживает захват звука при трансляции экрана
|
|
87
|
+
*/
|
|
88
|
+
function isAudioShareSupported(): boolean;
|
|
89
|
+
}
|
|
90
|
+
export default BrowserEnvironment;
|
package/static/External.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { IAsrData } from '../types/Asr';
|
|
2
|
+
import { ClientStatsEvent } from '../types/ClientStatsEvent';
|
|
2
3
|
import { ConversationData } from '../types/Conversation';
|
|
3
4
|
import HangupReason from '../classes/HangupReason';
|
|
4
5
|
import { MediaTrackKind } from '../classes/MediaSource';
|
|
@@ -513,6 +514,12 @@ declare namespace External {
|
|
|
513
514
|
* @param memory Статистика памяти
|
|
514
515
|
*/
|
|
515
516
|
function onStatistics(connection: StatResult, memory: Record<string, number>): void;
|
|
517
|
+
/**
|
|
518
|
+
* Событие статистики SDK
|
|
519
|
+
*
|
|
520
|
+
* @param data Данные события с `vcid` и `ts`
|
|
521
|
+
*/
|
|
522
|
+
function onClientStats(data: ClientStatsEvent): void;
|
|
516
523
|
/**
|
|
517
524
|
* Ошибка воспроизведения звука
|
|
518
525
|
*/
|
package/static/Params.d.ts
CHANGED
|
@@ -2,6 +2,7 @@ import type { VideoEffects } from '@vkontakte/calls-video-effects';
|
|
|
2
2
|
import type { EffectVoiceChange, VadControllerOptions, VadLib } from '@vkontakte/calls-audio-effects';
|
|
3
3
|
import type * as Vmoji from '@vkontakte/calls-vmoji';
|
|
4
4
|
import { IAsrData } from '../types/Asr';
|
|
5
|
+
import { ClientStatsEvent } from '../types/ClientStatsEvent';
|
|
5
6
|
import { ConversationData } from '../types/Conversation';
|
|
6
7
|
import HangupReason from '../classes/HangupReason';
|
|
7
8
|
import { MediaTrackKind } from '../classes/MediaSource';
|
|
@@ -42,6 +43,22 @@ export type ParamsObject = {
|
|
|
42
43
|
* По умолчанию `'0.0.0'`
|
|
43
44
|
*/
|
|
44
45
|
appVersion: string;
|
|
46
|
+
/**
|
|
47
|
+
* Автоматически запускать отправку клиентской статистики при `init()`.
|
|
48
|
+
*
|
|
49
|
+
* При `false` события копятся в очереди, но не уходят в сеть, пока хост не
|
|
50
|
+
* вызовет `startStats()`.
|
|
51
|
+
*
|
|
52
|
+
* _По умолчанию: `true`_
|
|
53
|
+
*/
|
|
54
|
+
autoStartStats: boolean;
|
|
55
|
+
/**
|
|
56
|
+
* Персистентная очередь клиентской статистики: события копятся в IndexedDB
|
|
57
|
+
* и уезжают пачками с подтверждением, переживая перезагрузку вкладки.
|
|
58
|
+
*
|
|
59
|
+
* _По умолчанию: `false`_
|
|
60
|
+
*/
|
|
61
|
+
statQueueEnabled: boolean;
|
|
45
62
|
/** @hidden */
|
|
46
63
|
clientType: string;
|
|
47
64
|
/** @hidden */
|
|
@@ -98,6 +115,8 @@ export type ParamsObject = {
|
|
|
98
115
|
/** @hidden */
|
|
99
116
|
signalingReconnectMaxCount: number;
|
|
100
117
|
/** @hidden */
|
|
118
|
+
signalingReconnectMaxDuration: number;
|
|
119
|
+
/** @hidden */
|
|
101
120
|
waitConnectionDelay: number;
|
|
102
121
|
/** @hidden */
|
|
103
122
|
waitResponseDelay: number;
|
|
@@ -235,6 +254,13 @@ export type ParamsObject = {
|
|
|
235
254
|
iceRestartWaitTime: number;
|
|
236
255
|
/** @hidden */
|
|
237
256
|
transportConnectionWaitTime: number;
|
|
257
|
+
/**
|
|
258
|
+
* Разрешить запрашивать переход на серверную топологию не только звонящему,
|
|
259
|
+
* но и принимающей стороне, если не удалось восстановить оборвавшееся p2p-соединение
|
|
260
|
+
*
|
|
261
|
+
* _По умолчанию: `false`_
|
|
262
|
+
*/
|
|
263
|
+
switchTopologyOnReconnectFromAnySide: boolean;
|
|
238
264
|
/**
|
|
239
265
|
* Частота получения статистики в миллисекундах
|
|
240
266
|
*
|
|
@@ -274,6 +300,13 @@ export type ParamsObject = {
|
|
|
274
300
|
perfStatReportEnabled: boolean;
|
|
275
301
|
/** @hidden */
|
|
276
302
|
callStatReportEnabled: boolean;
|
|
303
|
+
/**
|
|
304
|
+
* Отправлять событие статистики ice_candidate_gathering_failed
|
|
305
|
+
*
|
|
306
|
+
* _По умолчанию: `false`_
|
|
307
|
+
* @hidden
|
|
308
|
+
*/
|
|
309
|
+
iceCandidateErrorStatEnabled: boolean;
|
|
277
310
|
/**
|
|
278
311
|
* Отдавать приоритет кодеку H264 для исходящего видео
|
|
279
312
|
*
|
|
@@ -781,6 +814,12 @@ export type ParamsObject = {
|
|
|
781
814
|
* Статистика звонка
|
|
782
815
|
*/
|
|
783
816
|
onStatistics?: (stats: {}) => void;
|
|
817
|
+
/**
|
|
818
|
+
* Событие статистики SDK: те же данные, что уходят в статистику звонков, плюс `vcid` и `ts`
|
|
819
|
+
*
|
|
820
|
+
* @param data Данные события
|
|
821
|
+
*/
|
|
822
|
+
onClientStats?: (data: ClientStatsEvent) => void;
|
|
784
823
|
/**
|
|
785
824
|
* Ошибка воспроизведения звука
|
|
786
825
|
*/
|
|
@@ -946,6 +985,8 @@ export default abstract class Params {
|
|
|
946
985
|
static set platform(value: string);
|
|
947
986
|
static get clientStatsPlatform(): string;
|
|
948
987
|
static set clientStatsPlatform(value: string);
|
|
988
|
+
static get autoStartStats(): boolean;
|
|
989
|
+
static get statQueueEnabled(): boolean;
|
|
949
990
|
static get clientType(): string;
|
|
950
991
|
static set clientType(value: string);
|
|
951
992
|
static get externalUserType(): string;
|
|
@@ -975,6 +1016,7 @@ export default abstract class Params {
|
|
|
975
1016
|
static get signalingReconnectDelay(): number;
|
|
976
1017
|
static get signalingReconnectMaxDelay(): number;
|
|
977
1018
|
static get signalingReconnectMaxCount(): number;
|
|
1019
|
+
static get signalingReconnectMaxDuration(): number;
|
|
978
1020
|
static get waitConnectionDelay(): number;
|
|
979
1021
|
static get waitResponseDelay(): number;
|
|
980
1022
|
static get waitMessageDelay(): number;
|
|
@@ -1018,11 +1060,13 @@ export default abstract class Params {
|
|
|
1018
1060
|
};
|
|
1019
1061
|
static get iceRestartWaitTime(): number;
|
|
1020
1062
|
static get transportConnectionWaitTime(): number;
|
|
1063
|
+
static get switchTopologyOnReconnectFromAnySide(): boolean;
|
|
1021
1064
|
static get statisticsInterval(): number;
|
|
1022
1065
|
static set statisticsInterval(value: number);
|
|
1023
1066
|
static get networkStatisticsInterval(): number;
|
|
1024
1067
|
static get perfStatReportEnabled(): boolean;
|
|
1025
1068
|
static get callStatReportEnabled(): boolean;
|
|
1069
|
+
static get iceCandidateErrorStatEnabled(): boolean;
|
|
1026
1070
|
static get enableLogPerfStatReport(): boolean;
|
|
1027
1071
|
static get asrDataChannel(): boolean;
|
|
1028
1072
|
static get consumerScreenDataChannelPacketSize(): number;
|
|
@@ -1094,11 +1138,14 @@ export default abstract class Params {
|
|
|
1094
1138
|
videoSuspend: boolean;
|
|
1095
1139
|
debugLog: boolean;
|
|
1096
1140
|
callStatReportEnabled: boolean;
|
|
1141
|
+
iceCandidateErrorStatEnabled: boolean;
|
|
1097
1142
|
joinFromMultipleDevices: boolean;
|
|
1098
1143
|
movieShare: boolean;
|
|
1099
1144
|
clientType: string;
|
|
1100
1145
|
clientStatsPlatform: string;
|
|
1101
1146
|
appVersion: string;
|
|
1147
|
+
autoStartStats: boolean;
|
|
1148
|
+
statQueueEnabled: boolean;
|
|
1102
1149
|
consumerScreenDataChannelPacketSize: number;
|
|
1103
1150
|
switchVideoAtBadNetwork: boolean;
|
|
1104
1151
|
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
|
* Тип камеры мобильного устройства
|
|
@@ -17,10 +17,6 @@ export declare enum FacingMode {
|
|
|
17
17
|
*/
|
|
18
18
|
ENVIRONMENT = "environment"
|
|
19
19
|
}
|
|
20
|
-
/**
|
|
21
|
-
* Известные браузеры
|
|
22
|
-
*/
|
|
23
|
-
export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
|
|
24
20
|
declare namespace WebRTCUtils {
|
|
25
21
|
/**
|
|
26
22
|
* До вызова этого метода бесполезно опрашивать другие публичные методы.
|
|
@@ -85,24 +81,24 @@ declare namespace WebRTCUtils {
|
|
|
85
81
|
* @param needAudio Нужно ли аудио
|
|
86
82
|
* @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
|
|
87
83
|
*/
|
|
88
|
-
function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?:
|
|
84
|
+
function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
|
|
89
85
|
/**
|
|
90
86
|
* Запрашивает трансляцию экрана пользователя с опциональным захватом звука
|
|
91
87
|
*/
|
|
92
|
-
function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?:
|
|
88
|
+
function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
|
|
93
89
|
/**
|
|
94
90
|
* Запрашивает камеру пользователя
|
|
95
91
|
*
|
|
96
92
|
* @param deviceId ID устройства
|
|
97
93
|
* @param resolution Размеры видео
|
|
98
94
|
*/
|
|
99
|
-
function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?:
|
|
95
|
+
function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
|
|
100
96
|
/**
|
|
101
97
|
* Запрашивает микрофон пользователя
|
|
102
98
|
*
|
|
103
99
|
* @param deviceId ID устройства
|
|
104
100
|
*/
|
|
105
|
-
function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?:
|
|
101
|
+
function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
|
|
106
102
|
/**
|
|
107
103
|
* Устанавливает размер видео в стриме
|
|
108
104
|
*
|
|
@@ -118,76 +114,9 @@ declare namespace WebRTCUtils {
|
|
|
118
114
|
* Возвращает фейковый видео mediaTrack
|
|
119
115
|
*/
|
|
120
116
|
function getBlackMediaTrack(width?: number, height?: number): MediaStreamTrack;
|
|
121
|
-
/**
|
|
122
|
-
* Проверяет поддержку WebRTC браузером
|
|
123
|
-
*/
|
|
124
|
-
function isBrowserSupported(): boolean;
|
|
125
|
-
/**
|
|
126
|
-
* Возвращает первую отсутствующую capability в стабильном порядке.
|
|
127
|
-
*/
|
|
128
|
-
function getBrowserSupportFailure(): BrowserSupportFailure | null;
|
|
129
|
-
/**
|
|
130
|
-
* Проверяет поддержку шаринга экрана браузером
|
|
131
|
-
*/
|
|
132
|
-
function isScreenCapturingSupported(): boolean;
|
|
133
|
-
/**
|
|
134
|
-
* В некоторых браузерах H264 decoder сломан
|
|
135
|
-
*/
|
|
136
|
-
function isBrokenH264Decoder(): boolean;
|
|
137
|
-
/**
|
|
138
|
-
* В некоторых браузерах VP9 encoder сломан
|
|
139
|
-
* В симулкасте вп9 енкодер ведет себя некорректно
|
|
140
|
-
*/
|
|
141
|
-
function isBrokenVP9Encoder(): boolean;
|
|
142
|
-
/**
|
|
143
|
-
* В некоторых браузерах VP9 decoder сломан
|
|
144
|
-
*/
|
|
145
|
-
function isBrokenVP9Decoder(): boolean;
|
|
146
|
-
/**
|
|
147
|
-
* Может ли браузер делать H264 приоритетным
|
|
148
|
-
*/
|
|
149
|
-
function canPreferH264(): boolean;
|
|
150
|
-
/**
|
|
151
|
-
* Поддержка simulcast браузером.
|
|
152
|
-
* Safari корректно поддерживает simulcast начиная с версии 18.
|
|
153
|
-
* Firefox поддерживает simulcast с VP8 начиная с версии 134.
|
|
154
|
-
*/
|
|
155
|
-
function isSimulcastSupportedByBrowser(): boolean;
|
|
156
|
-
/**
|
|
157
|
-
* Имя операционной системы
|
|
158
|
-
*/
|
|
159
|
-
function os(): string;
|
|
160
|
-
/**
|
|
161
|
-
* Версия операционной системы
|
|
162
|
-
*/
|
|
163
|
-
function osVersion(): number | null | undefined;
|
|
164
|
-
/**
|
|
165
|
-
* Мобильный браузер или нет
|
|
166
|
-
*/
|
|
167
|
-
function isMobile(): boolean;
|
|
168
|
-
/**
|
|
169
|
-
* Имя браузера
|
|
170
|
-
*/
|
|
171
|
-
function browserName(): BrowserName | string;
|
|
172
|
-
/**
|
|
173
|
-
* Версия браузера
|
|
174
|
-
*/
|
|
175
|
-
function browserVersion(): string;
|
|
176
|
-
/**
|
|
177
|
-
* Если браузер основан на хроме - возвращает версию
|
|
178
|
-
*/
|
|
179
|
-
function baseChromeVersion(): number;
|
|
180
117
|
/**
|
|
181
118
|
* Возвращает AudioContext
|
|
182
119
|
*/
|
|
183
120
|
function getAudioContext(): AudioContext;
|
|
184
|
-
/**
|
|
185
|
-
* Возвращает подверсию браузера (если она есть)
|
|
186
|
-
*/
|
|
187
|
-
function browserSubVersion(): string;
|
|
188
|
-
/**
|
|
189
|
-
* Браузер поддерживает захват звука при трансляции экрана
|
|
190
|
-
*/
|
|
191
|
-
function isAudioShareSupported(): boolean;
|
|
192
121
|
}
|
|
193
122
|
export default WebRTCUtils;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { StatPayload } from '../classes/stat/StatQueue';
|
|
2
|
+
/**
|
|
3
|
+
* Событие статистики SDK, которое получает `onClientStats`
|
|
4
|
+
*/
|
|
5
|
+
export type ClientStatsEvent = StatPayload & {
|
|
6
|
+
/** Имя события из `Stat`. У периодической статистики звонка его нет */
|
|
7
|
+
name?: string;
|
|
8
|
+
/** ID звонка, `null` — пока он неизвестен */
|
|
9
|
+
vcid: string | null;
|
|
10
|
+
/** Время события, мс */
|
|
11
|
+
ts: number;
|
|
12
|
+
};
|
package/types/Params.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export type IApiEnv = 'AUTO' | 'PROD' | 'CALLS' | 'PROD_OK' | 'TEST' | 'VIDEOTEST' | 'CALLSTEST' | 'CALLS_BETA' | 'CALLS_BENDER' | 'CALLS_MAMES' | 'CALLS_MARS' | string;
|
|
1
|
+
export type IApiEnv = 'AUTO' | 'PROD' | 'CALLS' | 'PROD_OK' | 'TEST' | 'VIDEOTEST' | 'CALLSTEST' | 'CALLS_BETA' | 'CALLS_BENDER' | 'CALLS_MAMES' | 'CALLS_MARS' | 'CALLS_CHELSEA' | 'CALLS_KERZH' | string;
|
|
2
2
|
export type IAPIBaseUrl = string | null;
|