プレーヤステータス

説明:

AtomExプレーヤの再生状態を示す値です。
CriAtomExPlayer::GetStatus 関数で取得可能です。

再生状態は、通常以下の順序で遷移します。

1. Stop
2. Prep
3. Playing
4. PlayEnd

AtomExプレーヤ作成直後の状態は、停止状態（ Stop ）です。
CriAtomExPlayer::SetCue 関数等でデータをセットし、 CriAtomExPlayer::Start 関数を実行すると、再生準備状態（ Prep ）に遷移し、再生準備を始めます。
データが充分供給され、再生準備が整うと、ステータスは再生中（ Playing ） に変わり、音声の出力が開始されます。
セットされたデータを全て再生し終えた時点で、ステータスは再生完了 （ PlayEnd ）に変わります。

備考

AtomExプレーヤは、1つのプレーヤで複数音の再生が可能です。
再生中のAtomExプレーヤに対して CriAtomExPlayer::Start 関数を実行すると、 2つの音が重なって再生されます。
再生中に CriAtomExPlayer::Stop 関数を実行した場合、 AtomExプレーヤで再生中の全ての音声が停止し、ステータスは Stop に戻ります。
（ CriAtomExPlayer::Stop 関数の呼び出しタイミングによっては、 Stop に遷移するまでに時間がかかる場合があります。）

1つのAtomExプレーヤで複数回 CriAtomExPlayer::Start 関数を実行した場合、 1つでも再生準備中の音があれば、ステータスは Prep 状態になります。
（全ての音声が再生中の状態になるまで、ステータスは Playing 状態に 遷移しません。）
また、 Playing 状態のプレーヤに対し、再度 CriAtomExPlayer::Start 関数を実行した場合、ステータスは一時的に Prep に戻ります。

再生中に不正なデータを読み込んだ場合や、ファイルアクセスに失敗した場合、 ステータスは Error に遷移します。
複数の音声を再生中にある音声でエラーが発生した場合、プレーヤのステータスは 他の音声の状態に関係なく、 Error に遷移します。

参照:

CriAtomExPlayer::GetStatus, CriAtomExPlayer::Start, CriAtomExPlayer

列挙型の値:

Stop	停止中
Prep	再生準備中
Playing	再生中
PlayEnd	再生完了
Error	エラーが発生

タイムストレッチ用パラメータ

説明:

タイムストレッチDSPに指定するパラメータです。

参照:

CriAtomExVoicePool.AttachDspTimeStretch, CriAtomExPlayer.SetDspParameter

列挙型の値:

Ratio	ストレッチ比率
FrameTime	フレーム時間
Quality	処理品質

ピッチシフタ用パラメータ

説明:

ピッチシフタDSPに指定するパラメータです。

参照:

CriAtomExVoicePool.AttachDspPitchShifter, CriAtomExPlayer.SetDspParameter

列挙型の値:

Pitch	ピッチ
Formant	フォルマント
Mode	ピッチシフトモード

AtomExPlayerの作成

戻り値:

AtomExプレーヤ

説明:

AtomExプレーヤを作成します。

作成されたAtomExプレーヤを使用して音声データを再生する手順は以下のとおりです。

1. CriAtomExPlayer::SetCue 関数を使用して、AtomExプレーヤに再生するデータをセットする。
   
2. CriAtomExPlayer::Start 関数で再生を開始する。
   

注意:

本関数を実行する前に、ライブラリを初期化しておく必要があります。

パッキングされていない音声ファイルを CriAtomExPlayer::SetFile 関数で指定して再生する場合、本関数の代わりに CriAtomExPlayer::CriAtomExPlayer(int, int) を使用する必要があります。

本関数は完了復帰型の関数です。
AtomExプレーヤの作成にかかる時間は、プラットフォームによって異なります。
ゲームループ等の画面更新が必要なタイミングで本関数を実行するとミリ秒単位で 処理がブロックされ、フレーム落ちが発生する恐れがあります。
AtomExプレーヤの作成／破棄は、シーンの切り替わり等、負荷変動を許容できる タイミングで行うようお願いいたします。

参照:

CriAtomExPlayer::Dispose, CriAtomExPlayer::SetCue, CriAtomExPlayer::Start, CriAtomExPlayer::CriAtomExPlayer(int, int), CriAtomExPlayer::CriAtomExPlayer(bool), CriAtomExPlayer::CriAtomExPlayer(int, int, bool)

AtomExPlayerの作成（単体ファイル再生用）

引数:

maxPath	最大パス文字列長
maxPathStrings	同時再生ファイル数

戻り値:

AtomExプレーヤ

説明:

単体ファイル再生用にAtomExプレーヤを作成します。
単体ファイル再生が可能な点を除き、基本的な仕様は CriAtomExPlayer::CriAtomExPlayer() 関数と同じです。

備考:

本関数で作成されたAtomExプレーヤは、 単体ファイル再生用にmaxPath×maxPathStrings分のメモリ領域を確保します。
この領域は、ACBファイルやAWBファイルを再生する際には使用されません。
CriAtomExPlayer::SetFile 関数を使用しない場合、本関数の代わりに CriAtomExPlayer::CriAtomExPlayer() を使用することで、 メモリ使用量を抑えることが可能です。

参照:

CriAtomExPlayer::CriAtomExPlayer()

AtomExPlayerの作成（音声同期タイマ利用）

引数:

enableAudioSyncedTimer

音声同期タイマ有効フラグ

戻り値:

AtomExプレーヤ

説明:

音声同期タイマが利用可能なAtomExプレーヤを作成します。
音声に同期した再生時刻が取得可能な点を除き、基本的な仕様は CriAtomExPlayer::CriAtomExPlayer() 関数と同じです。

備考:

本関数で引数に true を指定して作成されたAtomExプレーヤを用いて 再生された音声に対しては、再生済みサンプル数に同期する時刻の更新処理が 行われるようになります。
::CriAtomExPlayback::GetTimeSyncedWithAudio 関数を使用しない場合、 本関数の引数に false を指定するか、本関数の代わりに CriAtomExPlayer::CriAtomExPlayer() を使用することで、負荷の増加を 抑えることが可能です。

注意:

注意: 本関数で引数に true を指定して作成されたAtomExプレーヤに対しては、 CriAtomExPlayer::SetPitch 関数による再生ピッチの変更は行えません。

参照:

CriAtomExPlayer::CriAtomExPlayer(), CriAtomExPlayback::GetTimeSyncedWithAudio()

AtomExPlayerの作成（単体ファイル再生、音声同期タイマ利用）

引数:

maxPath	最大パス文字列長
maxPathStrings	同時再生ファイル数
enableAudioSyncedTimer	音声同期タイマ有効フラグ

戻り値:

AtomExプレーヤ

説明:

単体ファイル再生用にAtomExプレーヤを作成します。
enableAudioSyncedTimer へのフラグ指定により、音声に同期した再生時刻が 取得可能になります。
基本的な仕様は CriAtomExPlayer::CriAtomExPlayer() 関数と同じです。

参照:

CriAtomExPlayer::CriAtomExPlayer(), CriAtomExPlayer::CriAtomExPlayer(int, int), CriAtomExPlayer::CriAtomExPlayer(bool)

AtomExプレーヤの破棄

説明:

AtomExプレーヤを破棄します。
本関数を実行した時点で、AtomExプレーヤ作成時にDLL内で確保されたリソースが全て解放されます。

注意:

本関数は完了復帰型の関数です。
音声再生中のAtomExプレーヤを破棄しようとした場合、本関数内で再生停止を 待ってからリソースの解放が行われます。
（ファイルから再生している場合は、さらに読み込み完了待ちが行われます。）
そのため、本関数内で処理が長時間（数フレーム）ブロックされる可能性があります。
AtomExプレーヤの作成／破棄は、シーンの切り替わり等、負荷変動を許容できる タイミングで行うようお願いいたします。

参照:

CriAtomExPlayer::CriAtomExPlayer

音声データのセット（キュー名指定）

引数:

acb	ACBオブジェクト
name	キュー名

キュー名を、AtomExプレーヤに関連付けます。
本関数でキュー名を指定後、 CriAtomExPlayer::Start 関数で再生を開始すると、指定されたキューが再生されます。

例:

        :
    // プレーヤの作成
    CriAtomExPlayer player = new CriAtomExPlayer();

    // ACFファイルの登録
    CriAtomEx.RegisterAcf(null, "sample.acf");

    // ACBファイルのロード
    CriAtomExAcb acb = CriAtomExAcb.LoadAcbFile(null, "sample.acb", "sample.awb");

    // 再生するキューの名前を指定
    player.SetCue(acb, "gun_shot");

    // セットされた音声データを再生
    player.Start();
        :

尚、一旦セットしたデータの情報は、 他のデータがセットされるまでAtomExプレーヤ内に保持されます。
そのため、同じデータを何度も再生する場合には、 再生毎にデータをセットしなおす必要はありません。
（ CriAtomExPlayer::Start 関数を繰り返し実行可能です。）

備考:

CriAtomExPlayer::SetCue 関数でキューをセットした場合、 以下の関数で設定されたパラメータは無視されます。

• CriAtomExPlayer::SetFormat
• CriAtomExPlayer::SetNumChannels
• CriAtomExPlayer::SetSamplingRate

（音声フォーマットやチャンネル数、サンプリングレート等の情報は、 ACB ファイルの情報を元に自動的にセットされます。）

参照:

CriAtomExPlayer::Start

音声データのセット（キューID指定）

引数:

acb	ACBオブジェクト
id	キューID

説明:

キューIDを、AtomExプレーヤに関連付けます。
本関数でキューIDを指定後、 CriAtomExPlayer::Start 関数で再生を開始すると、指定されたキューが再生されます。

例:

        :
    // プレーヤの作成
    CriAtomExPlayer player = new CriAtomExPlayer();

    // ACFファイルの登録
    CriAtomEx.RegisterAcf(null, "sample.acf");

    // ACBファイルのロード
    CriAtomExAcb acb = CriAtomExAcb.LoadAcbFile(null, "sample.acb", "sample.awb");

    // 再生するキューのIDを指定
    player.SetCue(acb, 100);

    // セットされた音声データを再生
    player.Start();
        :

尚、一旦セットしたデータの情報は、 他のデータがセットされるまでAtomExプレーヤ内に保持されます。
そのため、同じデータを何度も再生する場合には、 再生毎にデータをセットしなおす必要はありません。
（ CriAtomExPlayer::Start 関数を繰り返し実行可能です。）

備考:

CriAtomExPlayer::SetCue 関数でキューをセットした場合、以下の関数で設定された パラメータは無視されます。

• CriAtomExPlayer::SetFormat
• CriAtomExPlayer::SetNumChannels
• CriAtomExPlayer::SetSamplingRate

（音声フォーマットやチャンネル数、サンプリングレート等の情報は、 ACB ファイルの情報を元に自動的にセットされます。）

参照:

CriAtomExPlayer::Start

音声データのセット（キューインデックス指定）

引数:

acb	ACBオブジェクト
index	キューインデックス

キューインデックスを、AtomExプレーヤに関連付けます。
本関数でキューインデックスを指定後、 CriAtomExPlayer::Start 関数で再生を開始すると、指定されたキューが再生されます。

例:

        :
    // プレーヤの作成
    CriAtomExPlayer player = new CriAtomExPlayer();

    // ACFファイルの登録
    CriAtomEx.RegisterAcf(null, "sample.acf");

    // ACBファイルのロード
    CriAtomExAcb acb = CriAtomExAcb.LoadAcbFile(null, "sample.acb", "sample.awb");

    // 再生するキューのインデックスを指定
    player.SetCueIndex(acb, 300);

    // セットされた音声データを再生
    player.Start();
        :

尚、一旦セットしたデータの情報は、 他のデータがセットされるまでAtomExプレーヤ内に保持されます。
そのため、同じデータを何度も再生する場合には、 再生毎にデータをセットしなおす必要はありません。
（ CriAtomExPlayer::Start 関数を繰り返し実行可能です。）

備考:

CriAtomExPlayer::SetCueIndex 関数でキューをセットした場合、 以下の関数で設定されたパラメータは無視されます。

• CriAtomExPlayer::SetFormat
• CriAtomExPlayer::SetNumChannels
• CriAtomExPlayer::SetSamplingRate

（音声フォーマットやチャンネル数、サンプリングレート等の情報は、 ACB ファイルの情報を元に自動的にセットされます。）

