vimp-engine 0.38.2 → 0.39.0

package/src/client/network/HostHealthPolicy.js

@@ -56,6 +56,7 @@ export default class HostHealthPolicy {
     this._successor = false;
     this._hiddenSince = null;
     this._hiddenTimer = null;
+    this._hiddenOutcome = null;
     this._lastAutoAt = null;
     this._cooldownBefore = null;
     this._samples = [];
@@ -80,6 +81,12 @@ export default class HostHealthPolicy {
     this._successor = false;
     this._resetSamples();
 
+    // исход прошлой роли уже прочитан её журналом (flush при потере роли);
+    // новой роли он не принадлежит
+    if (isHost) {
+      this._hiddenOutcome = null;
+    }
+
     // роль получена скрытой вкладкой: скрытие отсчитывается от получения
     if (isHost && this._hiddenSince !== null) {
       this._hiddenSince = this._hostSince;
@@ -98,6 +105,7 @@ export default class HostHealthPolicy {
   setHidden(hidden) {
     if (hidden && this._hiddenSince === null) {
       this._hiddenSince = this._now();
+      this._hiddenOutcome = null;
       this._armHiddenTimer();
     } else if (!hidden) {
       this._hiddenSince = null;
@@ -105,6 +113,19 @@ export default class HostHealthPolicy {
     }
   }
 
+  /**
+   * Исход передачи для последнего эпизода скрытия (живёт до следующего
+   * скрытия или новой роли хоста, переживает возврат видимости и потерю
+   * роли — его читает журнал закрываемого эпизода): null — порог
+   * hiddenHandoffMs не достигнут; 'started' — передача началась;
+   * 'disabled' | 'no-successor' | 'blocked' (срок роли или кулдаун) —
+   * ожидаемый отказ; 'unexplained' — всё разрешено, а передача не началась.
+   * @returns {string|null}
+   */
+  hiddenHandoff() {
+    return this._hiddenOutcome;
+  }
+
   // сэмпл здоровья Worker'а
   addHealth(health) {
     if (this._hostSince === null || !health) {
@@ -182,6 +203,8 @@ export default class HostHealthPolicy {
     }
 
     if (this._handOverNow('hidden')) {
+      this._hiddenOutcome = 'started';
+
       return true;
     }
 
@@ -191,9 +214,27 @@ export default class HostHealthPolicy {
       this._armHiddenTimer(waitMs);
     }
 
+    // начатая передача исход не меняет: следующие проверки её уже не стартуют
+    if (this._hiddenOutcome !== 'started') {
+      this._hiddenOutcome = this._refusal(waitMs);
+    }
+
     return false;
   }
 
+  // почему передача со скрытой вкладки не началась
+  _refusal(waitMs) {
+    if (!this._enabled()) {
+      return 'disabled';
+    }
+
+    if (!this._successor) {
+      return 'no-successor';
+    }
+
+    return waitMs > 0 ? 'blocked' : 'unexplained';
+  }
+
   // немедленная передача: ждущую границы — ускорить, иначе начать
   _handOverNow(reason) {
     if (!this._enabled() || !this._successor) {

package/src/client/network/InlineHostBridge.js

@@ -11,7 +11,7 @@ import { createGuestIdentity } from '../../host/identity.js';
 // Почему inline, а не Worker: HostPlugin принципиально непередаваем в Worker
 // (postMessage не несёт функции), а standalone SDK получает от репозитория
 // игры именно живой объект плагина. Прод-путь (хост в Worker'е) не меняется —
-// расхождение dev/prod осознанное, см. plan/standalone-sdk/README.md.
+// расхождение dev/prod осознанное.
 //
 // Мастера в этом контуре нет: личность гостевая (ник из формы, identity.js),
 // профиль offline-заглушкой (lib/offlinePlayerData.js).
@@ -102,6 +102,13 @@ export default class InlineHostBridge {
 
     this._runtime = runtime;
 
+    // сбой чат-команды игры виден в консоли вкладки вместе с кадрами обработчика
+    runtime.host.setDiagnosticSink(report =>
+      console.error(
+        `[vimp] ${report.message}${report.stack ? `\n${report.stack}` : ''}`,
+      ),
+    );
+
     this._portMachine = new PortMachine({
       host: runtime.host,
       socketManager: runtime.socketManager,

package/src/client/network/LoopbackTransport.js

@@ -32,6 +32,13 @@ export default class LoopbackTransport {
       resume: this._resume,
     });
 
+    // голос хоста-игрока не идёт через Worker: ретранслятор живёт здесь же, в
+    // главном потоке, и отдаёт пакеты прямым вызовом. ?. — у InlineHostBridge
+    // (standalone) голоса нет (D4)
+    this._controller.attachVoice?.(this._socketId, {
+      send: bytes => this.publisher.emit('voice', bytes),
+    });
+
     // подписчики появляются после connect() (супервизор берёт уже
     // подключённый транспорт) — 'open' уходит следующей микрозадачей
     if (this._resume) {
@@ -50,6 +57,13 @@ export default class LoopbackTransport {
     }
   }
 
+  // голосовой пакет хоста-игрока — ретранслятору, минуя Worker
+  sendVoice(bytes) {
+    if (!this._closed) {
+      this._controller.voiceIngress?.(this._socketId, bytes);
+    }
+  }
+
   close() {
     this._emitClose();
   }

package/src/client/network/SessionSupervisor.js

@@ -54,6 +54,8 @@ export default class SessionSupervisor {
    *   транспорта (строка или ArrayBuffer).
    * @param {Function} opts.onTerminal - (closeCode) сессия закрыта
    *   окончательно: путь прежнего handleDisconnect.
+   * @param {Function} [opts.onVoice] - (data) голосовой пакет текущего
+   *   транспорта в состоянии inGame (бинарный, без разбора).
    * @param {Function} [opts.onStateChange] - (state, prev).
    * @param {Function} [opts.onResumed] - место возвращено (RESUME_RESULT ok).
    * @param {Function} [opts.onResumeRejected] - (reason) хост отказал.
@@ -76,6 +78,7 @@ export default class SessionSupervisor {
   constructor({
     onMessage,
     onTerminal,
+    onVoice = null,
     onStateChange = () => {},
     onResumed = () => {},
     onResumeRejected = () => {},
@@ -88,6 +91,7 @@ export default class SessionSupervisor {
   }) {
     this._onMessage = onMessage;
     this._onTerminal = onTerminal;
+    this._onVoice = onVoice;
     this._onStateChange = onStateChange;
     this._onResumed = onResumed;
     this._onResumeRejected = onResumeRejected;
@@ -166,6 +170,17 @@ export default class SessionSupervisor {
     this._transport?.send(data, reliable);
   }
 
+  /**
+   * Голосовой пакет текущему транспорту (только в inGame; транспорт без
+   * голоса — выброс).
+   * @param {Uint8Array} bytes
+   */
+  sendVoice(bytes) {
+    if (this._state === S.inGame) {
+      this._transport?.sendVoice?.(bytes);
+    }
+  }
+
   /**
    * Пользователь уходит сам (или сессию закрывает политика): закрытие
    * транспорта терминально, переподключения не будет.
@@ -477,6 +492,7 @@ export default class SessionSupervisor {
 
     const handlers = {
       message: data => this._handleMessage(transport, data),
+      voice: data => this._handleVoice(transport, data),
       close: closeCode => this._handleClose(transport, closeCode),
       open: () => this._handleOpen(transport),
     };
@@ -523,6 +539,14 @@ export default class SessionSupervisor {
     this._onMessage(data);
   }
 
+  // голос не обновляет метку живости: поток голоса не доказывает живость
+  // протокола хоста
+  _handleVoice(transport, data) {
+    if (transport === this._transport && this._state === S.inGame) {
+      this._onVoice?.(data);
+    }
+  }
+
   _handleOpen(transport) {
     if (transport !== this._transport) {
       return;

package/src/client/network/WebRtcManager.js

@@ -1,12 +1,15 @@
+import { VOICE_BACKPRESSURE_BYTES } from '../../config/voiceProtocol.js';
 import Publisher from '../../lib/Publisher.js';
 
 // Транспорт P2P-соединения клиента с браузерным хостом. Заменяет игровой
-// WebSocket: два RTCDataChannel вместо одного сокета.
+// WebSocket: три RTCDataChannel вместо одного сокета.
 //
 // - meta  (reliable-ordered)      — весь JSON-протокол [portId, payload] и
 //                                    бинарные кадры с одноразовыми событиями;
 // - state (unreliable-unordered)  — чисто позиционные бинарные кадры, их
-//                                    потерю компенсирует следующий кадр.
+//                                    потерю компенсирует следующий кадр;
+// - voice (unreliable-unordered)  — только голосовые пакеты,
+//                                    в готовность соединения не входит.
 //
 // Классификация кадров meta/state — на стороне хоста при упаковке. Клиент лишь
 // принимает данные из обоих каналов и отдаёт их одним потоком (событие
@@ -103,6 +106,7 @@ export default class WebRtcManager {
     this._pc = null;
     this._meta = null;
     this._state = null;
+    this._voice = null;
     this._roomId = null;
     // id вкладки — хост хранит его рядом с clientId пира
     this._memberId = memberId ?? null;
@@ -164,8 +168,18 @@ export default class WebRtcManager {
     });
     this._state.binaryType = 'arraybuffer';
 
+    // voice — голос: ненадёжный неупорядоченный, как state,
+    // но в готовность соединения не входит — связь не обязательна для матча, а
+    // потеря пакета голоса лечится следующим
+    this._voice = pc.createDataChannel('voice', {
+      ordered: false,
+      maxRetransmits: 0,
+    });
+    this._voice.binaryType = 'arraybuffer';
+
     this._wireChannel(this._meta);
     this._wireChannel(this._state);
+    this._wireVoiceChannel(this._voice);
 
     // канал standby открывает хост — только преемнику (этап 6)
     pc.ondatachannel = event => {
@@ -319,6 +333,28 @@ export default class WebRtcManager {
     }
   }
 
+  // голосовой пакет хосту; закрытый или переполненный канал — выброс (живой
+  // голос важнее старого)
+  sendVoice(bytes) {
+    const channel = this._voice;
+
+    if (
+      !channel ||
+      channel.readyState !== 'open' ||
+      channel.bufferedAmount > VOICE_BACKPRESSURE_BYTES
+    ) {
+      return;
+    }
+
+    // канал мог закрыться между проверкой и отправкой — исключение не должно
+    // уйти в колбэк энкодера
+    try {
+      channel.send(bytes);
+    } catch {
+      // пакет потерян, как и при закрытом канале
+    }
+  }
+
   close() {
     this._emitClose();
   }
@@ -420,7 +456,7 @@ export default class WebRtcManager {
 
   // поздние события каналов закрытого менеджера не должны ничего эмитить
   _dropChannelHandlers() {
-    for (const channel of [this._meta, this._state]) {
+    for (const channel of [this._meta, this._state, this._voice]) {
       if (channel) {
         channel.onopen = null;
         channel.onmessage = null;
@@ -451,6 +487,12 @@ export default class WebRtcManager {
     channel.onclose = () => this._emitClose();
   }
 
+  // onopen/onclose не ставим: голос не трогает _openChannels и не закрывает
+  // менеджер
+  _wireVoiceChannel(channel) {
+    channel.onmessage = event => this.publisher.emit('voice', event.data);
+  }
+
   // кода закрытия у data channel нет: 'close' эмитится без аргумента, как
   // и раньше (код приходит только от WebSocket-транспорта dedicated)
   _emitClose() {

package/src/client/session/HandoffFlow.js

@@ -261,6 +261,11 @@ export default class HandoffFlow {
     this._policy?.addHealth(health);
   }
 
+  // исход передачи для последнего эпизода скрытия (HostHealthPolicy)
+  hiddenHandoff() {
+    return this._policy?.hiddenHandoff() ?? null;
+  }
+
   // «Leave server» из меню комнаты (этап 8.3). Хост при других людях отдаёт
   // роль бете без отката и уходит; один в комнате — закрывает её
   // (host_leaving: людей нет — мастер закрывает комнату сразу). Гость

package/src/client/session/HostRole.js

@@ -321,11 +321,14 @@ export default class HostRole {
       onStats: this._debug ? stats => this._debug('standby sent', stats) : null,
     });
 
-    // метрики здоровья Worker'а (этап 9a): скрытая вкладка троттлит цикл —
-    // насколько, уходит в журнал одной сводкой за эпизод
+    // метрики здоровья Worker'а: эпизод скрытия, в котором матч просел,
+    // задел удалённых игроков, а автопередача не началась без видимой
+    // причины, уходит в журнал одной сводкой (HiddenHostHealthLog)
     this._hiddenLog = this._factories.hiddenLog({
       warn: (code, summary) =>
         this._diagnostics.warn(code, summary, { source: 'client' }),
+      minHealthyTickRate: migration.auto.overloadTickRate,
+      handoffOutcome: () => this._getHandoff().hiddenHandoff(),
       hidden: this._ui.isHidden(),
     });
     this._healthReporter = this._isLobbyMode

package/src/client/style.css

@@ -1,10 +1,17 @@
 @charset "UTF-8";
 
-/* База страницы: раньше жила инлайном в packages/engine/index.html, но в
-   репозитории игры этого файла нет — а без правил ниже интерфейс движка
-   остался бы без своей типографики и раскладки. Standalone SDK импортирует
-   этот файл целиком, поэтому всё, что здесь есть, применяется и к
-   встраивающей странице. */
+/* База страницы: типографика и раскладка интерфейса движка живут здесь, а
+   не в index.html, потому что в репозитории игры такого файла нет.
+   Standalone SDK импортирует этот файл целиком, поэтому всё, что здесь
+   есть, применяется и к встраивающей странице. */
+/* Цвета команд 1…3: общие у ника в чате и в HUD связи; игра, перекрасившая
+   команды, переопределяет переменные. */
+:root {
+  --vimp-team-color-1: #f56;
+  --vimp-team-color-2: #7ed;
+  --vimp-team-color-3: #fe5;
+}
+
 html,
 body {
   width: 100%;
@@ -307,6 +314,141 @@ body.hide-cursor {
   text-align: right;
 }
 
+/*voice*/
+
+/* Нейтральный вид HUD связи; игра перестилизует его по #voice-hud и
+   классам. Селектор по id перебивает `.vimp-shell > * { display: none }` */
+#voice-hud {
+  display: none;
+  position: absolute;
+  right: 24px;
+  top: 50%;
+  transform: translateY(-50%);
+  z-index: 4;
+  pointer-events: none;
+  flex-direction: column;
+  align-items: flex-end;
+  gap: 8px;
+  color: #fff;
+  font-size: 14px;
+  text-shadow: 1px 1px 1px #000;
+}
+
+#voice-hud.is-talking,
+#voice-hud.is-busy,
+#voice-hud.is-cooldown,
+#voice-hud.is-error,
+#voice-hud.is-incoming {
+  display: flex;
+}
+
+#voice-hud .voice-own,
+#voice-hud .voice-incoming {
+  display: none;
+  position: relative;
+  align-items: center;
+  gap: 8px;
+}
+
+#voice-hud.is-talking .voice-own,
+#voice-hud.is-busy .voice-own,
+#voice-hud.is-cooldown .voice-own,
+#voice-hud.is-error .voice-own,
+#voice-hud.is-incoming .voice-incoming {
+  display: flex;
+}
+
+#voice-hud .voice-icon {
+  width: 32px;
+  height: 32px;
+  fill: none;
+  stroke: currentColor;
+  stroke-width: 2;
+  stroke-linecap: round;
+}
+
+#voice-hud .voice-icon rect {
+  fill: currentColor;
+}
+
+#voice-hud .voice-cross {
+  display: none;
+}
+
+#voice-hud .voice-ring {
+  display: none;
+  position: absolute;
+  left: -2px;
+  top: -2px;
+  width: 36px;
+  height: 36px;
+  fill: none;
+  stroke: currentColor;
+  stroke-width: 2;
+  transform: rotate(-90deg);
+}
+
+#voice-hud.is-talking .voice-ring {
+  display: block;
+}
+
+#voice-hud .voice-own {
+  flex-direction: row-reverse;
+}
+
+#voice-hud.is-talking .voice-own {
+  color: #3ad16b;
+}
+
+#voice-hud.is-busy .voice-own {
+  color: #e5484d;
+}
+
+#voice-hud.is-cooldown .voice-own,
+#voice-hud.is-error .voice-own {
+  color: #8a8f98;
+}
+
+#voice-hud.is-busy .voice-cross,
+#voice-hud.is-error .voice-cross {
+  display: inline;
+}
+
+#voice-hud .voice-incoming {
+  flex-direction: row-reverse;
+  color: #f5a524;
+  animation: voice-pulse 1s ease-in-out infinite;
+}
+
+#voice-hud .voice-name {
+  color: var(--voice-name-color, #fff);
+  font-weight: bold;
+}
+
+#voice-hud .voice-team1 {
+  color: var(--voice-name-color, var(--vimp-team-color-1));
+}
+
+#voice-hud .voice-team2 {
+  color: var(--voice-name-color, var(--vimp-team-color-2));
+}
+
+#voice-hud .voice-team3 {
+  color: var(--voice-name-color, var(--vimp-team-color-3));
+}
+
+@keyframes voice-pulse {
+  50% {
+    opacity: 0.55;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  #voice-hud .voice-incoming {
+    animation: none;
+  }
+}
+
 /*vote*/
 
 #vote {
