メインコンテンツまでスキップ

高度な機能

AI Localization Automator には、ローカライゼーションのワークフローを効率化し、複雑なプロジェクトに最大限の柔軟性を提供するためのいくつかの高度な機能が含まれています。

翻訳テーブルとセッション管理​

翻訳ステータスの追跡​

メインの翻訳テーブルは、すべてのテキストエントリに対して包括的なステータス情報を提供します：

  • Pending: 翻訳待ちのテキスト
  • In Progress: 現在翻訳中
  • Completed: 正常に翻訳完了（緑色で表示）
  • Failed: すべての再試行後に翻訳が失敗（赤色で表示）
  • Cancelled: 翻訳が中断された

コンテキストメニューアクション​

テキストエントリを右クリックしてクイックアクションにアクセス：

ソーステキストの場合：

  • Copy Source Text: 元のテキストをクリップボードにコピー

翻訳エントリの場合：

  • Copy Translation: 翻訳されたテキストをクリップボードにコピー
  • Delete Translation: セッション翻訳を削除（現在のセッションで翻訳されたテキストのみ利用可能）

プリセットシステム​

完全な設定プリセットを保存および読み込み、異なるプロジェクト設定を素早く切り替えたり、チーム全体で設定を共有したりできます。

プリセットの管理​

プリセットシステムにより、ワンクリックで完全な設定を保存および復元できます：

プリセットの保存は、現在のすべての設定をキャプチャします：

  • 選択された翻訳プロバイダー
  • プロバイダー固有の設定（APIキー、モデル、パラメータ）
  • 翻訳設定（同時実行数、再試行、タイムアウト）
  • カスタムプロンプトテンプレート

プリセットの読み込みは、保存されたすべての設定を即座に適用し、以下を容易にします：

  • 異なるAIプロバイダー間の切り替え
  • チーム標準の設定の適用
  • 新しいプロジェクトの迅速なセットアップ
  • 異なるパラメータの組み合わせのテスト

プリセットファイル形式​

プリセットは、プロジェクトの Saved/TranslationPresets/ ディレクトリにJSONファイルとして保存されます：

  • バージョン管理のための人間が読める形式
  • 作成日やUEバージョンなどのメタデータを含む
  • チームメンバー間で共有可能
  • 適切な場合、機密データを安全に除外

バッチ処理コントロール​

同時実行管理​

同時に実行する翻訳の数を制御：

  • 低い同時実行数 (1-5): 控えめなアプローチ、API負荷を軽減
  • 中程度の同時実行数 (6-15): クラウドプロバイダー向けのバランスの取れたパフォーマンスと信頼性
  • 高い同時実行数 (16-50): クラウドプロバイダー向けの最大速度、安定した接続が必要 プロバイダー固有の推奨事項:
  • Ollama (ローカル): ローカルリソースに過負荷をかけないよう、低い同時実行数（約4）を使用する
  • クラウドプロバイダー (OpenAI、Anthropicなど): ネットワークの安定性とAPIレート制限に基づき、中〜高の同時実行数を使用する

リトライロジック​

高度なリトライシステムが一時的な障害を処理します:

翻訳ごとのリトライ: 各テキストエントリは、設定された上限までリトライされ、その後失敗としてマークされます。

グローバルな障害保護: すべての翻訳で連続して多くの失敗が発生した場合、システム全体の問題によるAPIコールの浪費を防ぐために、プロセス全体が停止します。

一時停止と再開​

  • 翻訳の一時停止: 進捗を失うことなく処理を一時的に停止
  • 翻訳の再開: 中断した場所から続行
  • 翻訳のキャンセル: 完全に停止し、処理中の項目をキャンセル済みとしてマーク

カスタムプロンプトテンプレート​

テンプレート変数​

プロンプトテンプレートは、いくつかのコンテキスト対応変数をサポートしています:

  • {SourceLanguage_EnglishName}: 英語でのソース言語（例: "German"）
  • {SourceLanguage_NativeLanguage}: ネイティブ表記でのソース言語（例: "Deutsch"）
  • {TargetLanguage_EnglishName}: 英語でのターゲット言語（例: "Spanish"）
  • {TargetLanguage_NativeLanguage}: ネイティブ表記でのターゲット言語（例: "español"）
  • {SourceText}: 翻訳する実際のテキスト
  • {ProviderName}: 現在のAIプロバイダー名

