save code

game1/js/utils.js

@@ -0,0 +1,38 @@
+// utils.js — 工具函数
+
+const DEV = new URLSearchParams(location.search).has('dev');
+
+const sleep = ms => new Promise(r => setTimeout(r, ms));
+
+function dbg(msg) {
+  const el = document.getElementById('dbg');
+  if (el && el.style.display !== 'none') el.textContent = msg;
+}
+
+// TTS — 仅用于朗读文字消息内容，不用于任何 UI 反馈
+const TTS = {
+  _voices: [],
+  init() {
+    if (!window.speechSynthesis) return;
+    const load = () => { this._voices = speechSynthesis.getVoices(); };
+    load();
+    speechSynthesis.onvoiceschanged = load;
+  },
+  _pick() {
+    return this._voices.find(v => v.lang.startsWith('zh') || v.name.includes('Chinese'))
+           || this._voices[0] || null;
+  },
+  speak(text, { rate = 0.85, volume = 0.8 } = {}) {
+    return new Promise(resolve => {
+      if (!window.speechSynthesis) { resolve(); return; }
+      speechSynthesis.cancel();
+      const u = new SpeechSynthesisUtterance(text);
+      u.lang = 'zh-CN'; u.rate = rate; u.volume = volume;
+      const v = this._pick();
+      if (v) u.voice = v;
+      u.onend = resolve; u.onerror = resolve;
+      speechSynthesis.speak(u);
+    });
+  },
+  stop() { if (window.speechSynthesis) speechSynthesis.cancel(); },
+};