@@ -457,15 +599,15 @@ body.hide-cursor {
 }
 
 #chat-box .line1:before {
-  color: var(--chat-name-color, #f56);
+  color: var(--chat-name-color, var(--vimp-team-color-1));
 }
 
 #chat-box .line2:before {
-  color: var(--chat-name-color, #7ed);
+  color: var(--chat-name-color, var(--vimp-team-color-2));
 }
 
 #chat-box .line3:before {
-  color: var(--chat-name-color, #fe5);
+  color: var(--chat-name-color, var(--vimp-team-color-3));
 }
 
 #cmd {
@@ -1329,7 +1471,7 @@ body.hide-cursor {
   color: #d66;
 }
 
-/* журнал клиентских ошибок (plan/client-reports, этап 5): тот же каркас и
+/* журнал клиентских ошибок: тот же каркас и
    палитра, что у панели реестра игр; графы — .games-filters/.games-filter-btn */
 #reports-panel {
   background-color: #222;

package/src/client/views/gameShell.js

@@ -55,9 +55,9 @@ const SHELL = [
             tag: 'div',
             id: 'auth-link',
             children: [
-              // ссылка и версия пакета ИГРЫ — заполняет main.js по AUTH_DATA
-              // из метаданных пакета в манифесте
-              { tag: 'p', children: [{ tag: 'a', id: 'auth-package-link' }] },
+              // версия пакета ИГРЫ (из манифеста) и ссылка на документацию
+              // (только в dev-сборке) — заполняет main.js по AUTH_DATA
+              { tag: 'p', children: [{ tag: 'a', id: 'auth-docs-link' }] },
               { tag: 'p', id: 'auth-version' },
               { tag: 'p', text: `© ${new Date().getFullYear()} VIMP` },
             ],

package/src/client/views/includes/auth.pug

@@ -15,10 +15,10 @@ div#auth
     div#auth-informs
 
     div#auth-link
-      //- ссылка и версия пакета ИГРЫ (мастер кладёт их в манифест, читая
-      //- package.json пакета) — проставляет main.js по AUTH_DATA; без данных
-      //- ячейки остаются пустыми
+      //- версия пакета ИГРЫ (мастер кладёт её в манифест, читая package.json
+      //- пакета) и ссылка на документацию (только в dev-сборке) —
+      //- проставляет main.js по AUTH_DATA; без данных ячейки остаются пустыми
       p
-        a#auth-package-link
+        a#auth-docs-link
       p#auth-version
       p © #{new Date().getFullYear()} VIMP

package/src/client/views/includes/lobby.pug

@@ -21,7 +21,7 @@ div#lobby(style='display:none')
             input#profile-open(type='button', value='Profile')
             input#games-open-mine(type='button', value='My games')
             input#games-open-moderation(type='button', value='Moderation', style='display:none')
-            //- журнал клиентских ошибок (plan/client-reports, этап 5): только админ
+            //- журнал клиентских ошибок: только админ
             input#reports-open(type='button', value='Errors', style='display:none')
         hr.lobby-divider
         h3.lobby-section-title= 'HOST A GAME'
@@ -67,8 +67,8 @@ div#lobby(style='display:none')
               span#leaderboard-total
             ol#lobby-leaderboard-list
             p#lobby-my-placement
-    //- футер: ссылку и версию пакета движка проставляет LobbyView
-    //- (engineVersion.js + lib/packageLink.js)
+    //- футер: ссылка на документацию статична, версию пакета движка
+    //- проставляет LobbyView (engineVersion.js)
     div#lobby-footer
       p
         a#lobby-terms-link(target='_blank', rel='noopener') Terms of Service
@@ -76,6 +76,6 @@ div#lobby(style='display:none')
         |
         a#lobby-privacy-link(target='_blank', rel='noopener') Privacy Policy
       p
-        a#lobby-link
+        a#lobby-link(href='https://docs.vimp.lgick.dev', target='_blank', rel='noopener') docs
       p#lobby-version
       p © #{new Date().getFullYear()} VIMP

package/src/client/views/includes/reports.pug

@@ -1,4 +1,4 @@
-//- Журнал клиентских ошибок (plan/client-reports, этап 5): только админ.
+//- Журнал клиентских ошибок: только админ.
 //- Панель скрыта по умолчанию — открывается кнопкой «Errors» бейджа
 //- пользователя (#lobby-user в lobby.pug); id элементов перечислены в
 //- config/lobby.js. Подписи — по-английски, как и остальное лобби