シームレス連結再生

/cri/pc/samples/criatomex/seamless_playback

Atom ライブラリには、複数の異なる波形データを連結して再生するため 「シームレス連結再生」 という機能が用意されています。
（一般的には「ギャップレス再生機能」とも呼ばれています。）
シームレス連結再生機能を用いることで、ループ情報の付いていない波形データをループ再生（同一の波形データを繰り返し再生）したり、パートごとに分割された波形データを任意の組み合わせで再生することが可能になります。

シームレス連結再生機能の使用手順は以下のとおりです。

criAtomExPlayer_Create 関数で AtomEx プレーヤーを作成する。
criAtomExPlayer_SetDataRequestCallback 関数を使用し、 AtomEx プレーヤーにデータ要求コールバック関数を登録する。
criAtomExPlayer_SetData 関数等で、最初に再生する音声データを指定する。
criAtomExPlayer_Start 関数で再生を開始する。
セットした音声データの読み込みが完了した時点でデータ要求コールバック関数が実行されるので、コールバック関数内で次に再生するデータをセットする。

再生開始までの処理コードは以下のようになります。

        ：
    /* プレーヤーの作成 */
    app_obj->player = criAtomExPlayer_Create(NULL, NULL, 0);

    /* シームレス連結再生用にコールバック関数を登録 */
    criAtomExPlayer_SetDataRequestCallback(
        app_obj->player, app_data_request_callback, app_obj);

    /* 初回再生データの指定 */
    criAtomExPlayer_SetCueId(app_obj->player, app_obj->acb_hn, CRI_ATOMCUESHEET_SEAMLESS_A);

    /* 再生の開始 */
    criAtomExPlayer_Start(app_obj->player);
        ：

尚、コールバックの設定や初回のデータ設定は AtomEx プレーヤーに対して行いますが、コールバック内でのデータの追加については、下位レイヤ（ Atom レイヤ）の 「 Atom プレーヤー」 の API を使用する必要があります。

例えば、複数のオンメモリデータを連結再生する場合、初回のデータ設定は AtomEx プレーヤーに対して criAtomExPlayer_SetData 関数を実行しますが、コールバック関数内で後続データを指定する際には、コールバック関数の引数で渡って来る Atom プレーヤーハンドルに対し criAtomPlayer_SetData 関数を使用してデータを指定します。

［備考］
波形データレベルのつなぎ合わせ処理は、 AtomEx プレーヤーではなく、ボイスで行われます。
そのため、連結再生用のコールバックは AtomEx プレーヤーからではなく、ボイスが内部的に保持している Atom プレーヤーから返される形になります。

尚、 Atom レイヤにはキューを再生する機能がないため、キュー内の波形データ同士を連結再生する場合、キューから AWB ハンドル、および波形データ ID を取得する必要があります。

キュー内の波形データを再生する場合、処理手順は以下のようになります。

criAtomExAcb_GetWaveformInfoById 関数でキューに含まれる波形データの情報を取得する。
波形データがオンメモリデータの場合は criAtomExAcb_GetOnMemoryAwbHandle 関数、ストリーミング再生データの場合は criAtomExAcb_GetStreamingAwbHandle 関数を使用して AWB ハンドルを取得する。
AWB ハンドルと波形 ID を使用して criAtomPlayer_SetWaveId 関数を実行する。

具体的な処理コードは以下のとおりです。

    CriAtomExWaveformInfo wave_info;
    CriAtomAwbHn awb_hn;
        ：
    /* 再生するキューに含まれる波形データの情報を取得 */
    criAtomExAcb_GetWaveformInfoById(app_obj->acb_hn, app_obj->request_id, &wave_info);

    /* 波形データがストリーミング再生用かどうかをチェック */
    if (wave_info.streaming_flag == CRI_FALSE) {
        /* ACBハンドルからオンメモリ再生用のAWBハンドルを取得 */
        awb_hn = criAtomExAcb_GetOnMemoryAwbHandle(app_obj->acb_hn);
    } else {
        /* ACBハンドルからストリーミング再生用のAWBハンドルを取得 */
        awb_hn = criAtomExAcb_GetStreamingAwbHandle(app_obj->acb_hn);
    }

    /* 連結する波形データをセット */
    /* 注意）AtomExプレーヤーではなくAtomプレーヤーのAPIを実行する。 */
    criAtomPlayer_SetWaveId(player, awb_hn, wave_info.wave_id);

    /* 備考）キューの中の波形データではなく、単体ファイルやメモリ   */
    /*       上にロードされた波形データを再生する場合には、         */
    /*       上記の操作を行わず、直接criAtomPlayer_SetFile関数や    */
    /*       criAtomPlayer_SetData関数を実行して問題ありません。    */
        ：

シームレス連結再生

サンプルのディレクトリ

サンプルの解説