@vkontakte/calls-sdk 2.6.2-dev.8c5f377.0 → 2.6.2-dev.974887b.0

package/classes/Conversation.d.ts

@@ -203,8 +203,6 @@ export default class Conversation extends EventEmitter {
     private _stopStreaming;
     private _sendUpdateDisplayLayout;
     private _cleanupCooldownQueue;
-    private static _isStopStreaming;
-    private static _layoutToString;
     private _onParticipantSourcesUpdate;
     private _onParticipantPromoted;
     private _onChatRoomUpdated;
@@ -250,6 +248,7 @@ export default class Conversation extends EventEmitter {
     videoEffect(effect: IEffect | null): Promise<void>;
     getParticipants(parameters: IGetParticipantsParameters): Promise<ExternalParticipant[]>;
     getParticipantListChunk(participantListChunkParameters: ParticipantListChunkParameters): Promise<ExternalParticipantListChunk>;
+    private _getInitialParticiapntListChunk;
     private _onLocalMediaStreamChanged;
     private _onScreenSharingStatus;
     private _changeRemoteMediaSettings;
@@ -305,6 +304,7 @@ export default class Conversation extends EventEmitter {
     private _toggleJoinAvailability;
     private _updateDisplayLayoutFromCache;
     private _setParticipantsStatus;
+    private _onJoinLinkChanged;
 }
 export declare class UpdateDisplayLayoutError extends Error {
     readonly participantErrors: {

package/classes/ParticipantIdRegistry.d.ts

@@ -2,7 +2,9 @@ import { ParticipantStreamDescription } from '../types/ParticipantStreamDescript
 import SignalingMessage from '../types/SignalingMessage';
 export declare class ParticipantIdRegistry {
     private streamDescriptionByCompactId;
+    private compactIdByStreamDescription;
     getStreamDescription(compactedId: number): ParticipantStreamDescription | undefined;
+    getCompactId(streamDescription: string): number | undefined;
     handleMessage(data: ArrayBuffer): SignalingMessage | null;
     private _createParticipantSourcesUpdateNotification;
 }

package/classes/ProducerCommandSerializationService.d.ts

@@ -0,0 +1,17 @@
+import ParticipantLayout, { RequestKeyFrame, StopStream } from '../types/ParticipantLayout';
+import SignalingMessage from '../types/SignalingMessage';
+import { ParticipantIdRegistry } from './ParticipantIdRegistry';
+import { PerfStatReport } from './transport/PerfStatReporter';
+export declare class ProducerCommandSerializationService {
+    private participantIdRegistry;
+    setParticipantIdRegistry(participantIdRegistry: ParticipantIdRegistry): void;
+    serializeUpdateDisplayLayout(sequenceNumber: number, layouts: {
+        [key: string]: ParticipantLayout | StopStream | RequestKeyFrame;
+    }): ArrayBuffer;
+    private writeLayout;
+    private writeStreamDesc;
+    serializePerfStatReport(sequenceNumber: number, report: PerfStatReport): ArrayBuffer;
+    deserializeCommandResponse(data: BufferSource): SignalingMessage | undefined;
+    private deserializeUpdateDisplayLayoutResponse;
+    private deserializeReportPerfStatResponse;
+}

package/classes/screenshare/ScreenCaptureSender.d.ts

@@ -3,6 +3,7 @@ export default class ScreenCaptureSender {
     private readonly _datachannel;
     private _destroyed;
     private _needKeyframe;
+    private readonly DATA_SIZE;
     constructor(track: MediaStreamTrack, datachannel: RTCDataChannel);
     private _requestFrame;
     private _wrapHeader;

package/classes/screenshare/Utils.d.ts

@@ -1,3 +1,4 @@
+export declare const HEADER_SIZE = 11;
 export interface FrameChunkHeader {
     timestamp: number;
     start: boolean;

package/default/Signaling.d.ts

@@ -13,6 +13,7 @@ import MediaModifiers from '../types/MediaModifiers';
 import MediaSettings from '../types/MediaSettings';
 import MuteStates from '../types/MuteStates';
 import { CompositeUserId, ParticipantId } from '../types/Participant';
+import ParticipantLayout, { RequestKeyFrame, StopStream } from '../types/ParticipantLayout';
 import { ParticipantListChunkParameters } from '../types/ParticipantListChunk';
 import SignalingMessage from '../types/SignalingMessage';
 import { WaitingParticipantId } from '../types/WaitingHall';
@@ -39,6 +40,8 @@ export default class Signaling extends BaseSignaling {
     private participantIdRegistry;
     private producerNotificationDataChannel;
     private producerCommandDataChannel;
+    private producerCommandDataChannelEnabled;
+    private producerCommandSerializationService;
     private static readonly RECONNECT_DELAY;
     private static readonly RECONNECT_MAX_DELAY;
     private static readonly RECONNECT_MAX_COUNT;
@@ -52,6 +55,7 @@ export default class Signaling extends BaseSignaling {
     setParticipantIdRegistry(participantIdRegistry: ParticipantIdRegistry): void;
     setProducerNotificationDataChannel(dataChannel: RTCDataChannel): void;
     setProducerCommandDataChannel(dataChannel: RTCDataChannel): void;
+    useCommandDataChannel(status: boolean): void;
     /**
      * Free used resources
      */
@@ -89,8 +93,8 @@ export default class Signaling extends BaseSignaling {
     changePriorities(priorities: {
         [key: string]: number;
     }): Promise<SignalingMessage | void>;
-    updateDisplayLayout(layout: {
-        [key: string]: string;
+    updateDisplayLayout(layouts: {
+        [streamDesc: string]: ParticipantLayout | StopStream | RequestKeyFrame;
     }): Promise<SignalingMessage>;
     addMovie(data: any): Promise<SignalingMessage>;
     updateMovie(data: any): Promise<SignalingMessage>;
@@ -140,6 +144,9 @@ export default class Signaling extends BaseSignaling {
     protected _reconnect(): void;
     private _handleCommandResponse;
     private _handleCommandsQueue;
+    private _serializeBinary;
+    private _serializeJson;
+    private _convertDisplayLayout;
     protected _waitConnectionMessage(): void;
     protected _stopWaitConnectionMessage(): void;
     private _startDoctor;

package/package.json

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

package/static/ApiTransport.d.ts

@@ -1,7 +1,7 @@
 export declare function init(): void;
 export declare function sendBeakon(method: string, params?: {
     [key: string]: any;
-}, noSession?: boolean): void;
+}, noSession?: boolean): Promise<void>;
 export declare function request(method: string, params?: {
     [key: string]: any;
 }, noSession?: boolean): Promise<unknown>;

package/static/External.d.ts

@@ -187,8 +187,10 @@ declare namespace External {
      * @param unmute Разрешение включить устройство
      * @param userId Пользователь, для которого изменились разрешения или `null` для текущего пользователя
      * @param adminId Пользователь, который изменил разрешения
+     * @param stateUpdated Если `true`, значит глобальное/персональное состояние изменилось и поля `muteStates`/`unmuteOptions` содержат обновления, если `false`, значит, эти поля не имеют значения
+     * @param requestedMedia Какие устройства попросили влючить участника
      */
-    function onMuteStates(muteStates: MuteStates, unmuteOptions: MediaOption[], mediaOptions: MediaOption[], muteAll?: boolean, unmute?: boolean, userId?: ExternalParticipantId | null, adminId?: ExternalParticipantId | null): void;
+    function onMuteStates(muteStates: MuteStates, unmuteOptions: MediaOption[], mediaOptions: MediaOption[], muteAll?: boolean, unmute?: boolean, userId?: ExternalParticipantId | null, adminId?: ExternalParticipantId | null, stateUpdated?: boolean, requestedMedia?: MediaOption[]): void;
     /**
      * Изменились роли собеседника в звонке
      *
@@ -348,5 +350,10 @@ declare namespace External {
      * @param stream стрим от WebRTC
      */
     function onRemoteMixedAudioStream(stream: MediaStream): void;
+    /**
+     * Получена новая ссылка на звонок
+     * @param joinLink токен присоединения к звонку
+     */
+    function onJoinLinkChanged(joinLink: string): void;
 }
 export default External;

package/static/Params.d.ts

@@ -186,6 +186,7 @@ export declare type ParamsObject = {
      * Работает только при приёме экрана через дата-канал.
      *
      * _По умолчанию: `true`_
+     * @deprecated
      */
     producerScreenTrack: boolean;
     /**
@@ -193,12 +194,19 @@ export declare type ParamsObject = {
      * Работает только при отправке экрана через дата-канал.
      *
      * _По умолчанию: `true`_
+     * @deprecated
      */
     consumerScreenTrack: boolean;
     producerNotificationDataChannel: boolean;
     producerCommandDataChannel: boolean;
     consumerScreenDataChannel: boolean;
     producerScreenDataChannel: boolean;
+    /**
+     * Размер пакета для отправки трансляции экрана в датаканал в байтах.
+     * Максимальный размер пакета 65536 bytes в хроме, но по стандарту лучше максимум 16 Кб.
+     * @hidden
+     */
+    consumerScreenDataChannelPacketSize: number;
     screenShareWebmBuilder: boolean;
     noiseSuppression: boolean;
     /**
@@ -349,7 +357,7 @@ export declare type ParamsObject = {
     /**
      * Изменились состояния устройств пользователя или разрешения включать камеру/микрофон
      */
-    onMuteStates?: (muteStates: MuteStates, unmuteOptions: MediaOption[], mediaOptions: MediaOption[], muteAll: boolean, unmute: boolean, userId: ExternalParticipantId | null, adminId: ExternalParticipantId | null) => void;
+    onMuteStates?: (muteStates: MuteStates, unmuteOptions: MediaOption[], mediaOptions: MediaOption[], muteAll: boolean, unmute: boolean, userId: ExternalParticipantId | null, adminId: ExternalParticipantId | null, stateUpdated?: boolean, requestedMedia?: MediaOption[]) => void;
     /**
      * Изменились роли собеседника в звонке
      */
@@ -465,6 +473,11 @@ export declare type ParamsObject = {
      * @param stream стрим от WebRTC
      */
     onRemoteMixedAudioStream?: (stream: MediaStream) => void;
+    /**
+     * Получена новая ссылка на звонок
+     * @param joinLink токен присоединения к звонку
+     */
+    onJoinLinkChanged?: (joinLink: string) => void;
 };
 export default abstract class Params {
     private static _params;
@@ -474,7 +487,7 @@ export default abstract class Params {
     static get(name: string): any;
     static get appName(): string;
     static get appVersion(): number;
-    static get sdkVersion(): string | number | boolean;
+    static get sdkVersion(): string;
     static get debug(): string | number | boolean;
     static get protocolVersion(): 5 | 6;
     static get platform(): string;
@@ -539,6 +552,7 @@ export default abstract class Params {
     static get producerCommandDataChannel(): boolean;
     static get consumerScreenDataChannel(): boolean;
     static get producerScreenDataChannel(): boolean;
+    static get consumerScreenDataChannelPacketSize(): number;
     static get screenShareWebmBuilder(): boolean;
     static get noiseSuppression(): boolean;
     static set noiseSuppression(value: boolean);

package/static/Utils.d.ts

@@ -60,5 +60,7 @@ declare namespace Utils {
      * https://stash.odkl.ru/projects/ODKL/repos/odnoklassniki-webrtc/browse/src/main/java/one/webrtc/domain/conversation/ParticipantIndex.java#67-78
      */
     function participantMarkerCompare(marker1: ExternalParticipantListMarker | undefined, marker2: ExternalParticipantListMarker | undefined): number;
+    /** убирает все ключи со значением `V` на 1 уровне */
+    function objectFilterOutValues<T extends Record<string, V>, V = unknown>(obj: T, value?: V | V[]): Partial<T>;
 }
 export default Utils;

package/types/LayoutUtils.d.ts

@@ -0,0 +1,5 @@
+import { Layout, RequestKeyFrame, StopStream } from './ParticipantLayout';
+export declare const REQUEST_KEY_FRAME_CODE = "kf";
+export declare function isStopStreaming(layout: Layout | StopStream | RequestKeyFrame): layout is StopStream;
+export declare function isRequestKeyFrame(layout: Layout | StopStream | RequestKeyFrame): layout is RequestKeyFrame;
+export declare function layoutToString(layout: Layout | StopStream | RequestKeyFrame): string;

package/types/ParticipantLayout.d.ts

@@ -31,10 +31,16 @@ export declare type StopStream = {
      */
     stopStream: true;
 };
+/**
+ * Request key frame from source. Should not be called often, negatively impacts video quality.
+ */
+export declare type RequestKeyFrame = {
+    keyFrameRequested: true;
+};
 /**
  * Лейаут собеседника в звонке
  */
-export declare type ParticipantLayout = (Layout | StopStream) & {
+export declare type ParticipantLayout = (Layout | StopStream | RequestKeyFrame) & {
     /**
      * Внешний ID пользователя
      */

package/types/SignalingMessage.d.ts

@@ -148,6 +148,8 @@ declare namespace SignalingMessage {
         muteStates: MuteStates;
         unmuteOptions?: MediaOption[];
         mediaOptions: MediaOption[];
+        requestedMedia?: MediaOption[];
+        stateUpdated?: boolean;
         unmute?: boolean;
         muteAll?: boolean;
     }
@@ -240,6 +242,7 @@ declare namespace SignalingMessage {
         demote: boolean;
         mediaModifiers: MediaModifiers;
         conversation: Conversation;
+        participants?: ParticipantListChunk;
     }
     export interface ChatRoomUpdated extends Notification {
         eventType: ChatRoomEventType;
@@ -273,6 +276,9 @@ declare namespace SignalingMessage {
         participants?: ParticipantListChunk;
         chatRoom?: ChatRoom;
     }
+    export interface JoinLinkChanged extends Notification {
+        joinLink: string;
+    }
     export {};
 }
 export default SignalingMessage;

package/utils/MsgPackerBufferUtils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Fork from messagepack internals.
+ * Package messagepack doesn't export createWriteBuffer and createReadBuffer methods.
+ */
+export declare function createWriteBuffer(): {
+    put(v: BufferSource): void;
+    putI8(v: number): void;
+    putI16(v: number): void;
+    putI32(v: number): void;
+    putI64(v: number): void;
+    putUi8(v: number): void;
+    putUi16(v: number): void;
+    putUi32(v: number): void;
+    putUi64(v: number): void;
+    putF(v: number): void;
+    ui8array(): Uint8Array;
+};
+export declare function createReadBuffer(buf: BufferSource): {
+    peek(): number;
+    get(len: number): ArrayBuffer;
+    getI8(): number;
+    getI16(): number;
+    getI32(): number;
+    getI64(): number;
+    getUi8(): number;
+    getUi16(): number;
+    getUi32(): number;
+    getUi64(): number;
+    getF32(): number;
+    getF64(): number;
+};