ローカライズ対応の実装例③

　前回に引き続き、多言語対応(ローカライズ対応)の実装例について紹介します。

　文字列の構造が下記のように、変数への参照データがある場合には別途実装が必要になります。

　おはよう name さん

　この場合のデータベースの構造と、ソースコードの実装方法について説明します。
また言語の変更が入った場合、リアルタイム(動的)に画面に反映される方法にて実装しています。

＜完成動画＞

１．設計

　前回作成したクラスのうち、LocalizeText クラス以外は修正は不要です。
またデータベース内に新しい文字列の構造のデータを追加して、動作検証を行います。
String.Format メソッドを利用して文字内の {} 部分を変数の内容に置き換える処理を実装して対応します。

　デバッグ用に新しいサンプルクラスを作成し、そちらで文字列の構造をベースにローカライズ対応した表示を行います。

MicroSoft
String.Format メソッド
https://learn.microsoft.com/ja-jp/dotnet/api/syste...

２．サンプルのデータベース

　スプレッドシート、あるいは Json データに新しいデータを追加するか、修正を行います。
文字列内の変数で置き換えたい部分を半角にて {0} と書きます。
これにより、String.Format メソッドにより、{0} 部分を置き換えることができます。
複数の文字列内の情報をゲーム内の情報で置き換えたい場合には {1} {2} のように {} 内の数字を１つずつ増やしてください。

　こちらについて、各言語ごとに登録してください。

　以下は以前利用したサンプルデータを修正したものです。

[
  {
    "tag": "greeting",
    "languageDatas": [
      "おはよう {0} {1} さん",
      "&#50504;&#45397;&#54616;&#49464;&#50836;",  // Seesaa Wiki の仕様上表示されませんが、韓国語です
      "Hello  {1} {0} "
    ]
  },
  {
    "tag": "battle",
    "languageDatas": [
      "戦闘  {0}  開始",
      "&#51204;&#53804;",  // Seesaa Wiki の仕様上表示されませんが、韓国語です
      "Battle  {0}  Start"
    ]
  }
]

３．LocalizeText クラスの修正

　新しい変数やメソッドを追加しています。

　ポイントはローカライズを行う際に、このクラス内ではなく、UnityAction に登録されている外部クラスのメソッドに処理を委譲している部分です。

LocalizeText.cs

<= クリックすると開きます

using UnityEngine;
using TMPro;
using UniRx;
using UnityEngine.Events;
using System;
using PlayFab;

public class LocalizeText : MonoBehaviour
{
    [SerializeField]
    private TMP_Text txtLocalize;
    
#pragma warning disable 0108
    [SerializeField] private string tag;
#pragma warning restore 0108

    public string Tag => tag;

    // マスターデータをキャッシュ
    [SerializeField] 
    private LocalizeMasterData localizeData;  // デバッグ終わったら SerializeField 外す
    public LocalizeMasterData LocalizeData => localizeData;

    private string message;

    UnityAction<Language> changeLanguageAction;
    IDisposable disposable;


    void Reset() {
        TryGetComponent(out txtLocalize);
        Debug.Log(txtLocalize);
    }

    void Start(){

        // tag が登録されていない場合には処理しない
        if (string.IsNullOrEmpty(tag)) {
            return;
        }

        LocalizeMasterData tempLocalizeData = StringManager.instance.GetLocalizeData(tag);

        if (tempLocalizeData != null) {
            // Tag からマスターデータ取得してキャッシュ(tag 内の全言語分キャッシュ済み)
            localizeData = StringManager.instance.GetLocalizeData(tag);
        }

        if (changeLanguageAction == null) {
            SetChangeLanguageAciton(UpdateLocalizeText);
        }

        // 言語監視
        disposable = StringManager.instance.CurrentLanguage.Subscribe(language => changeLanguageAction?.Invoke(language)).AddTo(this);
    }

    /// <summary>
    /// 言語変更による表示の切替
    /// </summary>
    /// <param name="newLanguage"></param>
    private void UpdateLocalizeText(Language newLanguage) {
        txtLocalize.text = localizeData.languageDatas[(int)newLanguage];
    }

    /// <summary>
    /// 文字設定
    /// </summary>
    /// <param name="newMessage"></param>
    public void SetMessageText(string newMessage) {

        message = newMessage;
        txtLocalize.text = newMessage;
        //Debug.Log(message);
    }

    /// <summary>
    /// ローカライズデータのセット
    /// </summary>
    /// <param name="newLocalizeData"></param>
    public void SetLocalizeData(LocalizeMasterData newLocalizeData) {
        localizeData = newLocalizeData;
        UpdateLocalizeText(StringManager.instance.CurrentLanguage.Value);
    }

    /// <summary>
    /// 現在表示中のメッセージを取得
    /// </summary>
    /// <returns></returns>
    public string GetMessage() {
        return txtLocalize.text;
    }

