LocalizationTable

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Une table de localisation est une base de données de traductions. Elle contient des chaînes source et des traductions pour diverses langues. Elle est utilisée avec le Translator et LocalizationService système de traductions automatiques pour contrôler les traductions de texte dans le jeu. Les tables de localisation sont conçues pour être traitées comme des

Entrées de la table de localisation

Chaque table de localisation contient un ensemble d'entrées. Chaque entrée contient les traductions du texte, ainsi que quelques champs spéciaux :

  • Clé est une clé unique optionnelle pour les recherches de hachage rapides dans le code. S'il n'est pas vide, il doit être unique dans la table.
  • La source est le texte original dans la langue source qui sera utilisé par le système de remplacement de texte automatique LocalizationService pour correspondre au texte GUI et rendre une traduction à la place. Le champ source peut être rempli par les outils de capture de texte, ou peut être défini manuellement. Pour les recher
  • Le contexte est le nom de l'objet dans lequel le texte est apparu. Le contexte est utilisé pour la désambiguaction par le système de remplacement de texte automatique. Lorsque plusieurs correspondent pour la source, le système choisira le meilleur match en Match à reculons à partir de la fin de la chaîne de contexte. Il existe d'autres manières plus robustes de gérer la désambiguaction, telles que d'utiliser plusieurs tables avec
  • L'exemple est ce que vous voulez qu'il en soit. Si l'outil de capture de texte devine certains paramètres pour une chaîne, le champ Exemple contiendra un exemple d'entre eux utilisés dans le contexte.

Tous ces champs sont optionnels, mais au moins l'un ou l'autre clé ou source doit être non vide. Aucune entrée ne peut avoir la même clé, la même source et le même contexte.

Voir traduire du contenu dynamique pour plus d'informations.

Échantillons de code

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



local function createLocalizationTable(entries)

	local localTable = Instance.new("LocalizationTable")

	localTable.DevelopmentLanguage = LocalizationService.SystemLocaleId

	localTable:SetEntries(entries)

	return localTable

end



local entries = {

	{

		Key = "Hello_World", -- The 'expressionKey' to be used with GetString

		Values = { -- A dictionary of keys corresponding to IETF language tags, and their translations.

			["ru"] = " !", -- Russian

 			["fr"] = "Bonjour le monde!", -- French

  			["de"] = "Hallo Welt!", -- German

			["en-US"] = "Hello world!", -- English

			["it"] = "Ciao mondo!", -- Italian

			["pt-BR"] = "Ol Mundo!", -- Portuguese

			["ja"] = "", -- Japanese

			["es"] = "Hola Mundo!", -- Spanish

		}

	}

}



local helloWorldTable = createLocalizationTable(entries)



print(helloWorldTable:GetString("en-US", "Hello_World"))

Résumé

Propriétés

Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Méthodes

  • GetEntries():Array

    Renvoie un tableau de dictionnaires, où chaque dictionnaire représente une entrée de données de localisation.

  • GetTranslator(localeId : string):Instance

    Renvoie un Translator pour les entrées dans cette table de localisation, dans la langue spécifiée.

  • RemoveEntry(key : string,source : string,context : string):void

    Supprime une entrée de la table de localisation, en utilisant le key, source, et context pour restreindre l'entrée spécifique à être supprimée.

  • RemoveEntryValue(key : string,source : string,context : string,localeId : string):void

    Supprime une seule traduction de langue de la table de localisation, en utilisant la fourmi key, source, context, et 1> localId1> pour restreindre l'entrée spécifique à être supprimée.

  • RemoveTargetLocale(localeId : string):void

    Supprime toutes les traductions de la table de localisation avec l'identifiant de lieu spécifié.

  • SetEntries(entries : Variant):void

    Définit le contenu de la table de localisation.

  • SetEntryContext(key : string,source : string,context : string,newContext : string):void

    Définit le contexte champ d'une entrée dans le Tableau de localisation à newContext, en utilisant le key spécifié, 2>source2> et 5>text5> pour restreindre l'entrée qui aura ce changement appliqué.

  • SetEntryExample(key : string,source : string,context : string,example : string):void

    Définit le example champ d'une entrée dans le key à 1> example1>, en utilisant le 4> clé4>, 7> source7>, et 9> context9> pour restreindre l'entrée qui aura ce changement appliqué.

  • SetEntryKey(key : string,source : string,context : string,newKey : string):void

    Définit le champ clé d'une entrée dans une table de localisation à newKey, en utilisant le key spécifié, 1> source1> et 4> context4> pour restreindre l'entrée qui aura ce changement appliqué.

  • SetEntrySource(key : string,source : string,context : string,newSource : string):void

    Définit le champ Source d'une entrée dans le newSource à key , en utilisant le 1> clé1> , 4> source4> et 7> context7> pour restreindre l'entrée qui aura ce changement appliqué.

  • SetEntryValue(key : string,source : string,context : string,localeId : string,text : string):void

    Définit le texte de la valeur de localisation spécifiée dans une entrée de la table de localisation, en utilisant le key spécifié, source et context pour restreindre l'entrée qui aura ce changement appliqué.

Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Propriétés

SourceLocaleId

string
Lecture parallèle

La localisation Roblox des chaînes de clés d'entrée pour cette table, par exemple « en-us » ou « es-es. » C'est généralement la « langue de développement » du jeu. Pour un Traducteur qui fusionne plusieurs objets de la table de localisation par défaut, il s'agit de la « LocaleId » de la table de localisation par défaut. Par défaut, « en-us ».

Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Méthodes

GetEntries

Array

