Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Brauseri integratsioon ja parimad tavad

Õppetund 14 / 14 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. TTS-i kasutuselevõtt veebirakenduses
  2. Brauseri koodekite tugi
  3. Safari AudioContexti probleem
  4. Blobi URL-id ja mälulekked
  5. Parimad tootmistavad
  6. Peamised punktid
  7. Kontrolli oma arusaamist

Uuendatud 3. novembril 2026, tuginedes xAI Text to Speech lehele: serveripoolne valideerimine kasutab praegust piirangut 60 000 märki päringu kohta. Allikas: Text to Speech.

TTS-i kasutuselevõtt veebirakenduses

TTS-i integreerimine brauserisse toob kaasa spetsiifilisi väljakutseid: koodekite tugi, mäluhaldus, Safari eripärad ja jõudlus. See viimane õppetund annab sulle vajaliku teadmise robustseks tootmises kasutamiseks.

Brauseri koodekite tugi

Mitte iga brauser ei toeta kõiki helivorminguid. Vali oma sihtrühmale sobiv koodek:

KoodekChromeFirefoxSafariEdgeSoovitatav
MP3JahJahJahJahJah
WAVJahJahJahJahJah
Toores PCMEiEiEiEiEi
mulaw/alawEiEiEiEiEi

Lihtne reegel: kasuta brauseris MP3-d või WAV-i. PCM, mulaw ja alaw on mõeldud serverirakendustele ja telefoniale, mitte veebis esitamiseks.

// Küsi API-lt MP3-formaati (läbi oma taustsüsteemi)
const response = await fetch("/api/tts", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    text: "Tere brauserist.",
    voice_id: "eve",
    language: "en"
    // output_format'i pole vaja määrata: MP3 on vaikimisi
  })
});

Safari AudioContexti probleem

Safari kehtestab turvapiirangu: AudioContext saab luua ainult kasutaja sündmuse käitlejas (klõps, klahvivajutus, puudutus). Kui püüad luua AudioContexti lehe laadimisel, blokeerib Safari selle vaikselt.

Vale lähenemine

// EI tööta Safaris
const audioContext = new AudioContext(); // Blokeeritud!

async function playTTS() {
  const audio = await fetchTTS("Tere");
  // audioContext on Safaris peatatud...
}

Õige lähenemine

let audioContext = null;

// Loo AudioContext kasutaja esimesel klõpsul
document.getElementById("play-btn").addEventListener("click", async () => {
  if (!audioContext) {
    audioContext = new AudioContext();
  }

  // Jätka, kui on peatatud
  if (audioContext.state === "suspended") {
    await audioContext.resume();
  }

  const response = await fetch("/api/tts", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      text: "Tere Safarist.",
      voice_id: "eve",
      language: "en"
    })
  });

  const arrayBuffer = await response.arrayBuffer();
  const audioBuffer = await audioContext.decodeAudioData(arrayBuffer);

  const source = audioContext.createBufferSource();
  source.buffer = audioBuffer;
  source.connect(audioContext.destination);
  source.start(0);
});

See lähenemine töötab igas brauseris, mitte ainult Safaris. See on hea universaalne tava.

Blobi URL-id ja mälulekked

Kui lood heli esitamiseks Blobi URL-e, kasutab iga URL mälu, kuni selle sõnaselgelt vabastad. Ilma puhastamiseta lekib sinu rakenduses mälu.

Probleem

// Iga väljakutse loob Blobi URL-i, mida kunagi ei vabastata
async function playTTS(text) {
  const response = await fetch("/api/tts", { ... });
  const blob = await response.blob();
  const url = URL.createObjectURL(blob); // Mäluleke!
  const audio = new Audio(url);
  audio.play();
}

Lahendus

async function playTTS(text) {
  const response = await fetch("/api/tts", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ text, voice_id: "eve", language: "en" })
  });

  const blob = await response.blob();
  const url = URL.createObjectURL(blob);
  const audio = new Audio(url);

  // Vabasta mälu, kui esitus lõpeb
  audio.addEventListener("ended", () => {
    URL.revokeObjectURL(url);
  });

  // Vabasta see ka vea korral
  audio.addEventListener("error", () => {
    URL.revokeObjectURL(url);
  });

  audio.play();
}

Rakenduste jaoks, mis genereerivad palju heli, hoia aktiivsete URL-ide nimekirja ja puhasta seda perioodiliselt:

class AudioManager {
  constructor() {
    this.activeUrls = new Set();
  }