    public void SetChangeLanguageAciton(UnityAction<Language> languageAction) {
        //disposable?.Dispose();
        changeLanguageAction = languageAction;
        //disposable = StringManager.instance.CurrentLanguage.Subscribe(language => changeLanguageAction?.Invoke(language)).AddTo(this);
        Debug.Log(languageAction.GetDelegateName());
    }
}

４．＜デリゲートを活用した処理の作り方＞

５．サンプルクラス

SampleLocalize.cs

<= クリックすると開きます

using TMPro;
using UniRx;
using UnityEngine;
using UnityEngine.Events;
using UnityEngine.UI;

public class SampleLocalize : MonoBehaviour
{    
    [SerializeField, Header("挨拶ローカライズ")] private LocalizeText textMarriageCount;
    [SerializeField, Header("戦闘ローカライズ")] private LocalizeText textUserLevel;


    void Start()
    {
        // ユーザーレベルの購読処理
        UserDataManager.Instance.Level
            .Subscribe(level =>
                SetCurrentLevelText(level, 
                    ReviveManager.GetCharaMaxLevel(UserDataManager.Instance.CharaStatus.marriage_count)))
            .AddTo(this);
            
        // 結婚回数の購読処理
        UserDataManager.Instance.MarriageCount
            .Subscribe(count => 
            SetMarriageCountText(UserDataManager.Instance.CharaStatus.marriage_count))
            .AddTo(this);


        // LocalizeText 内の言語切り替え時の処理を登録
        textUserLevel.SetChangeLanguageAciton(OnChangeLanguageLocalizeCurrentLevetText);


        // デバッグ用
        //this.UpdateAsObservable()
        //    .Where(_ => Input.GetKeyDown(KeyCode.P))
        //    .ThrottleFirst(System.TimeSpan.FromSeconds(1.0f))
        //    .Subscribe(_ =>
        //    {
        //        MarriageCount.Value++;
        //        UserLevel.Value++;
        //    })
        //    .AddTo(this);
    }

    /// <summary>
    /// テキストUIに転生回数をセット
    /// </summary>
    /// <param name="count"></param>
    private void SetMarriageCountText(int count)
    {
        if (textMarriageCount.LocalizeData.languageDatas.Length == 0)
        {
            LocalizeMasterData localizeData = StringManager.instance.GetLocalizeData(textMarriageCount.Tag);
            textMarriageCount.SetLocalizeData(localizeData);
        }

        // ローカライズ対応。現在利用している言語の文字列を取得
        string templateString = textMarriageCount.LocalizeData.languageDatas[(int)StringManager.instance.CurrentLanguage.Value];

        // {0} の部分に女神の名前を埋め込む
        string formattedString = string.Format(templateString, count.ToString());

        // 女神の名前 + 確認メッセージの表示
        textMarriageCount.SetMessageText(formattedString);
    }

    /// <summary>
    /// テキストUIに現在のレベルをセット
    /// </summary>
    private void SetCurrentLevelText(int level ,int maxLevel)
    {
        if (textUserLevel.LocalizeData.languageDatas.Length == 0)
        {
            LocalizeMasterData localizeData = StringManager.instance.GetLocalizeData(textUserLevel.Tag);
            textUserLevel.SetLocalizeData(localizeData);
        }

        string templateString = textUserLevel.LocalizeData.languageDatas[(int)StringManager.instance.CurrentLanguage.Value];

        // {0} の部分に女神の名前を埋め込む
        string formattedString = string.Format(templateString, level, maxLevel);

        // 女神の名前 + 確認メッセージの表示
        textUserLevel.SetMessageText(formattedString);
    }


    public void OnChangeLanguageLocalizeCurrentLevetText(Language newLanguage) {
        SetCurrentLevelText(UserDataManager.Instance.Level.Value, ReviveManager.GetCharaMaxLevel(UserDataManager.Instance.CharaStatus.marriage_count));
        Debug.Log("OnChangeLanguageLocalizeCurrentLevetText");
    }
}

６．実装例

　ゲームを実行して動作を確認します。

　PlayFab の場合、ログイン後、タイトルデータからローカライズ対応用のマスターデータを取得し、
StringManager クラスにキャッシュしておきます。

　ゲーム内で利用する LocalizeText ゲームオブジェクトには、タグの設定が出来ますので、
そちらを任意のタグに設定します。

　そのようにしておくことで、LocalizeMasterData 内のタグと照合し、表示する内容を自動化できます。
同時に言語切り替え時のローカライズ対応も可能になります。

＜実装動画＞

　以上で完成です。

このページを編集するこのページを元に新規ページを作成

印刷する

コメント（0）

ローカライズ対応の実装例③ - i-school 先頭へ

コメントをかく

名前	ユーザIDを使用しないで書き込む	ユーザーIDを使う	ログインする
画像コード	画像に記載されている文字を下のフォームに入力してください。
備考	「http://」を含む投稿は禁止されています。
本文
利用規約をご確認のうえご記入下さい

i-school