#include <cri_le_atom.h>

フィールド
CriSint32	max_channels

CriSint32	max_sampling_rate
	最大サンプリングレート [詳解]

CriBool	streaming_flag
	ストリーミング再生を行うかどうか [詳解]

CriAtomSoundRendererType	sound_renderer_type
	サウンドレンダラタイプ [詳解]

CriSint32	decode_latency
	デコード処理のレイテンシ [詳解]

void *	context
	プラットフォーム固有のパラメーターへのポインタ [詳解]

詳解

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

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

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

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

参照: criAtomPlayer_CreateStandardPlayer, criAtomPlayer_SetDefaultConfigForStandardPlayer

フィールド詳解

◆ max_channels

CriSint32 max_channels

    \brief 最大出力チャンネル数
    \par 説明:
    Atomプレーヤーで再生する音声のチャンネル数を指定します。<br>
    ::criAtomPlayer_CreateStandardPlayer 関数で作成されたAtomプレーヤーは、max_channelsで指定した
    チャンネル数"以下の"音声データを再生可能です。<br>
    最大出力チャンネル数として指定する値と、作成されたAtomプレーヤーで再生可能なデータの
    関係を以下に示します。<br>

**最大出力チャンネル数と再生可能なデータの関係**
最大出力チャンネル数（指定する値）	作成されたAtomプレーヤーで再生可能なデータ
1	モノラル
2	モノラル、ステレオ
6	モノラル、ステレオ、5.1ch
8	モノラル、ステレオ、5.1ch、7.1ch

備考:: サウンド出力時にハードウェアリソースを使用するプラットフォームにおいては、出力チャンネル数を小さくすることで、ハードウェアリソースの消費を抑えることが可能です。

注意: 指定された最大出力チャンネル数を超えるデータは、再生することはできません。
例えば、最大出力チャンネル数を1に設定した場合、作成されたAtomプレーヤーでステレオ音声を再生することはできません。
（モノラルにダウンミックスされて出力されることはありません。）

◆ max_sampling_rate

CriSint32 max_sampling_rate

最大サンプリングレート

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

備考:: 最大サンプリングレートを下げることで、Atomプレーヤー作成時に必要となるワークメモリのサイズを抑えることが可能です。

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

◆ streaming_flag

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

◆ sound_renderer_type

CriAtomSoundRendererType sound_renderer_type

サウンドレンダラタイプ

説明:: Atomプレーヤーが使用するサウンドレンダラの種別を指定します。
sound_renderer_type に CRIATOM_SOUND_RENDERER_DEFAULT を指定した場合、音声データはデフォルト設定のサウンドレンダラに転送されます。
sound_renderer_type に CRIATOM_SOUND_RENDERER_NATIVE を指定した場合、音声データは各プラットフォームのサウンド出力に転送されます。
sound_renderer_type に CRIATOM_SOUND_RENDERER_ASR を指定した場合、音声データはASR（Atom Sound Renderer）に転送されます。
（ASRの出力先は、ASR初期化時に別途指定。）

◆ decode_latency

CriSint32 decode_latency

デコード処理のレイテンシ

説明:: デコード処理のレイテンシを指定します。
decode_latency を 0 に設定した場合、プレーヤーは音声再生開始時に音声データのデコードを可能な限り遅延なく行います。
（オンメモリ再生時は criAtomPlayer_Start 関数を実行後、最初のサーバー処理内で再生開始に必要な量のデータをデコードし、音声の出力を開始します。）
これに対し decode_latency を 1 以上に設定した場合、再生開始に必要なデータのデコードを、複数回のサーバー処理に分割して行います。
（オンメモリ再生時であっても criAtomPlayer_Start 関数を実行後、 decode_latency に指定した回数サーバー処理が動作するまでは音声の出力が開始されません。）

備考:: Atomプレーヤーはサウンドバッファー内のデータ残量を元に、サーバー処理当たりの音声データのデコード量を決定しています。
音声再生開始前はサウンドバッファーが空の状態のため、音声再生中に比べて多くのデータ（再生中の 2 〜 4 倍程度）がデコードされます。
プレーヤー当たりの音声データのデコード処理負荷は小さいため、一音一音の発音開始時の処理負荷が問題になることはほとんどありません。
しかし、アプリケーション中で 1V に大量の発音リクエストを同時に発行した場合、全てのプレーヤーの処理負荷のピークが同期し、負荷が目に見えて大きくなる場合があります。
こういった制御を行うケースでは、 decode_latency の値を増やすことで、局所的に処理負荷が高くなる症状を回避することが可能です。

decode_latency のデフォルト値は、ほとんどの環境で 0 に設定されています。
しかし、携帯ゲーム機等、わずかな負荷変動でもアプリケーションに大きな影響を及ぼす環境では、デフォルト値が 1 以上に設定されている可能性があります。
（実際にセットされる値については criAtomPlayer_SetDefaultConfigForAdxPlayer マクロの適用結果を確認してください。）

現状 decode_latency の値に 4 以上の値を指定することはできません。
（ decode_latency に 4 以上の値を指定した場合でも、ライブラリ内で 3 に変更されます。）

◆ context

void* context

プラットフォーム固有のパラメーターへのポインタ

説明:: プラットフォーム固有のパラメーターへのポインタを指定します。 NULLを指定した場合、プラットフォーム毎のデフォルトパラメーターでプレーヤーを作成します。
パラメーター構造体は各プラットフォーム固有ヘッダーに定義されています。パラメーター構造体が定義されていないプラットフォームでは、常にNULLを指定してください。

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

cri_le_atom.h