Translator

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat

Tidak Direplikasi

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

LocaleId:string
Hanya Baca
Tidak Direplikasi
Baca Paralel
Lokasi string yang diterjemahkan.

Lihat semua yang diwarisi dari Instance

Lihat semua yang diwarisi dari Object

Metode

FormatByKey(key : string,args : Variant):string
Mengembalikan string teks lokal dalam LocalizationTable berdasarkan lokasi Translator nya, dengan unit.
Translate(context : Instance,text : string):string
Mengembalikan string teks lokal dalam LocalizationTable berdasarkan lokasi Translator nya, dengan pencarian sumber.

Lihat semua yang diwarisi dari Instance

Lihat semua yang diwarisi dari Object

Acara

Lihat semua yang diwarisi dari Instance

Lihat semua yang diwarisi dari Object

Properti

LocaleId

string

Hanya Baca

Tidak Direplikasi

Baca Paralel

Lokasi Roblox dari string terjemahan dari tabel ini, misalnya "en-us" atau "es-es." Standar untuk "en-us".

Lihat semua yang diwarisi dari Instance

Lihat semua yang diwarisi dari Object

Metode

FormatByKey

string

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

key: string

Nilai Kunci untuk mencari dan menerjemahkan.

args: Variant

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

string

Translate

string

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

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

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

context: Instance

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.

text: string

Teks Sumber untuk dicari dan diterjemahkan.