Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Comhtháthú brabhsálaire agus dea-chleachtais

Ceacht 14 as 14 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. TTS a chur in úsáid in aip ghréasáin
  2. Tacaíocht codec sa bhrabhsálaí
  3. Fadhb AudioContext i Safari
  4. URLanna Blob agus sceitheadh cuimhne
  5. Dea-chleachtais táirgeachta
  6. Príomhphointí
  7. Seiceáil do thuiscint

Nuashonraithe an 3 Samhain, 2026, bunaithe ar leathanach Text to Speech xAI: úsáideann bailíochtú taobh an fhreastalaí an teorainn reatha de 60,000 carachtar in aghaidh na hiarratais. Foinse: Text to Speech.

TTS a chur in úsáid in aip ghréasáin

Tagann dúshláin shonracha le TTS a chomhtháthú i mbrabhsálaí: tacaíocht codec, bainistiú cuimhne, saincheisteanna Safari, agus feidhmíocht. Tugann an ceacht deireanach seo duit gach rud atá uait le haghaidh comhtháthú láidir táirgeachta.

Tacaíocht codec sa bhrabhsálaí

Ní thacaíonn gach brabhsálaí le gach formáid fuaime. Roghnaigh an codec ceart do do lucht éisteachta:

CodecChromeFirefoxSafariEdgeMolta
MP3TáTáTáTáTá
WAVTáTáTáTáTá
PCM AmhNílNílNílNílNíl
mulaw/alawNílNílNílNílNíl

An riail shimplí: úsáid MP3 nó WAV sa bhrabhsálaí. Tá PCM, mulaw, agus alaw ceaptha d’aip freastalaí agus teileafónaíocht, ní do sheinm ghréasáin.

// Iarr MP3 ón API (trí do chúlchríoch)
const response = await fetch("/api/tts", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    text: "Hello from the browser.",
    voice_id: "eve",
    language: "en"
    // Ní gá output_format a shocrú: is é MP3 an réamhshocrú
  })
});

Fadhb AudioContext i Safari

Cuirtear srian slándála i bhfeidhm ag Safari: ní féidir AudioContext a chruthú ach laistigh de láimhseálaí imeachta úsáideora (cliceáil, brú eochrach, tapáil). Má dhéanann tú iarracht AudioContext a chruthú nuair a lódálann an leathanach, cuireann Safari bac air go ciúin.

An cur chuige mícheart

// NÍ OIBRÍONN sé seo i Safari
const audioContext = new AudioContext(); // Bacaithe!

async function playTTS() {
  const audio = await fetchTTS("Hello");
  // tá audioContext ar fionraí i Safari...
}

An cur chuige ceart

let audioContext = null;

// Cruthaigh an AudioContext ar an gcéad chliceáil ón úsáideoir
document.getElementById("play-btn").addEventListener("click", async () => {
  if (!audioContext) {
    audioContext = new AudioContext();
  }

  // Tosaigh arís má tá sé ar fionraí
  if (audioContext.state === "suspended") {
    await audioContext.resume();
  }

  const response = await fetch("/api/tts", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      text: "Hello from Safari.",
      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);
});

Oibríonn an cur chuige seo i ngach brabhsálaí, ní hamháin i Safari. Is dea-chleachtas uilíoch é.

URLanna Blob agus sceitheadh cuimhne

Nuair a chruthaíonn tú URLanna Blob chun fuaim a sheinm, úsáideann gach URL cuimhne go dtí go scaoileann tú go sainráite í. Gan glanadh, déanfaidh do aip sceitheadh cuimhne.

An fhadhb

// Cruthaíonn gach glao URL Blob nach scaoiltear riamh
async function playTTS(text) {
  const response = await fetch("/api/tts", { ... });
  const blob = await response.blob();
  const url = URL.createObjectURL(blob); // Sceitheadh cuimhne!
  const audio = new Audio(url);
  audio.play();
}

An réiteach

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);

  // Scaoil an chuimhne nuair a chríochnaíonn an seinm
  audio.addEventListener("ended", () => {
    URL.revokeObjectURL(url);
  });

  // Scaoil é freisin ar earráid
  audio.addEventListener("error", () => {
    URL.revokeObjectURL(url);
  });

  audio.play();
}

