ResourceTable

Description

A localization table that holds the translated values for one locale in a collection.

Each table targets a single locale (reported by ResourceTable.LocaleIdentifier) and shares its keys with every other locale table in the collection through one SharedTableData. Values are stored as polymorphic IResourceEntry objects (strings, assets, variants, or custom kinds) held through [SerializeReference], so a single table type covers every entry kind. Look entries up by stable key id or by key text with the ResourceTable.GetEntry family, add plain strings with ResourceTable.AddStringEntry, and add fully-formed entries with ResourceTable.AddEntry. Create a table through the ScriptableObject.CreateInstance method or the asset menu, and assign ResourceTable.SharedData before resolving keys by text.

Additional resources: SharedTableData, IResourceEntry, IStringEntry, LocaleIdentifier

<para>Create a table, add a string, and read it back.</para>

using Unity.Localization;
using UnityEngine;

namespace Unity.Localization.Samples
{
    public class ResourceTableOverviewExample
    {
        public void Run()
        {
            var shared = ScriptableObject.CreateInstance<SharedTableData>();
            var table = ScriptableObject.CreateInstance<ResourceTable>();
            table.SharedData = shared;
            table.LocaleIdentifier = "en";

            table.AddStringEntry("Greeting", "Hello");

            var entry = table.GetEntry<IStringEntry>("Greeting");
            Debug.Log(entry.Value); // Hello
        }
    }
}

Properties

Public Methods

Inherited Members