本関数を使用することで、キュー名やキューIDを指定せずにプレーヤに対して 音声をセットすることが可能です。
（キュー名やキューIDがわからない場合でも、 ACBファイル内のコンテンツを一通り再生可能なので、 デバッグ用途に利用可能です。）

参照:

CriAtomExPlayer::Start

音声データのセット（CPKコンテンツIDの指定）

引数:

binder	バインダ
contentId	コンテンツID

説明:

コンテンツをAtomExプレーヤに関連付けます。
CRI File Systemライブラリを使用してCPKファイル内のコンテンツファイルを ID指定で再生するために使用します。
本関数でプレーヤにバインダとコンテンツIDを指定し、 CriAtomExPlayer::Start 関数を実行すると、 指定されたコンテンツファイルがストリーミング再生されます。
尚、本関数を実行した時点では、ファイルの読み込みは開始されません。
ファイルの読み込みが開始されるのは、 CriAtomExPlayer::Start 関数実行後です。

例:

        :
    // プレーヤの作成
    CriAtomExPlayer player = new CriAtomExPlayer();

    // バインダの作成
    CriFsBinder binder = new CriFsBinder();

    // CPKファイルのバインドを開始
    CriFsBindRequest bindRequest = CriFsUtility.BindCpk(binder, "sample.cpk");

    // バインドの完了を待つ
    yield return bindRequest.WaitForDone(this);

    // 音声ファイルをセット
    // sample.cpk内の1番のコンテンツをセット
    player.SetContentId(binder, 1);

    // 再生する音声データのフォーマットを指定
    player.SetFormat(CriAtomEx.Format.ADX);
    player.SetNumChannels(2);
    player.SetSamplingRate(44100);

    // セットされた音声データを再生
    plaeyr.Start();
        :

尚、一旦セットしたファイルの情報は、 他のデータがセットされるまでAtomExプレーヤ内に保持されます。
そのため、同じデータを何度も再生する場合には、 再生毎にデータをセットしなおす必要はありません。
（ CriAtomExPlayer::Start 関数を繰り返し実行可能です。）

注意:

CriAtomExPlayer::SetContentId 関数で音声データをセットする場合、 以下の関数を使用して再生する音声データの情報を別途指定する必要があります。

• CriAtomExPlayer::SetFormat
• CriAtomExPlayer::SetNumChannels
• CriAtomExPlayer::SetSamplingRate

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::SetFormat, CriAtomExPlayer::SetNumChannels, CriAtomExPlayer::SetSamplingRate

音声データのセット（ファイル名の指定）

引数:

binder	バインダオブジェクト
path	ファイルパス

説明:

音声ファイルをAtomExプレーヤに関連付けます。
本関数でファイルを指定後、 CriAtomExPlayer::Start 関数で再生を開始すると、 指定されたファイルがストリーミング再生されます。
尚、本関数を実行した時点では、ファイルの読み込みは開始されません。
ファイルの読み込みが開始されるのは、 CriAtomExPlayer::Start 関数実行後です。

例:

        :
    // プレーヤの作成
    CriAtomExPlayer player = new CriAtomExPlayer();

    // 音声ファイルをセット
    player.SetFile(null, "sample.hca");

    // 再生する音声データのフォーマットを指定
    player.SetFormat(CriAtomEx.Format.HCA);
    player.SetNumChannels(2);
    player.SetSamplingRate(48000);

    // セットされた音声データを再生
    player.Start();
        :

尚、一旦セットしたファイルの情報は、 他のデータがセットされるまでAtomExプレーヤ内に保持されます。
そのため、同じデータを何度も再生する場合には、 再生毎にデータをセットしなおす必要はありません。
（ CriAtomExPlayer::Start 関数を繰り返し実行可能です。）

注意:

本関数を使用する場合、AtomExプレーヤを単体ファイル再生用に作成する必要があります。
具体的には、 CriAtomExPlayer::CriAtomExPlayer() の代わりに、 CriAtomExPlayer::CriAtomExPlayer(int, int) を使用する必要があります。

CriAtomExPlayer::SetFile 関数で音声データをセットする場合、 以下の関数を使用して再生する音声データの情報を別途指定する必要があります。

• CriAtomExPlayer::SetFormat
• CriAtomExPlayer::SetNumChannels
• CriAtomExPlayer::SetSamplingRate

参照:

CriAtomExPlayer::CriAtomExPlayer(int, int), CriAtomExPlayer::Start, CriAtomExPlayer::SetFormat, CriAtomExPlayer::SetNumChannels, CriAtomExPlayer::SetSamplingRate

音声データのセット（オンメモリデータの指定）

引数:

buffer	バッファアドレス
size	バッファサイズ

説明:

メモリ上に配置された音声データをAtomExプレーヤに関連付けます。
本関数でメモリアドレスとサイズを指定後、 CriAtomExPlayer::Start 関数で再生を開始すると、 指定されたデータが再生されます。

例:

        :
    // プレーヤの作成
    CriAtomExPlayer player = new CriAtomExPlayer();

    // 音声ファイルをセット
    player.SetData(null, buffer, size);

    // 再生する音声データのフォーマットを指定
    player.SetFormat(CriAtomEx.Format.HCA);
    player.SetNumChannels(2);
    player.SetSamplingRate(48000);

    // セットされた音声データを再生
    player.Start();
        :

尚、一旦セットしたファイルの情報は、 他のデータがセットされるまでAtomExプレーヤ内に保持されます。
そのため、同じデータを何度も再生する場合には、 再生毎にデータをセットしなおす必要はありません。
（ CriAtomExPlayer::Start 関数を繰り返し実行可能です。）

注意:

本関数を使用する場合、AtomExプレーヤを単体ファイル再生用に作成する必要があります。
具体的には、 CriAtomExPlayer::CriAtomExPlayer() の代わりに、 CriAtomExPlayer::CriAtomExPlayer(int, int) を使用する必要があります。

CriAtomExPlayer::SetData 関数で音声データをセットする場合、 以下の関数を使用して再生する音声データの情報を別途指定する必要があります。

• CriAtomExPlayer::SetFormat
• CriAtomExPlayer::SetNumChannels
• CriAtomExPlayer::SetSamplingRate

SetDataに渡すバッファアドレスは、ガベージコレクターに移動されないようにアプリケーション 側で事前に固定したものを渡してください。

参照:

CriAtomExPlayer::CriAtomExPlayer(int, int), CriAtomExPlayer::Start, CriAtomExPlayer::SetFormat, CriAtomExPlayer::SetNumChannels, CriAtomExPlayer::SetSamplingRate

フォーマットの指定

引数:

format

フォーマット

説明:

AtomExプレーヤで再生する音声のフォーマットを指定します。
CriAtomExPlayer::Start 関数で音声を再生した際、AtomExプレーヤは本関数で 指定されたフォーマットのデータを再生可能なボイスを、ボイスプールから取得します。
関数実行前のデフォルト設定値はADXフォーマットです。

備考:

本関数は、ACBファイルを使用せずに音声を再生する場合にのみセットする必要があります。
キューを再生する場合、フォーマットはキューシートから自動で取得されるため、 別途本関数を実行する必要はありません。

チャンネル数の指定

引数:

numChannels

チャンネル数

説明:

AtomExプレーヤで再生する音声のチャンネル数を指定します。
CriAtomExPlayer::Start 関数で音声を再生した際、AtomExプレーヤは本関数で 指定されたチャンネル数のデータを再生可能なボイスを、ボイスプールから取得します。
関数実行前のデフォルト設定値は2チャンネルです。

備考:

本関数は、ACBファイルを使用せずに音声を再生する場合にのみセットする必要があります。
キューを再生する場合、フォーマットはキューシートから自動で取得されるため、 別途本関数を実行する必要はありません。

サンプリングレートの指定

引数:

samplingRate

サンプリングレート

説明:

AtomExプレーヤで再生する音声のサンプリングレートを指定します。
CriAtomExPlayer::Start 関数で音声を再生した際、AtomExプレーヤは本関数で 指定されたサンプリングレートのデータを再生可能なボイスを、ボイスプールから取得します。
関数実行前のデフォルト設定値は32000Hzです。

備考:

本関数は、ACBファイルを使用せずに音声を再生する場合にのみセットする必要があります。
キューを再生する場合、フォーマットはキューシートから自動で取得されるため、 別途本関数を実行する必要はありません。

再生の開始

戻り値:

CriAtomExPlaybackオブジェクト

説明:

音声データの再生処理を開始します。
本関数を実行する前に、事前に CriAtomExPlayer::SetCue 関数等を使用し、 再生する音声データをAtomExプレーヤにセットしておく必要があります。
例えば、キューを再生する場合には、以下のように事前に CriAtomExPlayer::SetCue 関数を使って音声データをセットした後、本関数を実行する 必要があります。

        :
    // ACFファイルの登録
    CriAtomEx.RegisterAcf(null, "sample.acf");

    // ACBファイルのロード
    CriAtomExAcb acb = CriAtomExAcb.LoadAcbFile(null, "sample.acb", "sample.awb");

    // プレーヤの作成
    CriAtomExPlayer player = new CriAtomExPlayer();

    // 再生するキューの名前を指定
    player.SetCue(acb, "gun_shot");

    // セットされた音声データを再生
    player.Start();
        :

本関数実行後、再生の進み具合（発音が開始されたか、再生が完了したか等） がどうなっているかは、ステータスを取得することで確認が可能です。
ステータスの取得には、 CriAtomExPlayer::GetStatus 関数を使用します。
CriAtomExPlayer::GetStatus 関数は以下の5通りのステータスを返します。

1. Stop
2. Prep
3. Playing
4. PlayEnd
5. Error

AtomExプレーヤを作成した時点では、AtomExプレーヤのステータスは停止状態（ Stop ）です。
再生する音声データをセット後、本関数を実行することで、 AtomExプレーヤのステータスが準備状態（ Prep ）に変更されます。
（Prep は、データ供給やデコードの開始を待っている状態です。）
再生の開始に充分なデータが供給された時点で、AtomExプレーヤはステータスを 再生状態（ Playing ）に変更し、音声の出力を開始します。
セットされたデータを全て再生し終えると、AtomExプレーヤはステータスを再生終了状態 （ PlayEnd ）に変更します。
尚、再生中にエラーが発生した場合には、AtomExプレーヤはステータスをエラー状態 （ Error ）に変更します。

AtomExプレーヤのステータスをチェックし、ステータスに応じて処理を切り替えることで、 音声の再生状態に連動したプログラムを作成することが可能です。
例えば、音声の再生完了を待って処理を進めたい場合には、以下のようなコードになります。

        :
    // プレーヤの作成
    CriAtomExPlayer player = new CriAtomExPlayer();

    // 再生するキューの名前を指定
    player.SetCue(acb, "gun_shot");

    // セットされた音声データを再生
    player.Start();

    // 再生完了待ち
    while (player.GetStatus() != CriAtomExPlayer.Status.PlayEnd) {
        yield return null;
    }
        :

参照:

CriAtomExPlayer::SetCue, CriAtomExPlayer::GetStatus

再生の準備

戻り値:

CriAtomExPlaybackオブジェクト

説明:

音声データの再生を準備します。
本関数を実行する前に、事前に CriAtomExPlayer::SetData 関数等を使用し、 再生すべき音声データをAtomExプレーヤにセットしておく必要があります。

本関数を実行すると、ポーズをかけた状態で音声の再生を開始します。
関数実行のタイミングで音声再生に必要なリソースを確保し、 バッファリング（ストリーム再生を行うファイルの読み込み）を開始しますが、 バッファリング完了後も発音は行われません。
（発音可能な状態になっても、ポーズ状態で待機します。）

1音だけを再生するケースでは、本関数は以下のコードと同じ動作をします。

        ：
    // プレーヤをポーズ状態に設定
    player.Pause();

    // 音声の再生を開始
    CriAtomExPlayback playback = player.Start();
        ：

本関数で再生準備を行った音声を発音するには、 本関数が返すCriAtomExPlaybackオブジェクトに対し、 ::CriAtomExPlayback::Resume を実行する必要があります。

備考:

ストリーミング再生時には、 CriAtomExPlayer::Start 関数で再生を開始しても、 実際に音声の再生が開始されるまでにはタイムラグがあります。
（音声データのバッファリングに時間がかかるため。）

