LocalizationService
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
LocalizationService は、自動翻訳を処理するサービスです。
自動的にテキストを置き換えるために使用されます LocalizationTable オブジェクト。
LocalizationService は、GuiBase2d.RootLocalizationTable が GUI オブジェクトまたはその先祖に指定されていない限り、子のローカライズテーブルのみを自動的にテキストの置き換えに使用します。
概要
プロパティ
コアと内部機能のローカライズに使用されるローカル ID。
ローカルプレイヤーがオペレーティングシステムに設定したローカル言語ID。
方法
コアスクリプトのローカライズに使用される LocalizationTable オブジェクトのリストを返します。
自動ローカライズに使用されるすべてのエントリを取多言語化します。
ローカルデータを読み込んで使用する Translator を返します。
プレイヤーのクライアントの IP ジオロケーションに応じて国/地域コードのストリングを返します。
クラウドの LocalizationTable による引数のローカル化が読み込まれるまでに - がある場合。返します Translator インスタンスを使用して翻訳を提供するローカル化に使用できます。
プレイヤーのローカルプロバイダーの場合、LocalizationTable クラウドにより、Translator インスタンスが読み込まれました - が利用可能な場合。Class.LocalizationTable インスタンスを返し、2>Class.Translator2> のローカルプロバイダーを使用するために、5>Class.Translator5> インスタンスを返します。
プロパティ
RobloxLocaleId
このプロパティは、コアと内部機能のローカライズのために使用されるローカライズ ID を表示します。CoreGui などのコーナーと内部機能のローカライズに使用される 2つの文字コード (例: en-us ） を返します。
SystemLocaleId
このプロパティは、ローカルプレイヤーがオペレーティングシステムに設定したローカル言語IDを表示します。
これは、ローカルの 2つの文字コード (例: "en-us") で構成された文字列を返します。
また、Player.LocaleId を参照してください。これは、ユーザーが Roblox アカウントに設定したローカル化コンテンツをローカライズするためのローカル IDです。これは、Roblox がまだ内部でそのユーザーのローカル語言をサポートしていないときには、異なる値になります。
方法
GetCorescriptLocalizations
コアスクリプトのローカライズに使用される LocalizationTable オブジェクトのリストを返します。
戻り値
GetTableEntries
Class.LocalizationTable:GetEntries() では、Class.Instance 内の各要素が、Class.LocalizationTables 内の各要素
この関数は、オブジェクトが GuiBase2d を持つかどうかにかかわらず、入力を返します。オブジェクトが GuiBase2d.AutoLocalize を有効にしている場合、オブジェクトは自動的にローカライズされません。
テーブルのオーダーは次のとおりです:
- 次に、最初にインスタンスブジェクトの最も古い祖先 (含
- 最後に、クラウド LocalizationTable アプリはアレイに追加されます。如果クラウド LocalizationTable が存在しない場合、またはクラウド LocalizationTable がまだ読み込まれていない場合、このステップに表示されないようになります。
この関数は生成されません。クラウドが読み込まれるまでは LocalizationTable を待ちません。
パラメータ
戻り値
配列の配列、各配列が LocalizationTable:GetEntries() で説明されている形式と同じ形式です。
GetTranslatorForPlayer
この関数はプレイヤーを引数として取り、Translator インスタンスを返します which can be used to perform translations for that locale if any are available. The entries used for localization are the entries provided by the Class.Localization
この関数は生成されません。クラウドが読み込まれるまでは LocalizationTable を待ちません。
参照してください:
- LocalizationService:GetTranslatorForPlayerAsync() は、この関数と同じ機能を持つが、クラウドに LocalizationTable が読み込まれるまでは、生成します。
- LocalizationService:GetTranslatorForLocaleAsync() は、提供されたローカル言語を使用して翻訳するためのトランスレータを返します。
パラメータ
Class.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 がそのローカルコードを読み込まれるようになった場合、その
この関数はエラーする可能性があり、つまり pcall() で包まれる必要があります。
参照してください:
- LocalizationService:GetTranslatorForPlayer() は、指定されたプレイヤーのローカルに対応する翻訳機を取得します。この機能は使用できなくなっており、新しいワークには使用しないでください。
- LocalizationService:GetTranslatorForPlayerAsync() は、提供されたプレイヤーのローカルプレースに Cloud 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 の場合、そのプレイヤーのローカルに関連するクラウド
この関数はエラーする可能性があり、つまり pcall() で包まれる必要があります。
参照してください:
- LocalizationService:GetTranslatorForPlayer() , 同じ機能がこの関数に加えて、クラウドの LocalizationTable のためにプレイヤーのローカルに読み込まれるまでは、生成しません。この関数はデプレットされ、新しいワークには使用しないでください。
- LocalizationService:GetTranslatorForLocaleAsync() は、提供されたローカル言語を使用して翻訳するためのトランスレータを返します。
パラメータ
Class.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