HCA-MX再生

サンプルのディレクトリ

: /cri/pc/samples/criatomex/hca_mx_playback

サンプルの解説

: HCA-MXデータの再生を行うサンプルです。

: HCA-MXデータを再生する場合、あらかじめ全ての音声データを同一のサンプリングレートで作成しておく必要があります。
また、ランタイム側ではHCA-MX再生用に以下の設定を行う必要があります。

ライブラリ初期化時にHCA-MXの出力設定を行う。
HCA-MX再生用にボイスプールを作成する。

ライブラリの初期化について

: HCA-MXデータの再生を行う場合、ライブラリ初期化時にHCA-MX再生用の設定を行う必要があります。
具体的には、ライブラリ初期化時に指定する CriAtomExHcaMxConfig 構造体について、以下の項目を適切に設定する必要があります。

**CriAtomExHcaMxConfig構造体の主な設定項目**
指定するパラメーター	説明
num_mixers	使用するミキサの数を指定します。通常は1を指定します。 HCA-MXを使用しない場合は0を指定します。
max_voices	ボイスプールとして作成するボイスの総数を指定します。 HCA-MXを使用しない場合は0を指定します。
max_sampling_rate output_sampling_rate	使用する音声データのサンプリングレートを指定します。
max_input_channels output_channels	使用する音声データの最大チャンネル数を指定します。

注意:: 機種固有のライブラリ初期化関数を使用せず、 criAtomEx_Initialize 関数を使用してライブラリを初期化している場合、 criAtomExHcaMx_Initialize 関数を実行する必要があります。

ボイスプールの作成について

: HCA-MXデータを再生する際には、HCA-MX再生用に通常と異なる（標準ボイスプールではない）ボイスプールを作成する必要があります。
具体的には、HCA-MXが再生可能なボイスプールを criAtomExVoicePool_AllocateHcaVoicePool 関数で作成する必要があります。
尚、ボイスプールを作成する際には、 CriAtomExHcaMxVoicePoolConfig 構造体の player_config::max_sampling_rate に、再生する音声データと同じサンプリングレートを設定する必要があります。

    CriAtomExHcaMxVoicePoolConfig pool_config;
        ：
    /* HCA-MXボイスプールの作成 */
    criAtomExVoicePool_SetDefaultConfigForHcaMxVoicePool(&pool_config);
    pool_config.player_config.max_sampling_rate = 48000;    // 再生する音声データと同じ値を設定
    app_obj->hca_mx_pool = criAtomExVoicePool_AllocateHcaMxVoicePool(&pool_config, NULL, 0);
        ：

注意:: ACBファイルを使用せず、AWBファイルや単体ファイルを使用してHCA-MX再生を行う場合、追加で以下の設定が必要です。

criAtomExPlayer_SetFormat 関数で再生する音声の種別をHCA-MX（ CRIATOMEX_FORMAT_HCA_MX ）に設定する。
criAtomExPlayer_SetSamplingRate 関数で再生する音声データのサンプリングレートを指定する。