以下の操作を行うことで、ストリーム再生の音声についても、発音のタイミングを 制御することが可能になります。

1. CriAtomExPlayer::Prepare 関数で準備を開始する。
2. 手順1.で取得したCriAtomExPlaybackオブジェクトのステータスを ::CriAtomExPlayback::GetStatus 関数で確認。
3. ステータスが Playing になった時点で ::CriAtomExPlayback::Resume 関数でポーズを解除。
4. ポーズ解除後、次にサーバ処理が動作するタイミングで発音が開始される。

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

        :
    // プレーヤの作成
    CriAtomExPlayer player = new CriAtomExPlayer();

    // 再生するキューの名前を指定
    player.SetCue(acb, "gun_shot");

    // セットされた音声データの再生準備を開始
    CriAtomExPlayback playback = player.Prepare();

    // 再生準備完了待ち
    while (playback.GetStatus() != CriAtomExPlayback.Status.Playing) {
        yield return null;
    }

    // ポーズを解除
    playback.Resume(CriAtomEx.ResumeMode.PreparedPlayback);
        :

注意:

ポーズ解除時に PausedPlayback を指定した場合、 本関数による再生準備のためのポーズと、 CriAtomExPlayer::Pause 関数による一時停止処理の両方が解除されます。
CriAtomExPlayer::Pause 関数でポーズした音声を停止したまま 本関数で再生準備を行った音声を再生したい場合、ポーズの解除時に PreparedPlayback を指定してください。

参照:

CriAtomExPlayback::GetStatus, CriAtomExPlayback::Resume

再生の停止

引数:

ignoresReleaseTime

リリース時間を無視するかどうか （false = リリース処理を行う、ture = リリース時間を無視して即座に停止する）

説明:

再生の停止要求を発行します。
音声再生中のAtomExプレーヤに対して本関数を実行すると、 AtomExプレーヤは再生を停止（ファイルの読み込みや、発音を停止）し、 ステータスを停止状態（ Stop ）に遷移します。

引数をtrueに設定した場合、 再生中の音声にエンベロープのリリースタイムが設定されていたとしても、 リリース時間を無視して音声を即座に停止します。

備考:

既に停止しているAtomExプレーヤ（ステータスが PlayEnd や Error のAtomExプレーヤ） に対して本関数を実行すると、AtomExプレーヤのステータスを Stop に変更します。

注意:

音声再生中のAtomExプレーヤに対して本関数を実行した場合、 ステータスが即座に Stop になるとは限りません。
（停止状態になるまでに、時間がかかる場合があります。）

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::GetStatus

ポーズ

説明:

再生を一時停止します。

備考:

デフォルト状態（プレーヤ作成直後の状態）では、ポーズは解除されています。

注意:

本関数を実行すると、プレーヤで再生している"全ての"音声に対してポーズ処理が行われます。
再生中の個々の音声に対し、個別にポーズ処理を行う場合には、 ::CriAtomExPlayback::Pause 関数をご利用ください。

参照:

CriAtomExPlayer::Resume, CriAtomExPlayer::IsPaused, CriAtomExPlayback::Pause

ポーズ解除

引数:

mode

ポーズ解除対象

説明:

一時停止状態の解除を行います。

引数（mode）に PausedPlayback を指定して本関数を実行すると、 ユーザが CriAtomExPlayer::Pause 関数（または ::CriAtomExPlayback::Pause 関数）で一時停止状態になった音声の再生が再開されます。
引数（mode）に PreparedPlayback を指定して本関数を実行すると、 ユーザが CriAtomExPlayer::Prepare 関数で再生準備を指示した音声の再生が開始されます。

備考:

CriAtomExPlayer::Pause 関数でポーズ状態のプレーヤに対して CriAtomExPlayer::Prepare 関数で再生準備を行った場合、その音声は PausedPlayback 指定のポーズ解除処理と、 PreparedPlayback 指定のポーズ解除処理の両方が行われるまで、再生が開始されません。

CriAtomExPlayer::Pause 関数か CriAtomExPlayer::Prepare 関数かに関係なく、 常に再生を開始したい場合には、引数（mode）に AllPlayback を指定して本関数を実行してください。

注意:

本関数を実行すると、プレーヤで再生している"全ての"音声に対してポーズ解除 の処理が行われます。
再生中の個々の音声に対し、個別にポーズ解除の処理を行う場合には、 ::CriAtomExPlayback::Resume 関数をご利用ください。

参照:

CriAtomExPlayer::Pause, CriAtomExPlayback::Resume

ポーズ状態の取得

戻り値:

ポーズ中かどうか（false = ポーズされていない、true = ポーズ中）

説明:

プレーヤがポーズ中かどうかを返します。

注意:

本関数が ture を返すのは、「全ての音声がポーズ中の場合」のみです。
CriAtomExPlayer::Pause 関数実行後、再生ID指定で個々の音声のポーズを解除 （ ::CriAtomExPlayback::Pause 関数を実行）した場合、本関数は false を 返します。

本関数は CriAtomExPlayer::Pause 関数でポーズされた音声と、 CriAtomExPlayer::Prepare 関数でポーズされた音声とを区別しません。
（ポーズ方法に関係なく、全ての音声がポーズされているかどうかのみを判定します。）

参照:

CriAtomExPlayer::Pause, CriAtomExPlayback::Pause

ボリュームの設定

引数:

volume

ボリューム値

説明:

出力音声のボリュームを指定します。
本関数でボリュームを設定後、 CriAtomExPlayer::Start 関数で再生を開始すると、 設定されたボリュームで音声が再生されます。
またボリューム設定後に CriAtomExPlayer::Update 関数や CriAtomExPlayer::UpdateAll 関数を呼び出すことで、すでに再生中の音声のボリュームを更新することも可能です。

ボリューム値は音声データの振幅に対する倍率です（単位はデシベルではありません）。
例えば、1.0fを指定した場合、原音はそのままのボリュームで出力されます。
0.5fを指定した場合、原音波形の振幅を半分にしたデータと同じ音量（-6dB）で 音声が出力されます。
0.0fを指定した場合、音声はミュートされます（無音になります）。
ボリュームのデフォルト値は1.0fです。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // ボリュームの設定
 player.SetVolume(0.5f);

 // 再生の開始
 // 備考）ボリュームはプレーヤに設定された値（＝0.5f）で再生される。
 CriAtomExPlayback playback = player.Start();
    ：
 // ボリュームの変更
 // 注意）この時点では再生中の音声のボリュームは変更されない。
 player.SetVolume(0.3f);

 // プレーヤに設定されたボリュームを再生中の音声にも反映
 player.Update(playback);
    ：

備考:

ボリューム値には0.0f以上の値が設定可能です。
1.0fを超える値をセットした場合、プラットフォームによっては、 波形データを元素材よりも大きな音量で再生可能です。
ボリューム値に0.0f未満の値を指定した場合、値は0.0fにクリップされます。
（ボリューム値に負の値を設定した場合でも、 波形データの位相が反転されることはありません。）

キュー再生時、データ側にボリュームが設定されている場合に本関数を呼び出すと、 データ側に設定されている値と本関数による設定値とを乗算した値が適用されます。
例えば、データ側のボリュームが0.8f、AtomExプレーヤのボリュームが0.5fの場合、 実際に適用されるボリュームは0.4fになります。

デシベルで設定したい場合、以下の計算式で変換してから設定してください。

 volume = Math.Pow(10.0f, db_vol / 20.0f);

※db_volがデシベル値、volumeがボリューム値です。

注意:

1.0fを超えるボリュームを指定する場合、以下の点に注意する必要があります。

• プラットフォームごとに挙動が異なる可能性がある。
• 音割れが発生する可能性がある。

本関数に1.0fを超えるボリューム値を設定した場合でも、 音声が元の波形データよりも大きな音量で再生されるかどうかは、 プラットフォームや音声圧縮コーデックの種別によって異なります。
そのため、マルチプラットフォームタイトルでボリュームを調整する場合には、 1.0fを超えるボリューム値を使用しないことをおすすめします。
（1.0fを超えるボリューム値を指定した場合、同じ波形データを再生した場合でも、 機種ごとに異なる音量で出力される可能性があります。）

また、音量を上げることが可能な機種であっても、 ハードウェアで出力可能な音量には上限があるため、 音割れによるノイズが発生する可能性があります。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll

ピッチの設定

引数:

pitch

ピッチ（セント単位）

説明:

出力音声のピッチを指定します。
本関数でピッチを設定後、 CriAtomExPlayer::Start 関数で再生開始すると、 設定されたピッチで音声が再生されます。
またピッチ後に CriAtomExPlayer::Update 関数や CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、すでに再生された音声のピッチを更新することが可能です。

ピッチはセント単位で指定します。
1セントは1オクターブの1/1200です。半音は100セントです。
例えば、100.0fを指定した場合、ピッチが半音上がります。-100.0fを指定した場合、 ピッチが半音下がります。
ピッチのデフォルト値は0.0fです。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // ピッチの設定
 player.SetPitch(100.0f);

 // 再生の開始
 // 備考）ピッチはプレーヤに設定された値（＝100セント）で再生される。
 CriAtomExPlayback playback = player.Start();
    ：
 // ピッチの変更
 // 注意）この時点では再生中の音声のピッチは変更されない。
 player.SetPitch(-200.0f);

 // プレーヤに設定されたピッチを再生中の音声にも反映
 player.Update(playback);
    ：

備考:

キュー再生時、データ側にピッチが設定されている場合に本関数を呼び出すと、 データ側に設定されている値と本関数による設定値とを加算した値が適用されます。
例えば、データ側のピッチが-100.0f、AtomExプレーヤのピッチが200.0fの場合、 実際に適用されるピッチは100.0fになります。
サンプリングレートの周波数比率で設定したい場合、以下の計算式で変換してから設定してください。

 pitch = 1200.0 * Math.Log(freq_ratio, 2.0);

※freq_ratioが周波数比率、pitchがピッチの値です。

注意:

HCA-MX用にエンコードされた音声データは、ピッチの変更ができません。
（本関数を実行しても、ピッチは変わりません。）
ピッチを変更したい音声については、ADXやHCA等、他のコーデックでエンコードを行ってください。

設定可能な最大ピッチは、音声データのサンプリングレートとボイスプールの最大サンプリングレートに依存します。
例えば、音声データのサンプリングレートが24kHzで、ボイスプールの最大サンプリングレートが48kHzの場合、 設定可能な最大ピッチは1200(周波数比率2倍)になります。

再生サンプリングレートの上下によりピッチを実装しているため、 ピッチを変更すると音程と一緒に再生速度も変化します。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll

パンニング3D角度の設定

引数:

angle

パンニング3D角度（-180.0f〜180.0f：度単位）

説明:

パンニング3D角度を指定します。
本関数でパンニング3D角度を設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定されたパンニング3D角度で再生されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声のパンニング3D角度を更新することができます。

角度は度単位で指定します。
前方を0度とし、右方向（時計回り）に180.0f、左方向（反時計回り）に-180.0fまで設定できます。
例えば、45.0fを指定した場合、右前方45度に定位します。-45.0fを指定した場合、左前方45度に定位します。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // パンニング3D角度の設定
 player.SetPan3dAngle(45.0f);

 // 再生の開始
 // 備考）パンニング3D角度はプレーヤに設定された値（＝45.0f）で再生される。
 CriAtomExPlayback playback = player.Start();
    ：
 // パンニング3D角度の変更
 // 注意）この時点では再生中の音声のパンニング3D角度は変更されない。
 player.SetPan3dAngle(-45.0f);

 // プレーヤに設定されたパンニング3D角度を再生中の音声にも反映
 player.Update(playback);
    ：

備考:

キュー再生時、データ側にパンニング3D角度が設定されている場合に本関数を呼び出すと、 データ側に設定されている値と本関数による設定値とを加算した値が適用されます。
例えば、データ側のパンニング3D角度が15.0f、AtomExプレーヤのパンニング3D角度が30.0fの場合、 実際に適用されるパンニング3D角度は45.0fになります。
実際に適用されるパンニング3D角度が180.0fを超える値になった場合、値を-360.0fして範囲内に納めます。
同様に、実際に適用されるボリューム値が-180.0f未満の値になった場合は、値を+360.0fして範囲内に納めます。
（+360.0f, -360.0fしても定位は変わらないため、実質的には-180.0f〜180.0fの範囲を超えて設定可能です。）

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll

