primocode 7.18.0 → 8.0.1

package/studio/web/js/narracao.js

@@ -0,0 +1,254 @@
+/* ==========================================================================
+   narracao.js — locução.
+
+   Três caminhos, do melhor para o pior:
+     1. VOZ GRAVADA  — o usuário grava com o microfone. Sempre ganha.
+     2. VOZ PREMIUM  — voz aprimorada do sistema, se estiver instalada.
+     3. VOZ PADRÃO   — síntese compacta do sistema. Serve para rascunho.
+
+   As vozes de brincadeira da Apple (Eddy, Grandma, Rocko…) ficam escondidas:
+   existem no sistema, mas não servem para narrar nada.
+   ========================================================================== */
+
+var Narracao = (function () {
+  "use strict";
+
+  var sintese = window.speechSynthesis || null;
+  var cacheVozes = [];
+  var cancelado = false;
+
+  /* Vozes de novidade do macOS — som proposital de desenho animado. */
+  var NOVIDADE = /^(albert|bad news|bahh|bells|boing|bubbles|cellos|deranged|good news|jester|junior|kathy|organ|pipe organ|princess|ralph|superstar|trinoids|whisper|wobble|zarvox|fred|hysterical|eddy|flo|grandma|grandpa|reed|rocko|sandy|shelley|bruce|agnes|vicki|victoria|alice|alva|damayanti|fiona|moira|tessa|veena|rishi|karen|melina|xander)\b/i;
+
+  var PREMIUM = /premium|enhanced|aprimorad|neural|siri/i;
+
+  /* "Joana (português (Portugal))" → "Joana" — os parênteses aninham, então
+     corta a partir do primeiro em vez de tentar casar os pares. */
+  function limpo(nome) {
+    return String(nome || "").split(/\s*\(/)[0].trim() || String(nome || "");
+  }
+
+  function disponivel() { return !!sintese; }
+
+  /* nota de qualidade: quanto maior, melhor a voz para narrar */
+  function nota(v) {
+    var n = 0;
+    if (PREMIUM.test(v.name)) n += 100;
+    if (/pt[-_]?BR/i.test(v.lang)) n += 40;
+    else if (/^pt/i.test(v.lang)) n += 25;
+    if (v.localService) n += 5;
+    if (NOVIDADE.test(limpo(v.name))) n -= 200;
+    return n;
+  }
+
+  function vozes(op) {
+    op = op || {};
+    if (!sintese) return [];
+    var v = sintese.getVoices() || [];
+    if (v.length) cacheVozes = v;
+    var lista = cacheVozes.slice();
+    if (!op.todas) {
+      var uteis = lista.filter(function (x) { return !NOVIDADE.test(limpo(x.name)); });
+      if (uteis.length) lista = uteis;
+    }
+    if (op.idioma !== false) {
+      var pt = lista.filter(function (x) { return /^pt/i.test(x.lang); });
+      if (pt.length && !op.todosIdiomas) lista = pt;
+    }
+    // o sistema às vezes repete a mesma voz; fica só uma de cada
+    var vistas = {};
+    lista = lista.filter(function (v) {
+      var chave = limpo(v.name) + "|" + v.lang;
+      if (vistas[chave]) return false;
+      vistas[chave] = true;
+      return true;
+    });
+
+    return lista.sort(function (a, b) { return nota(b) - nota(a) || a.name.localeCompare(b.name); });
+  }
+
+  function melhorVoz() {
+    var v = vozes()[0];
+    return v ? v.name : null;
+  }
+
+  /* Quantas vozes boas existem: se der zero, vale avisar o usuário. */
+  function diagnostico() {
+    var todas = (sintese && sintese.getVoices()) || cacheVozes;
+    var pt = todas.filter(function (v) { return /^pt/i.test(v.lang); });
+    return {
+      total: todas.length,
+      portugues: pt.length,
+      premium: todas.filter(function (v) { return PREMIUM.test(v.name); }).length,
+      boasEmPortugues: pt.filter(function (v) { return !NOVIDADE.test(limpo(v.name)); }).length,
+      melhor: melhorVoz(),
+    };
+  }
+
+  function prontas() {
+    return new Promise(function (ok) {
+      if (!sintese) return ok([]);
+      if (vozes().length) return ok(vozes());
+      var t = setTimeout(function () { ok(vozes()); }, 1200);
+      sintese.addEventListener("voiceschanged", function so() {
+        clearTimeout(t);
+        sintese.removeEventListener("voiceschanged", so);
+        ok(vozes());
+      });
+    });
+  }
+
+  /* ------------------------------------------------------------ prosódia -- */
+
+  /* Fala corrida soa robótica. Quebrar em frases e respirar entre elas é o
+     que mais aproxima de uma locução de verdade. */
+  function emFrases(texto) {
+    return String(texto || "")
+      .split(/(?<=[.!?…:])\s+|\n+/)
+      .map(function (f) { return f.trim(); })
+      .filter(Boolean);
+  }
+
+  function pausaDe(frase) {
+    if (/[?!]$/.test(frase)) return 420;
+    if (/[.…]$/.test(frase)) return 340;
+    if (/:$/.test(frase)) return 260;
+    return 180;
+  }
+
+  function montar(texto, cfg) {
+    cfg = cfg || {};
+    var f = new SpeechSynthesisUtterance(String(texto || ""));
+    f.lang = cfg.idioma || "pt-BR";
+    // um pouco mais devagar que o padrão soa menos apressado
+    f.rate = cfg.velocidade != null ? cfg.velocidade : 0.96;
+    f.pitch = cfg.tom != null ? cfg.tom : 1;
+    f.volume = cfg.volume != null ? cfg.volume : 1;
+
+    var alvo = cfg.voz || melhorVoz();
+    if (alvo) {
+      var achou = (sintese.getVoices() || cacheVozes).filter(function (v) {
+        return v.name === alvo;
+      })[0];
+      if (achou) { f.voice = achou; f.lang = achou.lang; }
+    }
+    return f;
+  }
+
+  function falarUma(texto, cfg) {
+    return new Promise(function (ok) {
+      var f = montar(texto, cfg);
+      f.onend = f.onerror = function () { ok(); };
+      sintese.speak(f);
+    });
+  }
+
+  /* Fala o texto inteiro, frase a frase, com respiro entre elas. */
+  function falar(texto, cfg) {
+    if (!sintese || !String(texto || "").trim()) return Promise.resolve(0);
+    parar();
+    cancelado = false;
+
+    var frases = emFrases(texto);
+    var t0 = performance.now();
+
+    return frases.reduce(function (corrente, frase) {
+      return corrente.then(function () {
+        if (cancelado) return;
+        return falarUma(frase, cfg).then(function () {
+          if (cancelado) return;
+          return new Promise(function (r) { setTimeout(r, pausaDe(frase)); });
+        });
+      });
+    }, Promise.resolve()).then(function () {
+      return (performance.now() - t0) / 1000;
+    });
+  }
+
+  /* Mede quanto tempo a fala leva, sem ninguém ouvir. */
+  function medir(texto, cfg) {
+    var c = {};
+    for (var k in (cfg || {})) c[k] = cfg[k];
+    c.volume = 0;
+    return falar(texto, c);
+  }
+
+  function parar() {
+    cancelado = true;
+    if (!sintese) return;
+    try { sintese.cancel(); } catch (_) {}
+  }
+
+  function falando() { return !!sintese && sintese.speaking; }
+
+  function estimar(texto, velocidade) {
+    var palavras = String(texto || "").trim().split(/\s+/).filter(Boolean).length;
+    if (!palavras) return 0;
+    var frases = emFrases(texto).length;
+    return Math.max(1.2, palavras / (2.6 * (velocidade || 0.96)) + frases * 0.32);
+  }
+
+  /* -------------------------------------------------- gravar a própria voz */
+
+  var gravador = null, fluxoMic = null, pedacos = [];
+
+  function podeGravar() {
+    return !!(navigator.mediaDevices && navigator.mediaDevices.getUserMedia &&
+              window.MediaRecorder);
+  }
+
+  /* Grava do microfone e devolve {url, nome} já salvo na biblioteca. */
+  function gravar() {
+    if (!podeGravar()) return Promise.reject(new Error("este navegador não grava áudio"));
+    return navigator.mediaDevices.getUserMedia({
+      audio: { echoCancellation: true, noiseSuppression: true, autoGainControl: true },
+    }).then(function (fluxo) {
+      fluxoMic = fluxo;
+      pedacos = [];
+      var tipo = MediaRecorder.isTypeSupported("audio/webm;codecs=opus")
+        ? "audio/webm;codecs=opus"
+        : (MediaRecorder.isTypeSupported("audio/mp4") ? "audio/mp4" : "");
+      gravador = new MediaRecorder(fluxo, tipo ? { mimeType: tipo } : undefined);
+      gravador.ondataavailable = function (e) { if (e.data.size) pedacos.push(e.data); };
+      gravador.start();
+      return true;
+    });
+  }
+
+  function pararGravacao(nomeBase) {
+    return new Promise(function (ok, falha) {
+      if (!gravador || gravador.state !== "recording") return falha(new Error("nada gravando"));
+      gravador.onstop = function () {
+        if (fluxoMic) fluxoMic.getTracks().forEach(function (f) { f.stop(); });
+        var mime = gravador.mimeType || "audio/webm";
+        var blob = new Blob(pedacos, { type: mime });
+        var ext = /mp4/.test(mime) ? ".m4a" : ".weba";
+        var leitor = new FileReader();
+        leitor.onload = function () {
+          fetch("/api/midia", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+              nome: (nomeBase || "narracao") + ext,
+              dados: leitor.result,
+            }),
+          }).then(function (r) { return r.json(); })
+            .then(function (m) { m.erro ? falha(new Error(m.erro)) : ok(m); })
+            .catch(falha);
+        };
+        leitor.onerror = function () { falha(new Error("não consegui ler a gravação")); };
+        leitor.readAsDataURL(blob);
+      };
+      gravador.stop();
+    });
+  }
+
+  function gravando() { return !!gravador && gravador.state === "recording"; }
+
+  return {
+    disponivel: disponivel, vozes: vozes, prontas: prontas, melhorVoz: melhorVoz,
+    diagnostico: diagnostico, limpo: limpo,
+    falar: falar, medir: medir, parar: parar, falando: falando, estimar: estimar,
+    podeGravar: podeGravar, gravar: gravar, pararGravacao: pararGravacao, gravando: gravando,
+  };
+})();