Struct CriAtomExPlayer.Config

プレーヤー作成用コンフィグ構造体

Inherited Members
Namespace: CriWare
Assembly: CriWare.CriAtom.dll
Syntax
public struct CriAtomExPlayer.Config
Remarks

説明: AtomExプレーヤーを作成する際に、動作仕様を指定するための構造体です。 CriAtomExPlayer(in Config, IntPtr, int) 関数の引数に指定します。 作成されるプレーヤーは、オブジェクト作成時に本構造体で指定された設定に応じて、 内部リソースを必要なだけ確保します。 プレーヤーが必要とするワーク領域のサイズは、本構造体で指定されたパラメーターに応じて変化します。

注意: 将来的にメンバが増える可能性があるため、 SetDefaultConfig(out Config) メソッドを使用しない場合には、使用前に必ず構造体をゼロクリアしてください。 （構造体のメンバに不定値が入らないようご注意ください。）

Fields

enableAudioSyncedTimer

音声同期時刻更新の有無

Declaration
public NativeBool enableAudioSyncedTimer
Field Value
Type Description
NativeBool
Remarks

説明: AtomExプレーヤーが再生音声に同期した時刻更新処理を行うかどうかを指定します。

備考: enable_audio_synced_timer に true を指定した場合、 作成されたAtomExプレーヤーを用いて再生された音声に対して、 再生済みサンプル数に同期するように補正した再生時刻の更新を行うようになります。 補正された再生時刻は GetTimeSyncedWithAudio() 関数によって取得できます。 音声再生時の処理負荷が上がるため、音声に同期した正確な再生時刻を取得したいプレーヤーの 作成時のみ true を指定するようにしてください。

注意: 本フラグを有効にした場合、AtomExプレーヤーに対するピッチ指定が行えなくなります。

See Also

maxAisacs

最大AISAC数

Declaration
public byte maxAisacs
Field Value
Type Description
byte
Remarks

説明: 一つのキューに紐づけることができるAISACの最大数です。 Atomライブラリは、初期化時と AtomExPlayer 作成時に max_aisacs で指定された数分のAISACを参照できるリソースを確保します。 max_aisacs に指定する値の上限は55です。

maxPath

最大パス長

Declaration
public int maxPath
Field Value
Type Description
int
Remarks

説明: AtomExプレーヤーに指定可能なファイルパスの最大長です。 ファイル名を指定して音声の再生を行う場合、使用するパスの最大長を max_path として指定する必要があります。

備考: 本パラメーターは、パッキングされていない音声ファイルを、 ファイル名を指定して再生する際にのみセットする必要があります。 ファイル名指定の再生を行わず、キューIDや波形データIDを指定して再生を行う場合、 max_path を 0 に設定することが可能です。

注意: SetDefaultConfig(out Config) メソッドで CriAtomExPlayer.Config 構造体に デフォルト値を設定した場合、 max_path には 0 がセットされます。 ファイル名を指定して再生を行う場合、 SetDefaultConfig(out Config) メソッドを使用しないか、または SetDefaultConfig(out Config) メソッド実行後 に再度パスの最大長をセットする必要があります。

See Also

maxPathStrings

最大パス文字列数

Declaration
public int maxPathStrings
Field Value
Type Description
int
Remarks

説明: AtomExプレーヤーが保持するパス文字列の数です。

備考: SetFile(CriFsBinder, ArgString) 関数を実行すると、 指定したパス文字列がAtomExプレーヤー内に保持されます。 AtomExプレーヤーはデフォルト状態ではパス文字列を1つしか保持しません。 （メモリサイズ削減のため。） プレーヤー作成時に指定する max_path_strings の数を増やせば、 AtomExプレーヤーは指定された数分のパス文字列を保存するようになります。 max_path_strings に2以上の値を指定することで、 1つのプレーヤーで複数のファイルを同時にパス指定で再生することが可能となります。 ただし、 max_path_strings の値に応じて必要なワーク領域のサイズは増加します。 （max_path_strings×max_pathバイトのメモリが必要となります。）

See Also

updatesTime

時刻更新の有無

Declaration
public NativeBool updatesTime
Field Value
Type Description
NativeBool
Remarks

説明: AtomExプレーヤーが時刻更新処理を行うかどうかを指定します。

備考: updates_time に false を指定した場合、 作成されたAtomExプレーヤーは再生時刻の更新を行いません。 その結果、 GetTime() 関数による再生時刻の取得は行えなくなりますが、 音声再生時の処理負荷をわずかに下げることが可能となります。

See Also

voiceAllocationMethod

ボイス確保方式

Declaration
public CriAtomEx.VoiceAllocationMethod voiceAllocationMethod
Field Value
Type Description
CriAtomEx.VoiceAllocationMethod
Remarks

説明: AtomExプレーヤーがボイスを確保する際の方式を指定します。 voice_allocation_method に AllocateVoiceOnce を指定した場合、 AtomExプレーヤーはボイスの確保を発音開始のタイミングでのみ行います。 再生開始時点でボイスを確保できなかった場合や、 発音数制御により再生中にボイスが奪い取られた場合、 発音に関連するリソースが解放されるため、その波形データはその時点で停止します。 （再生が始まらなかった波形データや、再生が途中で停止された波形データが、 追加の再生リクエストなしに再生されることはありません。） これに対し、 voice_allocation_method に RetryVoiceAllocation を指定した場合、AtomExプレーヤーはボイスの確保を必要な限り何度も繰り返します。 ボイスが確保できない場合やボイスを奪い取られた場合でも、 発音を管理するリソース（バーチャルボイス）は解放しないので、 再度ボイスに空きができた時点で、発音処理が再開されます。

備考: RetryVoiceAllocation を指定した場合、発音中のボイスの処理に加え、 発音を行っていないバーチャルボイスについても定期的にボイスの再取得処理等が行われるため、 AllocateVoiceOnce を指定した場合に比べ、 処理負荷が高くなる可能性があります。 RetryVoiceAllocation 指定時、 ボイスの再確保に成功すると、波形データは再生時刻を考慮した位置からシーク再生されます。

注意: RetryVoiceAllocation を指定して AtomEx プレーヤーを作成した場合でも、 Atom ライブラリ初期化時に指定する max_virtual_voices の数を超える再生要求があった場合、発音は再開されなくなります。 （エラーコールバック関数に警告が返され、バーチャルボイスも削除されます。） RetryVoiceAllocation を指定する際には、 初期化時に必要充分なバーチャルボイスを確保してください。 （ max_virtual_voices に大きめの値を指定してください。） RetryVoiceAllocation を指定した場合、 再生されなかった波形データやボイスが奪い取られた波形データが、 いつどこから再生再開されるか、厳密に制御することはできません。 （実行タイミングにより毎回異なった結果になる可能性があります。）

See Also