パンニング3D距離の設定

引数:

distance

パンニング3D距離（-1.0f〜1.0f）

説明:

パンニング3Dでインテリアパンニングを行う際の距離を指定します。
本関数でパンニング3D距離を設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定されたパンニング3D距離で再生されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、すでに再生された音声のパンニング3D距離を更新することができます。

距離は、リスナー位置を0.0f、スピーカーの配置されている円周上を1.0fとして、-1.0f〜1.0fの範囲で指定します。
負値を指定すると、パンニング3D角度が180度反転し、逆方向に定位します。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // パンニング3D距離の設定
 player.SetPan3dInteriorDistance(0.5f);

 // 再生の開始
 // 備考）パンニング3D距離はプレーヤに設定された値（＝0.5f）で再生される。
 CriAtomExPlayback playback = player.Start();
    ：
 // パンニング3D距離の変更
 // 注意）この時点では再生中の音声のパンニング3D距離は変更されない。
 // 備考）以下の処理はパン3D角度を180度反転するのと等価
 player.SetPan3dInteriorDistance(-0.5f);

 // プレーヤに設定されたパンニング3D距離を再生中の音声にも反映
 player.Update(playback);
    ：

備考:

キュー再生時、データ側にパンニング3D距離が設定されている場合に本関数を呼び出すと、 データ側に設定されている値と本関数による設定値とを乗算した値が適用されます。
例えば、データ側のパンニング3D距離が0.8f、AtomExプレーヤのパンニング3D距離が0.5fの場合、 実際に適用されるパンニング3D距離は0.4fになります。
実際に適用されるパンニング3D距離が1.0fを超える値になった場合、値は1.0fにクリップされます。
同様に、実際に適用されるパンニング3D距離が-1.0f未満の値になった場合も、値は-1.0fにクリップされます。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll

パンニング3Dボリュームの設定

引数:

volume

パンニング3Dボリューム（0.0f〜1.0f）

説明:

パンニング3Dのボリュームを指定します。
本関数でパンニング3Dボリュームを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定されたパンニング3Dボリュームで再生されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声のパンニング3Dボリュームを更新することができます。

パンニング3Dボリュームは、パンニング3D成分と、 センター／LFEへの出力レベルとを個別に制御する場合に使用します。
例えば、センドレベルで常にLFEから一定のボリュームで出力させておき、 定位はパンニング3Dでコントロールするような場合です。
値の範囲や扱いは、通常のボリュームと同等です。 CriAtomExPlayer::SetVolume 関数を参照してください。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // パンニング3Dボリュームの設定
 player.SetPan3dVolume(0.8f);

 // 再生の開始
 // 備考）パンニング3Dボリュームはプレーヤに設定された値（＝0.5f）で再生される。
 CriAtomExPlayback playback = player.Start();
    ：
 // パンニング3Dボリュームの変更
 // 注意）この時点では再生中の音声のパンニング3Dボリュームは変更されない。
 player.SetPan3dVolume(0.7f);

 // プレーヤに設定されたパンニング3Dボリュームを再生中の音声にも反映
 player.Update(playback);
    ：

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll, CriAtomExPlayer::SetVolume

パンタイプの設定

引数:

panType

パンタイプ

説明:

パンタイプを指定します。
本関数でパンタイプを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、設定されたパンタイプで再生されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声のパンタイプを更新することができます。

備考:

キュー再生時に本関数を呼び出すと、データ側に設定されているパンタイプ設定を上書きします（データ側の設定値は無視されます）。
通常はデータ側でパンタイプが設定されているため、本関数を呼び出す必要はありません。
ACBファイルを使用せずに音声を再生する場合に、3Dポジショニング処理を有効にするためには、本関数で Pos3d を設定してください。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll, CriAtomEx.PanType

センドレベルの設定

引数:

channel	チャンネル番号
id	スピーカーID
level	センドレベル値（0.0f〜1.0f）

説明:

センドレベルを指定します。
センドレベルは、音声データの各チャンネルの音声を、どのスピーカーから どの程度の音量で出力するかを指定するための仕組みです。
本関数でセンドレベルを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定されたセンドレベルで再生されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声のセンドレベルを更新することができます。

第1引数のチャンネル番号は"音声データのチャンネル番号"を指定します。
第2引数のスピーカーIDには、指定したチャンネル番号のデータをどのスピーカーから 出力するかを指定し、第3引数では送信時のレベル（ボリューム）を指定します。
例えば、音声データのチャンネル0番のデータをライトスピーカーから フルボリューム（1.0f）で出力したい場合、指定は以下のようになります。

 player.SetSendLevel(0, CriAtomEx.Speaker.FrontRight, 1.0f);

センドレベル値の範囲や扱いは、ボリュームと同等です。 CriAtomExPlayer::SetVolume 関数を参照してください。

例:

 CriSint32 ch = 0;  // channel number 0
 CriAtomEx.Speaker spk = CriAtomEx.Speaker.FrontCenter;
 CriFloat32 level = 1.0f;
 // Set send level(ch0 to center)
 player.SetSendLevel(ch, spk, level);
 // Start playback
 CriAtomExPlayback playback = player.Start();
                :
 // Change send level
 level = 0.7f;
 player.SetSendLevel(ch, spk, level);
 player.Update(playback);

備考:

センドレベルの設定には「自動設定」「手動設定」の2通りが存在します。
AtomExプレーヤを作成した直後や、 CriAtomExPlayer::ResetParameters 関数で パラメータをクリアした場合、センドレベルの設定は「自動設定」となります。
これに対し、本関数を実行した場合、センドレベルの設定は「手動設定」になります。
（ユーザが各スピーカーへのセンドレベルをコントロールし、パンニングを行う必要があります。）

「自動設定」の場合、AtomExプレーヤは以下のように音声をルーティングします。

【モノラル音声を再生する場合】
チャンネル0の音声を左右のスピーカーから約0.7f（-3dB）のボリュームで出力します。

【ステレオ音声を再生する場合】
チャンネル0の音声をレフトスピーカーから、 チャンネル1の音声をライトスピーカーから出力します。

【4ch音声を再生する場合】
チャンネル0の音声をレフトスピーカーから、チャンネル1の音声をライトスピーカーから、 チャンネル2の音声をサラウンドレフトスピーカーから、 チャンネル3の音声をサラウンドライトスピーカーからでそれぞれ出力します。

【5.1ch音声を再生する場合】
チャンネル0の音声をレフトスピーカーから、チャンネル1の音声をライトスピーカーから、 チャンネル2の音声をセンタースピーカーから、チャンネル3の音声をLFEから、 チャンネル4の音声をサラウンドレフトスピーカーから、 チャンネル5の音声をサラウンドライトスピーカーからそれぞれ出力します。

【7.1ch音声を再生する場合】
チャンネル0の音声をレフトスピーカーから、チャンネル1の音声をライトスピーカーから、 チャンネル2の音声をセンタースピーカーから、チャンネル3の音声をLFEから、 チャンネル4の音声をサラウンドレフトスピーカーから、 チャンネル5の音声をサラウンドライトスピーカーからそれぞれ出力します。
チャンネル6の音声をサラウンドバックレフトスピーカーから、 チャンネル7の音声をサラウンドバックライトスピーカーからそれぞれ出力します。

これに対し、本関数を用いて「手動設定」を行った場合、音声データのチャンネル数に 関係なく、指定されたセンドレベル設定で音声が出力されます。
（音声データのチャンネル数に応じて、適宜センドレベル設定を切り替える必要があります。）

過去に指定したセンドレベルをクリアし、ルーティングを「自動設定」の状態に戻したい場合は、 CriAtomExPlayer::ResetParameters 関数を実行してください。

本パラメータはデータ側には設定できないため、常に本関数の設定値が適用されます。

注意:

センドレベルを設定していないチャンネルについては、音声が出力されません。
例えば、再生する音声データがステレオにもかかわらず、どちらか一方のチャンネルに対して しかセンドレベルが設定されていない場合、センドレベルを設定していないチャンネルの音声 はミュートされます。
センドレベルをコントロールする際には、必ず出力を行いたい全てのチャンネルについてセンド レベルの設定を行ってください。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll, CriAtomExPlayer::SetVolume

バイクアッドフィルタのパラメータの設定

引数:

type	フィルタタイプ
frequency	正規化周波数（0.0f〜1.0f）
gain	ゲイン（デシベル値）
q	Q値

説明:

バイクアッドフィルタの各種パラメータを指定します。
本関数でパラメータを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定されたパラメータでバイクアッドフィルタが動作します。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声に対してバイクアッドフィルタのパラメータを更新することができます。

正規化周波数は、対数軸上の24Hz〜24000Hzを、0.0f〜1.0fに正規化した値です。
ゲインはデシベルで指定します。
ゲインはフィルタタイプが以下の場合のみ有効です。

• LowShelf ：ローシェルフフィルタ
• HighShelf ：ハイシェルフフィルタ
• Peaking ：ピーキングフフィルタ

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // フィルタのパラメータを設定
 CriAtomEx.BiquadFilterType type = CriAtomEx.BiquadFilterType.LowPass;
 float frequency = 0.5f;
 float gain = 1.0f;
 float q = 3.0f;
 player.SetBiquadFilterParameters(type, frequency, gain, q);

 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：
 // パラメータの変更
 // 注意）この時点では再生中の音声のパラメータは変更されない。
 frequency = 0.7f;
 player.SetBiquadFilterParameters(type, frequency, gain, q);

 // プレーヤに設定されたパラメータを再生中の音声にも反映
 player.Update(playback);
    ：

備考:

• type
  データに設定された値を上書きします。
• frequency
  データに設定された値に加算されます。
• gain
  データに設定された値に乗算されます。
• q
  データに設定された値に加算されます。

実際に適用される正規化カットオフ周波数が1.0fを超える値になった場合、値は1.0fにクリップされます。
同様に、実際に適用される正規化カットオフ周波数が0.0f未満の値になった場合も、値は0.0fにクリップされます。

注意:

HCA-MX用にエンコードされた音声データには、バイクアッドフィルタが適用されません。
バイクアッドフィルタを使用したい音声は、ADXやHCA等、他のコーデックでエンコードしてください。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll

バンドパスフィルタのパラメータ設定

引数:

cofLow	正規化低域カットオフ周波数（0.0f〜1.0f）
cofHigh	正規化高域カットオフ周波数（0.0f〜1.0f）

説明:

バンドパスフィルタのカットオフ周波数を指定します。
本関数でカットオフ周波数を設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定されたカットオフ周波数でバンドパスフィルタが動作します。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声に対してバンドパスフィルタのカットオフ周波数を更新することができます。

正規化カットオフ周波数は、対数軸上の24Hz〜24000Hzを、0.0f〜1.0fに正規化した値です。
例えば、正規化低域カットオフ周波数を0.0f、正規化高域カットオフ周波数を1.0fと指定すると、 バンドパスフィルタは全域が通過し、正規化低域カットオフ周波数を上げるほど、 また正規化高域カットオフ周波数を下げるほど、通過域が狭くなっていきます。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // フィルタのパラメータを設定
 float cof_low = 0.0f;
 float cof_high = 0.3f;
 player.SetBandpassFilterParameter(cof_low, cof_high);

 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：
 // パラメータの変更
 // 注意）この時点では再生中の音声のパラメータは変更されない。
 cof_low = 0.7f;
 cof_high = 1.0f;
 player.SetBandpassFilterParameter(cof_low, cof_high);

 // プレーヤに設定されたパラメータを再生中の音声にも反映
 player.Update(playback);
    ：

備考:

キュー再生時、データ側にバンドパスフィルタのパラメータが設定されている場合に本関数を呼び出すと、 以下のように設定されます。

• cofLow
  データに設定された値に対し、「cofLowRev = 1.0f - cofLow」としてから乗算し、最終的にまた「cofLow = 1.0f - cofLowRev」と元に戻して適用されます。
  つまり、0.0fを「低域側に最もフィルタを開く」として、開き具合を乗算して適用していく形になります。
• cofHigh
  データに設定された値に対し、乗算して適用されます。
  つまり、1.0fを「高域側に最もフィルタを開く」として、開き具合を乗算して適用していく形になります。

実際に適用される正規化カットオフ周波数が1.0fを超える値になった場合、値は1.0fにクリップされます。
同様に、実際に適用される正規化カットオフ周波数が0.0f未満の値になった場合も、値は0.0fにクリップされます。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll

