wykrywanie języka za pomocą wbudowanej AI;

Thomas Steiner

Data publikacji: 24 września 2024 r., ostatnia aktualizacja: 20 maja 2025 r.

Zanim przetłumaczysz tekst z jednego języka na inny, musisz najpierw określić, w jakim języku jest on napisany. Wcześniej tłumaczenie wymagało przesłania tekstu do usługi w chmurze, przetłumaczenia go na serwerze, a następnie pobrania wyników.

Interfejs Language Detector API działa po stronie klienta, co oznacza, że możesz chronić prywatność użytkowników. Możesz udostępnić konkretną bibliotekę, która to robi, ale będzie ona wymagać pobrania dodatkowych zasobów.

Kiedy używać wykrywania języka

Interfejs Language Detector API jest przydatny przede wszystkim w tych przypadkach:

• Określanie języka tekstu wejściowego, aby można go było przetłumaczyć.
• Określanie języka tekstu wejściowego, aby można było wczytać odpowiedni model do zadań specyficznych dla danego języka, takich jak wykrywanie toksyczności.
• Określanie języka tekstu wejściowego, aby można go było prawidłowo oznaczyć, np. w internetowych serwisach społecznościowych.
• Określanie języka tekstu wejściowego, aby można było odpowiednio dostosować interfejs aplikacji. Na przykład w belgijskiej witrynie, aby wyświetlać interfejs tylko użytkownikom, którzy mówią po francusku.

Rozpocznij

Uruchom wykrywanie funkcji, aby sprawdzić, czy przeglądarka obsługuje interfejs Language Detector API.

if ('LanguageDetector' in self) {
  // The Language Detector API is available.
}

Pobieranie modelu

Wykrywanie języka zależy od modelu, który jest dostrojony do konkretnego zadania wykrywania języków. Interfejs API jest wbudowany w przeglądarkę, ale model jest pobierany na żądanie, gdy witryna po raz pierwszy próbuje użyć interfejsu API. W Chrome ten model jest bardzo mały w porównaniu z innymi modelami. Może być już obecny, ponieważ jest używany przez inne funkcje Chrome.

Aby sprawdzić, czy model jest gotowy do użycia, wywołaj asynchroniczną LanguageDetector.availability() funkcję. Jeśli odpowiedź na availability() to downloadable, nasłuchuj postępu pobierania i informuj o nim użytkownika, ponieważ pobieranie może potrwać.

Aby rozpocząć pobieranie i utworzyć instancję detektora języka, sprawdź aktywację użytkownika. Następnie wywołaj asynchroniczną funkcję LanguageDetector.create().

const detector = await LanguageDetector.create({
  monitor(m) {
    m.addEventListener('downloadprogress', (e) => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  },
});

Uruchamianie detektora języka

Interfejs Language Detector API używa modelu rankingowego, aby określić, który język jest najbardziej prawdopodobny w danym fragmencie tekstu. Ranking to rodzaj uczenia maszynowego, w którym celem jest uporządkowanie listy elementów. W tym przypadku interfejs Language Detector API szereguje języki od największego do najmniejszego prawdopodobieństwa.

Funkcja detect() może zwrócić pierwszy wynik, najbardziej prawdopodobną odpowiedź lub iterować po kandydatach z poziomem ufności. Jest to zwracane jako lista obiektów {detectedLanguage, confidence}. Poziom confidence jest wyrażony jako wartość od 0.0 (najniższy poziom ufności) do 1.0 (najwyższy poziom ufności).

const someUserText = 'Hallo und herzlich willkommen!';
const results = await detector.detect(someUserText);
for (const result of results) {
  // Show the full list of potential languages with their likelihood, ranked
  // from most likely to least likely. In practice, one would pick the top
  // language(s) that cross a high enough threshold.
  console.log(result.detectedLanguage, result.confidence);
}
// (Output truncated):
// de 0.9993835687637329
// en 0.00038279531872831285
// nl 0.00010798392031574622
// ...

Obszar testowy interfejsu API

Eksperymentuj z interfejsem Language Detector API w naszym obszarze testowym. Wpisz w polu tekstowym tekst napisany w różnych językach.

Zasady dotyczące uprawnień, elementy iframe i Web Workers

Domyślnie interfejs Language Detector API jest dostępny tylko w oknach najwyższego poziomu i w elementach iframe z tej samej domeny. Dostęp do interfejsu API można przekazać elementom iframe z innych domen za pomocą atrybutu zasad dotyczących uprawnień allow="":

<!--
  The hosting site at https://main.example.com can grant a cross-origin iframe
  at https://cross-origin.example.com/ access to the Language Detector API by
  setting the `allow="language-detector"` attribute.
-->
<iframe src="https://cross-origin.example.com/" allow="language-detector"></iframe>

Interfejs Language Detector API nie jest dostępny w Web Workers. Wynika to ze złożoności ustalenia odpowiedzialnego dokumentu dla każdego pracownika w celu sprawdzenia stanu zgodności z zasadami dotyczącymi uprawnień.

Prześlij opinię

Chcemy zobaczyć, co tworzysz za pomocą interfejsu Language Detector API. Udostępnij nam swoje witryny i aplikacje internetowe na X, YouTube i LinkedIn.

Jeśli masz uwagi na temat implementacji Chrome, zgłoś błąd w Chromium.

Dołącz do programu testowania aktualizacji aby wcześniej zapoznać się z nowymi wbudowanymi interfejsami AI API i uzyskać dostęp do dyskusji na naszej liście adresowej.