CriAtomSourceの再生状態を示す値です。

説明:

CriAtomSource::status プロパティにより取得できます。

列挙型の値:

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

設定されているキューを再生開始します。

戻り値:

再生ID

説明:

どのキューを再生するかは、事前に CriAtomSource::CueName プロパティにより設定しておく必要があります。

指定したキュー名のキューを再生開始します。

引数:

cueName

キュー名

戻り値:

再生ID

説明:

CriAtomSource::CueName プロパティの設定に関わらず、本関数に指定したキュー名のキューを再生します。

指定したキューIDのキューを再生開始します。

引数:

cueId

キューID

戻り値:

再生ID

説明:

CriAtomSource::CueName プロパティの設定に関わらず、本関数に指定したキューIDのキューを再生します。

再生を停止します。

説明:

音声再生中の CriAtomSource コンポーネントに対して本関数を実行すると、 CriAtomSource コンポーネントは再生を停止（ファイルの読み込みや、発音を止める）し、 ステータスを停止状態（ Stop ）に遷移します。
既に停止している CriAtomSource コンポーネント（ステータスが Playend や Error の CriAtomSource コンポーネント ） に対して本関数を実行すると、 CriAtomSource コンポーネント のステータスを Stop に変更します。

注意:

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

一時停止／再開します。

引数:

sw	True:一時停止、False:再開

説明:

再生のポーズ／ポーズ解除を行います。
sw に True を指定して本関数を実行すると、 CriAtomSource コンポーネントは再生中の音声をポーズ（一時停止）します。
sw に False を指定して本関数を実行すると、 CriAtomSource コンポーネントはポーズを解除し、一時停止していた音声の再生を再開します。

ポーズ状態の取得を行います。

戻り値:

ポーズ状態

説明:

ポーズのON/OFFを取得します。

参照:

CriAtomSource::Pause

バス名を指定してバスセンドレベルを設定します。

備考:

キュー再生時、データ側にバスセンドレベルが設定されている場合に本関数を呼び出すと、 データ側に設定されている値と本関数による設定値とを乗算した値が適用されます。
例えば、データ側のバスセンドレベルが0.8f、 CriAtomSource のバスセンドレベルが0.5fの場合、 実際に適用されるバスセンドレベルは0.4fになります。

バス名を指定してバスセンドレベルをオフセット指定で設定します。

説明:

キュー再生時、データ側にバスセンドレベルが設定されている場合に本関数を呼び出すと、 データ側に設定されている値と本関数による設定値とを加算した値が適用されます。
例えば、データ側のバスセンドレベルが0.2f、 CriAtomSource のバスセンドレベルが0.5fの場合、 実際に適用されるバスセンドレベルは0.7fになります。

内部で使用している CriAtomExPlayer です。

説明:

CriAtomExPlayer を直接制御する場合にはこのプロパティから CriAtomExPlayer を取得してください。

実行開始時に再生するかどうかを設定／取得します。

説明:

Trueが設定されていると、実行開始時に再生を開始します。

備考:

再生開始が行われるタイミングは、MonoBehaviour::Start 関数が呼ばれるタイミングです。

注意:

WebGL などの非同期 ACB ロードが有効なプラットフォームで本フラグによる 実行開始時のキュー再生を行う場合は、必ずキューシート名を指定してください。
指定しない場合、ロード待ちを行うべきキューシートが特定できないため、 キューの再生に失敗します。

再生するキュー名を設定／取得します。

説明:

CriAtomSource::Play() 関数を呼び出した場合や、 CriAtomSource::playOnStart プロパティの設定により実行開始時に再生する場合には、 本プロパティで設定されているキューを再生します。

キューシート名を設定／取得します。

説明:

CriAtomSource::Play 関数や CriAtomSource::CueName プロパティで指定したキューは、 本プロパティで設定されているキューシートから検索されます。

3Dポジショニングを使用するかを設定します。

説明:

デフォルトの設定では、3Dポジショニングの使用は有効になっています。
本パラメータは任意のタイミングで切り替えることができます。

音源の3Dリージョンの設定及び取得

注意:

3Dポジショニングが無効の場合、リージョンの設定は行えません。

音源のリスナーの設定及び取得

備考:

