Skip to content

Unity TTS plugin: Piper neural synthesis + OpenJTalk Japanese + Unity AI Inference Engine. Windows/Mac/Linux/Android/iOS ready. High-quality voices for games & apps.

License

Notifications You must be signed in to change notification settings

ayutaz/uPiper

Repository files navigation

uPiper

English | 日本語

Unity Tests Unity Build

piper-plusのUnityプラグイン - 高品質なニューラル音声合成エンジン

目次

機能

  • 高品質な音声合成(piper-plusベース)
  • 多言語対応(日本語、英語)
  • Unity AI Inference Engineによる高速推論
  • OpenJTalkによる高精度な日本語音素化(Windows/macOS/Linux/Android/iOS)
  • GPU推論サポート(GPUCompute/GPUPixel)

Requirements

  • Unity 6000.0.55f1
  • Unity AI Interface (Inference Engine) 2.2.x

インストール

Unity Package Manager経由(推奨)

ステップ1: パッケージのインストール

  1. Unity Editorで Window > Package Manager を開く
  2. + ボタンから Add package from git URL... を選択
  3. 以下のURLを入力:
    https://github.com/ayutaz/uPiper.git?path=Assets/uPiper
    

ステップ2: 必要なデータのインポート

Package Managerからインストール後、必ず以下の手順でデータをインポートしてください

  1. Package Managerで「In Project」を選択
  2. 「uPiper」パッケージを選択
  3. 「Samples」セクションを展開
  4. 以下のサンプルをインポート
    • OpenJTalk Dictionary Data (必須) - 日本語音声合成用辞書
    • CMU Pronouncing Dictionary (必須) - 英語音声合成用辞書
    • Voice Models (推奨) - 高品質音声モデル
    • Basic TTS Demo (オプション) - デモシーン

ステップ3: データのセットアップ

サンプルをインポートした後:

  1. メニューから uPiper > Setup > Install from Samples を実行
  2. インストールダイアログで「Install」をクリック
  3. セットアップが完了するまで待つ

ステップ4: 動作確認

  1. メニューから uPiper > Setup > Check Setup Status を実行
  2. すべての項目が「✓ Installed」になっていることを確認
  3. Basic TTS Demoシーンを開いて動作確認

⚠️ 重要: 辞書データをインポートしないとTTS機能は動作しません

パッケージファイルからのインストール

Releasesから最新のパッケージファイルをダウンロード:

  • Unity Package (.unitypackage): レガシー形式、全てのUnityバージョンで使用可能
  • UPM Package (.tgz): Unity Package Manager用、Unity 2019.3以降

トラブルシューティング

Samplesが1つしか表示されない場合

  • Unity Editorを再起動
  • Package Managerで「Refresh」ボタンをクリック

辞書ファイルが見つからないエラー

  • uPiper > Setup > Install from Samples を実行したか確認
  • uPiper > Setup > Check Setup Status で状態を確認

日本語が文字化けする場合

  • Basic TTS Demoに含まれるNotoSansJP-Regular SDFフォントを使用

UIボタンがクリックできない場合(Input Manager使用時)

  • プロジェクト設定で「Active Input Handling」を確認
  • Edit > Project Settings > Player > Active Input Handling
  • 「Input Manager」に設定されている場合、EventSystemAutoSetupコンポーネントが自動的に対応
  • 詳細は Samples~/BasicTTSDemo/BasicTTSDemo_README.md を参照

サポートプラットフォーム

現在サポート中

  • ✅ Windows (x64)
  • ✅ macOS (Apple Silicon/Intel)
  • ✅ Linux (x64)
  • ✅ Android (ARM64/ARMv7/x86/x86_64)
  • ✅ iOS (ARM64, iOS 11.0+)

未対応

  • ❌ WebGL - 技術調査中(piper-plus連携により将来対応予定)

GPU推論の使用

uPiperはGPU推論をサポートしており、より高速な音声生成が可能です:

var config = new PiperConfig
{
    Backend = InferenceBackend.Auto,  // 自動選択
    AllowFallbackToCPU = true,        // GPU失敗時にCPUフォールバック
    GPUSettings = new GPUInferenceSettings
    {
        MaxBatchSize = 4,
        UseFloat16 = true,
        MaxMemoryMB = 512
    }
};

詳細はGPU推論ガイドを参照してください。

詳細ドキュメント

ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。詳細は LICENSE ファイルを参照してください。

サードパーティライセンス

フォント

  • Noto Sans Japanese: SIL Open Font License, Version 1.1
    • Copyright 2014-2021 Adobe (http://www.adobe.com/)
    • TextMeshProでの日本語表示に使用
    • 詳細は Assets/Fonts/LICENSE.txt を参照

About

Unity TTS plugin: Piper neural synthesis + OpenJTalk Japanese + Unity AI Inference Engine. Windows/Mac/Linux/Android/iOS ready. High-quality voices for games & apps.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Contributors 2

  •  
  •