キューID再生

サンプルのディレクトリ

/cri/pc/samples/criatomex/playback_cue

サンプルで使用しているデータ

/cri/common/smpdata/criatomex/

• SampleProject.acf
• AtomCueSheet.acb
• AtomCueSheet.awb
  

サンプルの解説

オーサリングツール上で作成されたキューを再生する手順は、以下のとおりです。

1. オーサリングツールが出力した ACF ファイルを criAtomEx_RegisterAcfFile 関数で登録する。
2. オーサリングツールが出力した ACB ファイルと AWB ファイルを criAtomExAcb_LoadAcbFile 関数で登録する。
3. キュー再生用にボイスプールと D-BAS 、プレーヤーを作成する。
4. criAtomExPlayer_SetCueId 関数で、再生するキューの ID をプレーヤーに指定する。
5. criAtomExPlayer_Start 関数で、キューの再生を開始する。

以下、キューIDを指定して音声を再生するコードを示します。

CriAtomExDbasId dbas_id;
CriAtomExAcbHn acb_hn;
CriAtomExStandardVoicePoolConfig vp_config;
CriAtomExVoicePoolHn voice_pool;
CriAtomExPlayerHn player;
 
/* ストリーミング再生可能なボイスプールを作成 */
criAtomExVoicePool_SetDefaultConfigForStandardVoicePool(&vp_config);
vp_config.player_config.streaming_flag = CRI_TRUE;
stmvoice_pool = criAtomExVoicePool_AllocateStandardVoicePool(&vp_config, NULL, 0);
 
/* D-BASの作成 */
dbas_id = criAtomExDbas_Create(NULL, NULL, 0);
 
/* ACBファイルのロード */
acb_hn = criAtomExAcb_LoadAcbFile(NULL, PATH ACB_FILE, NULL, PATH AWB_FILE, NULL, 0);
 
/* プレーヤーの作成 */
player = criAtomExPlayer_Create(NULL, NULL, 0);
 
/* 再生するキューのIDを指定 */
criAtomExPlayer_SetCueId(player, acb_hn, 15);
 
/* 再生の開始 */
criAtomExPlayer_Start(player);

キューの指定方法について

上記サンプルでは、キューの指定を ID 指定で行っていますが、 criAtomExPlayer_SetCueName 関数や criAtomExPlayer_SetCueIndex 関数を使用することで、 キュー名やキューインデックス（ファイル内のキューのオフセット番号）でキューの指定を行うことも可能です。

また、オーサリングツールが出力したヘッダーファイルをインクルードすることで、 キュー ID を数値ではなく、マクロ定義名で指定することも可能です。

再生する音声のチャンネル数について

上記サンプルでは、音声再生用にストリーミング再生可能な標準ボイスプールを作成しています。
一般的な音声データ（モノラル／ステレオの ADX ／ HCA データ）については上記コードで再生が可能ですが、 マルチチャンネル音声を再生する場合にはコードを一部修正する必要があります。
具体的には、マルチチャンネル音声の再生に対応する場合は、ボイスプール作成時に player_config.max_channels の値を増やす必要があります。

オンメモリ再生のみを行う場合について

ストリーミング再生を行わず、オンメモリデータのみの再生を行う（ACBファイルのみを使用する）場合、 以下の修正を加えることで、使用するメモリサイズを削減することが可能です。

• ACBファイルのロードする際、AWBファイルのパスを指定しない。
• D-BASを作成しない。
• ボイスプール作成時、 player_config.streaming_flag を CRI_FALSE に設定する。