@vkontakte/calls-sdk 2.8.11-dev.6637565d.0 → 2.8.11-dev.6c644bb1.0

package/classes/Conversation.d.ts

@@ -127,7 +127,6 @@ export default class Conversation extends EventEmitter {
     private _prepareConversation;
     private _createParticipant;
     private _getParticipantId;
-    private _cacheParticipantExternalIds;
     private _setConversation;
     private _updateConversation;
     private _createMediaSource;
@@ -140,11 +139,15 @@ export default class Conversation extends EventEmitter {
     private _registerParticipants;
     /** Установим состояние локальных мьютов */
     private _registerParticipantLocalMuteState;
-    private _getStatusByTransportState;
+    private _remoteParticipantSessionState;
+    private _buildConnectionStatus;
+    private _isParticipantSessionStateApplicable;
+    private _setTransportStatus;
+    private _setSessionState;
+    private _emitParticipantTransition;
     private _registerParticipantInCache;
     private _getExistedParticipantByIdOrCreate;
     private _getExternalIdByParticipantId;
-    private _getExternalIdsByOkIdsFromCache;
     private _registerParticipantAndSetMarkersIfChunkEnabled;
     private _warnParticipantNotInConversation;
     private _denormalizeMarkers;
@@ -317,6 +320,11 @@ export default class Conversation extends EventEmitter {
     private _onSignalingFailed;
     private _onAcceptedCall;
     private _onHungup;
+    private _onSessionState;
+    private _reconcileParticipantSessionStates;
+    private _updateParticipantExternalId;
+    private _updateParticipantSessionState;
+    private _emitParticipantEffectiveStatusIfSessionOverridesTransport;
     private _onAddedParticipant;
     private _onJoinedParticipant;
     private _onClosedConversation;

package/default/Api.d.ts

@@ -45,9 +45,13 @@ export default class Api extends BaseApi {
     }>;
     getAnonymTokenByLink(joinLink: string, username?: string): Promise<string>;
     joinConversationByLink(joinLink: string, isVideo?: boolean, observedIds?: ExternalUserId[], payload?: string): Promise<ConversationResponse>;
+    /**
+     * NB: Не сохраняет порядок возвращаемых ID
+     * @hidden
+     */
+    getExternalIdsByOkIds(uids: OkUserId[]): Promise<ExternalParticipantId[]>;
     getCachedOkIdByExternalId(externalId: ExternalId): ParticipantId | null;
     getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
-    getCachedExternalIdByOkId(okId: OkUserId): ExternalParticipantId | null;
     cacheExternalId(participantId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
     mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, initialId: OkUserId | CompositeUserId | ParticipantId): void;
     unmapDecorativeId(initialId: OkUserId | CompositeUserId | ParticipantId): void;
@@ -59,5 +63,6 @@ export default class Api extends BaseApi {
     hangupConversation(conversationId: string, reason?: HangupType): void;
     removeHistoryRecords(recordIds: number[]): Promise<void>;
     cleanup(): void;
+    private _getExternalIdsByOkIds;
     getServerTime(): Promise<number>;
 }

package/enums/SignalingNotification.d.ts

@@ -24,6 +24,7 @@ declare enum SignalingNotification {
     REALLOC_CON = "realloc-con",
     AUDIO_ACTIVITY = "audio-activity",
     SPEAKER_CHANGED = "speaker-changed",
+    SESSION_STATE = "session-state",
     STALLED_ACTIVITY = "stalled-activity",
     CHAT_MESSAGE = "chat-message",
     CUSTOM_DATA = "custom-data",

package/package.json

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

package/static/Params.d.ts

@@ -493,6 +493,12 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     transparentAudio: boolean;
+    /**
+     * Включить получение обновлений состояния медийной сессии участников
+     *
+     * _По умолчанию: `false`_
+     */
+    enableSessionStateUpdates: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -1007,6 +1013,7 @@ export default abstract class Params {
     static get webtransport(): boolean;
     static get webtransportFF(): boolean;
     static get transparentAudio(): boolean;
+    static get enableSessionStateUpdates(): boolean;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1042,5 +1049,6 @@ export default abstract class Params {
         webtransport: boolean;
         webtransportFF: boolean;
         transparentAudio: boolean;
+        enableSessionStateUpdates: boolean;
     };
 }

package/static/ParticipantConnectionStatusUtils.d.ts

@@ -0,0 +1,16 @@
+import { ParticipantConnectionStatus, ParticipantSessionState } from '../types/Participant';
+import { ParticipantStatus } from './External';
+import TransportState from '../enums/TransportState';
+type StatusTransition = {
+    status: ParticipantStatus;
+    shouldNotify: boolean;
+};
+declare namespace ParticipantConnectionStatusUtils {
+    function create(status?: Partial<ParticipantConnectionStatus> | null): ParticipantConnectionStatus;
+    function fromTransportState(state?: TransportState): ParticipantStatus | null;
+    function computeEffective(status: ParticipantConnectionStatus): ParticipantStatus;
+    function setSessionState(status: ParticipantConnectionStatus, sessionState?: ParticipantSessionState, sessionStateConnectedBySpeaker?: boolean): StatusTransition;
+    function setTransport(status: ParticipantConnectionStatus, transport: ParticipantStatus): StatusTransition;
+    function setSessionStateApplicable(status: ParticipantConnectionStatus, applicable: boolean): StatusTransition;
+}
+export default ParticipantConnectionStatusUtils;

package/types/Participant.d.ts

@@ -44,6 +44,16 @@ export interface ParticipantStateMapped {
         ts: number;
     };
 }
+export interface ParticipantSessionState {
+    connected: boolean;
+}
+export interface ParticipantConnectionStatus {
+    transport: ParticipantStatus;
+    sessionState?: ParticipantSessionState;
+    sessionStateApplicable: boolean;
+    sessionStateConnectedBySpeaker: boolean;
+    lastEffective: ParticipantStatus;
+}
 /**
  * Состояния участников звонка
  */
@@ -63,7 +73,6 @@ export interface Participant {
     externalId: ExternalParticipantId;
     mediaSettings: MediaSettings;
     state: ParticipantState;
-    status: ParticipantStatus;
     remoteStream?: MediaStream | null;
     remoteAudioTrack?: MediaStreamTrack | null;
     secondStream?: MediaStream | null;
@@ -72,6 +81,7 @@ export interface Participant {
     clientType: string;
     roles: UserRole[];
     participantState: ParticipantStateMapped;
+    connectionStatus: ParticipantConnectionStatus;
     networkRating: number;
     lastRequestedLayouts: {
         [key: StreamDescriptionString]: ParticipantLayout;

package/types/SignalingMessage.d.ts

@@ -19,7 +19,7 @@ import MediaModifiers from './MediaModifiers';
 import MediaSettings from './MediaSettings';
 import { ISharedMovieInfo, ISharedMovieState, ISharedMovieStoppedInfo } from './MovieShare';
 import MuteStates from './MuteStates';
-import { CompositeUserId, OkUserId, ParticipantId, ParticipantListMarker as ParticipantParticipantListMarker, ParticipantListMarkers, ParticipantListType as ParticipantParticipantListType } from './Participant';
+import { CompositeUserId, OkUserId, ParticipantId, ParticipantListMarker as ParticipantParticipantListMarker, ParticipantListMarkers, ParticipantListType as ParticipantParticipantListType, ParticipantSessionState } from './Participant';
 import { MediaType, ParticipantStreamDescription } from './ParticipantStreamDescription';
 import { IRoomId } from './Room';
 import VideoSettings from './VideoSettings';
@@ -89,6 +89,7 @@ declare namespace SignalingMessage {
             state: Record<string, string>;
             stateUpdateTs: Record<string, number>;
         };
+        sessionState?: ParticipantSessionState;
         roles?: UserRole[];
         peerId?: PeerId;
         restricted?: boolean;
@@ -323,6 +324,13 @@ declare namespace SignalingMessage {
     export interface SpeakerChanged extends Notification {
         speaker: ParticipantId;
     }
+    export interface SessionState extends Notification {
+        connected: boolean;
+        participantId: OkUserId;
+        participantType: UserType;
+        deviceIdx?: number;
+        markers?: ParticipantListMarkers;
+    }
     export interface OptionsChanged extends Notification {
         options: ConversationOption[];
     }