chrome.ttsEngine

Beschreibung

Berechtigungen

Konzepte und Verwendung

Eine Erweiterung kann sich selbst als Sprach-Engine registrieren. Dadurch können einige oder alle Aufrufe auf Funktionen wie tts.speak() und tts.stop() und stellen eine alternative Implementierung bereit. Bei den Erweiterungen kann für die Sprachausgabe, einschließlich Streaming von Audio, jede verfügbare Webtechnologie kostenlos verwendet werden. von einem Server, HTML5-Audio. Eine Erweiterung kann sogar etwas anderes bewirken, mit den Äußerungen, z. B. Untertitel in einem Pop-up anzeigen oder als Log-Nachrichten an einen Remote-Server.

Zum Implementieren einer Text-in-Sprache-Engine muss eine Erweiterung den Parameter „ttsEngine“ deklarieren. und erklären dann, Stimmen im Erweiterungsmanifest zur Verfügung:

{
  "name": "My TTS Engine",
  "version": "1.0",
  "permissions": ["ttsEngine"],
  "tts_engine": {
    "voices": [
      {
        "voice_name": "Alice",
        "lang": "en-US",
        "event_types": ["start", "marker", "end"]
      },
      {
        "voice_name": "Pat",
        "lang": "en-US",
        "event_types": ["end"]
      }
    ]
  },
  "background": {
    "page": "background.html",
    "persistent": false
  }
}

In einer Erweiterung kann eine beliebige Anzahl von Stimmen angegeben werden.

Der Parameter voice_name ist erforderlich. Der Name sollte aussagekräftig genug sein, um Name der verwendeten Stimme und Suchmaschine. Im unwahrscheinlichen Fall, dass zwei Erweiterungen Stimmen registrieren mit demselben Namen kann ein Client die ID der Erweiterung angeben, die die Synthese durchführen soll.

Der Parameter lang ist optional, wird aber dringend empfohlen. Fast immer kann eine Stimme synthetisieren, in nur einer Sprache sprechen. Wenn eine Suchmaschine mehr als eine Sprache unterstützt, kann sie problemlos Für jede Sprache eine eigene Stimme registrieren In seltenen Fällen, in denen eine einzelne Stimme mehrere Sprachen unterstützt, ist es am einfachsten, zwei unterschiedliche Stimmen aufzulisten und diese mit dieselbe Logik intern. Wenn Sie jedoch eine Stimme erstellen möchten, die Äußerungen in beliebigen Sprache zu verwenden, lassen Sie den lang-Parameter im Manifest der Erweiterung weg.

Der Parameter event_types ist schließlich erforderlich, wenn die Suchmaschine Ereignisse zum Aktualisieren des Clients senden kann. den Fortschritt der Sprachsynthese. Es wird mindestens der Ereignistyp 'end' unterstützt, um anzugeben, nach Abschluss der Sprachausgabe wird dringend empfohlen, da Chrome andernfalls keine Äußerungen in der Warteschlange planen kann.

Nach dem Laden kann eine Erweiterung die Liste der deklarierten Stimmen durch folgenden Aufruf ersetzen: chrome.ttsEngine.updateVoices Beachten Sie, dass die im programmatischen Aufruf von updateVoices sind in der Camel-Case-Schreibweise angegeben, z.B. voiceName, im Gegensatz zur Manifestdatei, in der voice_name)

Die möglichen Ereignistypen, die Sie senden können, entsprechen den Ereignistypen, die in der Methode speak() verwendet werden. erhält:

• 'start': Die Suchmaschine hat mit der Aussprache der Äußerung begonnen.
• 'word': Eine Wortgrenze wurde erreicht. event.charIndex verwenden, um die aktuelle Sprache zu bestimmen .
• 'sentence': Eine Satzgrenze wurde erreicht. Mit event.charIndex ermitteln Sie den aktuellen Sprechposition.
• 'marker': Eine SSML-Markierung wurde erreicht. event.charIndex verwenden, um die aktuelle Sprache zu bestimmen .
• 'end': Die Suchmaschine hat die Äußerung vollständig gesprochen.
• 'error': Es ist ein suchmaschinenspezifischer Fehler aufgetreten und diese Äußerung kann nicht gesprochen werden. Mehr bestehen Informationen in event.errorMessage.

Die Ereignisse 'interrupted' und 'cancelled' werden nicht von der Sprach-Engine gesendet. Sie werden generiert. automatisch von Chrome.

Sprachausgabe-Clients können die Sprachinformationen aus dem Manifest Ihrer Erweiterung abrufen, indem sie folgende URL aufrufen: tts.getVoices, vorausgesetzt, Sie haben Sprachereignis-Listener wie unten beschrieben registriert.

Sprachereignisse verarbeiten

Um auf Anfrage von Clients Sprache zu generieren, muss Ihre Erweiterung Listener für beides registrieren onSpeak und onStop, wie hier:

const speakListener = (utterance, options, sendTtsEvent) => {
  sendTtsEvent({type: 'start', charIndex: 0})

  // (start speaking)

  sendTtsEvent({type: 'end', charIndex: utterance.length})
};

const stopListener = () => {
  // (stop all speech)
};

chrome.ttsEngine.onSpeak.addListener(speakListener);
chrome.ttsEngine.onStop.addListener(stopListener);

Die Entscheidung, ob eine bestimmte Sprachanfrage an eine Erweiterung gesendet wird, beruht ausschließlich auf Ob die Erweiterung die angegebenen Sprachparameter in ihrem Manifest unterstützt und registriert wurde Listener für onSpeak und onStop. Mit anderen Worten: Eine Erweiterung erhält keine Sprachanfrage und entscheidet dynamisch, ob sie verarbeitet werden soll.

chrome.ttsEngine.updateVoices(
  voices: TtsVoice[],
)

chrome.ttsEngine.onPause.addListener(
  callback: function,
)

chrome.ttsEngine.onResume.addListener(
  callback: function,
)

chrome.ttsEngine.onSpeak.addListener(
  callback: function,
)

chrome.ttsEngine.onSpeakWithAudioStream.addListener(
  callback: function,
)

chrome.ttsEngine.onStop.addListener(
  callback: function,
)