GetText

From Intrigues Wiki
Revision as of 14:48, 4 January 2024 by Tayfunwiki (talk | contribs) (Created page with "== <code>GetText</code> Method in IM Class == === Overview === The <code>GetText</code> method in the IM (Intrigue Manager) class is designed to retrieve the localized string associated with a specified key, according to the current language setting. === Description === * Method Signature: <code>public static string GetText(string key)</code> * Parameters: ** <code>key</code>: A string key that corresponds to the desired text in the localization database. === Functio...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

GetText Method in IM Class

Overview

The GetText method in the IM (Intrigue Manager) class is designed to retrieve the localized string associated with a specified key, according to the current language setting.

Description

  • Method Signature: public static string GetText(string key)
  • Parameters:
    • key: A string key that corresponds to the desired text in the localization database.

Functionality

  • The method first checks if it is being called within the Unity Editor and not during gameplay. If so, it retrieves the text for the editor context.
  • It then uses the provided key to fetch the corresponding localized text from the IEDatabase for the current language.
  • If the key is found and the text is not empty, it processes the text, potentially replacing variables within it.
  • If the text is not found, or if there is an issue with the key, it attempts to retrieve the text through an alternative method.

Usage

This method is used to dynamically fetch localized text based on the current language setting. It is crucial for implementing multilingual support in the game, allowing text elements like UI labels, dialogue, and notifications to adapt to the selected language.

Example of Usage

public class UIManager : MonoBehaviour {
    public Text messageText;

    void DisplayWelcomeMessage() {
        string welcomeKey = "welcome_message";
        string localizedText = IM.GetText(welcomeKey);
        messageText.text = localizedText;
    }
}

Description:

  • DisplayWelcomeMessage: This method demonstrates how to use IM.GetText to retrieve a localized string based on a key and then display it in a UI text element.

Remarks

  • The GetText method is vital for games with localization requirements, ensuring that all text elements reflect the current language setting.
  • Proper use of this method contributes significantly to the accessibility and user-friendliness of the game, catering to a global player base.
  • It's particularly important in narrative-driven games, educational software, or any application where language and text play a critical role.