vimp-engine 0.35.6 → 0.36.0

package/src/client/network/HiddenHostHealthLog.js

@@ -0,0 +1,76 @@
+// Сводка здоровья хоста за эпизод скрытой вкладки (host-migration этап
+// 9a): браузер троттлит Worker скрытой вкладки (этап 0), и в журнал
+// клиентских ошибок уходит, насколько просел матч, — одна запись на эпизод,
+// а не на каждую секунду (журнал дедуплицирует по коду и хранит details
+// только первой записи).
+//
+// Эпизод закрывается возвратом видимости, потерей роли хоста или
+// выгрузкой страницы (flush). Следующие эпизоды той же сессии журнал
+// склеивает с первым: растёт счётчик, details остаются первого — осознанно.
+// Эпизод без единой метрики (матч стоял, скрытие короче окна цикла) не
+// пишется. Без DOM: видимость сообщает владелец.
+
+export const HIDDEN_HEALTH_CODE = 'engine.host.hiddenHealth';
+
+export default class HiddenHostHealthLog {
+  /**
+   * @param {Object} options
+   * @param {Function} options.warn - (code, summary) запись в журнал.
+   * @param {boolean} [options.hidden] - вкладка скрыта в момент создания.
+   * @param {Function} [options.now] - монотонные часы, мс.
+   */
+  constructor({ warn, hidden = false, now = () => performance.now() }) {
+    this._warn = warn;
+    this._now = now;
+    this._episode = null;
+
+    this.setHidden(hidden);
+  }
+
+  setHidden(hidden) {
+    if (hidden && !this._episode) {
+      this._episode = {
+        startedAt: this._now(),
+        samples: 0,
+        minTickRate: Infinity,
+        maxGapMs: 0,
+        lostMs: 0,
+      };
+    } else if (!hidden) {
+      this.flush();
+    }
+  }
+
+  // метрика Worker'а (HostController.onHealth): в зачёт только скрытой вкладки
+  add(health) {
+    const episode = this._episode;
+
+    if (!episode || !health) {
+      return;
+    }
+
+    episode.samples += 1;
+    episode.minTickRate = Math.min(episode.minTickRate, health.tickRate);
+    episode.maxGapMs = Math.max(episode.maxGapMs, health.maxGapMs);
+    episode.lostMs += health.lostMs;
+  }
+
+  // закрыть эпизод (если идёт) и записать сводку
+  flush() {
+    const episode = this._episode;
+
+    this._episode = null;
+
+    if (!episode || episode.samples === 0) {
+      return;
+    }
+
+    this._warn(HIDDEN_HEALTH_CODE, {
+      hiddenMs: Math.round(this._now() - episode.startedAt),
+      samples: episode.samples,
+      minTickRate: episode.minTickRate,
+      maxGapMs: episode.maxGapMs,
+      lostMs: episode.lostMs,
+    });
+  }
+}

package/src/client/network/HostConnectionManager.js

@@ -26,7 +26,8 @@ export default class HostConnectionManager {
     this._threshold = opts.backpressureThreshold ?? 262144; // 256 КБ
     this._onPeersChange = opts.onPeersChange;
 
-    this._peers = new Map(); // clientId → { pc, meta, state, openCount }
+    // clientId → { pc, meta, state, openCount, memberId }
+    this._peers = new Map();
 
     signaling.publisher.on('webrtc_offer', 'onOffer', this);
     signaling.publisher.on('ice_candidate', 'onRemoteCandidate', this);
@@ -35,19 +36,39 @@ export default class HostConnectionManager {
 
   // приём SDP-оффера клиента: создаёт peer, отвечает answer
   async onOffer(msg) {
-    const { clientId, sdp } = msg;
+    // memberId — id вкладки гостя (переживает реконнект сигналинга);
+    // понадобится назначению преемника (host-migration, этап 6)
+    const { clientId, sdp, memberId = null } = msg;
+    // переподключение гостя к матчу (host-migration этап 4): Worker не
+    // начнёт хендшейк, а будет ждать RESUME_REQUEST
+    const resume = msg.resume === true;
 
     if (this._peers.has(clientId)) {
-      return;
+      // гость с тем же сигнальным id переподключается: для него прежнее
+      // соединение уже мертво, а у нас ещё полуоткрыто — снять его
+      // (Worker отсоединит участника и дождётся возобновления)
+      if (!resume) {
+        return;
+      }
+
+      this._closePeer(clientId);
     }
 
     const pc = this._peerFactory({ iceServers: this._iceServers });
-    const peer = { pc, meta: null, state: null, openCount: 0 };
+    const peer = {
+      pc,
+      meta: null,
+      state: null,
+      openCount: 0,
+      memberId,
+      resume,
+    };
 
     this._peers.set(clientId, peer);
 
     // каналы создаёт offerer — ловим их здесь
-    pc.ondatachannel = event => this._wireChannel(clientId, peer, event.channel);
+    pc.ondatachannel = event =>
+      this._wireChannel(clientId, peer, event.channel);
 
     pc.onicecandidate = event => {
       if (event.candidate) {
@@ -123,11 +144,14 @@ export default class HostConnectionManager {
       peer.openCount += 1;
 
       // оба канала открыты — поднимаем соединение клиента в Worker'е
-      // (Worker сразу шлёт CONFIG_DATA по meta)
+      // (Worker сразу шлёт CONFIG_DATA по meta, а при resume ждёт
+      // RESUME_REQUEST)
       if (peer.openCount === 2) {
         this._controller.open(clientId, {
-          onMessage: (payload, reliable) => this._deliver(peer, payload, reliable),
+          onMessage: (payload, reliable) =>
+            this._deliver(peer, payload, reliable),
           onClose: () => this._closePeer(clientId),
+          resume: peer.resume,
         });
 
         this._onPeersChange?.(this._peers.size);
@@ -182,7 +206,37 @@ export default class HostConnectionManager {
     this._onPeersChange?.(this._peers.size);
   }
 
-  // число активных пиров (для currentPlayers у мастера)
+  // RTCPeerConnection гостя по memberId (канал standby преемнику,
+  // host-migration этап 6): только пир с открытыми meta/state; null — нет
+  peerConnectionOf(memberId) {
+    if (!memberId) {
+      return null;
+    }
+
+    for (const peer of this._peers.values()) {
+      if (peer.memberId === memberId && peer.openCount === 2) {
+        return peer.pc;
+      }
+    }
+
+    return null;
+  }
+
+  // memberId гостей с открытыми meta и state — отчёт room_peers мастеру
+  // (кого хост действительно видит)
+  connectedMemberIds() {
+    const ids = [];
+
+    for (const peer of this._peers.values()) {
+      if (peer.openCount === 2 && peer.memberId) {
+        ids.push(peer.memberId);
+      }
+    }
+
+    return ids;
+  }
+
+  // число активных пиров
   get peerCount() {
     return this._peers.size;
   }