Translator
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Peran seorang Penerjemah adalah untuk memproduksi/mengembalikan string lokalisasi untuk pemain yang melihat. Ini dapat digunakan untuk mengambil teks lokalisasi tampilan dari LocalizationTable . Sumber dari properti Translator.LocaleId , set tabel yang akan dicari, dan urutan yang akan dicari
Input untuk Penerjemah adalah string bahasa pengembangan asli dan konteks, di mana semua atau bagian dari konteks dapat digunakan untuk menemukan terjemahan yang lebih tepat / situasi untuk string sumber.
Translator juga dapat digunakan untuk memproduksi string yang diterjemahkan dengan inserat (pengganti data) yang dapat mengubah urutan berdasarkan bahasa target.
Rangkuman
Properti
Lokasi string yang diterjemahkan.
Metode
Mengembalikan string teks lokal dalam LocalizationTable berdasarkan lokasi Translator nya, dengan unit.
Mengembalikan string teks lokal dalam LocalizationTable berdasarkan lokasi Translator nya, dengan pencarian sumber.
Properti
LocaleId
Lokasi Roblox dari string terjemahan dari tabel ini, misalnya "en-us" atau "es-es." Standar untuk "en-us".
Metode
FormatByKey
Mengembalikan string teks lokal dalam LocalizationTable berdasarkan lokasi Translator nya, dengan unit. Tabel argumen opcional digunakan untuk mengisi parameter format dalam entri teks yang cocok.
Catat bahwa metode ini akan menghasilkan kesalahan dalam kasus berikut:
- Jika tidak ada dari LocalizationTables yang tersedia untuk ini Translator termasuk nilai untuk unityang diberikan.
- Jika format string untuk kunci menggunakan parameter dan arg tidak merupakan array.
- Jika format string menggunakan parameter bernama dan arg bukan tabel pasangan nilai kunci.
- Jika argumen hilang nilai untuk parameter yang digunakan dalam format string yang cocok .
Lihat Localizing dengan Scripting untuk lebih banyak rincian dan contoh penggunaan fungsi ini.
Parameter
Nilai Kunci untuk mencari dan menerjemahkan.
Untuk diberikan jika teks Sumber dan terjemahan berisi string format. Akan menjadi tabel Lua value atau pasangan value kunci, tergantung pada apakah string format dihitung atau bernama.
Memberikan nilai
Translate
Mengembalikan string teks lokal dalam LocalizationTable berdasarkan lokasi Translator nya. String ini akan berada dalam konteks objek yang disediakan, mengingat teks sumber yang disediakan.
Lihat Localizing dengan Scripting untuk lebih banyak rincian dan contoh penggunaan fungsi ini.
Kontext Overrides
Dalam beberapa kasus, string sumber sumber mungkin memiliki terjemahan yang sama sekali berbeda dalam bahasa lain. Misalnya, nama kata bahasa Inggris "Screen" dapat menunjukkan kedua layar komputer dan layar jendela, tetapi terjemahan Spanyol sama sekali berbeda:
<tr><td>Kunci</td><td>Konтеks</td><td><b>Sumber.</b></td><td>Contoh</td><td><b>es</b></td></tr><tr><td /><td /><td>Layar</td><td /><td>Pantai</td></tr><tr><td /><td /><td>Layar</td><td /><td>Para nyamuk</td></tr><tr><td /><td /><td /><td /><td /></tr></tbody>
Sebuah | B | C | D | E |
Dalam kasus ini, argument pertama untuk fungsi ini — Instance — dapat digunakan sebagai "pemecah koneksi" ketika beberapa objek GUI menggunakan string sumber yang sama. Untuk mengimplementasi ini, spesifikasi "jalan" ke Instance yang ingin Anda atasi sebagai nilai Kontext dari data transl
<tr><td>Kunci</td><td><b>Konteks</b></td><td>Sumber</td><td>Contoh</td><td>es</td></tr><tr><td /><td>workspace.ComputerScreen.SurfaceGui.TextLabel</td><td>Layar</td><td /><td>Pantai</td></tr><tr><td /><td /><td>Layar</td><td /><td>Para nyamuk</td></tr><tr><td /><td /><td /><td /><td /></tr></tbody>
Sebuah | B | C | D | E |
Kemudian, ketika menyebut fungsi ini dalam script, pasikan Instance dengan argument pertama, diikuti dengan teks Mata pencarian sebagai argument kedua:
local LocalizationService = game:GetService("LocalizationService")
local success, translator = pcall(function()
return LocalizationService:GetTranslatorForPlayerAsync(game.Players.LocalPlayer)
end)
if success then
local trans = translator:Translate(workspace.ComputerScreen.SurfaceGui.TextLabel, "Screen")
print(trans)
else
warn("Cannot load translator for player!")
end
Parameter
Sebuah Instance dalam game yang valid untuk digunakan sebagai pengganti konteks seperti yang diuraikan di atas. Catat bahwa argumen ini dapat bervariasi, misalnya game, jika Anda tidak memerlukan pengganti konteks.
Teks Sumber untuk dicari dan diterjemahkan.
Memberikan nilai
Teks yang diterjemahkan.