バスセンドレベルの設定（バス名指定）

引数:

busName	バス名
level	センドレベル値（0.0f〜1.0f）

説明:

バスセンドレベルを指定します。
バスセンドレベルは、音声をどのバスにどれだけ流すかを指定するための仕組みです。
本関数でバスセンドレベルを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定されたバスセンドレベルで再生されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声のバスセンドレベルを更新することができます。

第1引数のバスIDは"音声データのチャンネル番号"を指定します。
第2引数では送信時のレベル（ボリューム）を指定します。

センドレベル値の範囲や扱いは、ボリュームと同等です。 CriAtomExPlayer::SetVolume 関数を参照してください。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // バスセンドレベルを設定
 int bus_id = 1;    // ex. reverb, etc...
 float level = 0.3f;
 player.SetBusSendLevel(bus_id, level);

 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：
 // パラメータの変更
 // 注意）この時点では再生中の音声のパラメータは変更されない。
 level = 0.5f;
 player.SetBusSendLevel(bus_id, level);

 // プレーヤに設定されたパラメータを再生中の音声にも反映
 player.Update(playback);
    ：

備考:

本関数を複数回呼び出すことで、複数のバスに流すこともできます。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll, CriAtomExPlayer::SetVolume

オフセットによるバスセンドレベルの設定（バス名指定）

引数:

busName	バス名
levelOffset	センドレベル値（0.0f〜1.0f）

説明:

バスセンドレベルをオフセットで指定します。
キュー再生時、データ側にバスセンドレベルが設定されている場合に本関数を呼び出すと、 データ側に設定されている値と本関数による設定値とを加算した値が適用されます。
それ以外の仕様は CriAtomExPlayer::SetBusSendLevel 関数と同様です。

備考:

CriAtomExPlayer::SetBusSendLevel 関数で 0.0f を設定し、かつ本関数でオフセット値を設定することで、
データ側に設定されていたバスセンドレベルを無視して値が設定可能です。（上書き設定）

参照:

CriAtomExPlayer::SetBusSendLevel

AISACコントロール値の設定（コントロール名指定）

引数:

controlName	コントロール名
value	コントロール値（0.0f〜1.0f）

説明:

コントロール名指定でAISACのコントロール値を指定します。
AISACのコントロール値は１つのプレイヤーに対して最大８つまで設定可能です。
本関数でAISACコントロール値を設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定されたAISACコントロール値で再生されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声のAISACコントロール値を更新することができます。

AISACコントロール値の扱いは::CriAtomExPlayer::SetAisacControl 関数と同様です。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // AISACコントロール値の設定
 float control_value = 0.5f;
 player.SetAisacControl("Any", control_value);

 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：
 // パラメータの変更
 // 注意）この時点では再生中の音声のパラメータは変更されない。
 control_value = 0.3f;
 player.SetAisacControl("Any", control_value);

 // プレーヤに設定されたパラメータを再生中の音声にも反映
 player.Update(playback);
    ：

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll, CriAtomExPlayer::SetAisacControl(uint, float)

AISACコントロール値の設定（コントロールID指定）

引数:

controlId	コントロールID
value	コントロール値（0.0f〜1.0f）

説明:

コントロールID指定でAISACのコントロール値を指定します。
AISACのコントロール値は１つのプレイヤーに対して最大８つまで設定可能です。
本関数でAISACコントロール値を設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定されたAISACコントロール値で再生されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声のAISACコントロール値を更新することができます。

AISACコントロール値には、0.0f〜1.0fの範囲で実数値を指定します。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // AISACコントロール値の設定
 CriAtomExAisacControlId control_id = 0;
 float control_value = 0.5f;
 player.SetAisacControl(control_id, control_value);

 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：
 // パラメータの変更
 // 注意）この時点では再生中の音声のパラメータは変更されない。
 control_value = 0.3f;
 player.SetAisacControl(control_id, control_value);

 // プレーヤに設定されたパラメータを再生中の音声にも反映
 player.Update(playback);
    ：

備考:

AISACのコントロールタイプによって、以下のように挙動が変わります。

• オフ
  • 本関数等によるAISACコントロール値が未設定の場合はそのAISACは動作しません。
• オートモジュレーション
  • 本関数の設定値には影響されず、時間経過とともに自動的にAISACコントロール値が変化します。
• ランダム
  • 本関数等によって設定されたAISACコントロール値を中央値として、データに設定されたランダム幅でランダマイズし、最終的なAISACコントロール値を決定します。
  • ランダマイズ処理は再生開始時のパラメータ適用でのみ行われ、再生中の音声に対するAISACコントロール値変更はできません。
  • 再生開始時にAISACコントロール値が設定されていなかった場合、0.0fを中央値としてランダマイズ処理を行います。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll, CriAtomExPlayer::SetAisacControl(string, float)

3D音源オブジェクトの設定

引数:

source

CriAtomEx3dSourceオブジェクト

説明:

3Dポジショニングを実現するための3D音源オブジェクトを設定します。
3Dリスナーオブジェクトと3D音源オブジェクトを設定することで、3Dリスナーオブジェクトと3D音源オブジェクトの位置関係等から定位や音量、ピッチ等が自動的に適用されます。
本関数で3D音源オブジェクトを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定された3D音源オブジェクトを参照して再生されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声が参照する3D音源オブジェクトを変更することができます。
sourceにnullを設定した場合は、すでに設定されている3D音源オブジェクトをクリアします。

注意:

3D音源オブジェクトのパラメータの変更、更新は、AtomExプレーヤの関数ではなく、3D音源オブジェクトの関数を使用して行います。
デフォルトでは、3Dポジショニングの計算は左手座標系で行われます。

例:

    ：
 // リスナの作成
 CriAtomEx3dListener listener = new CriAtomEx3dListener();

 // ソースの作成
 CriAtomEx3dSource source = new CriAtomEx3dSource();

 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();

 // ソース、リスナをプレーヤに設定
 player.Set3dListener(listener);
 player.Set3dSource(source);
    ：
 // 音源の位置を初期化
 source.SetPosition(0.0f, 0.0f, 0.0f);
 source.Update();
    ：
 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：
 // 音源の位置を変更
 source.SetPosition(10.0f, 0.0f, 0.0f);
 source.Update();
    ：

参照:

CriAtomEx3dListener, CriAtomExPlayer::Set3dSource, CriAtomExPlayer::Update

3Dリスナーオブジェクトの設定

引数:

listener

3Dリスナーオブジェクト

説明:

3Dポジショニングを実現するための3Dリスナーオブジェクトを設定します。
3Dリスナーオブジェクトと3D音源オブジェクトを設定することで、3Dリスナーと3D音源の位置関係等から定位や音量、ピッチ等が自動的に適用されます。
本関数で3Dリスナーオブジェクトを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、 設定された3Dリスナーオブジェクトを参照して再生されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声が参照する3Dリスナーオブジェクトを変更することができます。
listenerにnullを設定した場合は、すでに設定されている3Dリスナーオブジェクトをクリアします。

注意:

3Dリスナーオブジェクトのパラメータの変更、更新は、AtomExプレーヤの関数ではなく、3Dリスナーオブジェクトの関数を使用して行います。
デフォルトでは、3Dポジショニングの計算は左手座標系で行われます。

例:

    ：
 // リスナの作成
 CriAtomEx3dListener listener = new CriAtomEx3dListener();

 // ソースの作成
 CriAtomEx3dSource source = new CriAtomEx3dSource();

 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();

 // ソース、リスナをプレーヤに設定
 player.Set3dListener(listener);
 player.Set3dSource(source);
    ：
 // 音源の位置を初期化
 source.SetPosition(0.0f, 0.0f, 0.0f);
 source.Update();
    ：
 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：
 // リスナの位置を変更
 listener.SetPosition(-10.0f, 0.0f, 0.0f);
 listener.Update();
    ：

参照:

CriAtomEx3dListener, CriAtomExPlayer::Set3dSource, CriAtomExPlayer::Update

再生開始位置の指定

引数:

startTimeMs

再生開始位置（ミリ秒指定）

説明:

AtomExプレーヤで再生する音声について、再生を開始する位置を指定します。
音声データを途中から再生したい場合、再生開始前に本関数で再生開始位置を 指定する必要があります。

再生開始位置の指定はミリ秒単位で行います。
例えば、 start_time_ms に 10000 をセットして本関数を実行すると、 次に再生する音声データは 10 秒目の位置から再生されます。

備考

音声データ途中からの再生は、音声データ先頭からの再生に比べ、発音開始の タイミングが遅くなります。
これは、一旦音声データのヘッダを解析後、指定位置にジャンプしてからデータを読み 直して再生を開始するためです。

注意:

startTimeMs には64bit値をセット可能ですが、現状、32bit以上の再生時刻を 指定することはできません。

再生開始位置を指定してシーケンスを再生した場合、指定位置よりも前に配置された 波形データは再生されません。
（シーケンス内の個々の波形が途中から再生されることはありません。）

再生開始ブロックのセット（ブロックインデックス指定）

引数:

index

ブロックインデックス

説明:

再生開始ブロックインデックスを、AtomExプレーヤに関連付けます。
本関数で再生開始ブロックインデックスを指定後、ブロックシーケンスキューを CriAtomExPlayer::Start 関数で再生開始すると指定したブロックから再生を開始します。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // 音声データをセット
 player.SetCue(acb, 300);

 // 開始ブロックをセット
 player.SetFirstBlockIndex(1);

 // セットされた音声データを再生
 player.Start();
    ：

備考:

AtomExプレーヤのデフォルトブロックインデックスは 0 です。
CriAtomExPlayer::Start 関数による再生開始時にプレーヤに設定されているキューが ブロックシーケンスでない場合は、本関数で設定した値は利用されません。
指定したインデックスに対応したブロックがない場合は先頭ブロックから再生が行われます。
この際、指定インデックスのブロックが存在しない内容のワーニングが発生します。

備考:

再生開始後のブロック遷移は ::CriAtomExPlayback::SetNextBlockIndex 関数を使用して行い、 再生中のブロックインデックス取得は ::CriAtomExPlayback::GetCurrentBlockIndex 関数を使用します。

参照:

CriAtomExPlayer::Start, CriAtomExPlayback::SetNextBlockIndex, CriAtomExPlayback::GetCurrentBlockIndex

セレクタ情報の設定

引数:

selector	セレクタ名
label	ラベル名

説明:

セレクタ名とラベル名を指定して、プレーヤに設定します。１つのプレイヤーに対して最大８つまで設定可能です
トラックにセレクタラベルが指定されているキューを再生した場合、本関数で指定したセレクタラベル と一致したトラックだけを再生します。
プレーヤに設定したラベル情報の個別削除は CriAtomExPlayer::ClearSelectorLabels を実行してください。
ラベル情報を含む全てのプレーヤ設定値削除は CriAtomExPlayer::ResetParameters を実行してください。

参照:

CriAtomExPlayer::ClearSelectorLabels, CriAtomExPlayer::ResetParameters

設定されているセレクタ情報の削除

説明:

プレーヤに設定されているセレクタ名、ラベル名情報を全て削除します。
また削除後、::CriAtomExPlayer.Update 、::CriAtomExPlayer.UpdateAll を呼び出すことにより、 すでに再生中の音声に対してセレクタ情報の削除が行えますが、再生中音声が停止することはありません。

参照:

CriAtomExPlayer::ResetParameters

カテゴリの設定（ID指定）

引数:

categoryId

カテゴリID

説明:

カテゴリID指定でカテゴリを設定します。
設定したカテゴリ情報を削除するには、 CriAtomExPlayer::UnsetCategory 関数を使用します。

備考:

キュー再生時に本関数を呼び出すと、データ側に設定されているカテゴリ設定を上書きします（データ側の設定値は無視されます）。
本関数で設定したカテゴリ情報は、ACFのレジスト、アンレジストを行うとクリアされます。
ACFをレジストしていない状態ではデフォルトカテゴリが使用可能です。

注意:

カテゴリ設定は再生開始前に行ってください。再生中の音声に対してカテゴリ設定の更新を行うと、カテゴリの再生数カウントが異常になる危険があります。

参照:

CriAtomExPlayer::UnsetCategory, CriAtomExPlayer::SetCategory(string)

カテゴリの設定（カテゴリ名指定）

