Translator and Language Detector APIs

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die Übersetzungs- und Spracherkennungs-APIs bieten Funktionen zur Erkennung der Sprache, in der ein Text geschrieben ist, und zur Übersetzung von Texten in verschiedene Sprachen über das interne KI-Modell eines Browsers (was sich je nach Browser unterscheiden kann).

Konzepte und Nutzung

Die Übersetzung von Texten ist eine häufige Aufgabe im heutigen Internet. Typische Anwendungsfälle umfassen:

  • Die sofortige Übersetzung eines Artikels, der in Ihrer Sprache nicht verfügbar ist.
  • Die Übersetzung der Supportanfragen eines Benutzers in eine Sprache, die der Support-Mitarbeiter versteht.
  • Die Ermöglichung von Chats zwischen Benutzern, die nicht die Sprache des jeweils anderen sprechen.

Die Erkennung der Sprache eines Textes ist eine wichtige Voraussetzung für eine erfolgreiche automatisierte Übersetzung, hat aber auch andere Anwendungsbereiche als die direkte Übersetzung. Zum Beispiel ermöglicht sie die automatische Konfiguration der Benutzeroberfläche basierend auf der Benutzereingabe, von der Aktualisierung der Benutzeroberfläche und Fehlermeldungen bis hin zum automatischen Laden geeigneter Wörterbücher für die Rechtschreibprüfung oder die Erkennung von Schimpfwörtern.

KI eignet sich gut zur Erleichterung der Spracherkennung und -übersetzung. Die Übersetzungs- und Spracherkennungs-APIs bieten asynchrone (Promise-basierte) Mechanismen für eine Website zur Spracherkennung und Textübersetzung über das interne KI-Modell des Browsers. Dies ist nützlich und effizient, da der Browser den Dienst übernimmt, anstatt dass der Entwickler darauf angewiesen ist, dass der Benutzer KI-Modelle herunterlädt oder einen cloudbasierten Übersetzungsdienst hostet oder bezahlt.

  • Die Spracherkennung erfolgt über das LanguageDetector-Interface. Ein LanguageDetector-Objekt wird mit der statischen Methode LanguageDetector.create() erstellt, dann wird die Instanzmethode detect() mit dem zu erkennenden Textzeichenfolge übergeben.
  • Die Übersetzung erfolgt über das Translator-Interface. Ein Translator-Objekt wird mit der statischen Methode Translator.create() erstellt, dann wird die Instanzmethode translate() mit der zu übersetzenden Textzeichenfolge übergeben.

Sie können auch ausstehende Operationen mit einem AbortController abbrechen.

Die Translator- und LanguageDetector-Instanzen verbrauchen viele Ressourcen, daher wird empfohlen, sie mit der Instanzmethode destroy() zu entfernen, sobald Sie fertig sind (zum Beispiel Translator.destroy()).

Sehen Sie sich die Verwendung der Übersetzungs- und Spracherkennungs-APIs für eine Anleitung zur Nutzung der APIs an.

Schnittstellen

LanguageDetector Experimentell

Beinhaltet alle Funktionen zur Spracherkennung, einschließlich der Überprüfung der Verfügbarkeit des KI-Modells, der Erstellung einer neuen LanguageDetector-Instanz, deren Verwendung zur Erkennung einer Sprache und mehr.

Translator Experimentell

Beinhaltet alle Übersetzungsfunktionen, einschließlich der Überprüfung der Verfügbarkeit des KI-Modells, der Erstellung einer neuen Translator-Instanz, deren Verwendung zur Erstellung einer Übersetzung und mehr.

HTTP-Header

Permissions-Policy; die language-detector-Direktive

Steuert den Zugriff auf die Spracherkennungsfunktionalität. Wenn eine Richtlinie deren Verwendung ausdrücklich untersagt, schlägt jeder Versuch, die LanguageDetector-Methoden aufzurufen, mit einem NotAllowedError-DOMException fehl.

Permissions-Policy; die translator-Direktive

Steuert den Zugriff auf die Übersetzungsfunktionalität. Wenn eine Richtlinie deren Verwendung ausdrücklich untersagt, schlägt jeder Versuch, die Translator-Methoden aufzurufen, mit einem NotAllowedError-DOMException fehl.

Sicherheitsüberlegungen

Die Erstellung von LanguageDetector- und Translator-Objekten setzt voraus, dass der Benutzer kürzlich mit der Seite interagiert hat (vorübergehende Benutzeraktivierung ist erforderlich).

Der Zugriff auf die API wird auch durch die language-detector- und translator-Permissions-Policy-Direktiven gesteuert.

Beispiele

Für ein vollständiges Beispiel siehe Verwendung der Übersetzungs- und Spracherkennungs-APIs.

Spezifikationen

Specification
Unknown specification

Browser-Kompatibilität

Siehe auch