- このコンポーネントを利用すると、各種ハンドルの最大数の設定など、指定した条件での初期化を行うことができます。
- 注意:
- プラグインの機能を使う場合、CRIWARE Library Initializerコンポーネントは必ずシーンに配置してください。
本コンポーネントを使わないとプラグインが正常動作しない可能性があります。
- ［備考］
(*1) CRIWARE Library Initializerは[GameObject]->[CRIWARE]->[Create CRIWARE Library Initializer]メニューからも作成できます。
この場合は、ゲームオブジェクトとして作成することになります。
[Initializes File System]チェックボックス
- CRIWARE共通のファイルシステムである「CRI File Systemライブラリ」の初期化を行います。
[File System Config]グループ
- CRI File Systemライブラリの初期化パラメータを設定します。
パラメータ 説明 デフォルト値 Number of Loaders 使用する ::CriFsLoader ハンドルの数。
CriFsLoaderは通常のファイル読み込みに使います。
CRI Atomの機能を使用する場合は、Number of Loadersの値を最低でも１つ増やす必要があります。16 Number of Binders 使用する ::CriFsBinder ハンドルの数。
CriFsBinderはフォルダやCPKファイル(専用パッキングファイル) からのファイル読み込みに使います。
また、一つのAWBファイルのロードにつき、一つバインダ数を増やしてください。（内部でバインダを一つ消費するため）8 Number of Installers 使用する ::CriFsInstaller ハンドルの数。
CriFsInstallerは書き込み可能な外部デバイス（HDDなど）へファイルをコピーするために使います。
Number of Installersを1増やす度に、メモリ確保量が 2KB程度増えます。2 Install Buffer Size ::CriFsInstaller の設定です。
ファイルコピー時のバッファサイズをKiB単位で指定します。
4096 [KiB] Max Length of Path 読み込みやインストール時に指定するパスの最大の長さを指定します。
HTTPリクエスト時のURLの最大長もこの数値に依存します。
終端文字も含めるため、実際に使用できる文字数は"本数値-1"となります。256 [byte] User Agent String HTTPリクエスト時のUser-Agent文字列です。最大255文字(255バイト)です。
なし Minimize FD Usage このチェックが有効な場合、プラグイン側でのファイルディスクリプタの使用を最小限で行うようになります。
ファイルディスクリプタの節約を行いたい場合に有効にしてください。ただし、有効にするとファイル読み込み性能が若干落ちる恐れがあります。無効
| Android Config | Android用コンフィグ: | |
|---|---|---|
| - Device Read Bitrate | Androidのデバイス読み込み速度設定です。 | 50000000 [bps] |
[Initializes Atom]チェックボックス
- 「CRI Atomライブラリ」（CRI ADX2用ライブラリ）の初期化を行います。
[Atom Config]グループ
- CRI Atomライブラリの初期化パラメータを設定します。
| パラメータ | 説明 | デフォルト値 |
|---|---|---|
| ACF File Name | デフォルトのACFファイルを指定します。 | なし |
| Max Virtual Voices | 最大バーチャルボイス数。 同時に発音制御を行うボイス数です。 | 32 |
| Max Voice Limit Groups | 最大ボイスリミットグループ数。 オーサリングツール上で作成したボイスリミットグループの数が、設定値を超える場合、ACFファイルのロードに失敗します。 | 32 |
| Max Categories | 最大カテゴリ数。 オーサリングツール上で作成したボイスリミットグループの数が、設定値を超える場合、ACFファイルのロードに失敗します。 | 32 |
| Sampling Rate | 出力サンプリングレート。 HCA-MXデータ使用時は、データのサンプリングレートと同じレートを指定する必要があります。 0（デフォルト値）の場合、PCは48kHz、iOS／Androidは44.1kHzとなります。 | 0 |
| Server Frequency | CRI Atomのサーバ処理の動作周波数。 サーバ処理では、発音リクエスト処理、パラメータ更新、音声データのデコードと出力を行います。 | 60 [Hz] |
| ASR Output Mode | [Default]の場合、プラットフォームがサポートする最大チャンネル数で出力を行います。 [Stereo]を選択した場合は、2chにミキシングしてデバイスに出力します。 | Default |
| Uses Time For Seed | 音声の各種ランダム再生時に使用する乱数種に時刻を使用するかどうかを指定します。 使用しない場合、乱数種は固定になります。 | 使用しない |
| Uses In Game Preview | インゲームプレビュー機能を使用するかどうかを指定します。 現状、PC以外のプラットフォームでは無効です。 | 使用しない |
| Standard Voice Pool Config | 標準ボイスプール用コンフィグ： 標準ボイスはADXデータとHCAデータを再生することができます。 | |
| - Memory Voices | 標準ボイスのメモリ再生数 | 16 |
| - Streaming Voices | 標準ボイスのストリーム再生数。 再生数１つにつき、CriFsLoaderハンドルが１つ必要です。 Streaming Voicesの値を１つ増やす場合、[File System Config]グループのNubmer of Loadersの値も１つ増やしてください。 | 8 |
| HCA-MX Voice Pool Config | HCA-MXボイスプール用コンフィグ： HCA-MXボイスはHCA-MXデータを再生することができます。 | |
| - Memory Voices | HCA-MXボイスのメモリ再生数 | 0 |
| - Streaming Voices | HCA-MXボイスのストリーム再生数 再生数１つにつき、CriFsLoaderハンドルを１つ必要です。 Streaming Voicesの値を１つ増やす場合、[File System Config]グループのNubmer of Loadersの値も１つ増やしてください。 | 0 |
| iOS Config | iOS用コンフィグ: | |
|---|---|---|
| - Buffering Time | バッファサイズ (msec単位での指定) iOS端末で音声が途切れる場合このサイズを増やします。また、レイテンシを短くする場合にこのサイズを減らします。 | 50 [msec] |
| - Override iPod Music | iPodで音が再生されている場合に、iPodを停止するかを制御。 同様の設定がUnityのiOS固有設定にありますが、Atomライブラリを使用する場合は常にAtomライブラリの設定が使用されます。 | 停止させない |
| Android Config | Android用コンフィグ: | |
| - Buffering Time | バッファサイズ (msec単位での指定) | 133 [msec] |
| - Start Buf Time | 再生開始バッファサイズ (msec単位での指定) | 100 [msec] |
| Low Latency Standard Voice Pool Config | 低遅延再生用の標準ボイスプール設定: | |
| - Memory Voices | 低遅延再生用の標準ボイスプールのメモリ再生数 | 0 |
| - Streaming Voices | 低遅延再生用の標準ボイスプールのストリーム再生数 再生数１つにつき、CriFsLoaderハンドルを１つ必要です。 Streaming Voicesの値を１つ増やす場合、[File System Config]グループのNubmer of Loadersの値も１つ増やしてください。 | 0 |
[Don't Initialize On Awake]チェックボックス
- このチェックが有効な場合、Awake内でのプラグインの自動初期化を行いません。
初期化パラメタをスクリプトから動的に変更したい場合にチェックを有効にしてください。
有効にした場合、必ず CriWareInitializer::Initialize 関数で手動初期化を行う必要があります。
[Don't Destroy On Load]チェックボックス
- このチェックが無効な場合は、シーン切り替えを行った際にライブラリの終了処理を行います。
シーンを越えてサウンド制御を行いたい場合や、初期化設定を変更する必要がない場合はこのチェックボックスを有効にしてください。
- CRIWARE Library Initializer はアプリケーション全体を通して同時に１つしか存在しません。
複数のシーンにCRIWARE Library Initializer が設定されていてシーン切り替えを行った場合、Hierarchyウインドウに CRIWARE Library Initializer が２個表示される事がありますが、２個目 CRIWARE Library Initializer は中身のない無効なオブジェクトです。２個目の CRIWARE Library Initializer はシーン破棄時に一緒に破棄されますので実害はありません。
- 注意:
- CriWareInitializerが作成される前に他のCRIWAREコンポーネントを操作すると、そのタイミングでライブラリがデフォルトパラメータで初期化されてしまい、CriWareInitializerに指定したパラメータが反映されない可能性があります。
CriWareInitializerに指定したパラメータで確実に初期化処理を行いたい場合には、以下の操作を行ってください。
- アプリケーション起動後、最初に実行されるシーンにCriWareInitializerコンポーネントを配置する。
- [Execution Order]でCriWareInitializer.csが他のスクリプトよりも先に実行されるよう設定する。
- [Don't Destroy On Load]チェックボックスを有効にし、シーンチェンジ後も初期化状態を維持する。
