@vkontakte/calls-sdk 2.6.2-beta.2 → 2.6.2-beta.21

package/CallsSDK.d.ts

@@ -9,6 +9,7 @@ import { ConversationData } from './classes/Conversation';
 import HangupReason, { HangupReasonData } from './classes/HangupReason';
 import { MediaTrackKind } from './classes/MediaSource';
 import { StatResult } from './classes/transport/Statistics';
+import { TransportTopology } from './classes/transport/Transport';
 import Api from './default/Api';
 import Signaling from './default/Signaling';
 import CallDirection from './enums/CallDirection';
@@ -46,6 +47,10 @@ import ParticipantPriority from './types/ParticipantPriority';
 import { MediaType, ParticipantStreamDescription } from './types/ParticipantStreamDescription';
 import SignalingMessage from './types/SignalingMessage';
 import { WaitingHallResponse } from './types/WaitingHall';
+import { IFeedbackExternal } from './types/Feedback';
+import { ISharedMovieInfo, ISharedMovieStoppedInfo, ISharedMovieState, ISharedMovieStateResponse, IAddMovieParams, IOnRemoteMovieData, IMoviePreview, IUpdateMovieData } from './types/MovieShare';
+import ConversationFeature from './enums/ConversationFeature';
+import { IFeaturesPerRole } from './types/ConversationFeature';
 /**
  * Информация о текущем браузере
  */
@@ -184,9 +189,10 @@ export declare function init(params: Partial<ParamsObject>): Promise<void>;
  * @param payload Дополнительные данные для передачи на сервер
  * @param joiningAllowed Создать токен комнаты для подключения по ссылке
  * @param requireAuthToJoin Запретить анонимам подключаться по ссылке (если поддерживается сервером)
+ * @param onlyAdminCanShareMovie Только администратор может включать совметсный просмотр
  */
-export declare function callTo(externalId?: string | ExternalId | string[] | ExternalId[], mediaOptions?: MediaOption[], payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean): Promise<ConversationData>;
-export declare function callInternal(ids: OkUserId[], type: CallType, mediaOptions: MediaOption[], payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean): Promise<ConversationData>;
+export declare function callTo(externalId?: string | ExternalId | string[] | ExternalId[], mediaOptions?: MediaOption[], payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean, onlyAdminCanShareMovie?: boolean): Promise<ConversationData>;
+export declare function callInternal(ids: OkUserId[], type: CallType, mediaOptions: MediaOption[], payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean, onlyAdminCanShareMovie?: boolean): Promise<ConversationData>;
 /**
  * Обработать пуш о входящем звонке
  *
@@ -274,6 +280,13 @@ export declare function changeDevice(kind: MediaDeviceKind, deviceId: string): P
  * @param state Включить или выключить
  */
 export declare function captureScreen(state: boolean): Promise<void>;
+/**
+ * Включить/выключить захват экрана
+ *
+ * @param screenState Включить или выключить захват экрана.
+ * @param audioShareState Включить или выключить захват звука. Может быть использован только вместе с захватом экрана.
+ */
+export declare function captureScreenAndAudio(screenState: boolean, audioShareState: boolean): Promise<void>;
 /**
  * Позволяет установить кастомный стрим для видео
  * например для стрима из canvas, с наложением изображений
@@ -393,9 +406,12 @@ export declare function customDataInternal(data: JSONObject, uid?: OkUserId | nu
  *
  * @param payload Дополнительные данные для передачи на сервер
  * @param requireAuthToJoin Запретить анонимам подключаться по ссылке (если поддерживается сервером)
+ * @param startConversationParameters Дополнительные параметры для создания звонка (например onlyAdminCanShareMovie)
  * @returns Токен комнаты
  */
-export declare function startConversation(payload?: string, requireAuthToJoin?: boolean): Promise<string>;
+export declare function startConversation(payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie }?: {
+    onlyAdminCanShareMovie?: boolean;
+}): Promise<string>;
 /**
  * Создать токен комнаты для подключения по ссылке к существующему звонку
  *
@@ -447,17 +463,16 @@ export declare function getStreamInfo(): Promise<{
  *
  * @param movieId
  */