  async play(text) {
    const response = await fetch("/api/tts", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ text, voice_id: "eve", language: "en" })
    });

    const blob = await response.blob();
    const url = URL.createObjectURL(blob);
    this.activeUrls.add(url);

    const audio = new Audio(url);
    audio.addEventListener("ended", () => this.release(url));
    audio.addEventListener("error", () => this.release(url));
    audio.play();
    return audio;
  }

  release(url) {
    URL.revokeObjectURL(url);
    this.activeUrls.delete(url);
  }

  cleanup() {
    // Vabasta iga aktiivne URL
    for (const url of this.activeUrls) {
      URL.revokeObjectURL(url);
    }
    this.activeUrls.clear();
  }
}

Parimad tootmistavad

Taustsüsteemi kiiruse piiramine

Kaitse oma taustsüsteemi kuritarvitamise eest, piirates kasutaja kohta tehtavate päringute arvu:

const rateLimit = require("express-rate-limit");

const ttsLimiter = rateLimit({
  windowMs: 60 * 1000, // 1 minut
  max: 10, // 10 päringut minutis IP-aadressi kohta
  message: { error: "Liiga palju TTS-päringuid" }
});

app.post("/api/tts", ttsLimiter, async (req, res) => {
  // ... edastamine xAI API-le
});

Teksti valideerimine

Valideeri ja puhasta tekst enne API-le saatmist:

function validateTTSInput(text) {
  if (!text || typeof text !== "string") {
    throw new Error("Tekst on nõutav");
  }
  if (text.length > 60000) {
    throw new Error("Tekst on liiga pikk (maksimaalselt 60 000 märki)");
  }
  // Eemalda juhtmärgid
  return text.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, "");
}

Heli vahemällu salvestamine

Korduvate tekstide (tervitused, standardsed juhised) jaoks salvesta genereeritud heli vahemällu:

const audioCache = new Map();

async function getTTS(text, voice, language) {
  const cacheKey = `${text}:${voice}:${language}`;

  if (audioCache.has(cacheKey)) {
    return audioCache.get(cacheKey);
  }

  const audio = await fetchTTSFromAPI(text, voice, language);
  audioCache.set(cacheKey, audio);
  return audio;
}

Eelgeneratsioon

Sisu jaoks, mida tead ette (e-õpe, IVR), genereeri helifailid ehitusajal, mitte reaalajas.

Peamised punktid

  • Kasuta brauseris MP3-d või WAV-i, mitte kunagi PCM/mulaw/alaw
  • Safaris loo AudioContext kasutaja sündmuse käitleja sees
  • Vabasta alati Blobi URL-id funktsiooniga URL.revokeObjectURL() pärast kasutamist
  • Lisa oma taustsüsteemi proksile kiiruse piiramine
  • Valideeri ja puhasta tekst enne API-le saatmist
  • Salvesta korduvate tekstide heli vahemällu, et säästa API-kõnesid
  • Genereeri heli ette sisu jaoks, mida tead ette

Kontrolli oma arusaamist

xAI kõnesüntees: esimesest kõnest voogedastuseni.

1. Kuidas toimib põhiline TTS-kõne?

Vastus: POST-päring aadressile /v1/tts koos teksti, valitud häälega (mille saad API kaudu loetleda) ja parameetritega. Vastuseks on heli, mida arveldatakse sünteesitud mahu järgi.

2. Mida võimaldavad väljendusrikkad sildid?

Vastus: Juhtida kõnet teksti seest: reaalsised ja ümbritsevad sildid intonatsiooni, pauside ja rõhuasetuse jaoks, mida saad kombineerida loomulikuks ja suunatud lugemiseks.

3. Millal peaksid üle minema TTS WebSocketile?

Vastus: Reaalaja jaoks: tekst väljub voona ja heli saabub pidevalt. See on LLM → TTS torustike alus, kus hääl algab enne genereerimise lõppu.

4. Kuidas turvad brauseri integratsiooni?

Vastus: Ära kunagi pane API võtit kliendile: brauser suhtleb läbi sinu serveri või kasutab lühiajalisi mandaate ning sa käitled HTTP-vigu korrektselt.

5. Kuidas näeb välja täielik tootmistorustik?

Vastus: Voogedastav LLM → tekstilõigud → TTS WebSocket → heliesitus. Iga lüli voogedastab, nii et tajutav latentsus kukub kokku, ja selle kursuse parimad tavad sulgevad ahela.

Sildid väljendusrikkuse jaoks, WebSocket reaalaja jaoks, sinu server saladuste jaoks: sinu rakendused on valmis rääkima.