引数:

categoryName

カテゴリ名

説明:

カテゴリ名指定でカテゴリを設定します。
設定したカテゴリ情報を削除するには、 CriAtomExPlayer::UnsetCategory 関数を使用します。

備考:

カテゴリ指定を名前で行うことを除き、基本的な仕様は CriAtomExPlayer::SetCategory(int) 関数と同様です。

参照:

CriAtomExPlayer::UnsetCategory, CriAtomExPlayer::SetCategory(int)

カテゴリの削除

説明:

プレーヤハンドルに設定されているカテゴリ情報を削除します。

参照:

CriAtomExPlayer::SetCategory

キュープライオリティの設定

引数:

priority

キュープライオリティ

説明:

AtomExプレーヤにキュープライオリティを設定します。
本関数でキュープライオリティをセット後、 CriAtomExPlayer::Start 関数で音声を再生すると、 再生された音声は本関数でセットしたキュープライオリティで発音されます。
関数実行前のデフォルト設定値は0です。

備考:

AtomExプレーヤがキューを再生した際、再生するキューの所属先カテゴリがリミット数 分発音済みの場合、プライオリティによる発音制御が行われます。
具体的には、AtomExプレーヤの再生リクエストが、再生中のキューのプライオリティよりも 高い場合、AtomExプレーヤは再生中のキューを停止し、リクエストによる再生を開始します。
（再生中の音声が停止され、別の音声が再生されます。）
逆に、AtomExプレーヤの再生リクエストが、再生中のキューのプライオリティよりも低い場合、 AtomExプレーヤの再生リクエストが拒否されます。
（リクエストされたキューは再生されません。）
AtomExプレーヤの再生リクエストが、再生中のキューのプライオリティと等しい場合、 AtomExプレーヤは後着優先で発音制御を行います。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::ResetParameters

ボイスプライオリティの設定

引数:

priority

ボイスプライオリティ（-255〜255）

説明:

AtomExプレーヤにボイスプライオリティを設定します。
本関数でプライオリティをセット後、 CriAtomExPlayer::Start 関数で音声を再生すると、 再生された音声は本関数でセットしたプライオリティで発音されます。
また設定後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出すことにより、 すでに再生された音声のプライオリティを更新することができます。

ボイスプライオリティには、-255〜255の範囲で整数値を指定します。
範囲外の値を設定した場合、範囲に収まるようにクリッピングされます。
関数実行前のデフォルト設定値は0です。

備考:

AtomExプレーヤが波形データを再生しようとした際、 当該波形データが所属するボイスリミットグループの発音数が上限に達していた場合や、 ボイスプール内のボイスが全て使用中であった場合、 ボイスプライオリティによる発音制御が行われます。
（指定された波形データを再生するかどうかを、ボイスプライオリティを元に判定します。）

具体的には、再生を行おうとした波形データのプライオリティが、 現在ボイスで再生中の波形データのプライオリティよりも高い場合、 AtomExプレーヤは再生中のボイスを奪い取り、リクエストされた波形データの再生を開始します。
（再生中の音声が停止され、別の音声が再生されます。）

逆に、再生を行おうとした波形データのプライオリティが、 ボイスで再生中の波形データのプライオリティよりも低い場合、 AtomExプレーヤはリクエストされた波形データの再生を行いません。
（リクエストされた音声は再生されず、再生中の音声が引き続き鳴り続けます。）

再生しようとした波形データのプライオリティが、 ボイスで再生中の波形データのプライオリティと等しい場合、 AtomExプレーヤは発音制御方式（先着優先 or 後着優先）に従い、 以下のような制御が行われます。

• 先着優先時は、再生中の波形データを優先し、リクエストされた波形データを再生しません。
• 後着優先時は、リクエストされた波形データを優先し、ボイスを奪い取ります。

キュー再生時、データ側にボイスプライオリティが設定されている場合に本関数を呼び出すと、 データ側に設定されている値と本関数による設定値とを加算した値が適用されます。
例えば、データ側のプライオリティが255、AtomExプレーヤのプライオリティが45の場合、 実際に適用されるプライオリティは300になります。
本関数で設定可能な値の範囲は-255〜255ですが、ライブラリ内部の計算はintの範囲で行われるため、 データ側と加算した結果は-255〜255を超える場合があります。

注意:

本関数は、波形データにセットされたボイスプライオリティを制御します。
Atom Craft上でキューに対して設定されたカテゴリキュープライオリティには影響を与えませんので、 ご注意ください。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::Update, CriAtomExPlayer::UpdateAll, CriAtomExPlayer::SetVoiceControlMethod

ボイス制御方法の指定

引数:

method

ボイス制御方法

説明:

AtomExプレーヤにボイス制御方法を設定します。
本関数でボイス制御方法をセット後、 CriAtomExPlayer::Start 関数で音声を再生すると、 当該プレーヤで再生する波形データには、本関数で指定した制御方式が適用されます。
関数実行前のデフォルト設定値は後着優先（ PreferLast ）です。

備考:

AtomExプレーヤが波形データを再生しようとした際、 当該波形データが所属するボイスリミットグループの発音数が上限に達していた場合や、 ボイスプール内のボイスが全て使用中であった場合、 ボイスプライオリティによる発音制御が行われます。

本関数でセットされたボイス制御方式は、発音制御の際、 再生しようとした波形データのプライオリティと、 再生中の波形データのプライオリティが同プライオリティであった場合に考慮されます。
（ボイスプライオリティによる発音制御の詳細は CriAtomExPlayer::SetVoicePriority 関数の説明をご参照ください。）

既知の不具合:

現状、本関数でボイス制御方法を指定した場合でも、 キュー再生時にはオーサリングツール上でセットしたボイス制御方法が優先して適用されます。

参照:

CriAtomExPlayer::Start, CriAtomExPlayer::SetVoicePriority, CriAtomEx.VoiceControlMethod

プリディレイタイムの設定

引数:

time	プリディレイタイム（0.0f〜2000.0f）

説明:

プリディレイタイムを設定します。
本関数でプリディレイタイムを設定後、::CriAtomExPlayer::Start 関数により再生開始すると、 設定されたプリディレイタイム発音を待ちます。

プリディレイタイムには、0.0f〜10000.0fの範囲で実数値を指定します。単位はms（ミリ秒）です。
プリディレイタイムのデフォルト値は0.0fです。

備考:

キュー再生時、データ側にプリディレイタイムが設定されている場合に本関数を呼び出すと、 データ側に設定されている値と本関数の設定値を加算した値が適用されます。

注意:

再生中に CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数によって更新することはできません。

HCA-MX用にエンコードされた音声データには、プリディレイが適用されません。
エンベロープを使用したい音声は、ADXやHCA等、他のコーデックでエンコードしてください。

参照:

CriAtomExPlayer::Start

エンベロープのアタックタイムの設定

引数:

time	アタックタイム（0.0f〜2000.0f）

説明:

エンベロープのアタックタイムを設定します。
本関数でアタックタイムを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、設定されたアタックタイムで再生されます。

アタックタイムには、0.0f〜2000.0fの範囲で実数値を指定します。単位はms（ミリ秒）です。
アタックタイムのデフォルト値は0.0fです。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // エンベロープの設定
 player.SetEnvelopeAttackTime(10.0f);

 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：

備考:

キュー再生時、データ側にアタックタイムが設定されている場合に本関数を呼び出すと、 データ側に設定されている値を上書きして適用されます（データ側の設定値は無視されます）。

注意:

再生中に CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数によって更新することはできません。

HCA-MX用にエンコードされた音声データには、エンベロープが適用されません。
エンベロープを使用したい音声は、ADXやHCA等、他のコーデックでエンコードしてください。

参照:

CriAtomExPlayer::Start

エンベロープのホールドタイムの設定

引数:

time	ホールドタイム（0.0f〜2000.0f）

説明:

エンベロープのホールドタイムを設定します。
本関数でホールドタイムを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、設定されたホールドタイムで再生されます。

ホールドタイムには、0.0f〜2000.0fの範囲で実数値を指定します。単位はms（ミリ秒）です。
ホールドタイムのデフォルト値は0.0fです。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // エンベロープの設定
 player.SetEnvelopeHoldTime(player, 20.0f);

 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：

備考:

キュー再生時、データ側にホールドタイムが設定されている場合に本関数を呼び出すと、 データ側に設定されている値を上書きして適用されます（データ側の設定値は無視されます）。

注意:

再生中に CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数によって更新することはできません。

HCA-MX用にエンコードされた音声データには、エンベロープが適用されません。
エンベロープを使用したい音声は、ADXやHCA等、他のコーデックでエンコードしてください。

参照:

CriAtomExPlayer::Start

エンベロープのディケイタイムの設定

引数:

time	ディケイタイム（0.0f〜2000.0f）

説明:

エンベロープのディケイタイムを設定します。
本関数でディケイタイムを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、設定されたディケイタイムで再生されます。

ディケイタイムには、0.0f〜2000.0fの範囲で実数値を指定します。単位はms（ミリ秒）です。
ディケイタイムのデフォルト値は0.0fです。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // エンベロープの設定
 player.SetEnvelopeDecayTime(player, 10.0f);

 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：

備考:

キュー再生時、データ側にディケイタイムが設定されている場合に本関数を呼び出すと、 データ側に設定されている値を上書きして適用されます（データ側の設定値は無視されます）。

注意:

再生中に CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数によって更新することはできません。

HCA-MX用にエンコードされた音声データには、エンベロープが適用されません。
エンベロープを使用したい音声は、ADXやHCA等、他のコーデックでエンコードしてください。

参照:

CriAtomExPlayer::Start

エンベロープのリリースタイムの設定

引数:

time	リリースタイム（0.0f〜10000.0f）

説明:

エンベロープのリリースタイムを設定します。
本関数でリリースタイムを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、設定されたリリースタイムで再生されます。

リリースタイムには、0.0f〜10000.0fの範囲で実数値を指定します。単位はms（ミリ秒）です。
リリースタイムのデフォルト値は0.0fです。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // エンベロープの設定
 player.SetEnvelopeReleaseTime(player, 3000.0f);

 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：

備考:

キュー再生時、データ側にリリースタイムが設定されている場合に本関数を呼び出すと、 データ側に設定されている値を上書きして適用されます（データ側の設定値は無視されます）。

注意:

再生中に CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数によって更新することはできません。

HCA-MX用にエンコードされた音声データには、エンベロープが適用されません。
エンベロープを使用したい音声は、ADXやHCA等、他のコーデックでエンコードしてください。

参照:

CriAtomExPlayer::Start

エンベロープのサスティンレベルの設定

引数:

level

サスティンレベル（0.0f〜2000.0f）

説明:

エンベロープのサスティンレベルを設定します。
本関数でサスティンレベルを設定後、 CriAtomExPlayer::Start 関数により再生開始すると、設定されたサスティンレベルで再生されます。

サスティンレベルには、0.0f〜1.0fの範囲で実数値を指定します。
サスティンレベルのデフォルト値は0.0fです。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // エンベロープの設定
 player.SetEnvelopeSustainLevel(0.5f);

 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：

備考:

キュー再生時、データ側にサスティンレベルが設定されている場合に本関数を呼び出すと、 データ側に設定されている値を上書きして適用されます（データ側の設定値は無視されます）。

注意:

再生中に CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数によって更新することはできません。

HCA-MX用にエンコードされた音声データには、エンベロープが適用されません。
エンベロープを使用したい音声は、ADXやHCA等、他のコーデックでエンコードしてください。

参照:

CriAtomExPlayer::Start

プレーヤにフェーダを取り付ける

説明:

プレーヤにフェーダをアタッチ（取り付け）し、 CriAtomExPlayerをクロスフェード専用のプレーヤに変化させます。
（複数音の同時再生等、従来のCriAtomExPlayerの持つ機能が一部利用できなくなります。）

本関数でフェーダをアタッチしたプレーヤは、以降音声再生開始毎 （ CriAtomExPlayer::Start 関数や CriAtomExPlayer::Prepare 実行を実行する毎）に、 以下の制御を行います。

• 既にフェードアウト中の音があれば強制停止。
• 現在再生中（またはフェードイン中）の音声をフェードアウト。
• 新規に再生を開始する音声をフェードイン。

また、再生停止時（ CriAtomExPlayer::Stop 関数実行時）には、 以下の制御を行います。

