管理テキスト

管理テキスト機能を使用すると、ゲーム内のUI文字列やキャラクターの表示名など、Naninovel全体で使用されるさまざまなテキスト要素を、ローカライズ可能なドキュメントを介して管理（置換）できます。

管理テキストドキュメントを生成するには、Naninovel -> Tools -> Managed Text エディタコンテキストメニューからアクセスできる管理テキストツールを使用します。

「Select」ボタンを使用して、管理テキストドキュメントを保存するパス（デフォルトでは Resources/Naninovel/Text）を選択し、「Generate」を押してドキュメントを作成します。

Create -> Naninovel -> Managed Text アセットコンテキストメニューを使用して、カスタム管理テキストドキュメントを作成することもできます。

管理テキストドキュメントの各行は、次の形式のエントリです：パス: 値。ここで、パスはテキスト変数へのパスであり、値はその変数の値です。たとえば、以下は組み込みUIのレコードを含む「DefaultUI」ドキュメントのデフォルトの内容です。

値を編集でき、変更は次回の実行時に適用されます。

Delete Unused オプションを有効にすると、ManagedTextProvider コンポーネントまたはソースコードの ManagedText 属性（詳細は以下を参照）を介して直接参照されていない管理テキストドキュメント内のレコードが削除されます。

TIP

管理テキスト値に改行を挿入するには、TMProテキストですぐにサポートされている <br> タグを使用します。

管理テキストプロバイダー

ManagedTextProvider コンポーネントを使用すると、スクリプトを使用せずに任意のUnityゲームオブジェクトを管理テキストレコードにバインドできます。コンポーネントをゲームオブジェクトに追加し、Category（ドキュメント名）、Key（ドキュメント内のレコード名）を指定し、OnValueChanged イベントを使用して値をゲームオブジェクトのプロパティにバインドします。

以下は、"MyCustomDocument" ドキュメントにキー "MyCustomText" で保存された管理テキストレコードをUnity Text コンポーネントにバインドする例です。

カスタムUI、テキストプリンター、または選択肢ハンドラーで ManagedTextProvider コンポーネントが使用されている場合、管理テキストツールを使用すると、対応するレコードが自動的に生成されます（リソースが構成メニューで割り当てられている場合）。その他の場合は、手動でレコードを追加する必要があります。

管理テキスト変数

管理テキストレコードをソースコード内の変数にバインドすることも可能です。これを行うには、ManagedText 属性を静的文字列フィールドに追加します。フィールドの値は、エンジンの初期化時に管理テキストドキュメントで指定された値で上書きされます。

以下は、管理テキスト変数を使用してC#スクリプト内のテキストラベルをローカライズする例です。

csharp

using Naninovel;
using UnityEngine.UI;

// UnityのTextコンポーネントを継承して、そのまま使用できるようにします。
public class CustomLabel : Text
{
    // "CustomLabel.LabelText" 管理テキストレコードの値は、エンジンの初期化時に
    // 以下の変数に割り当てられ、ロケールの変更時に更新されます。
    [ManagedText("foo")] // "foo" はレコードのドキュメント名です。
    public static string LabelText = "bar"; // "bar" はデフォルト値です。

    protected override void Awake ()
    {
        base.Awake();

        text = LabelText; // 現在のレコード値をラベルに割り当てます。

        var l10n = Engine.GetService<ILocalizationManager>();
        // ユーザーが実行時にロケールを変更したときにラベルを更新します。
        l10n.OnLocaleChanged += _ => text = LabelText;
    }
}

スクリプトテキスト

シナリオスクリプトから直接管理テキスト値を参照できます。これは、スクリプト式でローカライズ可能なテキストを使用したい場合に役立ちます。

Script という名前の管理テキストドキュメントを作成し、T_ または t_ 接頭辞を持つキーを使用してレコードを追加します。Script 管理テキストドキュメントに次のレコードがあるとします。

T_Greeting1: Hey!
T_Greeting2: Hello!
T_Greeting3: Hi!

—次のように値を参照できます。

nani

@print {Random(T_Greeting1,T_Greeting2,T_Greeting3)}

Script 管理テキストドキュメントは、他のドキュメントと同じ方法でローカライズできます。ユーザーが別のロケールを選択すると、テキストは対応するローカライズされたドキュメントから自動的に参照されます。

ローカライズ

管理テキストのローカライズは、シナリオスクリプトと同様のワークフローに従います。

Resources/Naninovel/Text フォルダに必要な管理テキストドキュメントを生成（作成/編集）します。
ロケールフォルダ（Resources/Naninovel/Localization/{Locale}、ここで {Locale} はターゲットロケールタグ）でローカライズユーティリティを実行します。
ソース管理テキストドキュメントのローカライズドキュメントが、対応するロケールフォルダに表示されます。それらを使用して翻訳を追加または編集します。

管理テキストドキュメントとそれに対応するローカライズ版を更新するには、まず Resources/Naninovel/Text フォルダで管理テキスト生成ユーティリティを実行し、次に Resources/Naninovel/Localization/{Locale} でローカライズユーティリティを実行します。どちらのユーティリティもデフォルトで既存の変更（管理テキストレコードとその翻訳）を保持しようとするため、更新ごとにすべてを書き直す必要はありません。

ローカライズユーティリティの使用方法の詳細については、ローカライズを参照してください。

EXAMPLE

ローカライズサンプルでローカライズ設定の例（管理テキストを含む）を見つけてください。自分のプロジェクトでローカライズを設定する際に問題がある場合は、参考にしてください。

カスタムドキュメント

カスタムニーズに合わせて任意の数の管理テキストドキュメントを作成し、エンジンが初期化されている間にC#で使用できます。これらのカスタムドキュメントは、上記で説明した組み込みタイプと同じように機能します。C#とシナリオスクリプトの両方でアクセスし、ManagedTextProvider コンポーネントを介してレコードを取得し、ローカライズドキュメントを自動生成するなどです。

Resources/Naninovel/Text フォルダ（または選択したリソースプロバイダーを介して公開）の下の Create -> Naninovel -> Managed Text アセットコンテキストメニューを介して、新しいカスタム管理テキストドキュメントを作成します。その後、C#の ITextManager エンジンサービスを介してドキュメントにアクセスできるようになります。以下は、Foo: Bar という内容の Custom という名前のカスタムドキュメントからレコードにアクセスする例です。

var manager = Engine.GetService<ITextManager>();
// ドキュメントはアクセスする前にロードする必要があります。
// 通常、カスタムシステムの初期化中に一度行われます。
await manager.DocumentLoader.Load("Custom");
var document = manager.GetDocument("Custom");
var record = document.Get("Foo");
Debug.Log($"Key: {record.Key} Value: {record.Value}");

管理テキスト ​

管理テキストプロバイダー ​

管理テキスト変数 ​

スクリプトテキスト ​

ローカライズ ​

カスタムドキュメント ​