@vkontakte/calls-sdk 2.8.10 → 2.8.11-dev.5500645b.0

package/classes/Conversation.d.ts

@@ -60,6 +60,7 @@ export default class Conversation extends EventEmitter {
     private _audioFix;
     private _streamByStreamId;
     private _streamIdByStreamDescription;
+    private _participantIdByDebugStreamId;
     private _streamWaitTimerByStreamDescription;
     private _sequenceNumberByStreamDescription;
     private _cooldownTimestampByStreamDescription;
@@ -216,6 +217,7 @@ export default class Conversation extends EventEmitter {
     private _sendUpdateDisplayLayout;
     private _cleanupCooldownQueue;
     private _onParticipantSourcesUpdate;
+    private _registerVideoStreamDebugParticipant;
     private _onParticipantPromoted;
     private _onChatRoomUpdated;
     private _onSharedMovieUpdate;
@@ -372,6 +374,8 @@ export default class Conversation extends EventEmitter {
     private _onAudioMixStall;
     private _onRemoteSignalledStall;
     private _onRemoteDataStats;
+    private _onVideoStreamDebug;
+    private _resolveVideoStreamDebugParticipantId;
     private _fixAudioDevice;
     private _fixVideoDevice;
     private _toggleJoinAvailability;

package/classes/transport/DirectTransport.d.ts

@@ -7,6 +7,9 @@ import BaseTransport from './BaseTransport';
 export default class DirectTransport extends BaseTransport {
     private readonly _participantId;
     private readonly _isMaster;
+    private _hasOutboundVideoDebug;
+    private _hasInboundVideoDebug;
+    private _videoDebugBytes;
     private _remoteSDP;
     private _remoteCandidates;
     private _lastRemoteSDP;
@@ -67,6 +70,8 @@ export default class DirectTransport extends BaseTransport {
     private static _patchRemoteDescription;
     private _onReplacedTrack;
     private _startStatInterval;
+    private _reportVideoStreamDebug;
+    private _getVideoDebugBitrate;
     /**
      * Check SVC support
      * @see https://webrtc.internaut.com/mc/

package/classes/transport/ServerTransport.d.ts

@@ -5,6 +5,9 @@ import ServerSettings from '../../types/ServerSettings';
 import { MediaSource } from '../MediaSource';
 import BaseTransport from './BaseTransport';
 export default class ServerTransport extends BaseTransport {
+    private _hasOutboundVideoDebug;
+    private _inboundVideoDebugParticipants;
+    private _videoDebugBytes;
     private _producerNotification;
     private _producerCommand;
     private _producerScreen;
@@ -36,6 +39,7 @@ export default class ServerTransport extends BaseTransport {
     private _participantIdRegistry;
     private _disabledSenders;
     private _rtpReceiversByStreamId;
+    private _participantIdByVideoTrackId;
     private _producerSessionId;
     private _newAudioShareTrack;
     private _simulcastInfo;
@@ -74,6 +78,10 @@ export default class ServerTransport extends BaseTransport {
     private _stopSettingsInterval;
     private _collectStat;
     private _reportStats;
+    private _reportVideoStreamDebug;
+    private _getVideoDebugStreamId;
+    private _getVideoDebugTrackId;
+    private _getVideoDebugBitrate;
     private _detectStaleTracks;
     private _allocateConsumer;
     private _processOffer;

package/classes/transport/Transport.d.ts

@@ -1,5 +1,6 @@
 import type { AnimojiSvgData, RGBTuple } from '@vkontakte/calls-vmoji';
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { VideoStreamDebugDirection } from '../../static/DebugVideoStats';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
 import EventEmitter from '../EventEmitter';
@@ -21,7 +22,8 @@ export declare const enum TransportEvent {
     ASR_TRANSCRIPTION = "ASR_TRANSCRIPTION",
     ANIMOJI_STREAM = "ANIMOJI_STREAM",
     ANIMOJI_ERROR = "ANIMOJI_ERROR",
-    SCREEN_SHARING_STAT = "SCREEN_SHARING_STAT"
+    SCREEN_SHARING_STAT = "SCREEN_SHARING_STAT",
+    VIDEO_STREAM_DEBUG = "VIDEO_STREAM_DEBUG"
 }
 export declare const enum TransportState {
     IDLE = "IDLE",
@@ -36,6 +38,18 @@ export declare const enum TransportTopology {
     DIRECT = "DIRECT",
     SERVER = "SERVER"
 }
+export type VideoStreamDebugEvent = {
+    direction: VideoStreamDebugDirection;
+    streamId?: ParticipantId;
+    trackId?: string;
+    mimeType?: string;
+    width?: number;
+    height?: number;
+    frameRate?: number;
+    bitrate?: number;
+    packetsLost?: number;
+    clear?: boolean;
+};
 export declare class Transport extends EventEmitter {
     private readonly _signaling;
     private readonly _mediaSource;
@@ -85,6 +99,7 @@ export declare class Transport extends EventEmitter {
     private _onPeerConnectionClosed;
     private _onServerAudioMixStall;
     private _onRemoteDataStats;
+    private _onVideoStreamDebug;
     private _onRemoteTrackAdded;
     private _onRemoteTrackRemoved;
     private _onAsrTranscription;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.10",
+  "version": "2.8.11-dev.5500645b.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/DebugVideoStats.d.ts

@@ -0,0 +1,22 @@
+import { ExternalParticipantId } from '../types/ExternalId';
+export declare const enum VideoStreamDebugDirection {
+    INBOUND = "inbound",
+    OUTBOUND = "outbound"
+}
+export type VideoStreamDebugData = {
+    direction: VideoStreamDebugDirection;
+    externalParticipantId: ExternalParticipantId;
+    trackId?: string;
+    mimeType?: string;
+    width?: number;
+    height?: number;
+    frameRate?: number;
+    bitrate?: number;
+    packetsLost?: number;
+};
+declare namespace DebugVideoStats {
+    function format(data: VideoStreamDebugData): string;
+    function send(data: VideoStreamDebugData): void;
+    function clear(externalParticipantId: ExternalParticipantId): void;
+}
+export default DebugVideoStats;

package/static/External.d.ts

@@ -563,5 +563,9 @@ declare namespace External {
      * Собеседник подключился к сигналлингу
      */
     function onPeerRegistered(): void;
+    /**
+     * Дебаг информация по видеопотоку, отформатированная SDK для отображения в клиенте.
+     */
+    function onVideoStreamDebug(externalParticipantId: ExternalParticipantId, debug: string): void;
 }
 export default External;

package/static/Params.d.ts

@@ -104,6 +104,13 @@ export type ParamsObject = {
     debugLog: boolean;
     /** @hidden */
     debug: boolean;
+    /**
+     * Вкчлючает отправку на клиент статы по входящим/исходящим видео-потокам
+     * @hidden
+     *
+     * _По умолчанию: `false`_
+     */
+    debugVideoStreams: boolean;
     /**
      * Выставляет таймаут в ms для fetch запросов от sdk
      * По умолчанию 5000 ms
@@ -863,6 +870,15 @@ export type ParamsObject = {
      * Собеседник подключился к сигналлингу
      */
     onPeerRegistered?: () => void;
+    /**
+     * Дебаг информация по видеопотоку, отформатированная SDK для отображения в клиенте.
+     *
+     * Работает только если включен `debugVideoStreams`.
+     *
+     * @param externalParticipantId Id участника, к которому относится видеопоток
+     * @param debug Отформатированный текст для отображения
+     */
+    onVideoStreamDebug?: (externalParticipantId: ExternalParticipantId, debug: string) => void;
 };
 export default abstract class Params {
     private static _params;
@@ -914,6 +930,7 @@ export default abstract class Params {
     static get waitMessageDelay(): number;
     static get waitAnotherTabDelay(): number;
     static get debugLog(): boolean;
+    static get debugVideoStreams(): false | ((externalParticipantId: ExternalParticipantId, debug: string) => void) | undefined;
     static get forceRelayPolicy(): boolean;
     static set forceRelayPolicy(value: boolean);
     static get videoMinWidth(): number;

package/types/Statistics.d.ts

@@ -113,6 +113,10 @@ export interface StatRtp extends StatRtpOutboundVideo {
      * Идентификатор пользователя, связанный с этим потоком
      */
     userId?: string;
+    /**
+     * Идентификатор media track, связанный с этим RTP потоком
+     */
+    trackId?: string;
     /**
      * Пропускная способность в битах в секунду
      */