• 既にフェードアウト中の音があれば強制停止。
• 現在再生中（またはフェードイン中）の音声をフェードアウト。

備考:

フェーダをアタッチするプレーヤが音声再生中の場合、本関数を実行したタイミングで プレーヤが再生中の音声は全て停止されます。

フェーダは、アタッチ中のプレーヤに対して CriAtomExPlayer::Start 関数や、 CriAtomExPlayer::Stop 関数が実行される度、 当該プレーヤで再生中の音声に対して以下の制御を行います。

1. 既にフェードアウト中の音声が存在する場合、その音声を即座に停止する。
2. フェードイン中の音声（または再生中の音声）が存在する場合、 その音声をその時点の音量から CriAtomExPlayer::SetFadeOutTime 関数で指定された時間をかけてフェードアウトさせる。
3. CriAtomExPlayer::Start 関数が実行された場合、 プレーヤにセットされている音声データをボリューム0で再生開始し、 CriAtomExPlayer::SetFadeInTime 関数で指定された時間をかけてフェードインさせる。

（ CriAtomExPlayer::Start 関数の代わりに CriAtomExPlayer::Prepare 関数を使用した場合、ポーズを解除する時点で上記の制御が行われます。）

注意:

本関数を実行すると、CriAtomExPlayerに対する再生／停止操作が大きく変更されます。
（フェーダアタッチ前後で挙動が大きく変わります。）
具体的には、同時に発音可能な音声の数が1音（クロスフェード中のみ2音）に限定され、 ::CriAtomExPlayback を用いた制御も行えなくなります。

本関数は、クロスフェード処理を行いたい場合にのみ必要となります。
1音だけのフェードイン／アウトについては、エンベロープやTweenをご利用ください。

フェーダの動作仕様の都合上、フェードイン／アウトの処理対象となるのは、 過去2回の音声再生のみです。
それ以前に再生された音声は、 CriAtomExPlayer::Start 関数や CriAtomExPlayer::Stop 関数が実行された時点で強制的に停止されます。
強制停止処理のタイミングで意図しないノイズが発生する恐れがありますので、 同時再生数が3音以上にならないよう注意してください。

フェードイン／アウトが機能するのは『AtomExプレーヤに対する操作』のみです。
CriAtomExPlayer::Start 関数実行時に取得した再生IDに対し、 ::CriAtomExPlayback::Stop を実行しても、フェードアウトは行われません。
（フェーダの設定が無視され、即座に停止処理が行われます。）

参照:

CriAtomExPlayer::DetachFader

プレーヤからフェーダを取り外す

説明:

プレーヤからフェーダをデタッチ（取り外し）します。
本関数でフェーダをデタッチしたプレーヤには、以降フェードイン／アウトの処理が行われなくなります。

備考:

フェーダをデタッチするプレーヤが音声再生中の場合、本関数を実行したタイミングで プレーヤが再生中の音声は全て停止されます。

参照:

CriAtomExPlayer::AttachFader

フェードアウト時間の設定

引数:

ms	フェードアウト時間（ミリ秒指定）

説明:

フェーダをアタッチ済みのプレーヤに対し、フェードアウト時間を指定します。
次回音声再生時（ CriAtomExPlayer::Start 関数実行時）には、本関数で設定された 時間で再生中の音声がフェードアウトします。

フェードアウト時間のデフォルト値は 500 ミリ秒です。

備考:

フェードアウト時間が設定されている場合、CriAtomExPlayer は以下の順序で再生を停止します。

1. 指定された時間で音声のボリュームを 0 まで落とす。
2. ボリュームが 0 の状態でディレイ時間が経過するまで再生を続ける。
3. ディレイ時間経過後に再生を停止する。

フェードアウト時のボリュームコントロールは、音声再生停止前に行われます。
そのため、波形データにあらかじめ設定されたエンベロープのリリース時間は無視されます。
（厳密には、ボリュームが 0 になってからエンベロープのリリース処理が適用されます。）

第2引数（ ms ）に 0 を指定する場合と、 -1 を指定する場合とでは、以下のように挙動が異なります。

• 0 指定時：即座にボリュームが 0 に落とされ、停止処理が行われる。
• -1 指定時：ボリューム変更は行われず、停止処理が行われる。

再生停止時にフェードアウト処理を行わず、波形にあらかじめ設定されている エンベロープのリリース処理を有効にしたい場合、第2引数（ ms ）に、 -1 を指定してください。
-1 を指定することで、フェードアウト処理によるボリューム制御が行われなくなるため、 CriAtomExPlayer::Stop 関数実行後、ディレイ時間経過後に通常の停止処理が行われます。
（波形データにエンベロープのリリースが設定されている場合、リリース処理が行われます。）

注意:

本関数を実行する前に、 CriAtomExPlayer::AttachFader 関数を使用して あらかじめプレーヤにフェーダをアタッチしておく必要があります。

本関数で設定した値は、既に再生中の音声には一切影響しません。
本関数で設定したフェード時間は、本関数実行後に CriAtomExPlayer::Start 関数や CriAtomExPlayer::Stop 関数を実行するタイミングで適用されます。
（既にフェードアウトを開始している音声に対しては、 本関数で後からフェードアウト時間を変更することはできません。）

参照:

CriAtomExPlayer::AttachFader, CriAtomExPlayer::SetFadeInTime

フェードイン時間の設定

引数:

ms	フェードイン時間（ミリ秒指定）

説明:

フェーダをアタッチ済みのプレーヤに対し、フェードイン時間を指定します。
次回音声再生時（ CriAtomExPlayer::Start 関数実行時）には、本関数で設定された 時間で新規に音声がフェードイン再生されます。

フェードイン時間のデフォルト値は 0 秒です。
そのため、本関数を使用しない場合フェードインは行われず、即座にフルボリューム で音声の再生が開始されます。

注意:

本関数を実行する前に、 CriAtomExPlayer::AttachFader 関数を使用して あらかじめプレーヤにフェーダをアタッチしておく必要があります。

本関数で設定した値は、既に再生中の音声には一切影響しません。
本関数で設定したフェード時間は、本関数実行後に CriAtomExPlayer::Start 関数を 実行するタイミングで適用されます。
（既にフェードインを開始している音声に対しては、 本関数で後からフェードイン時間を変更することはできません。）

参照:

CriAtomExPlayer::AttachFader, CriAtomExPlayer::SetFadeInTime

フェードイン開始オフセットの設定

引数:

ms	フェードイン開始オフセット（ミリ秒指定）

説明:

フェーダをアタッチ済みのプレーヤに対し、フェードイン開始オフセットを指定します。
本関数を使用することで、フェードインを開始するタイミングをフェードアウトに対して 任意の時間早めたり、遅らせることが可能です。
例えば、フェードアウト時間を5秒、フェードイン開始オフセットを5秒に設定した場合、 フェードアウトが5秒で完了した直後に次の音声をフェードインさせることが可能です。
逆に、フェードイン時間を5秒、フェードイン開始オフセットを-5秒に設定した場合、 フェードインが5秒で完了した直後に再生中の音のフェードアウトを開始させることが可能です。

フェードイン開始オフセットのデフォルト値は 0 秒です。
（フェードインとフェードアウトが同時に開始されます。）

備考:

フェードイン開始のタイミングは、フェードインする音声の再生準備が整ったタイミングです。
そのため、フェードイン開始オフセットが 0 秒に設定されている場合でも、フェードイン音声 のバッファリングに時間がかかる場合（ストリーム再生時等）には、フェードアウトの開始までに しばらく時間がかかります。
（本パラメータは、フェードインとフェードアウトのタイミングを調整するための相対値です。）

注意:

本関数を実行する前に、 CriAtomExPlayer::AttachFader 関数を使用して あらかじめプレーヤにフェーダをアタッチしておく必要があります。

本関数で設定した値は、既に再生中の音声には一切影響しません。
本関数で設定したフェード時間は、本関数実行後に CriAtomExPlayer::Start 関数や CriAtomExPlayer::Stop 関数を実行するタイミングで適用されます。
（既にフェード処理を開始している音声に対しては、 本関数で後からフェード処理のタイミングを変更することはできません。）

参照:

CriAtomExPlayer::AttachFader, CriAtomExPlayer::SetFadeInTime

フェードアウト後のディレイ時間の設定

引数:

ms	フェードアウト後のディレイ時間（ミリ秒指定）

説明:

フェードアウト完了後、ボイスを破棄するまでのディレイ時間を設定します。
本関数を使用することで、フェードアウトを終えたボイスが破棄されるまでのタイミングを任意に設定可能です。

ディレイ時間のデフォルト値は 500 ミリ秒です。
（フェードアウト音を再生するボイスは、ボリュームが 0 に設定された後、 500 ミリ秒後に破棄されます。）

備考:

音声のフェードアウトが完了する前にボイスが停止されるプラットフォーム以外は、 本関数を使用する必要はありません。

注意:

本関数を実行する前に、 CriAtomExPlayer::AttachFader 関数を使用して あらかじめプレーヤにフェーダをアタッチしておく必要があります。

本関数で設定した値は、既に再生中の音声には一切影響しません。
本関数で設定したフェード時間は、本関数実行後に CriAtomExPlayer::Start 関数や CriAtomExPlayer::Stop 関数を実行するタイミングで適用されます。
（既にフェードアウトを開始している音声に対しては、 本関数で後からフェードアウト後のディレイ時間を変更することはできません。）

ボリュームの制御とボイスの停止が反映されるタイミングは、プラットフォームによって異なります。
そのため、本関数に 0 を指定した場合、プラットフォームによってはボリュームの変更が反映される 前にボイスが停止される恐れがあります。

参照:

CriAtomExPlayer::AttachFader

フェード処理中かどうかを取得

戻り値:

フェード処理中かどうか

説明:

フェード処理が行われている最中かどうかを取得します。

備考:

本関数は、以下の処理期間中 true を返します。

• クロスフェード開始のための同期待ち中。
• フェードイン／フェードアウト処理中（ボリューム変更中）。
• フェードアウト完了後のディレイ期間中。

フェーダパラメータの初期化

説明:

フェーダに設定されている各種パラメータをクリアし、初期値に戻します。

注意:

本関数を実行する前に、 CriAtomExPlayer::AttachFader 関数を使用して あらかじめプレーヤにフェーダをアタッチしておく必要があります。

本関数でフェーダパラメータをクリアしても、既に再生中の音声には一切影響しません。
本関数でクリアしたフェーダパラメータは、本関数実行後に CriAtomExPlayer::Start 関数や CriAtomExPlayer::Stop 関数を実行するタイミングで適用されます。
（既にフェード処理を開始している音声に対しては、 本関数でクリアしたフェーダパラメータを適用することはできません。）

グループ番号の指定

説明:

発音時にボイスをどのボイスリミットグループから取得するかを指定します。

group_no に -1 を指定した場合、プレーヤはボイスリミットグループによる制限を受けなくなります。
（空きボイスがあるか、または自身より低プライオリティのボイスがあれば、
ボイスリミットグループに関係なくボイスを取得します。）

注意:

再生を開始し、指定したボイスリミットグループのボイスが全て使用中だった場合、 再生した音声が発音されるかどうかは、ボイスプライオリティ制御によって決まります。
（ボイスプライオリティによる発音制御の詳細は CriAtomExPlayer::SetVoicePriority 関数の説明をご参照ください。）

キュー再生時に本関数を呼び出すと、データ側に設定されているボイスリミットグループ設定を
上書きします（データ側の設定値は無視されます）。
ただし、group_no に -1 を指定した場合はデータ側に設定されているボイスリミットグループを参照します。

再生パラメータの更新（CriAtomExPlaybackオブジェクト単位）

引数:

playback

CriAtomExPlaybackオブジェクト

説明:

AtomExプレーヤに設定されている再生パラメータ（AISACコントロール値を含む）を使用して、 CriAtomExPlaybackオブジェクトのパラメータを更新します。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：
 // ボリュームの変更
 // 注意）この時点では再生中の音声のパラメータは変更されない。
 player.SetVolume(volume);

 // プレーヤに設定されたパラメータを再生中の音声にも反映
 player.Update(playback);
    ：

注意:

パラメータ更新に仕様するCriAtomExPlayerオブジェクトは、 CriAtomExPlaybackオブジェクトを生成したプレーヤでなければなりません。

参照:

CriAtomExPlayer::UpdateAll

再生パラメータの更新（再生中の音全て）

