@vkontakte/calls-sdk 2.8.5-dev.1925f9b.0 → 2.8.5-dev.36da4e4e.0

package/CallsSDK.d.ts

@@ -368,8 +368,13 @@ export declare function changePriorities(priorities: ParticipantPriority[]): Pro
  * Изменяет состояния пользователя в звонке (например, "поднять руку" или "отошёл")
  *
  * @param state Список состояний в виде ключ-значение. Максимальная длина ключей и значений - 5 символов. Пустые значения будут пропущены
+ * @param externalId Внешний ID пользователя
+ */
+export declare function changeParticipantState(state: Record<string, string>, externalId?: ExternalId): Promise<void>;
+/**
+ * Принудительно опустить руки участников в текущем сессионном зале админа
  */
-export declare function changeParticipantState(state: Record<string, string>): Promise<void>;
+export declare function putHandsDown(): Promise<void>;
 /**
  * Изменяет лейаут.
  * Также сообщает серверу каких участников звонка стримить на этот клиент
@@ -413,6 +418,13 @@ export declare function setMediaModifiers(mediaModifiers: MediaModifiers): Promi
  * @param enabled true - включить, false - отключить
  */
 export declare function enableVideoSuspend(enabled: boolean): Promise<void>;
+/**
+ * Режим, при котором будет предложено включить автоматическое
+ * отключение приёма видео в условиях плохого соединения
+ *
+ * @param enabled true - включить, false - отключить
+ */
+export declare function enableVideoSuspendSuggest(enabled: boolean): Promise<void>;
 /**
  * Включить/выключить опции звонка
  *
@@ -656,6 +668,14 @@ export declare function getParticipantListChunk(participantListChunkParameters:
 export declare function getParticipants(parameters: IGetParticipantsParameters): Promise<ExternalParticipant[]>;
 export declare function feedback(key: string): Promise<SignalingMessage>;
 export declare function userFeedbackStats(userResponse: number, reason?: string, groupCallUsersCount?: number): void;
+/**
+ * Логирует клиентское событие статистики
+ *
+ * @param eventType Тип события
+ * @param eventData Дополнительные данные события
+ * @param immediatelty Отправить ли событие немедленно
+ */
+export declare function logClientEvent(eventType: string, eventData?: Record<string, string | number | boolean>, immediately?: boolean): void;
 export declare function enableFeatureForRoles(feature: ConversationFeature, roles: UserRole[]): Promise<void>;
 /**
  * Удаляет записи истории звонков

package/abstract/BaseApi.d.ts

@@ -8,6 +8,13 @@ export type ClientStats = {
     vcid: ConversationData['id'] | null;
     [k: string]: string | number | null;
 };
+export type ClientEvent = {
+    timestamp: number;
+    call_topology: 'D' | 'S';
+    event_type: string;
+    vcid: ConversationData['id'] | null;
+    [k: string]: string | number | boolean | null;
+};
 export type LogItem = {
     count?: number;
     custom: ClientStats;
@@ -52,6 +59,10 @@ export default abstract class BaseApi {
      * method: vchat.clientStats
      */
     logClientStats(items: ClientStats[]): void;
+    /**
+     * method: vchat.clientEvents
+     */
+    logClientEvents(items: ClientEvent[]): void;
     abstract getOkIdsByExternalIds(externalIds: ExternalId[]): Promise<OkUserId[]>;
     abstract getParticipantIdsByExternalIds(externalIds: ExternalId[]): Promise<Map<ExternalId, ParticipantId>>;
     abstract getExternalIdsByOkIds(uids: OkUserId[]): Promise<ExternalParticipantId[]>;

package/abstract/BaseSignaling.d.ts

@@ -46,9 +46,8 @@ export default abstract class BaseSignaling extends EventEmitter {
     abstract sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit): Promise<SignalingMessage>;
     abstract sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidate): Promise<SignalingMessage>;
     abstract changeMediaSettings(mediaSettings: MediaSettings): Promise<SignalingMessage>;
-    abstract changeParticipantState(state: {
-        [key: string]: string;
-    }): Promise<SignalingMessage>;
+    abstract changeParticipantState(state: Record<string, string>, compositeUserId?: CompositeUserId): Promise<SignalingMessage>;
+    abstract putHandsDown(): Promise<SignalingMessage>;
     abstract addParticipant(participantId: CompositeUserId, params?: AddParticipantParams): Promise<SignalingMessage>;
     abstract removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<SignalingMessage>;
     abstract allocateConsumer(description: RTCSessionDescription | null, capabilities: {
@@ -92,6 +91,7 @@ export default abstract class BaseSignaling extends EventEmitter {
     abstract pinParticipant(participantId: ParticipantId, unpin: boolean, roomId: number | null): Promise<SignalingMessage>;
     abstract updateMediaModifiers(mediaModifiers: MediaModifiers): Promise<SignalingMessage>;
     abstract enableVideoSuspend(enabled: boolean): Promise<SignalingMessage>;
+    abstract enableVideoSuspendSuggest(enabled: boolean): Promise<SignalingMessage>;
     abstract changeOptions(changes: {
         [key in ConversationOption]?: boolean;
     }): Promise<SignalingMessage>;