説明

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

説明:: HCA-MXが再生可能なプレーヤを作成する際に、動作仕様を指定するための構造体です。
criAtomPlayer_CreateHcaMxPlayer 関数の引数に指定します。

作成されるプレーヤは、ハンドル作成時に本構造体で指定された設定に応じて、内部リソースを必要なだけ確保します。
プレーヤが必要とするワーク領域のサイズは、本構造体で指定されたパラメータに応じて変化します。

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

参照:: criAtomPlayer_CreateHcaMxPlayer, criAtomPlayer_SetDefaultConfigForHcaMxPlayer

変数

CriSint32 max_channels

最大出力チャンネル数

説明:: Atomプレーヤで再生する音声のチャンネル数を指定します。
criAtomPlayer_CreateHcaMxPlayer 関数で作成されたAtomプレーヤは、max_channelsで指定したチャンネル数"以下の"音声データを再生可能です。

CriSint32 max_sampling_rate

最大サンプリングレート

説明:: Atomプレーヤで再生する音声のサンプリングレートを指定します。
criAtomPlayer_CreateHcaMxPlayer 関数で作成されたAtomプレーヤは、max_sampling_rateで指定したサンプリングレートと一致する音声データのみを再生可能です。

注意:: 指定された最大サンプリングレートに一致しないデータは、再生することはできません。
例えば、最大サンプリングレートを48000に設定した場合、作成されたAtomプレーヤで 48000Hz以外の音声を再生することはできません。
（レート変換されて出力されることはありません。）

CriBool streaming_flag

ストリーミング再生を行うかどうか

説明:: Atomプレーヤでストリーミング再生（ファイルからの再生）を行うかどうかを指定します。
streaming_flagにCRI_FALSEを指定した場合、作成されたAtomプレーヤはオンメモリのデータ再生（ criAtomPlayer_SetData 関数で指定したメモリアドレスの再生）のみをサポートします。（ファイルからの再生はできません。）
streaming_flagにCRI_TRUEを指定した場合、作成されたAtomプレーヤはオンメモリのデータ再生に加え、ファイルからの再生（ criAtomPlayer_SetFile 関数や criAtomPlayer_SetContentId 関数で指定されたファイルの再生）をサポートします。

補足:: streaming_flagをCRI_TRUEにした場合、Atomプレーヤ作成時にファイル読み込み用のリソースが確保されます。
そのため、streaming_flagをCRI_FALSEの場合に比べ、Atomプレーヤの作成に必要なメモリのサイズが大きくなります。