Translator

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

No creable

No replicado

El rol de un traductor es fabricar/devolver cadenas localizadas para el jugador de visualización.Se puede usar para recuperar texto localizado listo para mostrar de un LocalizationTable .La fuente de la propiedad Translator.LocaleId de origen, el conjunto de tablas que buscará y el orden en que las buscará depende del método que se utilizó para crear la instancia del Traductor.

La entrada para un traductor es la cadena de desarrollo original y un contexto, donde todo o parte del contexto se puede utilizar para encontrar una traducción más precisa/situacional para la cadena de origen.

El traductor también se puede utilizar para fabricar cadenas traducidas con inserciones (reemplazos de datos) que pueden cambiar el orden según el idioma de destino.

Resumen

Propiedades

LocaleId:string
Solo lectura
No replicado
Leer paralelo
El idioma de las cadenas traducidas.

Ver todos los heredados de Instance

Ver todos los heredados de Object

Métodos

FormatByKey(key : string,args : Variant):string
Devuelve la cadena de texto localizada en una LocalizationTable basada en su cadena de ubicación Translator, por clave.
Translate(context : Instance,text : string):string
Devuelve la cadena de texto localizada en una basada en su cadena de ubicación local, por búsqueda de fuentes.

Ver todos los heredados de Instance

Ver todos los heredados de Object

Eventos

Ver todos los heredados de Instance

Ver todos los heredados de Object

Propiedades

LocaleId

string

Solo lectura

No replicado

Leer paralelo

El local de Roblox de las cadenas traducidas de salida de esta tabla, por ejemplo "en-us" o "es-es". Se prefiere "en-us".

Ver todos los heredados de Instance

Ver todos los heredados de Object

Métodos

FormatByKey

string

Devuelve la cadena de texto localizada en una LocalizationTable basada en su cadena de ubicación Translator, por clave.La tabla opcional arg se usa para llenar los parámetros de formato en la entrada de texto coincidente.

Tenga en cuenta que este método lanzará un error en los siguientes casos:

Si ninguno de los LocalizationTables disponibles para este Translator incluye un valor para la clave dada.
Si el formato de cadena para la clave usa parámetros numerados y args no es un matriz/lista.
Si la cadena de formato usa parámetros nominales y args no es una tabla de pares de clave-valor,
Si args carece de valores para parámetros que se usan en la cadena de formato coincidente .

Vea Localizar con programación para más detalles y ejemplos de uso de esta función.

Parámetros

key: string

El valor de la Clave para buscar y traducir.

Valor predeterminado: ""

args: Variant

Se proporcionará si el texto y las traducciones de Fuente contienen cadenas de formato.Será una tabla de valores Luau de pares de valores o clave-valor, dependiendo de si las cadenas de formato están numeradas o llamadas.

Valor predeterminado: ""

Devuelve

string

Translate

string

Devuelve la cadena de texto localizada en una LocalizationTable basada en su cadena de ubicación Translator.Esta cadena estará en el contexto del objeto proporcionado, dado el texto de fuente proporcionado Fuente .

Vea Localizar con programación para más detalles y ejemplos de uso de esta función.

Anulaciones de contexto

En algunos casos, las cadenas duplicadas Fuente pueden tener traducciones completamente diferentes en otros idiomas.Por ejemplo, el nombre inglés "Pantalla" puede indicar tanto una pantalla de ordenador como una pantalla de ventana, pero las traducciones españolas son completamente diferentes:


<td width="16%">B</td>

    <td width="18%">C</td>

    <td width="12%">D</td>

    <td width="18%">E</td>
  </tr>

  <tr>
    <td>Clave</td>

    <td>Contexto</td>

    <td><b>Fuente</b></td>

    <td>Ejemplo</td>

    <td><b>es</b></td>
  </tr>

  <tr>
    <td />

    <td />

    <td>Pantalla</td>

    <td />

    <td>Pantalla</td>
  </tr>

  <tr>
    <td />

    <td />

    <td>Pantalla</td>

    <td />

    <td>Mosquitero</td>
  </tr>

  <tr>
    <td />

    <td />

    <td />

    <td />

    <td />
  </tr>
</tbody>

En estos casos, el primer argumento a esta función — un argumento válido en el juego Instance — se puede usar como "rompedor de empate" cuando varios objetos de interfaz de usuario usan la misma cadena de fuente.Para implementar esto, especifique el "camino" al Instance que desea anular como el valor del contexto de los datos de traducción:


<td width="36%">B</td>

    <td width="18%">C</td>

    <td width="12%">D</td>

    <td width="18%">E</td>
  </tr>

  <tr>
    <td>Clave</td>

    <td><b>Contexto</b></td>

    <td>Fuente</td>

    <td>Ejemplo</td>

    <td>es</td>
  </tr>

  <tr>
    <td />

    <td>espacio de trabajo.ComputerScreen.SurfaceGui.TextLabel</td><td>pantalla</td>

    <td />

    <td>Pantalla</td>
  </tr>

  <tr>
    <td />

    <td />

    <td>Pantalla</td>

    <td />

    <td>Mosquitero</td>
  </tr>

  <tr>
    <td />

    <td />

    <td />

    <td />

    <td />
  </tr>
</tbody>

Luego, al llamar esta función en un script, pasa el mismo como primer argumento, seguido por el texto de búsqueda de fuente como segundo argumento:


local Players = game:GetService("Players")
local LocalizationService = game:GetService("LocalizationService")

local success, translator = pcall(function()
	return LocalizationService:GetTranslatorForPlayerAsync(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

Parámetros

context: Instance

Un válido en el juego Instance para usar para anulación de contexto como se describe anteriormente.Tenga en cuenta que este argumento puede ser arbitrario, por ejemplo game , si no requiere una invalidar/reemplazarde contexto.

Valor predeterminado: ""

text: string

El texto Fuente para buscar y traducir.

Valor predeterminado: ""