VRCT/src-python/docs/details/translation_languages.md

translation_languages.py - 翻訳言語マッピング

概要

翻訳エンジンが対応する言語コードのマッピングテーブルを提供するモジュールです。複数の翻訳エンジン（DeepL、Google、Bing、Papago等）の言語コード仕様の差異を吸収し、統一的な翻訳言語管理を実現します。

主要機能

多エンジン対応

• DeepL（無料版・API版）
• Google Translate
• Microsoft Translator（Bing）
• Papago Translator
• その他のWeb翻訳サービス

言語コード統合管理

• 各エンジン固有の言語コード形式を統一
• 送信元（source）と送信先（target）言語の分離管理
• 地域固有言語バリエーションの対応

データ構造

translation_lang

translation_lang: Dict[str, Dict[str, Dict[str, str]]] = {
    "エンジン名": {
        "source": {"言語名": "言語コード", ...},
        "target": {"言語名": "言語コード", ...}
    }
}

DeepL翻訳エンジン（無料版）

translation_lang["DeepL"] = {
    "source": {
        "Arabic": "ar", "Bulgarian": "bg", "Czech": "cs", "Danish": "da",
        "German": "de", "Greek": "el", "English": "en", "Spanish": "es",
        "Estonian": "et", "Finnish": "fi", "French": "fr", "Irish": "ga",
        "Croatian": "hr", "Hungarian": "hu", "Indonesian": "id", 
        "Icelandic": "is", "Italian": "it", "Japanese": "ja",
        "Korean": "ko", "Lithuanian": "lt", "Latvian": "lv",
        "Maltese": "mt", "Bokmal": "nb", "Dutch": "nl",
        "Norwegian": "no", "Polish": "pl", "Portuguese": "pt",
        "Romanian": "ro", "Russian": "ru", "Slovak": "sk",
        "Slovenian": "sl", "Swedish": "sv", "Turkish": "tr",
        "Ukrainian": "uk", "Chinese Simplified": "zh",
        "Chinese Traditional": "zh"
    },
    "target": {/* 同じマッピング */}
}

DeepL API（有料版）

translation_lang["DeepL_API"] = {
    "source": {/* 基本的にDeepLと同様 */},
    "target": {
        "Japanese": "ja",
        "English American": "en-US",    # 地域別対応
        "English British": "en-GB",
        "Portuguese Brazilian": "pt-BR", # ブラジル・ポルトガル語
        "Portuguese European": "pt-PT",  # ヨーロッパ・ポルトガル語
        "Chinese Simplified": "zh",
        "Chinese Traditional": "zh"
        /* その他の言語 */
    }
}

主要対応言語

西欧言語

• English: 英語（米国・英国バリエーション）
• German: ドイツ語
• French: フランス語
• Spanish: スペイン語
• Italian: イタリア語
• Portuguese: ポルトガル語（ブラジル・欧州）
• Dutch: オランダ語
• Swedish: スウェーデン語
• Norwegian: ノルウェー語

東欧・スラブ言語

• Russian: ロシア語
• Polish: ポーランド語
• Czech: チェコ語
• Slovak: スロバキア語
• Ukrainian: ウクライナ語
• Bulgarian: ブルガリア語
• Croatian: クロアチア語
• Slovenian: スロベニア語

アジア言語

• Japanese: 日本語
• Korean: 韓国語
• Chinese Simplified: 中国語（簡体字）
• Chinese Traditional: 中国語（繁体字）
• Indonesian: インドネシア語

その他の言語

• Arabic: アラビア語
• Turkish: トルコ語
• Finnish: フィンランド語
• Estonian: エストニア語
• Latvian: ラトビア語
• Lithuanian: リトアニア語
• Maltese: マルタ語
• Irish: アイルランド語

使用方法

基本的な言語コード取得

from models.translation.translation_languages import translation_lang

# DeepLで日本語から英語への翻訳
deepl_source = translation_lang["DeepL"]["source"]["Japanese"]  # "ja"
deepl_target = translation_lang["DeepL"]["target"]["English"]   # "en"

# DeepL APIで地域固有の英語指定
deepl_api_target = translation_lang["DeepL_API"]["target"]["English American"]  # "en-US"

対応言語の確認

def get_supported_languages(engine_name):
    """指定エンジンの対応言語一覧取得"""
    if engine_name in translation_lang:
        engine_data = translation_lang[engine_name]
        source_langs = list(engine_data["source"].keys())
        target_langs = list(engine_data["target"].keys()) 
        return {
            "source": source_langs,
            "target": target_langs,
            "common": list(set(source_langs) & set(target_langs))
        }
    return None

# 使用例
deepl_langs = get_supported_languages("DeepL")
print(f"DeepL対応言語数: {len(deepl_langs['common'])}")

言語コード変換