La fonction GetCommands renvoie un tableau de dictionnaires contenant un certain LocalizationTable, où chaque dictionnaire représente une entrée de données de localisation.

Pour définir les entrées d'une table de localisation, vous pouvez utiliser LocalizationTable:SetEntries() .

Chaque dictionnaire dans l' array contient les champs suivants :

<tbody>

  <tr>

    <td>

      <b>Clé</b>

    </td>



    <td><code>Bibliothèque.string</code></td>

    <td>Une clé de recherche pour cette entrée spécifique dans la table de localisation.</td>

  </tr>



  <tr>

    <td>

      <b>Source</b>

    </td>



    <td><code>Bibliothèque.string</code></td>

    <td>La chaîne utilisée pour former le texte localisé. Utilisée comme une recherche si une clé n'est pas fournie.</td>

  </tr>



  <tr>

    <td>

      <b>Contexte</b>

    </td>



    <td><code>Bibliothèque.string</code></td>

    <td>Un <code>Class.Instance:GetFullName()</code> chemin à l'objet que vous avez utilisé pour générer la table de localisation. Utilisé comme une recherche si une clé n'est pas fournie.</td>

  </tr>



  <tr>

    <td>

      <b>Exemple</b>

    </td>



    <td><code>Bibliothèque.string</code></td>

    <td>La chaîne utilisée pour formerater la localisation. Facultatif.</td>

  </tr>



  <tr>

    <td>

      <b>valeurs</b>

    </td>



    <td><code>Dictionnaire</code></td>

    <td>Un dictionnaire de traductions de langue pour cette entrée de localisation. Les clés de ce dictionnaire sont les identifiants de lieu, et les valeurs sont des chaînes qui sont utilisées pour appliquer la localisation pour la langue correspondant à l'identifiant du lieu.</td>

  </tr>

</tbody>
IndexTypeDescription

Retours

Array

Un tableau de dictionnaires, où chaque dictionnaire représente une entrée de données de localisation.

Échantillons de code

Using a LocalizationTable
local LocalizationService = game:GetService("LocalizationService")



local localizationTable = LocalizationService:FindFirstChild("LocalizationTable")



local entries = {

	{

		["Key"] = "0001",

		["Source"] = "en-us",

		["Values"] = {

			["0001"] = "Hello Muddah, hello Fadduh.",

			["0002"] = "Here I am at Camp Granada.",

			["0003"] = "Camp is very entertaining.",

			["0004"] = "And they say we'll have some fun if it stops raining.",

		},

	},

}



localizationTable:SetEntries(entries)

local get_results = localizationTable:GetEntries()



for _index, dict in pairs(get_results) do

	for _key, value in pairs(dict["Values"]) do -- Loop through every key, value pair in the dictionary to print our strings

		print(value)

	end

end

GetTranslator

Instance

Retourne un Translator pour les entrées dans cette table de localisation, dans la langue spécifiée. Le traducteur recherchera d'abord dans cette table et ensuite dans les tables ancêtres.

Paramètres

localeId: string

Retours

Instance

RemoveEntry

void

Supprime une entrée de la table de localisation, en utilisant le key, source, et context pour restreindre l'entrée spécifique à être supprimée.

Paramètres

key: string
source: string
context: string

Retours

void

RemoveEntryValue

void

Supprime une seule traduction de langue de la table de localisation, en utilisant la fourmi key, source, context, et 1> localId1> pour restreindre l'entrée spécifique à être supprimée.

Paramètres

key: string
source: string
context: string
localeId: string

Retours

void

RemoveTargetLocale

void

Supprime toutes les traductions de la table de localisation avec l'identifiant de lieu spécifié.

Paramètres

localeId: string

Retours

void

SetEntries

void

Définit le contenu de la table de localisation.

Le paramètre entrées doit être un tableau de dictionnaires dans le même format que celui renvoyé par la fonction LocalizationTable:GetEntries().

Paramètres

entries: Variant

Retours

void

SetEntryContext

void

Définit le contexte champ d'une entrée dans le Tableau de localisation à newContext, en utilisant le key spécifié, 2>source2> et 5>text5> pour restreindre l'entrée qui aura ce changement appliqué.

Paramètres

key: string
source: string
context: string
newContext: string

Retours

void

SetEntryExample

void

Définit le example champ d'une entrée dans le key à 1> example1>, en utilisant le 4> clé4>, 7> source7>, et 9> context9> pour restreindre l'entrée qui aura ce changement appliqué.

Paramètres

key: string
source: string
context: string
example: string

Retours

void

SetEntryKey

void

Définit le champ clé d'une entrée dans une table de localisation à newKey, en utilisant le key spécifié, 1> source1> et 4> context4> pour restreindre l'entrée qui aura ce changement appliqué.

Paramètres

key: string
source: string
context: string
newKey: string

Retours

void

SetEntrySource

void

Définit le champ Source d'une entrée dans le newSource à key , en utilisant le 1> clé1> , 4> source4> et 7> context7> pour restreindre l'entrée qui aura ce changement appliqué.

Paramètres

key: string
source: string
context: string
newSource: string

Retours

void

SetEntryValue

void

Définit le texte de la valeur de localisation spécifiée dans une entrée de la table de localisation, en utilisant le key spécifié, source et context pour restreindre l'entrée qui aura ce changement appliqué.

Paramètres

key: string
source: string
context: string
localeId: string
text: string

Retours

void
Afficher tous les hérités de Instance
Afficher tous les hérités de Object

Évènements

Afficher tous les hérités de Instance
Afficher tous les hérités de Object