@vkontakte/calls-sdk 2.6.2-dev.abaf7cc.0 → 2.6.2-dev.ac5839e.0

package/classes/Conversation.d.ts

@@ -50,7 +50,7 @@ export declare type ConversationData = {
     direction: CallDirection;
     concurrent: boolean;
     needRate: boolean;
-    recordInfo: RecordInfo | null;
+    recordsInfo: Record<number, RecordInfo | null>;
     chatId: string | null;
     asrInfo: AsrInfo | null;
     /**
@@ -180,6 +180,13 @@ export default class Conversation extends EventEmitter {
      * @hidden
      */
     private _processConnectionData;
+    /**
+     * Обрабатывает информацию о записи/трансляции в основном и сессионных залах
+     * @param connection
+     * @private
+     * @hidden
+     */
+    private _processRecordInfos;
     private _allocateTransport;
     private _createSpeakerDetector;
     private _createSpecListener;
@@ -232,7 +239,7 @@ export default class Conversation extends EventEmitter {
     grantRoles(participantId: CompositeUserId, roles: UserRole[], revoke: boolean): Promise<void>;
     startAsr(): Promise<void>;
     stopAsr(): Promise<void>;
-    muteParticipant(participantId: ParticipantId | null, muteStates: MuteStates, requestedMedia?: MediaOption[]): Promise<void>;
+    muteParticipant(participantId: ParticipantId | null, muteStates: MuteStates, requestedMedia?: MediaOption[], roomId?: number): Promise<void>;
     enableFeatureForRoles(feature: ConversationFeature, roles: UserRole[]): Promise<void>;
     pinParticipant(participantId: ParticipantId, unpin: boolean): Promise<void>;
     updateMediaModifiers(mediaModifiers: MediaModifiers): Promise<void>;
@@ -260,9 +267,9 @@ export default class Conversation extends EventEmitter {
     activateRooms(roomIds: number[], deactivate: boolean): Promise<void>;
     switchRoom(toRoomId?: number, participantId?: ParticipantId): Promise<void>;
     removeRooms(roomIds: number[]): Promise<void>;
-    startStream(isRecord?: boolean, name?: string | null, movieId?: string | null, privacy?: 'PUBLIC' | 'FRIENDS' | 'DIRECT_LINK', groupId?: string | null): Promise<SignalingMessage>;
-    stopStream(): Promise<SignalingMessage>;
-    recordSetRole(participantId: ParticipantId, role: RecordRole | null): Promise<void>;
+    startStream(isRecord?: boolean, name?: string | null, movieId?: string | null, privacy?: 'PUBLIC' | 'FRIENDS' | 'DIRECT_LINK', groupId?: string | null, roomId?: number | null): Promise<SignalingMessage>;
+    stopStream(roomId?: number | null): Promise<SignalingMessage>;
+    recordSetRole(participantId: ParticipantId, role: RecordRole | null, roomId?: number | null): Promise<void>;
     getStreamInfo(): Promise<{
         movieId: any;
         preview: any;
@@ -300,12 +307,14 @@ export default class Conversation extends EventEmitter {
     private _onChatMessage;
     private _onCustomData;
     private _onRecordInfo;
+    changeRecordInfoForRoom(roomId?: number): Promise<void>;
     private _onAsrInfo;
     private _onRolesChanged;
     /**
      * Клиент должен немедленно выключить микрофон и/или камеру
      */
     private _onMuteParticipant;
+    applyMuteStates(muteStates: MuteStates, mediaOptions: MediaOption[], roomId?: number): void;
     private _processMuteState;
     private _onPinParticipant;
     private _onOptionsChanged;

package/classes/ProducerCommandSerializationService.d.ts

@@ -1,6 +1,6 @@
 import ParticipantLayout, { RequestKeyFrame, StopStream } from '../types/ParticipantLayout';
 import SignalingMessage from '../types/SignalingMessage';
-import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
+import { SharingStatReport } from './screenshare/SharingStatReport';
 import { ParticipantIdRegistry } from './ParticipantIdRegistry';
 import { PerfStatReport } from './transport/PerfStatReporter';
 export declare class ProducerCommandSerializationService {

package/classes/transport/ServerTransport.d.ts

@@ -76,6 +76,5 @@ export default class ServerTransport extends EventEmitter {
     static _onSignalingStateChange(pc: RTCPeerConnection, event: any): void;
     private _onConnectionStateChange;
     private _onReplacedTrack;
-    private static _isUnifiedPlanSupported;
     getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;
 }

package/default/Signaling.d.ts

@@ -107,8 +107,8 @@ export default class Signaling extends BaseSignaling {
     switchRoom(toRoomId?: number, participantId?: ParticipantId): Promise<SignalingMessage>;
     removeRooms(roomIds: number[]): Promise<SignalingMessage>;
     startStream(data: any): Promise<SignalingMessage>;
-    stopStream(): Promise<SignalingMessage>;
-    recordSetRole(participantId: ParticipantId, role: RecordRole | null): Promise<SignalingMessage>;
+    stopStream(data: any): Promise<SignalingMessage>;
+    recordSetRole(participantId: ParticipantId, role: RecordRole | null, roomId: number | null): Promise<SignalingMessage>;
     getRecordStatus(): Promise<SignalingMessage>;
     switchTopology(topology: TransportTopology, force?: boolean): Promise<SignalingMessage>;
     requestRealloc(): Promise<SignalingMessage>;
@@ -118,7 +118,7 @@ export default class Signaling extends BaseSignaling {
     chatHistory(count: number): Promise<SignalingMessage>;
     customData(data: JSONObject, participantId: ParticipantId | null): Promise<SignalingMessage>;
     grantRoles(participantId: CompositeUserId, roles: UserRole[], revoke: boolean): Promise<SignalingMessage>;
-    muteParticipant(participantId: ParticipantId | null, muteStates: MuteStates, requestedMedia: MediaOption[]): Promise<SignalingMessage>;
+    muteParticipant(participantId: ParticipantId | null, muteStates: MuteStates, requestedMedia: MediaOption[], roomId?: number): Promise<SignalingMessage>;
     enableFeatureForRoles(feature: ConversationFeature, roles: UserRole[]): Promise<SignalingMessage>;
     pinParticipant(participantId: ParticipantId, unpin: boolean): Promise<SignalingMessage>;
     updateMediaModifiers(mediaModifiers: MediaModifiers): Promise<SignalingMessage>;

package/package.json

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

package/static/External.d.ts

@@ -250,9 +250,10 @@ declare namespace External {
      * @param userId Пользователь, для которого изменились разрешения или `null` для текущего пользователя
      * @param adminId Пользователь, который изменил разрешения
      * @param stateUpdated Если `true`, значит глобальное/персональное состояние изменилось и поля `muteStates`/`unmuteOptions` содержат обновления, если `false`, значит, эти поля не имеют значения
-     * @param requestedMedia Какие устройства попросили влючить участника
+     * @param requestedMedia Какие устройства попросили включить участника
+     * @param roomId ID сессионного зала или ничего в случае основного зала
      */
-    function onMuteStates(muteStates: MuteStates, unmuteOptions: MediaOption[], mediaOptions: MediaOption[], muteAll?: boolean, unmute?: boolean, userId?: ExternalParticipantId | null, adminId?: ExternalParticipantId | null, stateUpdated?: boolean, requestedMedia?: MediaOption[]): void;
+    function onMuteStates(muteStates: MuteStates, unmuteOptions: MediaOption[], mediaOptions: MediaOption[], muteAll?: boolean, unmute?: boolean, userId?: ExternalParticipantId | null, adminId?: ExternalParticipantId | null, stateUpdated?: boolean, requestedMedia?: MediaOption[], roomId?: number): void;
     /**
      * Изменились роли собеседника в звонке
      *
@@ -359,12 +360,14 @@ declare namespace External {
      * @param type Тип записи
      * @param externalMovieId Внешний ID ролика
      * @param externalOwnerId Внешний ID пользователя/группы от которого ведётся трансляция
+     * @param roomId ID зала в котором стартанула запись
      */
-    function onRecordStarted(initiator: ExternalParticipantId, movieId: number, startTime: number, type: 'STREAM' | 'RECORD', externalMovieId?: string, externalOwnerId?: string): void;
+    function onRecordStarted(initiator: ExternalParticipantId, movieId: number, startTime: number, type: 'STREAM' | 'RECORD', externalMovieId?: string, externalOwnerId?: string, roomId?: number): void;
     /**
      * Закончена запись звонка
+     * @param roomId ID зала в котором остановлена запись
      */
-    function onRecordStopped(): void;
+    function onRecordStopped(roomId?: number): void;
     /**
      * Состояние своей сети
      *

package/static/Params.d.ts

@@ -175,9 +175,6 @@ export declare type ParamsObject = {
     };
     perfStatReportEnabled: boolean;
     callStatReportEnabled: boolean;
-    unifiedPlanBrowsers: {
-        [key: string]: number;
-    };
     /**
      * Отдавать приоритет кодеку H264 для исходящего видео
      *
@@ -239,32 +236,44 @@ export declare type ParamsObject = {
     breakVideoPayloadTypes: boolean;
     /**
      * Включить постраничный вывод участников. Работает только если включено videoTracksCount (слоты)
+     *
+     * _По умолчанию: `false`_
      */
     useParticipantListChunk: boolean;
     /**
      * Включить комнаты
+     *
+     * _По умолчанию: `false`_
      */
     useRooms: boolean;
     /**
-     * Индекс участника для первого chunk'а который придет при установки соединения с сервером
+     * Индекс участника для первого chunk'а который придет при установке соединения с сервером
+     *
+     * _По умолчанию: `0`_
      */
     participantListChunkInitIndex: number;
     /**
-     * Количество участников которые придут в первом chunk'е при установки соединения с сервером
+     * Количество участников которые придут в первом chunk'е при установке соединения с сервером
      * если параметр не проставлен то будет использоваться значение по умолчанию установленное на сервере
      */
     participantListChunkInitCount: number | null;
     /**
      * Включать RED-extension (redundancy) для групповых звонков
+     *
+     * _По умолчанию: `false`_
      */
     serverAudioRed: boolean;
     /**
      * Включать RED-extension (redundancy) для p2p звонков
+     *
+     * _По умолчанию: `false`_
      */
     p2pAudioRed: boolean;
     /**
      * Добавлять флаг spsPpsIdrInKeyframe для h264 кодека. В результате ключевые фреймы без sps и pps
      * не используются как ключевые. Решает проблему с артефактами на видео в случае потерь пакетов.
+     *
+     * _По умолчанию: `false`_
      */
     h264spsPpsIdrInKeyframe: boolean;
     /**
@@ -415,7 +424,7 @@ export declare type ParamsObject = {
     /**
      * Изменились состояния устройств пользователя или разрешения включать камеру/микрофон
      */
-    onMuteStates?: (muteStates: MuteStates, unmuteOptions: MediaOption[], mediaOptions: MediaOption[], muteAll: boolean, unmute: boolean, userId: ExternalParticipantId | null, adminId: ExternalParticipantId | null, stateUpdated?: boolean, requestedMedia?: MediaOption[]) => void;
+    onMuteStates?: (muteStates: MuteStates, unmuteOptions: MediaOption[], mediaOptions: MediaOption[], muteAll: boolean, unmute: boolean, userId: ExternalParticipantId | null, adminId: ExternalParticipantId | null, stateUpdated?: boolean, requestedMedia?: MediaOption[], roomId?: number) => void;
     /**
      * Изменились роли собеседника в звонке
      */
@@ -485,11 +494,11 @@ export declare type ParamsObject = {
     /**
      * Начата трансляция/запись звонка
      */
-    onRecordStarted?: (initiator: ExternalParticipantId, movieId: number, startTime: number, type: 'STREAM' | 'RECORD', externalMovieId?: string, externalOwnerId?: string) => void;
+    onRecordStarted?: (initiator: ExternalParticipantId, movieId: number, startTime: number, type: 'STREAM' | 'RECORD', externalMovieId?: string, externalOwnerId?: string, roomId?: number) => void;
     /**
      * Закончена трансляция/запись звонка
      */
-    onRecordStopped?: () => void;
+    onRecordStopped?: (roomId?: number) => void;
     /**
      * Состояние своей сети
      *
@@ -655,7 +664,6 @@ export default abstract class Params {
     static get audioNack(): boolean;
     static get consumerScreenTrack(): boolean;
     static get producerScreenTrack(): boolean;
-    static isUnifiedPlanSupported(name: string, version: number): boolean;
     static get movieShare(): boolean;
     static get videoTracksCount(): number;
     static get breakVideoPayloadTypes(): boolean;

package/static/Polyfills.d.ts

@@ -0,0 +1,7 @@
+export declare const fromEntries: {
+    <T = any>(entries: Iterable<readonly [PropertyKey, T]>): {
+        [k: string]: T;
+    };
+    (entries: Iterable<readonly any[]>): any;
+};
+export declare function blobToArrayBuffer(data: Blob): Promise<ArrayBuffer>;

package/static/Utils.d.ts

@@ -6,7 +6,8 @@ import VideoSettings from '../types/VideoSettings';
 export declare const PARAMETERS_SEPARATOR = ":";
 export declare const DEVICE_IDX_PARAMETER = "d";
 declare namespace Utils {
-    function patchSDP(sdp: string, preferH264: boolean, brokenH264: boolean, preferVP9: boolean, h264spsPpsIdrInKeyframe: boolean, isAudioNack?: boolean, preferRed?: boolean): string;
+    function patchLocalSDP(sdp: string, preferH264: boolean, brokenH264: boolean, preferVP9: boolean, h264spsPpsIdrInKeyframe: boolean, isAudioNack?: boolean, preferRed?: boolean): string;
+    function patchRemoteSDP(sdp: string): string;
     function getPeerIdString(peerId: SignalingMessage.PeerId): string;
     function comparePeerId(peerId1: SignalingMessage.PeerId, peerId2: SignalingMessage.PeerId): boolean;
     function getPeerConnectionHostInfo(pc: RTCPeerConnection): Promise<any>;

package/static/WebRTCUtils.d.ts

@@ -10,6 +10,47 @@ export declare enum FacingMode {
     LEFT = "left",
     RIGHT = "right"
 }
+/********************* MediaConstraints *********************/
+/**
+ * Вспомогательный класс для формирования параметров, которые нужны для запроса камеры и микрофона.
+ * @hidden
+ */
+declare class MediaConstraints {
+    protected audio: MediaTrackConstraints | boolean;
+    protected video: MediaTrackConstraints | boolean;
+    private readonly needVideo;
+    constructor(audioDeviceId: boolean | string, videoDeviceId?: boolean | string, videoMaxWidth?: number, videoMaxHeight?: number);
+    /**
+     * Возвращает нативные параметры для передачи в getUserMedia.
+     */
+    getNative(): object;
+    /**
+     * Метод упрощает параметры, чтобы попробовать сделать getUserMedia еще раз при ошибке.
+     * Сначала убираются размеры, потом соотношения сторон.
+     */
+    simplify(): MediaConstraints;
+    /**
+     * Проверяет, можно ли упростить параметры.
+     */
+    canSimplify(): boolean;
+    /**
+     * Проверяет, есть ли параметры видео.
+     */
+    isVideo(): boolean;
+    /**
+     * Проверяет, есть ли параметры аудио.
+     */
+    isAudio(): boolean;
+}
+/********************* /MediaConstraints *********************/
+/********************* ScreenConstraints *********************/
+/**
+ * Вспомогательный класс для формирования параметров, которые нужны для запроса трансляции экрана.
+ * @hidden
+ */
+export declare class ScreenConstraints extends MediaConstraints {
+    constructor(width: number, height: number, withAudioShare: boolean);
+}
 declare namespace WebRTCUtils {
     /**
      * Инициализирует устройства. До вызова этого метода бесполезно опрашивать другие публичные методы
@@ -64,7 +105,7 @@ declare namespace WebRTCUtils {
      */
     function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean): Promise<MediaStream>;
     /**
-     * Запрашивает трансляцию экрана пользователя
+     * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
      */
     function getScreenMedia(withAudioShare: boolean): Promise<MediaStream>;
     /**
@@ -100,15 +141,6 @@ declare namespace WebRTCUtils {
      * Проверяет поддержку шаринга экрана браузером
      */
     function isScreenCapturingSupported(): boolean;
-    /**
-     * Проверяет доступность кодека VP8 при использовании WebRTC.
-     * Кодек может быть доступен, даже если видео VP8 в браузере не поддерживается.
-     */
-    function canVP8(): boolean;
-    /**
-     * Проверяет используемый план (unified-plan или plan-b)
-     */
-    function isUnifiedPlan(): boolean;
     /**
      * В некоторых браузерах H264 сломан
      */

package/static/WebRTCUtils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/Conversation.d.ts

@@ -9,4 +9,5 @@ export interface IProcessMuteStateParams {
     admin?: Participant | null;
     stateUpdated?: boolean;
     requestedMedia?: MediaOption[];
+    roomId?: number;
 }

package/types/Room.d.ts

@@ -1,4 +1,5 @@
 import { ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk } from './ExternalId';
+import MuteStates from './MuteStates';
 import { ParticipantListMarkers } from './Participant';
 export interface Room {
     id: number;
@@ -32,6 +33,10 @@ export interface Room {
      * if this room is active (read/write, optional)
      */
     active?: boolean;
+    /**
+     * global (room-wide) mute state, if any
+     */
+    muteStates?: MuteStates;
 }
 /**
  * Initial rooms state

package/types/SignalingMessage.d.ts

@@ -94,6 +94,8 @@ declare namespace SignalingMessage {
         active?: boolean;
         countdownSec?: number;
         timeoutMs?: number;
+        muteStates?: MuteStates;
+        recordInfo?: RecordInfo;
     }
     interface Notification extends SignalingMessage {
         type?: string;
@@ -171,6 +173,7 @@ declare namespace SignalingMessage {
         stateUpdated?: boolean;
         unmute?: boolean;
         muteAll?: boolean;
+        roomId?: number;
     }
     export interface PinParticipant extends Notification {
         participantId: ParticipantId;