-export declare function addMovie(movieId: string): Promise<{
+export declare function addMovie(params: IAddMovieParams): Promise<{
     movieId: string;
     streamType: string;
 }>;
 /**
  * Изменить видео/лайв в звонке
  *
- * @param movieId
- * @param gain
+ * @param params
  */
-export declare function updateMovie(movieId: string, gain?: number, offset?: string, pause?: boolean): Promise<void>;
+export declare function updateMovie(params: IUpdateMovieData): Promise<void>;
 /**
  * Удалить видео/лайв из звонка
  *
@@ -513,6 +528,8 @@ export declare function getWaitingHall(pageMarker?: string | null, count?: numbe
 export declare function promoteParticipant(externalId: ExternalId, demote?: boolean): Promise<void>;
 export declare function getParticipantListChunk(participantListChunkParameters: ParticipantListChunkParameters): Promise<import("./types/ExternalId").ExternalParticipantListChunk>;
 export declare function getParticipants(parameters: IGetParticipantsParameters): Promise<ExternalParticipant[]>;
+export declare function feedback(key: string): Promise<SignalingMessage>;
+export declare function enableFeatureForRoles(feature: ConversationFeature, roles: UserRole[]): Promise<void>;
 /**
  * Удаляет записи истории звонков
  *
@@ -523,5 +540,5 @@ export declare function removeHistoryRecords(recordIds: number[]): Promise<void>
  * Версия SDK
  */
 export declare function version(): string;
-export type { AddParticipantParams, ConversationData, ConversationParams, ConversationResponse, ExternalId, ExternalParticipant, ExternalParticipantListMarkers as ExternalParticipantMarkers, ExternalParticipantId, HangupReasonData, IceServer, JSONArray, JSONObject, JSONType, Layout, MediaModifiers, MediaSettings, MuteStates, OkUserId, ParamsObject, ParticipantLayout, ParticipantPriority, ParticipantStateMapped, ParticipantStreamDescription, ParticipantListChunkParameters, IGetParticipantsParameters, SignalingMessage, StatResult, StopStream, WaitingHallResponse, IVideoDimentions, };
-export { Api, BaseApi, BaseLogger, BaseSignaling, CallDirection, CallType, ChatRoomEventType, ConversationOption, DebugMessageType, ExternalIdType, FacingMode, FatalError, HangupReason, HangupType, MediaOption, MediaTrackKind, MediaType, MuteState, ParticipantState, ParticipantStatus, RecordRole, Signaling, SignalingCommandType, SignalingConnectionType, SignalingNotification, UserRole, UserType, Utils, };
+export type { AddParticipantParams, ConversationData, ConversationParams, ConversationResponse, ExternalId, ExternalParticipant, ExternalParticipantListMarkers as ExternalParticipantMarkers, ExternalParticipantId, HangupReasonData, IceServer, JSONArray, JSONObject, JSONType, Layout, MediaModifiers, MediaSettings, MuteStates, OkUserId, ParamsObject, ParticipantLayout, ParticipantPriority, ParticipantStateMapped, ParticipantStreamDescription, ParticipantListChunkParameters, IGetParticipantsParameters, SignalingMessage, StatResult, StopStream, WaitingHallResponse, IVideoDimentions, IFeedbackExternal, ISharedMovieInfo, ISharedMovieStoppedInfo, ISharedMovieState, ISharedMovieStateResponse, IAddMovieParams, IOnRemoteMovieData, IMoviePreview, IUpdateMovieData, IFeaturesPerRole, };
+export { Api, BaseApi, BaseLogger, BaseSignaling, CallDirection, CallType, ChatRoomEventType, ConversationOption, DebugMessageType, ExternalIdType, FacingMode, FatalError, HangupReason, HangupType, MediaOption, MediaTrackKind, MediaType, MuteState, ParticipantState, ParticipantStatus, RecordRole, Signaling, SignalingCommandType, SignalingConnectionType, SignalingNotification, UserRole, UserType, Utils, TransportTopology, ConversationFeature, };

package/abstract/BaseApi.d.ts

@@ -19,8 +19,12 @@ export default abstract class BaseApi {
     abstract init(): void;
     abstract authorize(): Promise<void>;
     abstract userId(participantId: CompositeUserId): Promise<ExternalId>;
-    abstract createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean): Promise<ConversationResponse>;
-    abstract startConversation(conversationId: string, ids?: OkUserId[], type?: CallType, isVideo?: boolean, payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean): Promise<ConversationResponse>;
+    abstract createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, createConversationParameters?: {
+        onlyAdminCanShareMovie?: boolean;
+    }): Promise<ConversationResponse>;
+    abstract startConversation(conversationId: string, ids?: OkUserId[], type?: CallType, isVideo?: boolean, payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean, createConversationParameters?: {
+        onlyAdminCanShareMovie?: boolean;
+    }): Promise<ConversationResponse>;
     abstract joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
     createJoinLink(conversationId: string): Promise<{
         join_link: string;

package/abstract/BaseSignaling.d.ts

@@ -2,6 +2,7 @@ import EventEmitter from '../classes/EventEmitter';
 import { ParticipantIdRegistry } from '../classes/ParticipantIdRegistry';
 import { PerfStatReport } from '../classes/transport/PerfStatReporter';
 import { TransportTopology } from '../classes/transport/Transport';
+import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
 import MediaOption from '../enums/MediaOption';
 import RecordRole from '../enums/RecordRole';
@@ -11,8 +12,10 @@ import { JSONObject } from '../static/Json';
 import ConversationResponse from '../types/ConversationResponse';
 import MediaModifiers from '../types/MediaModifiers';
 import MediaSettings from '../types/MediaSettings';
+import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
 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';
@@ -53,10 +56,10 @@ export default abstract class BaseSignaling extends EventEmitter {
         [key: string]: number;
     }): Promise<SignalingMessage | void>;
     abstract updateDisplayLayout(layouts: {
-        [key: string]: string;
+        [streamDesc: string]: ParticipantLayout | StopStream | RequestKeyFrame;
     }): Promise<SignalingMessage | void>;