D’aipeanna a ghineann go leor fuaime, coinnigh liosta de URLanna gníomhacha agus glan iad go tréimhsiúil:

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() {
    // Scaoil gach URL gníomhach
    for (const url of this.activeUrls) {
      URL.revokeObjectURL(url);
    }
    this.activeUrls.clear();
  }
}

Dea-chleachtais táirgeachta

Teorannú ráta ar an gcúlchríoch

Cosain do chúlchríoch ó mhí-úsáid trí theorainn a chur le hiarratais in aghaidh an úsáideora:

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

const ttsLimiter = rateLimit({
  windowMs: 60 * 1000, // 1 nóiméad
  max: 10, // 10 n-iarratas in aghaidh an nóiméid in aghaidh an IP
  message: { error: "Too many TTS requests" }
});

app.post("/api/tts", ttsLimiter, async (req, res) => {
  // ... seachas chuig an API xAI
});

Bailíochtú téacs

Bailíochtaigh agus glan an téacs sula seolann tú chuig an API é:

function validateTTSInput(text) {
  if (!text || typeof text !== "string") {
    throw new Error("Text is required");
  }
  if (text.length > 60000) {
    throw new Error("Text too long (60,000 characters max)");
  }
  // Bain carachtair rialaithe
  return text.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, "");
}

Caiséáil fuaime

Le haghaidh téacsanna arna n-athrá (beannachtaí, treoracha caighdeánacha), déan caiséal ar an bhfuaim ghinte:

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;
}

Réamhghiniúint

Le haghaidh ábhair atá ar eolas agat roimh ré (ríomhfhoghlaim, IVR), déan na comhaid fuaime a réamhghiniúint ag am tógála seachas ar an eitilt.

Príomhphointí

  • Úsáid MP3 nó WAV sa bhrabhsálaí, ná húsáid PCM/mulaw/alaw riamh
  • I Safari, cruthaigh an AudioContext laistigh de láimhseálaí imeachta úsáideora
  • Scaoil URLanna Blob i gcónaí le URL.revokeObjectURL() tar éis úsáide
  • Cuir teorannú ráta le do sheachasóir cúil
  • Bailíochtaigh agus glan téacs sula seolann tú chuig an API é
  • Déan caiséal ar an bhfuaim do théacsanna arna n-athrá chun glaonna API a shábháil
  • Déan fuaim a réamhghiniúint d’ábhar atá ar eolas agat roimh ré

Seiceáil do thuiscint

Sintéis cainte xAI: ón gcéad ghlao go dtí an píblíne sruthaithe.

1. Conas a oibríonn an glao TTS bunúsach?

Freagra: POST chuig /v1/tts leis an téacs, an ghuth roghnaithe (is féidir leat liosta a dhéanamh de tríd an API), agus na paraiméadair. Is í an fhreagra ná an fhuaime, agus déantar billeáil de réir an toirte a sintéiseadh.

2. Cad a ligeann clibeanna sloinnte duit a dhéanamh?

Freagra: Rialú cainte laistigh den téacs: clibeanna inline agus timfhilleadh le haghaidh intanaithe, sosanna, agus béime, ar féidir leat a chomhcheangal le haghaidh léamh nádúrtha, treoraithe.

3. Cathin ar chóir duit aistriú go TTS WebSocket?

Freagra: Le haghaidh fíor-ama: téann an téacs amach mar shruth agus tagann an fhuaime ar ais go leanúnach. Is é bunús píblíní LLM → TTS é, á dtosaíonn an ghuth sula bhfuil an ghiniúint críochnaithe.

4. Conas a dhéanann tú comhtháthú brabhsálaire a dhaingniú?

Freagra: Ná cuir an eochair API riamh sa chliant: téann an brabhsálaí trí do fhreastalaí nó úsáideann sé creidiúintí gearrthéarmacha, agus láimhseálann tú earráidí HTTP i gceart.

5. Cén chuma atá ar an bpíblíne táirgeachta iomlán?

Freagra: LLM sruthaithe → codanna téacs → TTS WebSocket → seinm fuaime. Déanann gach nasc sruthú, mar sin titann an mhoill mheasta, agus dúnann na dea-chleachtais ón gcúrsa seo an lúb.

Clibeanna le haghaidh sloinnte, WebSocket le haghaidh fíor-ama, do fhreastalaí le haghaidh rúin: tá do chuid aipeanna réidh le labhairt.