Pixi’VN
ナレーション

国際化

i18next などのライブラリと onInkTranslate 関数を使って、Pixi’VN の ink テキストを翻訳する方法を学びます。

詳しくはこちらで説明していますが、Pixi’VN では i18next などのライブラリを使ってゲーム内のテキストを翻訳できます。また、ink と Pixi’VN の連携でも、ライブラリを使って ink のテキストを翻訳できます。

Pixi’VN では、onInkTranslate 関数を使って翻訳イベントを捕捉できます。

import { onInkTranslate } from "@drincs/pixi-vn-ink";
import { useEffect } from "react";
import { useTranslation } from "react-i18next";

export default function useInkInitialization() {
    const { t } = useTranslation(["narration"]);
    useEffect(() => {
        onInkTranslate(t);
    }, [t]);

    return null;
}

翻訳ファイルの自動生成

テンプレート

すべてのテンプレートで、設定にある次のボタンを使うと、翻訳に使用する JSON ファイルを自動生成できます。 dowload-translate

翻訳ファイルを簡単に作成できるよう、generateJsonInkTranslation 関数を使って ink テキストから JSON 構造を自動生成できます。

lib/i18n.ts
import { generateJsonInkTranslation } from "@drincs/pixi-vn-ink";
import i18n from "i18next";
import { convertInkToJson } from "./utils/ink-utility";

function getLocalesResource(
    lng: string,
): Promise<Record<string, Record<string, string>>> {
    return import(`./../locales/${lng}.json`);
}

async function generateResourceToTranslate(lng: string): Promise<any> {
    let res = await getLocalesResource(lng);
    res = { ...res };
    if (!res) {
        res = {};
    }
    if (!res.narration) {
        res.narration = {};
    }
    if (res.default) {
        delete res.default;
    }
    const manifest = await import("@/assets/ink-manifest.gen.json");
    for (const path of manifest.default) {
        const element = await fetch(path).then((r) => r.json());
        element && (await generateJsonInkTranslation(element, res.narration));
    }
    return res;
}

export async function downloadResourceToTranslate() {
    const lng = i18n.options.fallbackLng?.toString() || "en";
    const data = await generateResourceToTranslate(lng);
    const jsonString = JSON.stringify(data);
    // download the save data as a JSON file
    const blob = new Blob([jsonString], { type: "application/json" });
    // download the file
    const url = URL.createObjectURL(blob);
    const a = document.createElement("a");
    a.href = url;
    a.download = `strings_${lng}.json`;
    a.click();
}

このページの内容