@vkontakte/calls-sdk 2.8.13-dev.a25e6d68.0 → 2.8.13-dev.ad2c4012.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 +28 -11
- package/abstract/BaseApi.d.ts +4 -0
- package/calls-sdk.cjs.js +7 -7
- package/calls-sdk.esm.js +1960 -1602
- package/classes/conversation/Conversation.d.ts +1 -0
- package/classes/stat/ApiCallStats.d.ts +12 -0
- package/classes/stat/ConversationStats.d.ts +4 -0
- package/classes/stat/NetworkAdaptationStats.d.ts +35 -0
- package/classes/stat/PeerConnectionStats.d.ts +22 -0
- package/classes/stat/SdpStats.d.ts +39 -0
- package/classes/stat/Stat.testUtils.d.ts +10 -0
- package/classes/stat/StatAggregator.d.ts +8 -1
- package/classes/stat/StatPings.d.ts +2 -0
- package/classes/transport/DirectTransport.d.ts +7 -0
- package/classes/transport/PerfStatReporter.d.ts +2 -0
- package/classes/transport/ServerTransport.d.ts +2 -0
- package/default/Signaling.d.ts +9 -1
- package/default/SignalingTransport.d.ts +5 -1
- package/enums/Stat.d.ts +26 -1
- package/package.json +1 -1
- package/static/BrowserEnvironment.d.ts +90 -0
- package/static/External.d.ts +7 -0
- package/static/Params.d.ts +19 -0
- package/static/SimulcastInfo.d.ts +1 -0
- package/static/WebRTCUtils.d.ts +0 -71
- package/types/ClientStatsEvent.d.ts +11 -0
- package/types/IEventualStatLog.d.ts +1 -1
- package/types/Params.d.ts +1 -1
|
@@ -66,6 +66,7 @@ export default class Conversation extends EventEmitter {
|
|
|
66
66
|
private _reservedId;
|
|
67
67
|
private readonly _onUnload;
|
|
68
68
|
private readonly _onRestore;
|
|
69
|
+
private readonly _onVisibilityChange;
|
|
69
70
|
private readonly _audioOutput;
|
|
70
71
|
private readonly _stats;
|
|
71
72
|
private _lastStalled;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { StatAggregator } from './StatAggregator';
|
|
2
|
+
/** Отправляет в стату время выполнения запросов к API */
|
|
3
|
+
export declare class ApiCallStats {
|
|
4
|
+
private readonly _statAggregator;
|
|
5
|
+
constructor(statAggregator: StatAggregator | null);
|
|
6
|
+
/**
|
|
7
|
+
* @param method название метода API, например `vchat.getConversationParams`
|
|
8
|
+
* @param duration время от запроса до ответа, мс
|
|
9
|
+
* @param error описание ошибки, если запрос не удался
|
|
10
|
+
*/
|
|
11
|
+
log(method: string, duration: number, error?: string): void;
|
|
12
|
+
}
|
|
@@ -3,6 +3,7 @@ import BaseLogger from '../../abstract/BaseLogger';
|
|
|
3
3
|
import TransportTopology from '../../enums/TransportTopology';
|
|
4
4
|
import HangupReason from '../HangupReason';
|
|
5
5
|
import StatEventCollector from './StatEventCollector';
|
|
6
|
+
import { ApiCallStats } from './ApiCallStats';
|
|
6
7
|
import { CallLifecycleStats } from './CallLifecycleStats';
|
|
7
8
|
import { CodecStatsAggregator } from './CodecStatsAggregator';
|
|
8
9
|
import { StatAggregator } from './StatAggregator';
|
|
@@ -15,6 +16,8 @@ export declare class ConversationStats {
|
|
|
15
16
|
readonly codecStatsAggregator: CodecStatsAggregator;
|
|
16
17
|
readonly pings: StatPings;
|
|
17
18
|
readonly signalingCommands: StatSignalingCommands;
|
|
19
|
+
readonly apiCalls: ApiCallStats;
|
|
20
|
+
private readonly _api;
|
|
18
21
|
private _unloading;
|
|
19
22
|
constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);
|
|
20
23
|
/**
|
|
@@ -25,6 +28,7 @@ export declare class ConversationStats {
|
|
|
25
28
|
prepareForUnload(): void;
|
|
26
29
|
/** Вкладка пережила pagehide: возвращаем запись в очередь. */
|
|
27
30
|
restoreAfterUnload(): void;
|
|
31
|
+
resetPingBaseline(): void;
|
|
28
32
|
logHangup(reason: HangupReason): void;
|
|
29
33
|
flushCallMetrics(): void;
|
|
30
34
|
destroy(): void;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { StatAggregator } from './StatAggregator';
|
|
2
|
+
/** Причина события client_requested_server_topology */
|
|
3
|
+
export declare const enum ServerTopologyReason {
|
|
4
|
+
NO_CONNECTION_TIMEOUT = "no_connection_timeout",
|
|
5
|
+
CONNECTION_FAILED = "connection_failed",
|
|
6
|
+
SUCCESS_CONNECTION = "success_connection",
|
|
7
|
+
/** Возможна на бэке, в вебе пока не поддержана */
|
|
8
|
+
NO_DATA_TIMEOUT = "no_data_timeout",
|
|
9
|
+
/** Возможна на бэке, в вебе пока не поддержана */
|
|
10
|
+
SUCCESS_AUDIO = "success_audio",
|
|
11
|
+
/** Возможна на бэке, в вебе пока не поддержана */
|
|
12
|
+
CONNECTION_ACCEPTED_FAILED = "connection_accepted_failed"
|
|
13
|
+
}
|
|
14
|
+
export declare const enum NetworkQuality {
|
|
15
|
+
GOOD = "good",
|
|
16
|
+
BAD_1 = "bad_1",
|
|
17
|
+
BAD_2 = "bad_2"
|
|
18
|
+
}
|
|
19
|
+
export type VideoEncoderChange = {
|
|
20
|
+
/** Круговая задержка, мс */
|
|
21
|
+
rtt: number;
|
|
22
|
+
/** Потери, проценты */
|
|
23
|
+
loss: number;
|
|
24
|
+
networkQuality: NetworkQuality;
|
|
25
|
+
/** mimeType исходящего видео, например video/VP8 */
|
|
26
|
+
mimeType: string | undefined;
|
|
27
|
+
source: 'camera' | 'screencast' | 'all';
|
|
28
|
+
};
|
|
29
|
+
/** Отправляет в стату решения клиента по смене топологии и настроек видеоэнкодера */
|
|
30
|
+
export declare class NetworkAdaptationStats {
|
|
31
|
+
private readonly _statAggregator;
|
|
32
|
+
constructor(statAggregator: StatAggregator | null);
|
|
33
|
+
logServerTopologyRequested(reason: ServerTopologyReason, elapsed: number): void;
|
|
34
|
+
logVideoEncoderChanged(change: VideoEncoderChange): void;
|
|
35
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { StatAggregator } from './StatAggregator';
|
|
2
|
+
/** Стата жизненного цикла RTCPeerConnection */
|
|
3
|
+
export declare class PeerConnectionStats {
|
|
4
|
+
private readonly _statAggregator;
|
|
5
|
+
private _pc;
|
|
6
|
+
private _lastSignalingStateChange;
|
|
7
|
+
private _lastGatheringStateChange;
|
|
8
|
+
private _lastConnectionState;
|
|
9
|
+
private readonly _handleConnectionStateChange;
|
|
10
|
+
private readonly _handleSignalingStateChange;
|
|
11
|
+
private readonly _handleGatheringStateChange;
|
|
12
|
+
private readonly _handleIceCandidateError;
|
|
13
|
+
constructor(statAggregator: StatAggregator | null);
|
|
14
|
+
observe(pc: RTCPeerConnection): void;
|
|
15
|
+
/** Вызывать перед закрытием соединения: отсюда уходят последнее состояние и closed */
|
|
16
|
+
stop(): void;
|
|
17
|
+
logIceRestart(): void;
|
|
18
|
+
logIceCandidateAddFailed(candidate: RTCIceCandidateInit, error: unknown): void;
|
|
19
|
+
private _sinceLastChange;
|
|
20
|
+
private _logConnectionState;
|
|
21
|
+
private _log;
|
|
22
|
+
}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { StatAggregator } from './StatAggregator';
|
|
2
|
+
type SdpDescription = {
|
|
3
|
+
type: RTCSdpType;
|
|
4
|
+
sdp?: string;
|
|
5
|
+
};
|
|
6
|
+
/**
|
|
7
|
+
* Отправляет в стату согласование SDP: что сгенерировали, что получили от собеседника
|
|
8
|
+
* и на какой операции сломались.
|
|
9
|
+
*/
|
|
10
|
+
export declare class SdpStats {
|
|
11
|
+
private readonly _statAggregator;
|
|
12
|
+
private _pc;
|
|
13
|
+
private _gatheringStartedAt;
|
|
14
|
+
private _remoteSdpReceivedAt;
|
|
15
|
+
private readonly _handleGatheringStateChange;
|
|
16
|
+
constructor(statAggregator: StatAggregator | null);
|
|
17
|
+
/** Начинает следить за сбором кандидатов, предыдущее соединение перестает слушать */
|
|
18
|
+
observe(pc: RTCPeerConnection): void;
|
|
19
|
+
stop(): void;
|
|
20
|
+
/** Сгенерировали свой SDP */
|
|
21
|
+
logSdpGenerated(type: RTCSdpType): void;
|
|
22
|
+
/** Собрали свой ICE-кандидат */
|
|
23
|
+
logCandidateGenerated(candidate: RTCIceCandidate): void;
|
|
24
|
+
/** Получили SDP от собеседника */
|
|
25
|
+
logSdpReceived(type: RTCSdpType): void;
|
|
26
|
+
/** Получили ICE-кандидата от собеседника */
|
|
27
|
+
logCandidateReceived(candidate: RTCIceCandidateInit): void;
|
|
28
|
+
/** Не смогли сгенерировать SDP */
|
|
29
|
+
logCreateFailed(type: RTCSdpType, error: unknown): void;
|
|
30
|
+
/** Не смогли применить свой SDP */
|
|
31
|
+
logSetLocalFailed(sdp: SdpDescription, error: unknown): void;
|
|
32
|
+
/** Не смогли применить SDP собеседника */
|
|
33
|
+
logSetRemoteFailed(sdp: SdpDescription, error: unknown): void;
|
|
34
|
+
destroy(): void;
|
|
35
|
+
private _intervalSince;
|
|
36
|
+
private _logFailure;
|
|
37
|
+
private _log;
|
|
38
|
+
}
|
|
39
|
+
export {};
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { MockInstance } from 'vitest';
|
|
2
|
+
/**
|
|
3
|
+
* Дожидается работы, которую код запускает в фоне и не отдаёт промис: ждёт всё,
|
|
4
|
+
* что вернули вызовы шпионов, пока не перестанут появляться новые вызовы.
|
|
5
|
+
*
|
|
6
|
+
* Замена опросу vi.waitFor: тот сдаётся через секунду, а IndexedDB на
|
|
7
|
+
* загруженной машине отвечает дольше. Шпионы должны пропускать вызов к
|
|
8
|
+
* настоящему методу (vi.spyOn без подмены).
|
|
9
|
+
*/
|
|
10
|
+
export declare function settleCalls(...spies: MockInstance[]): Promise<void>;
|
|
@@ -7,8 +7,15 @@ export declare class StatAggregator {
|
|
|
7
7
|
private _lastCallStatContext;
|
|
8
8
|
constructor(logger: StatEventCollector);
|
|
9
9
|
logCallStat(params: ICallStatLog): void;
|
|
10
|
-
/**
|
|
10
|
+
/**
|
|
11
|
+
* Событие уходит с теми полями, что переданы. Без value — уходит без value.
|
|
12
|
+
* @link https://wiki.odkl.ru/pages/viewpage.action?pageId=100892588
|
|
13
|
+
*/
|
|
11
14
|
logEventualStat(params: IEventualStatLog): void;
|
|
15
|
+
/** value — время от метки с тем же именем, что у события. Метки нет — событие не отправляем. */
|
|
16
|
+
logEventualStatSinceMark(params: IEventualStatLog & {
|
|
17
|
+
value?: never;
|
|
18
|
+
}): void;
|
|
12
19
|
destroy(): void;
|
|
13
20
|
private _getCallStatContext;
|
|
14
21
|
private _flushEventualStats;
|
|
@@ -12,5 +12,7 @@ export declare class StatPings {
|
|
|
12
12
|
mark(transport: SignalingTransportType): void;
|
|
13
13
|
/** Отправляем данные в стату */
|
|
14
14
|
logMetrics(): void;
|
|
15
|
+
/** Сбрасываем baseline после скрытия страницы, чтобы фоновой простой не стал интервалом ping. */
|
|
16
|
+
resetBaseline(): void;
|
|
15
17
|
destroy(): void;
|
|
16
18
|
}
|
|
@@ -31,6 +31,10 @@ export default class DirectTransport extends BaseTransport {
|
|
|
31
31
|
private _lastStat;
|
|
32
32
|
private _fingerprint;
|
|
33
33
|
private _neverConnected;
|
|
34
|
+
private _connectionStartedAt;
|
|
35
|
+
private _connectionLostAt;
|
|
36
|
+
/** Запросили переход на серверную топологию, не дождавшись первого подключения p2p */
|
|
37
|
+
private _serverRequestedOnNoConnection;
|
|
34
38
|
private _serverSettings;
|
|
35
39
|
private _prevConsumerSettings;
|
|
36
40
|
private _networkLimitsForVideo;
|
|
@@ -39,6 +43,9 @@ export default class DirectTransport extends BaseTransport {
|
|
|
39
43
|
private _lastBadConnection;
|
|
40
44
|
private _perfStatReporter;
|
|
41
45
|
private _directStatReporter;
|
|
46
|
+
private readonly _sdpStats;
|
|
47
|
+
private readonly _peerConnectionStats;
|
|
48
|
+
private readonly _networkAdaptationStats;
|
|
42
49
|
private readonly _debug;
|
|
43
50
|
private readonly _logger;
|
|
44
51
|
private readonly _statAggregator;
|
|
@@ -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;
|
|
@@ -45,6 +45,8 @@ export default class ServerTransport extends BaseTransport {
|
|
|
45
45
|
private readonly _debug;
|
|
46
46
|
private readonly _logger;
|
|
47
47
|
private readonly _statAggregator;
|
|
48
|
+
private readonly _sdpStats;
|
|
49
|
+
private readonly _peerConnectionStats;
|
|
48
50
|
private readonly _codecStatsAggregator;
|
|
49
51
|
private readonly _simulcast;
|
|
50
52
|
constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
|
package/default/Signaling.d.ts
CHANGED
|
@@ -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;
|
|
@@ -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;
|
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,28 @@ 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",
|
|
28
|
+
SDP_CREATE_OFFER = "sdp_create_offer",
|
|
29
|
+
SDP_CREATE_ANSWER = "sdp_create_answer",
|
|
30
|
+
SDP_SET_LOCAL_OFFER = "sdp_set_local_offer",
|
|
31
|
+
SDP_SET_LOCAL_PRANSWER = "sdp_set_local_pranswer",
|
|
32
|
+
SDP_SET_LOCAL_ANSWER = "sdp_set_local_answer",
|
|
33
|
+
SDP_SET_LOCAL_ROLLBACK = "sdp_set_local_rollback",
|
|
34
|
+
SDP_SET_REMOTE_OFFER = "sdp_set_remote_offer",
|
|
35
|
+
SDP_SET_REMOTE_PRANSWER = "sdp_set_remote_pranswer",
|
|
36
|
+
SDP_SET_REMOTE_ANSWER = "sdp_set_remote_answer",
|
|
37
|
+
SDP_SET_REMOTE_ROLLBACK = "sdp_set_remote_rollback",
|
|
38
|
+
SDP_GENERATED = "sdp_generated",
|
|
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",
|
|
17
42
|
WEBSOCKET_CONNECTED = "websocket_connected",
|
|
18
43
|
WEBSOCKET_RECONNECTED = "websocket_reconnected",
|
|
19
44
|
WEBSOCKET_FAILED_PINGS = "websocket_failed_pings",
|
package/package.json
CHANGED
|
@@ -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';
|
|
@@ -114,6 +115,8 @@ export type ParamsObject = {
|
|
|
114
115
|
/** @hidden */
|
|
115
116
|
signalingReconnectMaxCount: number;
|
|
116
117
|
/** @hidden */
|
|
118
|
+
signalingReconnectMaxDuration: number;
|
|
119
|
+
/** @hidden */
|
|
117
120
|
waitConnectionDelay: number;
|
|
118
121
|
/** @hidden */
|
|
119
122
|
waitResponseDelay: number;
|
|
@@ -297,6 +300,13 @@ export type ParamsObject = {
|
|
|
297
300
|
perfStatReportEnabled: boolean;
|
|
298
301
|
/** @hidden */
|
|
299
302
|
callStatReportEnabled: boolean;
|
|
303
|
+
/**
|
|
304
|
+
* Отправлять событие статистики ice_candidate_gathering_failed
|
|
305
|
+
*
|
|
306
|
+
* _По умолчанию: `false`_
|
|
307
|
+
* @hidden
|
|
308
|
+
*/
|
|
309
|
+
iceCandidateErrorStatEnabled: boolean;
|
|
300
310
|
/**
|
|
301
311
|
* Отдавать приоритет кодеку H264 для исходящего видео
|
|
302
312
|
*
|
|
@@ -804,6 +814,12 @@ export type ParamsObject = {
|
|
|
804
814
|
* Статистика звонка
|
|
805
815
|
*/
|
|
806
816
|
onStatistics?: (stats: {}) => void;
|
|
817
|
+
/**
|
|
818
|
+
* Событие статистики SDK: те же данные, что уходят в статистику звонков, плюс `vcid` и `ts`
|
|
819
|
+
*
|
|
820
|
+
* @param data Данные события
|
|
821
|
+
*/
|
|
822
|
+
onClientStats?: (data: ClientStatsEvent) => void;
|
|
807
823
|
/**
|
|
808
824
|
* Ошибка воспроизведения звука
|
|
809
825
|
*/
|
|
@@ -1000,6 +1016,7 @@ export default abstract class Params {
|
|
|
1000
1016
|
static get signalingReconnectDelay(): number;
|
|
1001
1017
|
static get signalingReconnectMaxDelay(): number;
|
|
1002
1018
|
static get signalingReconnectMaxCount(): number;
|
|
1019
|
+
static get signalingReconnectMaxDuration(): number;
|
|
1003
1020
|
static get waitConnectionDelay(): number;
|
|
1004
1021
|
static get waitResponseDelay(): number;
|
|
1005
1022
|
static get waitMessageDelay(): number;
|
|
@@ -1049,6 +1066,7 @@ export default abstract class Params {
|
|
|
1049
1066
|
static get networkStatisticsInterval(): number;
|
|
1050
1067
|
static get perfStatReportEnabled(): boolean;
|
|
1051
1068
|
static get callStatReportEnabled(): boolean;
|
|
1069
|
+
static get iceCandidateErrorStatEnabled(): boolean;
|
|
1052
1070
|
static get enableLogPerfStatReport(): boolean;
|
|
1053
1071
|
static get asrDataChannel(): boolean;
|
|
1054
1072
|
static get consumerScreenDataChannelPacketSize(): number;
|
|
@@ -1120,6 +1138,7 @@ export default abstract class Params {
|
|
|
1120
1138
|
videoSuspend: boolean;
|
|
1121
1139
|
debugLog: boolean;
|
|
1122
1140
|
callStatReportEnabled: boolean;
|
|
1141
|
+
iceCandidateErrorStatEnabled: boolean;
|
|
1123
1142
|
joinFromMultipleDevices: boolean;
|
|
1124
1143
|
movieShare: boolean;
|
|
1125
1144
|
clientType: string;
|
|
@@ -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
|
@@ -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
|
* До вызова этого метода бесполезно опрашивать другие публичные методы.
|
|
@@ -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,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Событие статистики SDK, которое получает `onClientStats`
|
|
3
|
+
*/
|
|
4
|
+
export type ClientStatsEvent = Record<string, string | number | boolean | null> & {
|
|
5
|
+
/** Имя события из `Stat`. У периодической статистики звонка его нет */
|
|
6
|
+
name?: string;
|
|
7
|
+
/** ID звонка, `null` — пока он неизвестен */
|
|
8
|
+
vcid: string | null;
|
|
9
|
+
/** Время события, мс */
|
|
10
|
+
ts: number;
|
|
11
|
+
};
|
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;
|