roblox-localization

Roblox のローカライズ

読み込むタイミング

多言語対応、翻訳システム、ロケール固有のコンテンツ、地域検出を実装する場合に読み込みます。LocalizationService、LocalizationTable、自動翻訳、国／地域の検出について説明します。

クイックリファレンス

ロケールの検出

• player.LocaleId：プレイヤーが Roblox アカウントに設定したロケール（例：en-us、pt-br、ja-jp）
• LocalizationService.RobloxLocaleId：コア機能／内部機能のロケール
• LocalizationService.SystemLocaleId：プレイヤーの OS のロケール
• LocalizationService:GetCountryRegionForPlayerAsync(player)：IP ジオロケーションによる国コード（例：US、BR、JP）

翻訳テーブル

• LocalizationTable：翻訳エントリを格納します（キー → ロケールごとの翻訳）
• 自動翻訳を使うには、LocalizationTable を LocalizationService の子にします
• GUI オブジェクトの GuiBase2d.RootLocalizationTable を設定すると、要素ごとにテーブルを指定できます
• Studio では Localization Tools プラグインを使って、文字列をテーブルに自動抽出できます

自動翻訳

• 自動翻訳には、GUI とそのすべての祖先で AutoLocalize = true に設定し、対応するテーブルエントリを用意する必要があります
• 通常どおり TextLabel.Text を設定すると、エンジンがプレイヤーのロケールに応じた翻訳済み文字列に置き換えます
• 翻訳が見つからない場合は、ソーステキストにフォールバックします

手動翻訳

local translator = LocalizationService:GetTranslatorForPlayerAsync(player)
local translated = translator:Translate(game, "Welcome!")
local formatted = translator:FormatByKey("coins_count", {count})

国／地域の検出

local country = LocalizationService:GetCountryRegionForPlayerAsync(player)
if country == "US" then -- USD pricing
    -- US offer
elseif country == "GB" then
    -- UK offer
end

主なルール

• GetCountryRegionForPlayerAsync は非同期です。pcall で囲み、失敗する可能性を考慮してください
• GetTranslatorForPlayerAsync は非同期です。トランスレーターをキャッシュしてください
• テーブルを選択するには RootLocalizationTable を設定し、祖先の階層全体で AutoLocalize を true に保ってください
• 翻訳エントリには、SourceText、SourceLocaleId に続いて、en-us、pt-br などの列を設定します
• 一括編集するには、Studio からテーブルを CSV としてエクスポート／インポートしてください
• Studio のロケールシミュレーターを使って、異なるロケールでテストしてください

注意点

• すべてのロケールがサポートされているわけではありません。player.LocaleId を確認してください
• 自動翻訳は GUI 以外のテキストには機能しません。手動で Translator:Translate を使用してください
• GetCountryRegionForPlayerAsync は IP ジオロケーションを使用するため、VPN を使うと誤った結果になります
• エントリが見つからない場合、何も通知されずにソーステキストにフォールバックします

詳細が必要ですか？ references/full.md を読み込んでください。