def convert_language_code(language_name, from_engine, to_engine, direction="source"):
    """エンジン間での言語コード変換"""
    try:
        # 元エンジンから言語名を確認
        from_codes = translation_lang[from_engine][direction]
        to_codes = translation_lang[to_engine][direction]
        
        if language_name in from_codes and language_name in to_codes:
            return to_codes[language_name]
        return None
    except KeyError:
        return None

# 使用例：DeepLからGoogle Translateへの変換
google_code = convert_language_code("Japanese", "DeepL", "Google", "target")

翻訳システムでの統合利用

class TranslationLanguageManager:
    """翻訳言語管理クラス"""
    
    @staticmethod
    def get_language_code(engine, language, direction="target"):
        """安全な言語コード取得"""
        try:
            return translation_lang[engine][direction][language]
        except KeyError:
            return None
    
    @staticmethod
    def is_language_supported(engine, language, direction="target"):
        """言語サポート確認"""
        try:
            return language in translation_lang[engine][direction]
        except KeyError:
            return False
    
    @staticmethod
    def get_compatible_engines(source_lang, target_lang):
        """両言語をサポートするエンジン一覧"""
        compatible = []
        for engine in translation_lang:
            source_supported = TranslationLanguageManager.is_language_supported(
                engine, source_lang, "source"
            )
            target_supported = TranslationLanguageManager.is_language_supported(
                engine, target_lang, "target"
            )
            if source_supported and target_supported:
                compatible.append(engine)
        return compatible

# 使用例
manager = TranslationLanguageManager()

# 日本語→英語をサポートするエンジン
engines = manager.get_compatible_engines("Japanese", "English")
print(f"対応エンジン: {engines}")

# 特定エンジンでの言語コード取得
ja_code = manager.get_language_code("DeepL", "Japanese", "source")
en_code = manager.get_language_code("DeepL", "English", "target")

エンジン別特徴

DeepL（無料版）

• 強み: 高精度、自然な翻訳
• 制限: 月間使用量制限、API制限
• 対応: 26言語

DeepL API（有料版）

• 強み: DeepLの高精度、地域別言語対応
• 制限: 従量課金
• 対応: 地域固有言語バリエーション

Google Translate

• 強み: 多言語対応、高速
• 制限: API制限、精度のばらつき
• 対応: 100+言語

Microsoft Translator

• 強み: リアルタイム翻訳、音声対応
• 制限: APIキー必要
• 対応: 70+言語

地域バリエーション対応

英語の地域別対応

# DeepL APIでの英語バリエーション
"English American": "en-US",    # アメリカ英語
"English British": "en-GB",     # イギリス英語

ポルトガル語の地域別対応

# ブラジル・ポルトガル語とヨーロッパ・ポルトガル語
"Portuguese Brazilian": "pt-BR",
"Portuguese European": "pt-PT",

中国語の文字体系対応

# 簡体字・繁体字の区別
"Chinese Simplified": "zh",     # 簡体字（中国本土）
"Chinese Traditional": "zh",    # 繁体字（台湾・香港）

拡張性

新エンジンの追加

# 新しい翻訳エンジンの追加例
translation_lang["NewEngine"] = {
    "source": {
        "Japanese": "jp",
        "English": "en",
        "Korean": "kr"
    },
    "target": {
        "Japanese": "jp",
        "English": "en",
        "Korean": "kr"
    }
}

新言語の追加

# 既存エンジンへの新言語追加
translation_lang["DeepL"]["source"]["Hindi"] = "hi"
translation_lang["DeepL"]["target"]["Hindi"] = "hi"

エラーハンドリング

安全な言語コード取得

def safe_get_language_code(engine, language, direction="target", fallback="en"):
    """フォールバック機能付き言語コード取得"""
    try:
        return translation_lang[engine][direction][language]
    except KeyError:
        # フォールバック言語を返す
        try:
            return translation_lang[engine][direction].get("English", fallback)
        except KeyError:
            return fallback

言語サポート検証

def validate_translation_pair(engine, source_lang, target_lang):
    """翻訳ペアの有効性検証"""
    try:
        engine_data = translation_lang[engine]
        source_supported = source_lang in engine_data["source"]
        target_supported = target_lang in engine_data["target"]
        
        return {
            "valid": source_supported and target_supported,
            "source_supported": source_supported,
            "target_supported": target_supported
        }
    except KeyError:
        return {
            "valid": False,
            "source_supported": False,
            "target_supported": False,
            "error": f"Unknown engine: {engine}"
        }

注意事項

• エンジンによって言語コード形式が異なる
• 地域バリエーションはエンジンにより対応状況が異なる
• 新しい言語追加時は全エンジンでの対応状況を確認
• API制限や課金体系はエンジンごとに異なる
• 一部の言語ペアは翻訳精度に差がある場合がある

関連モジュール

• translation_translator.py: 翻訳エンジン本体
• translation_utils.py: 翻訳ユーティリティ
• transcription_languages.py: 音声認識言語マッピング
• config.py: 翻訳言語設定管理
• controller.py: 言語選択UI制御