LocalizationSettings.PreferredLoading

Description

The default loading behaviour used by the reference accessors and their change events.

Defaults to LoadingPreference.Asynchronous. When set to LoadingPreference.Synchronous, the event-driven accessors (LocalizedString.GetLocalizedStringAsync, LocalizedAsset<T0>.GetLocalizedAssetAsync, and LocalizedTable.GetTableAsync) resolve synchronously when the value is available, and fall back to an asynchronous load when it is not. When no settings instance is registered, this reads as LoadingPreference.Asynchronous.

Additional resources: LoadingPreference

<para>Make localized references resolve synchronously by default.</para>

using Unity.Localization;
using UnityEngine;

namespace Unity.Localization.Samples
{
    public class PreferredLoadingExample : MonoBehaviour
    {
        [SerializeField] LocalizedString m_Greeting = new();

        void OnEnable()
        {
            LocalizationSettings.PreferredLoading = LoadingPreference.Synchronous;
            m_Greeting.StringChanged += OnGreetingChanged;
        }

        void OnDisable() => m_Greeting.StringChanged -= OnGreetingChanged;

        void OnGreetingChanged(string value) => Debug.Log(value);
    }
}