@vkontakte/calls-sdk 2.8.7 → 2.8.8-dev.36567070.0

package/classes/codec/IDecoder.d.ts

@@ -1,5 +1,5 @@
 export default interface IDecoder {
-    init(onFrameImage: (image: VideoFrame | ImageData) => void, onFrameError?: (error: unknown) => void): Promise<void>;
+    init(onFrameImage: (image: VideoFrame | ImageData) => void, onFrameError?: (error: unknown) => void, onKeyFrameRequested?: () => void): Promise<void>;
     decodeFrame(timestamp: number, data: Uint8Array, isVP9: boolean, keyFrame?: boolean): void;
     destroy(): void;
 }

package/classes/codec/LibVPxDecoder.d.ts

@@ -1,7 +1,7 @@
 import IDecoder from './IDecoder';
 import WorkerBase from './WorkerBase';
 export default class LibVPxDecoder extends WorkerBase implements IDecoder {
-    init(onFrameImage: (image: ImageData) => void, onFrameError: (error: unknown) => void): Promise<void>;
+    init(onFrameImage: (image: ImageData) => void, onFrameError: (error: unknown) => void, onKeyFrameRequested: () => void): Promise<void>;
     decodeFrame(timestamp: number, data: Uint8Array, isVP9: boolean, keyFrame?: boolean): void;
     destroy(): void;
     static isBrowserSupported(): boolean;

package/classes/codec/WebCodecsDecoder.d.ts

@@ -1,7 +1,7 @@
 import IDecoder from './IDecoder';
 import WorkerBase from './WorkerBase';
 export default class WebCodecsDecoder extends WorkerBase implements IDecoder {
-    init(onFrameImage: (frame: VideoFrame) => void, onFrameError: (error: unknown) => void): Promise<void>;
+    init(onFrameImage: (frame: VideoFrame) => void, onFrameError: (error: unknown) => void, onKeyFrameRequested: () => void): Promise<void>;
     decodeFrame(timestamp: number, data: Uint8Array, isVP9: boolean, keyFrame?: boolean): void;
     destroy(): void;
     static isBrowserSupported(): boolean;

package/classes/screenshare/BaseStreamBuilder.d.ts

@@ -8,9 +8,10 @@ export declare abstract class BaseStreamBuilder {
     protected readonly _participantId: ParticipantId;
     protected readonly _onStream: IOnStream;
     protected readonly _onStat: IOnStat;
+    protected readonly _onKeyFrameRequested?: VoidFunction;
     protected readonly _statScreenShareFirstFrame: StatScreenShareFirstFrame;
     protected _chunks: FrameChunk[];
-    protected constructor(participantId: ParticipantId, onStream: IOnStream, onStat: IOnStat);
+    protected constructor(participantId: ParticipantId, onStream: IOnStream, onStat: IOnStat, onKeyFrameRequested?: VoidFunction);
     appendChunk(chunk: FrameChunk): void;
     destroy(): void;
     protected abstract _processFrame(frame: FrameData): void;

package/classes/screenshare/ScreenCaptureReceiver.d.ts

@@ -10,6 +10,10 @@ export default class ScreenCaptureReceiver {
     private _onStat;
     constructor(datachannel: RTCDataChannel, participantIdRegistry: ParticipantIdRegistry, onStream: (streamId: string, stream: MediaStream) => void, onEos: (streamId: string) => void, onStat: IOnStat);
     private _onDataChannelMessage;
+    /**
+     * Отправить запрос ключевого кадра в datachannel.
+     */
+    private _requestKeyFrame;
     close(participantId: ParticipantId): void;
     destroy(): void;
     static isBrowserSupported(): boolean;

package/classes/screenshare/StreamBuilder.d.ts

@@ -1,14 +1,26 @@
 import { ParticipantId } from '../../types/Participant';
 import { BaseStreamBuilder, FrameData, IOnStat, IOnStream } from './BaseStreamBuilder';
 export default class StreamBuilder extends BaseStreamBuilder {
-    private readonly _renderer;
-    private readonly _decoder;
+    private _renderer;
+    private _decoder;
     private _decoderReady;
     private _decoderBusy;
     private _decoderQueue;
-    private readonly _fpsMeter;
-    constructor(participantId: ParticipantId, onStream: IOnStream, onStat: IOnStat);
+    private _fpsMeter;
+    constructor(participantId: ParticipantId, onStream: IOnStream, onStat: IOnStat, onKeyFrameRequested: VoidFunction);
     protected _processFrame(frame: FrameData): void;
+    private _initFpsMeter;
+    /**
+     * Инициализация рендерера
+     * @param forceCanvasRenderer используется для принудительного создания CanvasRenderer, который работает с LibVPX
+     */
+    private _initRenderer;
+    /**
+     * Инициализация декодера
+     * @param forceLibVPXDecoder используется для принудительного создания LibVPXDecoder
+     */
+    private _initDecoder;
+    private _switchToLibVPXDecoder;
     private _decodeQueue;
     destroy(): void;
     static isBrowserSupported(): boolean;

package/classes/screenshare/Utils.d.ts

@@ -20,3 +20,4 @@ export interface CcFeedback {
     ts2: number;
 }
 export declare function parseCcFeedback(data?: ArrayBuffer): CcFeedback | null;
+export declare function prepareKeyFrameRequest(ssrc: number): ArrayBuffer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.7",
+  "version": "2.8.8-dev.36567070.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/Params.d.ts

@@ -507,6 +507,18 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     webtransportFF: boolean;
+    /**
+     * Скриншара
+     * Включить возможность запрашивать ключевой кадр декодером
+     * @hidden
+     */
+    streamBuilderKeyFrameRequest: boolean;
+    /**
+     * Скриншара
+     * Включить переключение на LibVPX при проблемах с WebCodecsDecoder
+     * @hidden
+     */
+    streamBuilderAutoSwitchToLibVPX: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -1020,6 +1032,10 @@ export default abstract class Params {
     static set webtransport(value: boolean);
     static get webtransportFF(): boolean;
     static set webtransportFF(value: boolean);
+    static set streamBuilderKeyFrameRequest(value: boolean);
+    static get streamBuilderKeyFrameRequest(): boolean;
+    static set streamBuilderAutoSwitchToLibVPX(value: boolean);
+    static get streamBuilderAutoSwitchToLibVPX(): boolean;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1051,5 +1067,7 @@ export default abstract class Params {
         simulcast: boolean;
         webtransport: boolean;
         webtransportFF: boolean;
+        streamBuilderKeyFrameRequest: boolean;
+        streamBuilderAutoSwitchToLibVPX: boolean;
     };
 }

package/static/WebRTCUtils.d.ts

@@ -21,7 +21,9 @@ export declare enum FacingMode {
 export type BrowserName = 'IE' | 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
 declare namespace WebRTCUtils {
     /**
-     * Инициализирует устройства. До вызова этого метода бесполезно опрашивать другие публичные методы
+     * До вызова этого метода бесполезно опрашивать другие публичные методы.
+     * - Инициализирует устройства.
+     * - Получает версию ОС
      */
     function init(): Promise<void>;
     /**
@@ -151,6 +153,10 @@ declare namespace WebRTCUtils {
      * Имя операционной системы
      */
     function os(): string;
+    /**
+     * Версия операционной системы
+     */
+    function osVersion(): number | null | undefined;
     /**
      * Мобильный браузер или нет
      */