説明:

AtomExプレーヤに設定されている再生パラメータ（AISACコントロール値を含む）を使用して、 このAtomExプレーヤで再生中の音全ての再生パラメータを更新します。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // 再生の開始
 CriAtomExPlayback playback = player.Start();
    ：
 // ボリュームの変更
 // 注意）この時点では再生中の音声のパラメータは変更されない。
 player.SetVolume(volume);

 // プレーヤに設定されたパラメータを再生中の全ての音声に反映
 player.UpdateAll();
    ：

参照:

CriAtomExPlayer::Update

再生パラメータの初期化

説明:

AtomExプレーヤに設定されている再生パラメータ（AISACコントロール値を含む）をリセットし、初期状態（未設定状態）に戻します。
本関数呼び出し後、 CriAtomExPlayer::Start 関数により再生開始すると、初期状態の再生パラメータで再生されます。

例:

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // ボリュームの変更
 player.SetVolume(0.5f);

 // 音声を再生
 // 備考）ここで再生された音声は0.5fのボリュームで出力される。
 CriAtomExPlayback playback1 = player.Start();

 // プレーヤに設定されたパラメータをリセット
 // 備考）プレーヤのボリューム設定がデフォルト値（1.0f）に戻される。
 player.ResetParameters();

 // 別の音を再生
 // 備考）ここで再生された音声は1.0fのボリュームで出力される。
 CriAtomExPlayback playback2 = player.Start();
    ：

備考:

本関数呼び出し後、 CriAtomExPlayer::Update 関数、 CriAtomExPlayer::UpdateAll 関数を呼び出したとしても、すでに再生されている音声のパラメータは初期値には戻りません。
すでに再生されている音声のパラメータを変える場合は、明示的に CriAtomExPlayer::SetVolume 関数等を呼び出してください。

本関数でリセットされるパラメータは、以下のパラメータです。

• CriAtomEx::Parameter に定義されているパラメータ
• AISACコントロール値（ CriAtomExPlayer::SetAisacControl 関数で設定）
• キュープライオリティ（ CriAtomExPlayer::SetCuePriority 関数で設定）
• 3D音源ハンドル（ CriAtomExPlayer::Set3dSource 関数で設定）
• 3Dリスナーハンドル（ CriAtomExPlayer::Set3dListener 関数で設定）
• カテゴリ設定（ CriAtomExPlayer::SetCategory 関数で設定）
• 再生開始ブロック（ CriAtomExPlayer::SetFirstBlockIndex 関数で設定）

なお、本関数では3D音源ハンドルや3Dリスナーハンドル自体のもつパラメータ（位置等）はリセットされません。「AtomExプレーヤに設定されているハンドルが何か」という設定だけがリセットされます。 これらのハンドル自体のパラメータをリセットしたい場合には、それぞれのハンドルのパラメータリセット関数を呼び出してください。

参照:

CriAtomEx3dSource::ResetParameters, CriAtomEx3dListener::ResetParameters

再生時刻の取得

戻り値:

再生時刻（ミリ秒単位）

説明:

AtomExプレーヤで最後に再生した音声の、再生時刻を取得します。

再生時刻が取得できた場合、本関数は 0 以上の値を返します。
再生時刻が取得できない場合（ボイスの取得に失敗した場合等）、本関数は負値を返します。

備考:

同一プレーヤで複数の音声を再生し、本関数を実行した場合、本関数は "最後に"再生した音声の時刻を返します。
複数の音声に対して再生時刻をチェックする必要がある場合には、 再生する音声の数分だけプレーヤを作成するか、または ::CriAtomExPlayback::GetTime 関数をご利用ください。

本関数が返す再生時刻は「再生開始後からの経過時間」です。
ループ再生時や、シームレス連結再生時を行った場合でも、 再生位置に応じて時刻が巻き戻ることはありません。

CriAtomExPlayer::Pause 関数でポーズをかけた場合、 再生時刻のカウントアップも停止します。
（ポーズを解除すれば再度カウントアップが再開されます。）
本関数で取得可能な時刻の精度は、サーバ処理の周波数に依存します。
（時刻の更新はサーバ処理単位で行われます。）
より精度の高い時刻を取得する必要がある場合には、本関数の代わりに ::CriAtomExPlayback::GetNumPlayedSamples 関数を使用し、 再生済みサンプル数を取得してください。

注意:

戻り値の型はlongですが、現状、32bit以上の精度はありません。
再生時刻を元に制御を行う場合、約24日で再生時刻が異常になる点に注意が必要です。
（ 2147483647 ミリ秒を超えた時点で、再生時刻がオーバーフローし、負値になります。）

再生中の音声が発音数制御によって消去された場合、 再生時刻のカウントアップもその時点で停止します。
また、再生開始時点で発音数制御によりボイスが割り当てられなかった場合、 本関数は正しい時刻を返しません。
（負値が返ります。）

ドライブでリードリトライ処理等が発生し、一時的に音声データの供給が途切れた場合でも、 再生時刻のカウントアップが途切れることはありません。
（データ供給停止により再生が停止した場合でも、時刻は進み続けます。）
そのため、本関数で取得した時刻を元に映像との同期を行った場合、 リードリトライ発生毎に同期が大きくズレる可能性があります。
波形データと映像の同期を厳密に取る必要がある場合は、本関数の代わりに ::CriAtomExPlayback::GetNumPlayedSamples 関数を使用し、 再生済みサンプル数との同期を取ってください。

参照:

CriAtomExPlayback::GetTime, CriAtomExPlayback::GetNumPlayedSamples

ステータスの取得

戻り値:

ステータス

説明:

AtomExプレーヤのステータスを取得します。
ステータスはAtomExプレーヤの再生状態を示す CriAtomExPlayer::Status 型の値で、 以下の5通りの値が存在します。

1. Stop
2. Prep
3. Playing
4. PlayEnd
5. Error

AtomExプレーヤを作成した時点では、AtomExプレーヤのステータスは停止状態（ Stop ）です。
再生する音声データをセット後、 CriAtomExPlayer::Start 関数を実行することで、 AtomExプレーヤのステータスが準備状態（ Prep ）に変更されます。
（ Prep は、データ供給やデコードの開始を待っている状態です。）
再生の開始に充分なデータが供給された時点で、AtomExプレーヤはステータスを 再生状態（ Playing ）に変更し、音声の出力を開始します。
セットされたデータを全て再生し終えると、AtomExプレーヤはステータスを再生終了状態 （ PlayEnd ）に変更します。
尚、再生中にエラーが発生した場合には、AtomExプレーヤはステータスをエラー状態 （ Error ）に変更します。

AtomExプレーヤのステータスをチェックし、ステータスに応じて処理を切り替えることで、 音声の再生状態に連動したプログラムを作成することが可能です。
例えば、音声の再生完了を待って処理を進めたい場合には、以下のようなコードになります。

    ：
 // プレーヤの作成
 CriAtomExPlayer player = new CriAtomExPlayer();
    ：
 // 音声データをセット
 player.SetCue(acb, cueId);

 // セットされた音声データを再生
 player.Start();

 // 再生完了待ち
 while (player.GetStatus() != CriAtomExPlayer.Status.PlayEnd) {
    yield return null;
 }
    :

参照:

CriAtomExPlayer::Start

パラメータの取得（浮動小数点数）

引数:

id

パラメータID

戻り値:

パラメータ設定値

説明:

AtomExプレーヤに設定されている各種パラメータの値を取得します。
値は浮動小数点数で取得されます。

参照:

CriAtomEx.Parameter, CriAtomExPlayer::GetParameterUint32, CriAtomExPlayer::GetParameterSint32

パラメータの取得（符号なし整数）

引数:

id

パラメータID

戻り値:

パラメータ設定値

説明:

AtomExプレーヤに設定されている各種パラメータの値を取得します。
値は符号なし整数で取得されます。

参照:

CriAtomEx.Parameter, CriAtomExPlayer::GetParameterFloat32, CriAtomExPlayer::GetParameterSint32

パラメータの取得（符号付き整数）

引数:

id

パラメータID

戻り値:

パラメータ設定値

説明:

AtomExプレーヤに設定されている各種パラメータの値を取得します。
値は符号付き整数で取得されます。

参照:

CriAtomEx.Parameter, CriAtomExPlayer::GetParameterFloat32, CriAtomExPlayer::GetParameterUint32

出力サウンドレンダラタイプの設定

引数:

type	出力先のサウンドレンダラタイプ

説明:

AtomExプレーヤの再生に使用するサウンドレンダラの種別を設定します。
本設定を行ってから再生を開始すると、設定されたサウンドレンダラタイプで作成されたボイス プールから再生可能なボイスを取得します。
サウンドレンダラタイプの設定はキューの再生単位で設定可能です。

参照:

CriAtomEx.SoundRendererType

乱数種の設定

引数:

seed

乱数種

説明:

AtomExプレーヤが保持する疑似乱数生成器に乱数種を設定します。
乱数種を設定することにより、各種ランダム再生処理に再現性を持たせることができます。

参照:

CriAtomEx.SetRandomSeed

ループ再生の切り替え

引数:

sw	ループスイッチ（true: ループモード、false: ループモード解除）

説明:

ループポイントを持たない波形データに対し、ループ再生のON/OFFを切り替えます。
デフォルトはループOFFです。
ループ再生をONにした場合は、音声終端まで再生しても再生は終了せず先頭に戻って再生を繰り返します。

注意:

本関数の設定は波形データに対して適用されます。
シーケンスデータに対して本関数を実行した場合、 シーケンスデータ内の個々の波形データがループ再生される形になります。

本関数による指定は、ループポイントを持たない波形データに対してのみ有効です。
ループポイントを持つ波形データを再生する場合、本関数の指定に関係なく、 波形データのループ位置に従ってループ再生が行われます。

本関数は内部的にシームレス連結再生機能を使用します。
そのため、シームレス連結再生に未対応のフォーマット（HCA-MX等）を使用した場合、 ループ位置にある程度の無音が入る形になります。

ループスイッチの変更は、再生開始前にのみ可能です。
再生中のプレーヤに対してループスイッチを変更することはできません。

ASRラックIDの指定

引数:

asr_rack_id

ASRラックID

説明:

ボイスの出力先ASRラックIDを指定します。

注意:

本関数は ボイスのサウンドレンダラタイプにASRを使用する場合にのみ効果があります。
（他のボイスを使用する場合、本関数の設定値は無視されます。）

ASRラックIDは再生開始前に設定する必要があります。
既に再生が開始された音声に対し、後からASRラックIDを変更することはできません。

HCA-MX用にエンコードされた音声データには、本関数の設定が適用されません。

ボイスプール識別子の設定

引数:

identifier

ボイスプール識別子

説明:

発音時にボイスをどのボイスプールから取得するかを指定します。
本関数を実行すると、プレーヤは以降指定されたボイスプール識別子に一致するボイスプールからのみボイスを取得します。

参照:

CriAtomExStandardVoicePool, CriAtomExWaveVoicePool

DSPタイムストレッチ比率の設定

引数:

ratio

ストレッチ比率

説明:

DSPタイムストレッチの再生時間の倍率を設定します。
元データの再生時刻に ratio を掛けた値がストレッチ結果の再生時間となります。
設定可能な値の範囲は 0.5f 〜 2.0f までです。

注意:

設定する値は再生速度ではなく「再生時間」に対する倍率です。
ストレッチの割合を再生速度で指定する場合、再生速度の倍率の逆数を設定してください。

参照:

CriAtomExVoicePool.AttachDspTimeStretch, CriAtomExPlayer.SetVoicePoolIdentifier

DSPピッチシフタのピッチシフト量の設定

引数:

pitch

ピッチシフト量

説明:

DSPピッチシフタのピッチシフト量を設定します。
単位はセントです。
設定可能な値の範囲は -2400 〜 2400 までです。
原音と比べて 1200 で 2倍、-1200 で 1/2倍 のピッチシフトになります。

参照:

CriAtomExVoicePool.AttachDspPitchShifter, CriAtomExPlayer.SetVoicePoolIdentifier

DSPパラメータの設定

引数:

id	パラメータID
value	パラメータ値

説明:

ボイスにアタッチしているDSPのパラメータを設定します。

参照:

CriAtomExVoicePool.AttachDspTimeStretch, CriAtomExVoicePool.AttachDspPitchShifter, .SetVoicePoolIdentifier