Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

wykrywanie języka za pomocą wbudowanej AI;

Thomas Steiner

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

Browser Support

Source

Zanim przetłumaczysz tekst z jednego języka na inny, musisz najpierw określić, w jakim języku jest dany tekst. 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żna wprawdzie dostarczyć konkretną bibliotekę, która to robi, ale wymagałoby to pobrania dodatkowych zasobów.

Kiedy używać wykrywania języka

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

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ń związanych z językiem, takich jak wykrywanie toksyczności;
określanie języka tekstu wejściowego, aby można było go prawidłowo oznaczyć, np. w serwisach społecznościowych;
określanie języka tekstu wejściowego, aby można było odpowiednio dostosować interfejs aplikacji; Na przykład w witrynie belgijskiej, aby wyświetlać tylko interfejs odpowiedni dla użytkowników mówiących po francusku.

Rozpocznij

Interfejsy Language Detector API i Translator API działają w Chrome na komputerach. Te interfejsy API nie działają na urządzeniach mobilnych.

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 już być obecny, ponieważ ten model jest używany przez inne funkcje Chrome.

Aby sprawdzić, czy model jest gotowy do użycia, wywołaj funkcję asynchroniczną LanguageDetector.availability(). Jeśli odpowiedź na availability() brzmiała downloadable, poczekaj na postęp pobierania i poinformuj użytkownika, ponieważ pobieranie może trochę potrwać.

Aby uruchomić pobieranie i utworzyć instancję detektora języka, sprawdź aktywność 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 rankingu, aby określić, który język jest najbardziej prawdopodobny w danym fragmencie tekstu. Ranking to rodzaj uczenia maszynowego, którego celem jest uporządkowanie listy elementów. W tym przypadku interfejs Language Detector API szereguje języki od najwyższego do najniższego prawdopodobieństwa.

Funkcja detect() może zwracać pierwszy wynik, najbardziej prawdopodobną odpowiedź lub iterować po kandydatach z rankingu z poziomem ufności. Jest zwracana jako lista obiektów {detectedLanguage, confidence}. Poziom confidence jest wyrażony jako wartość z zakresu 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
// ...

Laboratorium API

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

Zasady dotyczące uprawnień, elementy iframe i skrypty Web Worker

Domyślnie interfejs Language Detector API jest dostępny tylko w oknach najwyższego poziomu i w elementach iframe tego samego pochodzenia. Dostęp do interfejsu API można przekazać elementom iframe ze współdzieleniem za pomocą atrybutu zasad 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 procesu ustalania dokumentu odpowiedzialnego za każdy proces roboczy w celu sprawdzenia stanu zgodności z zasadami zasad dotyczących uprawnień.

Prześlij opinię

Chętnie dowiemy się, co udało Ci się stworzyć za pomocą interfejsu Language Detector API. Udostępnij nam swoje witryny i aplikacje internetowe na X, YouTube i LinkedIn.

Jeśli masz uwagi dotyczące implementacji Chrome, zgłoś błąd Chromium.

Dołącz do programu wczesnej wersji przedpremierowej, aby zapoznać się z nowymi interfejsami API wbudowanej AI i uzyskać dostęp do dyskusji na naszej liście adresowej.