LocalizationService
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
ローカライゼーションサービスは、自動翻訳を処理する責任のあるサービスです。
自動テキスト置換に使用される LocalizationTable オブジェクトのストレージとして使用されます。
ローカライゼーションサービスは、GUI オブジェクトまたはその祖先に GuiBase2d.RootLocalizationTable が指定されない限り、子のローカライゼーションテーブルを自動的にテキスト置換に使用しません。
概要
プロパティ
コアと内部機能のローカライゼーションに使用されるローカル ID。
ローカルプレイヤーがそのオペレーティングシステム用に設定したローカル ID。
方法
コアスクリプトのローカライズに使用される LocalizationTable オブジェクトのリストを返します。
自動多言語化に使用されるすべてのエントリを取得します。
ローカルデータをロードして翻訳に使用する Translator を返します。
プレイヤーのクライアント IP ジオロケーションに従って国/地域コードストリングを返す
引数ローカルがロードされるまで、LocalizationTable クラウドの生成が続行されます - 利用可能な場合。提供されたローカルのための翻訳に使用する Translator インスタンスを返します。
プレイヤーのローカルにクラウド LocalizationTable が読み込まれるまでの生成 - 利用可能な場合。提供されたローカルのための翻訳に使用する Translator インスタンスを返します。
プロパティ
RobloxLocaleId
このプロパティは、CoreGui などのコアと内部機能のローカライゼーションに使用されるローカルIDを表示します。ローカルに対して、2文字コード (例: en-us ) を含む文字列を返します。
SystemLocaleId
このプロパティは、ローカルプレイヤーがオペレーティングシステムに設定したローカルIDを表示します。
これは、ローカルに対して 2文字コード（例: "en-us"）を含む文字列を返します。
参照してください Player.LocaleId , ユーザーがロブロックスアカウントに設定したローカルIDで、体験内のコンテンツをローカライズするのに使用されます。Roblox がそのプレイヤーのローカルを内部でまだサポートしていない場合、これは異なる値になります。
方法
GetCorescriptLocalizations
コアスクリプトのローカライズに使用される LocalizationTable オブジェクトのリストを返します。
戻り値
GetTableEntries
返す Array 、それぞれの要素が返された Array は、Array に記載されたものと同じ形式のエントリであり、LocalizationTable:GetEntries() で説明されたものと同じです。返された Array の要素の順序は、LocalizationTables で検索され、提供された Instance の自動翻訳を試みるための順序と同じです。特定の LocalizationTable 内のエントリ要素は、指定されない順序で返されます。
この機能は、オブジェクトが 有効になっているかどうかにかかわらず、エントリを返します。GuiBase2d がオブジェクトの場合、GuiBase2d.AutoLocalize が有効になっていない限り、実際に自動的に翻訳されることはありません。
テーブルの順序は次のとおりです:
- まず、提供されたオブジェクトを含むオブジェクトの最も古い GuiBase2d 祖先を検索します(GuiBase2d.RootLocalizationTable を含む)。テーブルは、その の祖先の を通り上がって説明された順序で付加します。そのような GuiBase2d.RootLocalizationTable が見つからない場合、このステップでテーブルは追加されません。If instance が nil である場合、このステップでテーブルは追加されません。
- 次に、 LocalizationTable 下の階層のテーブルが LocalizationService に追加されます。各子 の に対して、サービスに付属するテーブルの最も低い子孫から始まるテーブルがすべて追加され、サービスの子供まで続きます。子が がない場合、このステップでテーブルが追加されない。
- 最後に、クラウド LocalizationTable が配列に付加されます。クラウドがない場合 、またはクラウドがまだロードされていない場合は、このステップでテーブルが付加されません。
この機能は、生成しません。クラウドが LocalizationTable ロードされるまで待たないでしょう。
パラメータ
戻り値
各配列が LocalizationTable:GetEntries() で説明された形式と同じ形式である配列のアレイ。
GetTranslatorForPlayer
この機能は、プレイヤーを引数として受け取り、そのローカルのための翻訳を実行するために使用できる Translator インスタンスを返します。如果可能な場合は、そのローカルのための翻訳を実行するために使用できます。ローカライゼーションに使用されるエントリは、 階層によって提供されるエントリ、およびクラウド 、もし利用可能で既にロードされている場合も含まれます。これは LocalizationService:GetTableEntries(nil) によって返される同じセットのエントリになります。
この機能は、生成しません。クラウドが LocalizationTable ロードされるまで待たないでしょう。
参照してください：
- LocalizationService:GetTranslatorForPlayerAsync() は、クラウドが LocalizationTable ロードされるまで同じ機能を持っていますが、この機能とは異なります。
- LocalizationService:GetTranslatorForLocaleAsync() , 提供されたローカルを使用した翻訳に使用する翻訳機を返します。
パラメータ
あなたが受け取っている Player のための Translator。
戻り値
指定されたローカルのための Translator インスタンス。
コードサンプル
This code sample attempts to retrieve a Translator object for the local player. LocalizationService:GetTranslatorForPlayerAsync() is wrapped in a pcall because it may error. If it does not error and returns a Translator, it translates and prints "Hello World!" in the player's language. If the function errors, it prints "GetTranslatorForLocaleAsync failed:" followed by the error message.
LocalizationService:GetTranslatorForPlayer() can also be used if you'd like to get the player's translator without yielding until the function returns.
local LocalizationService = game:GetService("LocalizationService")
local Players = game:GetService("Players")
local textLabel = script.Parent
local success, translator = pcall(function()
return LocalizationService:GetTranslatorForPlayerAsync(Players.LocalPlayer)
end)
if success then
local result = translator:Translate(textLabel, "Hello World!")
print(result)
else
print("GetTranslatorForPlayerAsync failed: " .. translator)
endGetCountryRegionForPlayerAsync
プレイヤーのクライアント IP ジオロケーションに従って国/地域コードストリングを返します。サポートされる国/地域コードは次のとおりです：
| コード |
|---|
| コード |
|---|
| コード |
|---|
参照してください：
- PolicyService:GetPolicyInfoForPlayerAsync() , 地理的位置、年齢グループ、プラットフォームに基づくプレイヤーに関するポリシー情報を返す
パラメータ
国/地域情報を取得しているプレイヤー。
戻り値
プレイヤーの国/地域コードを示す文字列。
コードサンプル
This code sample gets the country/region code for a local player and prints "Hello, friend from Canada!" if the player's client IP geolocation is Canada.
local LocalizationService = game:GetService("LocalizationService")
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local result, code = pcall(LocalizationService.GetCountryRegionForPlayerAsync, LocalizationService, player)
if result and code == "CA" then
print("Hello, friend from Canada!")
else
print("GetCountryRegionForPlayerAsync failed: " .. code)
endGetTranslatorForLocaleAsync
この機能は、ローカルコードを引数として受け取り、クラウドが LocalizationTable そのローカルにロードされるまで出力します。もし可能であれば。その後、利用可能な場合は、そのローカルのための翻訳を実行するための Translator オブジェクトを返します。ローカライゼーションに使用されるエントリは、LocalizationService の LocalizationTable 階層によって提供されるエントリと、クラウドテーブル（利用可能な場合）です。これは LocalizationService:GetTableEntries(nil) によって返される同じセットのエントリになります。
この機能はエラーが発生し得るため、pcall() で包まれる必要があります。
参照してください：
- LocalizationService:GetTranslatorForPlayer() は、提供されたプレイヤーのローカルに対応する翻訳者を取得します。この機能は廃止され、新しい作業では使用してはなりません。
- LocalizationService:GetTranslatorForPlayerAsync() は、提供されたプレイヤーのローカルにクラウド LocalizationTable がロードされてから、提供されたプレイヤーのローカルに対応する翻訳者を取得するまで続行します。
パラメータ
Roblox がサポートする言語またはローカルコード。
戻り値
指定されたローカルのための Translator インスタンス。
コードサンプル
This code sample attempts to retrieve a Translator object for the locale "fr" (French).
LocalizationService:GetTranslatorForLocaleAsync() is wrapped in a pcall because it may error. If it does not error and returns a Translator, prints "Hello in French:" followed by the French translation of "Hello World!". If the function errors, it prints "GetTranslatorForLocaleAsync failed:" followed by the error message.
local LocalizationService = game:GetService("LocalizationService")
local textLabel = script.Parent
local success, translator = pcall(function()
return LocalizationService:GetTranslatorForLocaleAsync("fr")
end)
if success then
local result = translator:Translate(textLabel, "Hello World!")
print("Hello in French: " .. result)
else
print("GetTranslatorForLocaleAsync failed: " .. translator)
endGetTranslatorForPlayerAsync
この機能は、プレイヤーを引数として受け取り、クラウドが LocalizationTable そのプレイヤーのローカルにロードされるまで待機します（可能であれば）。その後、利用可能な場合は、そのローカルのための翻訳を実行するための Translator オブジェクトを返します。ローカライゼーションに使用されるエントリは、LocalizationService の LocalizationTable 階層によって提供されるエントリと、クラウドテーブル（利用可能な場合）です。これは LocalizationService:GetTableEntries(nil) によって返される同じセットのエントリになります。
この機能はエラーが発生し得るため、pcall() で包まれる必要があります。
参照してください：
- LocalizationService:GetTranslatorForPlayer() , この機能と同じ機能ですが、プレイヤーのローカルのクラウド LocalizationTable がロードされるまで待たず、生成しません。この機能は非推奨であり、新しい作業には使用してはならない。
- LocalizationService:GetTranslatorForLocaleAsync() , 提供されたローカルを使用した翻訳に使用する翻訳機を返します。
パラメータ
あなたが受け取っている Player のための Translator。
戻り値
指定されたローカルのための Translator インスタンス。
コードサンプル
This code sample attempts to retrieve a Translator object for the local player. LocalizationService:GetTranslatorForPlayerAsync() is wrapped in a pcall because it may error. If it does not error and returns a Translator, it translates and prints "Hello World!" in the player's language. If the function errors, it prints "GetTranslatorForLocaleAsync failed:" followed by the error message.
LocalizationService:GetTranslatorForPlayer() can also be used if you'd like to get the player's translator without yielding until the function returns.
local LocalizationService = game:GetService("LocalizationService")
local Players = game:GetService("Players")
local textLabel = script.Parent
local success, translator = pcall(function()
return LocalizationService:GetTranslatorForPlayerAsync(Players.LocalPlayer)
end)
if success then
local result = translator:Translate(textLabel, "Hello World!")
print(result)
else
print("GetTranslatorForPlayerAsync failed: " .. translator)
end