#include <cri_le_atom.h>

詳解

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プレーヤーの作成に必要なメモリのサイズが大きくなります。

この構造体詳解は次のファイルから抽出されました: