Moduł Google Translate¶
Opis¶
Moduł ten powstał w celu umożliwienia tłumaczenia tekstu w technologii NEOS. Dzięki temu możliwe jest używanie tłumaczeń w aplikacji SenteS4 jak i Teneum. Obsługuję klienta desktopowego oraz webowego. Moduł wykorzystuje API googla do tłumaczeń.
Przykład działania:
Minimalne wymagania¶
Minimalna wersja serwera NEOS to 4.6
Instalacja¶
- Należy skopiować moduł do katalogu "Modules" w serwerze NEOS. Binarki modułu dostępne są tutaj: X:\DBR\release\neos\modules\GoogleTranslate
- W katalogu GoogleTranslate znajduje się katalog Keys. Należy zarejestrować się i odpowiednio wygenerować klucz dostępu do "Google Cloud Translate API". Następnie w tym folderze należy zapisać ten plik jako key.json. (Ważna jest wielkość znaków, pierwszy folder z dużej, nazwa pliku z małej)!!!
- Aby uzyskać klucz należy mieć aktywować usługę google translate google cloud console. Istnieje możliwość aktywowania wersji triall (300\$ na rok do wykorzystania).
Ważne
Klient na środowisku produkcyjnym powinien sam uzyskać klucz i wybrać odpowiednią dla siebie licencję
-
Tutaj znajdziesz informację na temat cen i licencji: Pricing.
-
Po uzyskaniu klucza kopiujemy go do ..Neos/Modules/GoogleTranslate/Keys/key.json
Przykład użycia¶
- Po poprawnym podłączeniu modułu (należy zweryfikować w logach czy poprawnie został załadowany) można wykorzystać moduł w następujący sposób.
var result = Neos.Modules.GoogleTranslate.Services.GoogleTranslateService.Instance.TranslateText("Tekst do tłumaczenia", "skrót języka np: en");
-
Należy wykonać metodę TranslateText, która przyjmuje 2 parametry. Pierwszy z nich to tekst do przetłumaczenia, natomiast drugi to język na jaki chcemy przetłumaczyć. Lista języków dostępna jest Tutaj.
-
Moduł umożliwia też użycie metody "TranslateResult", która zwraca obiekt Google.Cloud.Translation.V2.TranslationResult. Obiekt zawiera dodatkowe informacje o tłumaczeniu. Więcej w dokumentacji googla.