リスナーが設定されていない場合は音源に最も近いリスナーが利用されます。

注意:

3Dポジショニングが無効の場合、リスナーの設定は行えません。

初期リージョンを設定します。

説明:

Startが実行されるタイミングで適用するリージョンを設定します。
3Dポジショニング有効時にのみ適用されます。
空(null)の場合は適用されません。

初期リスナーを設定します。

説明:

Startが実行されるタイミングで適用するリスナーを設定します。
3Dポジショニング有効時にのみ適用されます。
空(null)の場合は適用されません。

備考:

リスナーが設定されていない場合は音源に最も近いリスナーが利用されます。

ループ再生の切り替え

引数:

loop	ループスイッチ（True: ループモード、False: ループモード解除）

説明:

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

注意:

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

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

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

本パラメータが評価されるのは、CriAtomSource コンポーネントのステータスが停止状態で、 CriAtomSource::Play 関数を呼び出した場合です。

ボリュームを設定／取得します。

説明:

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

備考:

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

ピッチを設定／取得します。

説明:

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

備考:

キュー再生時、データ側にピッチが設定されている場合に本関数を呼び出すと、 データ側に設定されている値と本関数による設定値とを加算した値が適用されます。
例えば、データ側のピッチが-100.0f、 CriAtomSource のピッチが200.0fの場合、 実際に適用されるピッチは100.0fになります。

パンニング3D角度を設定／取得します。

説明:

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

備考:

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

パンニング3D距離を設定／取得します。

説明:

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

備考:

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

再生開始位置を設定／取得します。

説明:

再生を開始する位置を設定／取得します。 再生開始位置を設定すると、音声データを途中から再生することができます。
再生開始位置の指定はミリ秒単位で行います。例えば、 10000 を設定すると、 次に再生する音声データは 10 秒目の位置から再生されます。

備考:

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

注意:

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

再生時刻（ミリ秒単位）を取得します。

説明:

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

備考:

同一 CriAtomSource コンポーネントで複数の音声を再生した場合は、 "最後に"再生した音声の時刻を示します。
複数の音声に対して再生時刻をチェックする必要がある場合には、 再生する音声の数分だけ CriAtomSource コンポーネントを作成してください。

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

CriAtomSource::Pause 関数でポーズをかけた場合、 再生時刻のカウントアップも停止します。
（ポーズを解除すれば再度カウントアップが再開されます。）

注意:

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

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

ファイル読み込みが間に合わない等の理由により、一時的に音声データの供給が途切れた場合でも、 再生時刻のカウントアップが途切れることはありません。
（データ供給停止により再生が停止した場合でも、時刻は進み続けます。）
そのため、本関数で取得した時刻を元に映像との同期を行った場合、 データ供給不足が発生する度に同期が大きくズレる可能性があります。

ステータスを取得します。

説明:

CriAtomSource コンポーネントのステータスを取得します。
ステータスは CriAtomSource コンポーネントの再生状態を示す値で、以下の5通りの値が存在します。

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

CriAtomSource コンポーネントが作成された時点では、 CriAtomSource コンポーネントのステータスは停止状態 （ Stop ）です。
CriAtomSource.Play 関数等で再生開始すると、 CriAtomSource コンポーネントのステータスが準備状態 （ Prep ）に変更されます。
（ Prep は、データ供給やデコードの開始を待っている状態です。）
再生の開始に十分なデータが供給された時点で、 CriAtomSource コンポーネントはステータスを再生状態 （ Playing ）に変更します。
尚、再生中にエラーが発生した場合には、 CriAtomSource コンポーネントはステータスをエラー状態 （ Error ）に変更します。

CriAtomSource コンポーネントのステータスをチェックし、ステータスに応じて処理を切り替えることで、 音声の再生状態に連動したプログラムを作成することが可能です。

距離減衰有効化設定を設定／取得します。

説明:

距離減衰による音量の変動を有効にするか無効にするかを設定／取得します。
デフォルトは有効です。

低遅延再生ボイスプールから再生を行うかどうかを設定／取得します。

説明:

Trueが設定されていると、低遅延再生ボイスプールを使って再生を開始します。

備考:

本フラグを有効にする場合は、CriWareInitializerの低遅延再生ボイスプール数を設定しておく必要があります。