Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


SystemLocaleSelector

Detects the language the device is set to and matches the closest available locale.
Read time 1 minuteLast updated 5 days ago

Definition

public class SystemLocaleSelector : IStartupLocaleSelector

Remarks

This selector first tries SystemLocaleSelector.GetSystemCulture, which reports the language the user asked the operating system for. Apple platforms, Android and WebGL give that as a language tag carrying the region and the script, such as
pt-BR
or
zh-Hant-TW
; elsewhere it falls back to CurrentUICulture. When no locale matches it tries Application.systemLanguage, which every platform reports but which carries the language alone. Each answer is matched against LocaleIdentifier and then up the culture parent chain, so a device set to
fr-FR
selects
fr
when only
fr
is available. Disabled locales are passed over, so a disabled match does not stop the search. If nothing matches, GetStartupLocale returns null and the next selector in LocalizationSettings.StartupSelectors runs. This selector is part of the default selector chain. Override SystemLocaleSelector.GetSystemCulture to supply a fixed culture in tests.
Selects the locale that best matches the device language.

Examples

using Unity.Localization;namespace Unity.Localization.Samples{ public class SystemLocaleSelectorExample { public Locale Run() { var selector = new SystemLocaleSelector(); Locale locale = selector.GetStartupLocale(LocalizationSettings.Instance); return locale; } }}

Methods

Method

Description

GetSystemCultureReturns the culture used to detect the startup locale.