-    abstract addMovie(data: any): Promise<SignalingMessage>;
-    abstract updateMovie(data: any): Promise<SignalingMessage>;
+    abstract addMovie(data: IAddMovieParams): Promise<SignalingMessage>;
+    abstract updateMovie(data: IUpdateMovieData): Promise<SignalingMessage>;
     abstract removeMovie(data: any): Promise<SignalingMessage>;
     abstract startStream(data: any): Promise<SignalingMessage>;
     abstract stopStream(): Promise<SignalingMessage>;
@@ -69,6 +72,7 @@ export default abstract class BaseSignaling extends EventEmitter {
     abstract customData(data: JSONObject, participantId: ParticipantId | null): Promise<SignalingMessage>;
     abstract grantRoles(participantId: CompositeUserId, roles: UserRole[], revoke: boolean): Promise<SignalingMessage>;
     abstract muteParticipant(participantId: ParticipantId | null, muteStates: MuteStates, requestedMedia: MediaOption[]): Promise<SignalingMessage>;
+    abstract enableFeatureForRoles(feature: ConversationFeature, roles: UserRole[]): Promise<SignalingMessage>;
     abstract pinParticipant(participantId: ParticipantId, unpin: boolean): Promise<SignalingMessage>;
     abstract updateMediaModifiers(mediaModifiers: MediaModifiers): Promise<SignalingMessage>;
     abstract changeOptions(changes: {
@@ -76,6 +80,7 @@ export default abstract class BaseSignaling extends EventEmitter {
     }): Promise<SignalingMessage>;
     abstract getWaitingHall(fromId: WaitingParticipantId | null, count?: number, backward?: boolean): Promise<SignalingMessage>;
     abstract promoteParticipant(participantId: CompositeUserId, demote?: boolean): Promise<SignalingMessage>;
+    abstract feedback(key: string): Promise<SignalingMessage>;
     abstract setProducerNotificationDataChannel(dataChannel: RTCDataChannel): void;
     abstract setProducerCommandDataChannel(dataChannel: RTCDataChannel): void;
     abstract useCommandDataChannel(status: boolean): void;