Struct CriAtomHcaMx.Config

HCA-MX初期化用コンフィグ構造体

Inherited Members
Namespace: CriWare
Assembly: CriWare.CriAtom.dll
Syntax
[Serializable]
public struct CriAtomHcaMx.Config
Remarks

備考: デフォルト設定を使用する場合、 SetDefaultConfig(out Config) メソッドで 構造体にデフォルトパラメーターをセットした後、 Initialize(in Config, IntPtr, int) 関数 に構造体を指定してください。

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

Fields

maxInputChannels

入力データの最大チャンネル数

Declaration
public int maxInputChannels
Field Value
Type Description
int
Remarks

説明: アプリケーション中で再生するHCA-MXデータの最大チャンネル数を指定します。 再生するデータがモノラルの場合は1を、ステレオの場合は2を指定してください。

備考: HCA-MX初期化時に max_input_channels に指定された数以下の音声データが 再生可能になります。 例えば、 max_input_channels に6を指定した場合、5.1ch音声だけでなく、 モノラル音声やステレオ音声も再生可能になります。 100個のデータのうち、99個がモノラル、1個がステレオの場合でも、 max_input_channels には2を指定する必要があります。

maxPlayers

ミキサーに登録可能な最大プレーヤー数

Declaration
public int maxPlayers
Field Value
Type Description
int
Remarks

説明: ミキサーごとに登録可能なHCA-MXプレーヤーの数を指定します。

maxSamplingRate

最大サンプリングレート

Declaration
public int maxSamplingRate
Field Value
Type Description
int
Remarks

説明: HCA-MXの出力に指定できる最大サンプリングレートです。

備考: 例えばSetFrequencyRatio(int, float) 関数に 2.0f を指定する場合は output_sampling_rate * 2 を指定してください。

numMixers

ミキサー数

Declaration
public int numMixers
Field Value
Type Description
int
Remarks

説明: HCA-MXデコード結果を送信するミキサーの数を指定します。 ミキサーを複数作成することで、 ミキサーごとに異なるバスエフェクトを適用することが可能になります。

注意: HCA-MXのデコード処理、および定常状態の処理負荷は、 ミキサーの数に比例して重くなります。

outputChannels

出力チャンネル数

Declaration
public int outputChannels
Field Value
Type Description
int
Remarks

説明: HCA-MXデータの出力チャンネル数を指定します。 通常、ターゲット機に接続されたスピーカーの数（出力デバイスの 最大チャンネル数）を指定します。 出力チャンネル数の最大値は HcaMxMaxOutputChannels で、最小数は 1 です。

備考: モノラル音声のみを再生し、パンをコントロールしない場合には、 output_channels を1にすることで、処理負荷を下げることが可能です。

注意: output_channels の数を max_input_channels 以下の値に設定することは できません。

outputSamplingRate

出力サンプリングレート

Declaration
public int outputSamplingRate
Field Value
Type Description
int
Remarks

説明: 再生するHCA-MXデータのサンプリングレートを指定します。 HCA-MXは、音単位のサンプリングレート変更を行えません。 HCA-MXデータを作成する際には、必ず全ての音声データを同一のサンプリング レートで作成し、その値を output_sampling_rate に指定してください。

serverFrequency

サーバー処理の実行頻度

Declaration
public float serverFrequency
Field Value
Type Description
float
Remarks

説明: サーバー処理を実行する頻度を指定します。

注意: Atomライブラリ初期化時に指定した値（ CriAtom.Config 構造体の server_frequency ）と、同じ値をセットする必要があります。

See Also

soundRendererType

サウンドレンダラタイプ

Declaration
public CriAtom.SoundRendererType soundRendererType
Field Value
Type Description
CriAtom.SoundRendererType
Remarks

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

See Also