CRIWAREの初期化パラメータ詳細
プロジェクト設定画面で設定可能な項目について
現在のバージョンでは、プロジェクト設定で以下のパラメータを編集できます。
File Systemライブラリ初期化設定
Non-Asset Content Directory
コンテンツの配置場所を指定します。
絶対パスまたはContentフォルダに対する相対パスを指定します。
(「/」で始まるパスが指定された場合は絶対パス、「/」以外で始まるパスが指定された場合はContentフォルダに対する相対パスと解釈されます。)
Number of Binders
バインダ数を指定します。
CRIWARE UE4プラグインとは別に、アプリケーションでCriFsBinderHnを作成する場合に使用します。
16個を超えるバインダを使用する場合や、メモリ使用量削減のためバインダ数を減らしたい場合には、本パラメータを変更してください。
Maximum Number of Binds
最大バインド回数を指定します。
CRIWARE UE4プラグインとは別に、アプリケーションでCPKファイルをバインドする場合に使用します。
16回を超えるバインドを同時に行う場合や、メモリ使用量削減のためバインド数を減らしたい場合には、本パラメータを変更してください。
Number of Loaders
ローダ数を指定します。
CRIWARE UE4プラグインは、ストリーム再生にローダを使用します。
16本以上の音声をストリーム再生する場合や、アプリケーションで別途CriFsLoaderHnを作成する場合、本パラメータを変更する必要があります。
Maximum Path Length
CRIWARE UE4プラグインで扱えるファイルの最大パス長を指定します。
(使用を想定しているパスの長さを、バイト単位で指定します。)
アプリケーション実行中に以下のエラーが出る場合、本パラメータの値を増やす必要があります。
LogCriWare: Error: E2008092451:Can not store path. (Increase max_path of CriFsConfig.)
Output log
ファイルアクセスログを出力するかどうかの指定。
本パラメータをONに設定した場合、CRIWARE UE4プラグイン内のファイルアクセス情報がログとして出力されます。
ファイルを配置しているのにリードエラーが発生する場合等、予期せぬ不具合が発生した際のデバッグに役立ちます。
Atomライブラリ初期化設定
Automatically Create Cue Asset
ACBファイルをエディタにインポートした際、自動的にAtom Cueアセットを作成するかどうかの指定です。
本パラメータがONの場合、ACBファイルをエディタにインポートした際、Atom Cue Sheetアセットと共に、ACBファイルに含まれるキューがAtom Cueアセットとして展開されます。
本パラメータをOFFに変更した場合、ACBファイルをエディタにインポートしても、Atom Cue Sheetアセットのみが作成され、Atom Cueアセットは作成されません。
Use In Game Preview
インゲームプレビューを行うかどうかの指定。
インゲームプレビュー機能を使用する場合、本パラメータをONに設定する必要があります。
Output Log
発音等の情報をログとして出力するかどうかの指定。
本パラメータをONに設定した場合、Atomライブラリ内のコマンド処理がログとして出力されます。
音源を配置しているのに聞こえない等、予期せぬ不具合が発生した際のデバッグに役立ちます。
Maximum Number of Virtual Voices
バーチャルボイス数を指定します。
バーチャルボイスは音声データの発音を管理するオブジェクトです。
バーチャルボイス数の目安は「同時に再生する波形データの数」+「1Vにリクエストする発音要求の数」です。
バーチャルボイス数が不足した場合、エラーがログに出力され、音声の再生に失敗します。
バーチャルボイスが不足する場合、本パラメータでバーチャルボイスの数を多めに設定してください。
Number of Standard Memory Voices
メモリ再生に使用するボイスの数を指定します。
本パラメータで指定した数以上の波形データを同時に再生した場合、ボイスプライオリティに応じて再生する音声が選択されます。
Number of Channels of Standard Memory Voice
メモリ再生用ボイスで再生可能な最大チャンネル数を指定します。
本パラメータで指定した値を超えるチャンネル数の音声データは再生することができません。
Sampling Rate of Standard Memory Voice
メモリ再生用ボイスで再生可能な最大サンプリングレートを指定します。
本パラメータで指定した値を超えるサンプリングレートの音声データは再生することができません。
48000Hzを超える音声を再生する場合、ピッチ変更を行う場合、ホンパラメータを変更する必要があります。
(ピッチ変更を行う場合、ピッチ変更を加味した値を指定する必要があります。)
Number of Standard Streaming Voices
ストリーム再生兼用(メモリ再生とストリーム再生の両方が可能な)ボイスの数を指定します。
本パラメータで指定した数以上の波形データを同時に再生した場合、ボイスプライオリティに応じて再生する音声が選択されます。
Number of Channels of Standard Streaming Voice
ストリーム再生兼用ボイスで再生可能な最大チャンネル数を指定します。
本パラメータで指定した値を超えるチャンネル数の音声データは再生することができません。
Sampling Rate of Standard Streaming Voice
ストリーム再生兼用ボイスで再生可能な最大サンプリングレートを指定します。
48000Hzを超える音声を再生する場合、ピッチ変更を行う場合、本パラメータを変更する必要があります。
(ピッチ変更を行う場合、ピッチ変更を加味した値を指定する必要があります。)
ACF Asset Path
ACFアセットのパスを指定します。
CRIWARE UE4プラグインは、起動時に本パラメータで指定されたACFアセットを自動的ロードします。
Distance Factor
距離係数を指定します。
距離係数は、Unreal Engine 4とCRI Atom Craftの距離単位の違いを吸収するための係数です。
具体的には、「Unreal Engine上の距離1を、Atomライブラリでいくつと解釈するか」を示す値です。
例えば、Unreal Engine 4の座標系をセンチメートル単位、CRI Atom Craftの距離単位をメートルと想定してデータを作成した場合、DistanceFactorには0.01を指定する必要があります。
DistanceFactorの未指定時の値(デフォルト値)は1.0です。
(Unreal Engine 4とCRI Atom Craftで同じ距離単位を使用。)
Sampling Rate of HCA-MX Voice
HCA-MXデータのサンプリングレートを指定します。
Number of HCA-MX Memory Voices
HCA-MXメモリ再生に使用するボイスの数を指定します。
本パラメータで指定した数以上の波形データを同時に再生した場合、ボイスプライオリティに応じて再生する音声が選択されます。
HCA-MXを使用しない場合には、本パラメータを0に設定してください。
Number of Channels of HCA-MX Memory Voice
HCA-MXメモリ再生用ボイスで再生可能な最大チャンネル数を指定します。
本パラメータで指定した値を超えるチャンネル数の音声データは再生することができません。
Number of HCA-MX Streaming Voices
HCA-MXストリーム再生兼用(メモリ再生とストリーム再生の両方が可能な)ボイスの数を指定します。
本パラメータで指定した数以上の波形データを同時に再生した場合、ボイスプライオリティに応じて再生する音声が選択されます。
HCA-MXを使用しない場合には、本パラメータを0に設定してください。
Number of Channels of HCA-MX Streaming Voice
HCA-MXストリーム再生兼用ボイスで再生可能な最大チャンネル数を指定します。
本パラメータで指定した値を超えるチャンネル数の音声データは再生することができません。
プロジェクト設定での設定例
プロジェクト設定での簡単な設定例を以下に示します。
≪例≫
Next:
ブループリントAPI
Copyright (c) 2012-2018 CRI Middleware Co., Ltd.
CRIWARE Unreal Engine 4 プラグインマニュアル SDKVer.2.10版