LocalizationManager.cs

LocalizationManager Class

The LocalizationManager class provides a static interface for managing localization data, handling translations, and updating UI text elements in Unity. It loads localization data from JSON files and provides functions to manage and update localized text throughout the game.

Namespace: Indie.Localization

Fields:

• localizationData: A dictionary that stores localized data organized by scene, key, and language.

• currentLanguage: The currently selected language for displaying text.

• JsonFolderPath: The file path where localization JSON files are stored.

• JsonFileName: The name of the localization JSON file.

• supportedLanguages: An instance of the SupportedLanguages class, storing the list of supported languages.

Methods:

• LoadLocalizationData(): Loads localization data from the JSON file located at JsonPath. If the file doesn't exist, it initializes an empty dictionary. It also loads supported languages and OpenAI API key resources.

• GetLocalizedText(string sceneName, string key): Retrieves the localized text for a given scene and key. If the translation is not found, it adds a new entry with a simulated translation.

• AddOrUpdateEntry(string sceneName, string key, Dictionary<string, string> translations): Adds or updates a localization entry in the dictionary for a specific scene and key.

• SaveLocalizationData(): Saves the current localization data dictionary to the JSON file and refreshes the Unity Asset Database.

• SetLanguage(string language): Sets the current language for displaying text and updates all localized text elements.

• UpdateAllText(): Updates all instances of LocalizableText components in the scene to reflect the current language settings.

• AddLocalizableTextComponent(TextMeshProUGUI text): Adds a LocalizableText component to a TextMeshProUGUI object if it doesn't already have one, sets it up, and marks it for saving.

• RemoveAllLocalizableTextComponents(): Removes all instances of LocalizableText components from the scene.

• ClearAllLocalizationData(): Clears all localization data from the dictionary and saves the changes.

• ClearSceneLocalization(string sceneName): Removes all localization entries for a specific scene and saves the changes.

• UpdateSceneLocalization(): Iterates over all open scenes, updating the localization entries for each TextMeshProUGUI component found.

• GenerateSupportedLanguagesJSON(string originalText): Creates a JSON payload with simulated translations for each supported language.

• Translate(string jsonPayload): Asynchronously translates the provided JSON payload using OpenAI and returns a dictionary of translations.

• SetJsonFolderPath(string folderPath): Sets the folder path for storing JSON localization files.

• SetJsonFileName(string fileName): Sets the file name for the JSON localization file.

• SetSupportedLanguages(SupportedLanguages languages): Sets the supported languages for the localization system.