テンプレートのベストプラクティス​

効果的なプロンプトは以下を行うべきです:

  • 翻訳タスクを明確に述べる
  • フォーマット指定子（%s、{0}など）の保持を強調する
  • AIに翻訳のみを出力するよう指示する
  • コンテンツタイプ（ゲームUI、ダイアログなど）に関するコンテキストを提供する
  • スタイル要件（フォーマル、カジュアル、技術的など）を指定する

ゲームUIの例:

Translate this game user interface text from {SourceLanguage_EnglishName} to {TargetLanguage_EnglishName}.

IMPORTANT:
- Output ONLY the translated text
- Preserve all format specifiers like %s, %d, {0}, {1}
- Keep UI text concise and clear
- Use appropriate formality for game interface

Text to translate: {SourceText}

データ管理​

翻訳のクリア​

「翻訳のクリア」機能は、すべてのセッション翻訳を削除し、保存されたアーカイブファイルから再読み込みします：

  • 現在のセッションで行われた翻訳のみに影響します
  • 以前に保存された翻訳は保持されます
  • 異なるプロバイダーや設定のテストに便利です
  • 確認後は元に戻せません

翻訳の保存​

完了した翻訳をUEのローカライゼーションアーカイブファイルにコミットします：

  • 各ターゲットカルチャの .archive ファイルを更新します
  • UEのローカライゼーションシステムと統合します
  • このセッションで変更されていない既存の翻訳を保持します
  • ローカライゼーションターゲットの統計を更新します

進捗状況の監視​

リアルタイム進捗更新​

進捗システムは詳細なフィードバックを提供します：

  • 進捗バー: 完了率の視覚的表示
  • 数値進捗: 「X/Y 完了」カウンター
  • ステータスメッセージ: 現在の操作とプロバイダー情報
  • アクティブリクエスト数: 現在処理中の翻訳数

永続的な進捗追跡​

長い翻訳セッション中：

  • 一時停止して再開しても進捗は維持されます
  • セッション翻訳は保存された翻訳とは別に追跡されます
  • 明示的にクリアされるまで翻訳ステータスは維持されます
  • AI Translation Managerを安全に閉じて再開できます

ローカライゼーションダッシュボードとの統合​

シームレスなワークフロー​

プラグインはUEのローカライゼーションシステムと直接統合します：

  • 収集されたテキストエントリを自動的に検出します
  • アーカイブファイルから既存の翻訳を読み取ります
  • 結果をUEの標準形式で保存します
  • ローカライゼーションターゲットの統計を更新します
  • 他のローカライゼーションツールとの互換性を維持します

マルチターゲットサポート​

UIは一度に1つのターゲットに焦点を当てますが：

  • 各ローカライゼーションターゲットは独自の翻訳状態を維持します
  • プロバイダー設定はターゲット間で共有されます
  • 複数のターゲットを順番に作業できます
  • セッション追跡はターゲットごとに行われます

パフォーマンス最適化​

メモリ管理​

プラグインは効率的なメモリ使用のために設計されています：

  • すべてを一度に読み込むのではなく、翻訳データをストリーミングします
  • 完了したリクエストを自動的にクリーンアップします
  • 大規模な翻訳テーブルに対して効率的にUI更新を管理します
  • パフォーマンスの低下なく数千のエントリを処理します

ネットワーク最適化​

クラウドプロバイダー向け：

  • 設定可能なリクエストタイムアウトでハングを防止します
  • 指数関数的バックオフによる自動リトライ
  • スループット向上のためのコネクションプーリング
  • プロバイダーがサポートする場合のリクエストバッチ処理

エラーリカバリ​

堅牢なエラー処理により信頼性の高い運用を保証します：

  • 一時的なネットワーク問題に対する自動リトライ
  • プロバイダーが利用不可の場合の優雅な機能低下
  • トラブルシューティングのための詳細なエラーログ記録
  • 不正な形式のAPIレスポンスの安全な処理