Publikuj i udostępniaj

Lokalizacja gry PlayDrop i jej strony

Odczytaj język gracza przez sdk.host.language, wybierz obsługiwane języki spośród 20 w PlayDrop i przetłumacz stronę gry oraz jej grafikę.

Strona internetowa i aplikacje PlayDrop są dostępne w 20 językach. Gra może podążać za językiem gracza w dwóch osobnych miejscach: w samej grze, którą tłumaczysz w kodzie, oraz na swojej stronie gry, którą tłumaczysz w catalogue.json.

Zacznij od angielskiego i jednego języka więcej

Udostępnij angielski oraz język swojego użytkownika, jeśli jest inny. Dodawaj kolejne języki, gdy planujesz dotrzeć do tych graczy. Częściowe tłumaczenie wypada gorzej niż dobra gra po angielsku, więc tłumacz całe ekrany.

Przetłumacz grę

sdk.host.language to język gracza spośród 20 języków PlayDrop: en, fr, de, es, pt-BR, it, nl, sv, nb, fi, pl, tr, ar, th, vi, id, ja, ko, zh-Hans i zh-Hant.

const STRINGS = { en: { play: "Play" }, fr: { play: "Jouer" } };
let language = "en";
try { language = sdk.host.language; } catch { /* older host */ }
const t = STRINGS[language] ?? STRINGS[language.split("-")[0]] ?? STRINGS.en;

sdk.host.locale to starsza wartość, ograniczona do pierwotnych dziesięciu języków i zwracająca en dla pozostałych; lepiej używać language. Na bardzo starych hostach obie mogą rzucić host_locale_unavailable. Arabski zapisuje się od prawej do lewej: odwróć układ interfejsu, a nie rozgrywkę, i testuj długie słowa po niemiecku i fińsku.

Przetłumacz stronę gry

Ustaw sourceLocale na język, w którym napisano stronę gry, a potem dodaj po jednym kompletnym tłumaczeniu na język w listingLocalizations, z kluczami według języka:

json

{
  "sourceLocale": "en",
  "displayName": "Moon Jump",
  "description": "Jump between lunar platforms and reach the flag.",
  "listingLocalizations": {
    "fr": {
      "displayName": "Saut lunaire",
      "subtitle": "Des plateformes lunaires contre la montre",
      "description": "Sautez de plateforme en plateforme et atteignez le drapeau.",
      "controls": "Touchez ou appuyez sur Espace pour sauter.",
      "listing": { "heroLandscape": "listing/locales/fr/hero-landscape.png" }
    }
  }
}

Każde tłumaczenie wymaga własnego displayName. Może też tłumaczyć subtitle, description, inspirationPrompt, controls, makingOf i releaseNotes.
Przetłumaczona grafika, taka jak grafika główna z przetłumaczonym tytułem, trafia do obiektu listing tłumaczenia, z tymi samymi polami co główna strona gry.
PlayDrop zapisuje, której wersji tekstu źródłowego odpowiada każde tłumaczenie. Gdy źródłowa strona gry się zmienia, zaktualizuj tłumaczenia w tym samym przesłaniu.

Przetłumaczona strona gry nie tłumaczy gry, a przetłumaczona gra nie tłumaczy strony gry. Wymieniaj tylko języki, które gra naprawdę obsługuje.

Gracze i wyszukiwarki

Strona internetowa udostępnia każdy język pod osobnym adresem, z linkami między wersjami, więc wyszukiwarki mogą zaproponować język czytelnika. Gracze widzą tłumaczenie zgodne z ich językiem w PlayDrop, a w przeciwnym razie język źródłowy.