CriAtomExPlayerOutputAnalyzer クラス

音声出力データ解析モジュール（プレーヤ/ソース単位) [詳解]

CriAtomExPlayerOutputAnalyzer の継承関係図

クラス
struct	Config
	音声出力データ解析モジュールコンフィグ構造体 [詳解]

公開型
enum	Type { LevelMeter = 0, SpectrumAnalyzer = 1, PcmCapture = 2 }
	解析処理種別 [詳解]

公開メンバ関数
	CriAtomExPlayerOutputAnalyzer (Type[] types, Config[] configs=null)
	音声出力データ解析モジュールの作成 [詳解]
delegate void	PcmCaptureCallback (float[] dataL, float[] dataR, int numChannels, int numData)
	波形取得コールバック [詳解]
override void	Dispose ()
	出力データ解析モジュールの破棄 [詳解]
bool	AttachExPlayer (CriAtomExPlayer player)
	AtomExプレーヤのアタッチ [詳解]
void	DetachExPlayer ()
	AtomExプレーヤのデタッチ [詳解]
bool	AttachDspBus (string busName)
	DSPバスのアタッチ [詳解]
void	DetachDspBus ()
	DSPバスのデタッチ [詳解]
float	GetRms (int channel)
	アタッチ中の音声出力のRMSレベルの取得 [詳解]
void	GetSpectrumLevels (ref float[] levels)
	スペクトル解析結果の取得 [詳解]
void	GetPcmData (ref float[] data, int ch)
	アタッチ中の音声出力の波形データの取得 [詳解]
void	SetPcmCaptureCallback (PcmCaptureCallback callback)
	波形データ取得コールバックの登録 [詳解]
void	ExecutePcmCaptureCallback ()
	波形データ取得コールバックの実行 [詳解]
void	ExecutePcmCaptureCallback (PcmCaptureCallback callback)

公開変数類
const int	MaximumSpectrumBands = 512
	スペクトラムアナライザの最大バンド数 [詳解]

詳解

音声出力データ解析モジュール（プレーヤ/ソース単位)

非推奨:

削除予定の非推奨APIです。 CriWare.CriAtomExOutputAnalyzer クラスの使用を検討してください。

説明:

CriAtomSource/CriAtomExPlayerごとの音声出力の解析を行います。
レベルメータ機能などを提供します。

注意:

将来的に本クラスは廃止される予定です。 CriWare.CriAtomExOutputAnalyzer をご利用ください。
HCA-MXやプラットフォーム固有の音声圧縮コーデックを使用している場合は解析できません。
HCAもしくはADXコーデックをご利用ください。

列挙型メンバ詳解

enum Type

strong

解析処理種別

説明:

解析モジュール作成時に指定する解析処理の種別を示す値です。

参照

CriAtomExOutputAnalyzer

列挙値
LevelMeter	レベルメーター(RMSレベル計測)
SpectrumAnalyzer	スペクトルアナライザ
PcmCapture	波形データ取得

構築子と解体子

CriAtomExPlayerOutputAnalyzer ( Type[]  types, Config[]  configs = null  )

inline

音声出力データ解析モジュールの作成

戻り値

音声出力データ解析モジュール

説明:

CriAtomSource/CriAtomExPlayerの出力音声データの解析モジュールを作成します。
作成した解析モジュールは、CriAtomSourceまたはCriAtomExPlayerにアタッチして使用します。
アタッチしている音声出力に対し、レベルメータなどの解析を行います。

備考:

解析モジュールにアタッチ可能なCriAtomSource/CriAtomExPlayerは一つのみです。
解析モジュールを使いまわす場合は、デタッチを行ってください。

注意:

将来的に本クラスは廃止される予定です。CriAtomExOutputAnalyzerをご利用ください。
音声出力データ解析モジュールの作成時には、アンマネージドなリソースが確保されます。
解析モジュールが不要になった際は、必ず CriAtomExPlayerOutputAnalyzer.Dispose メソッドを呼んでください。

関数詳解

delegate void PcmCaptureCallback ( float[]  dataL, float[]  dataR, int  numChannels, int  numData  )

inherited

波形取得コールバック

説明:

出力される波形データを取得するためのコールバックです。

override void Dispose ( )

inlineinherited

出力データ解析モジュールの破棄

説明:

出力データ解析モジュールを破棄します。
本関数を実行した時点で、出力データ解析モジュール作成時にプラグイン内で確保されたリソースが全て解放されます。
メモリリークを防ぐため、出力データ解析モジュールが不要になった時点で本メソッドを呼び出してください。

注意:

本関数は完了復帰型の関数です。
アタッチ済みのAtomExプレーヤがある場合、本関数内でデタッチが行われます。
対象のAtomExプレーヤが再生中の音声は強制的に停止しますのでご注意ください。

参照

CriAtomExOutputAnalyzer::CriAtomExOutputAnalyzer

bool AttachExPlayer ( CriAtomExPlayer  player )

inlineinherited

AtomExプレーヤのアタッチ

戻り値

アタッチが成功したかどうか（成功：True、失敗：False）

説明:

出力データ解析を行うAtomExプレーヤをアタッチします。
複数のAtomExプレーヤをアタッチすることは出来ません。 アタッチ中に別のAtomExプレーヤをアタッチした場合、アタッチ中のAtomExプレーヤはデタッチされます。

CriAtomSourceをアタッチする場合、CriAtomSource::AttachToOutputAnalyzerを使用してください。

注意:

アタッチは再生開始前に行う必要があります。再生開始後のアタッチは失敗します。

本関数でアタッチしたAtomExプレーヤをデタッチする前に破棄した場合、 デタッチ時にアクセス違反が発生します。
必ず先にデタッチを行ってからAtomExプレーヤを破棄してください。

参照

CriAtomExOutputAnalyzer::DetachExPlayer, CriAtomSource::AttachToOutputAnalyzer

void DetachExPlayer ( )

inlineinherited

AtomExプレーヤのデタッチ

説明:

出力データ解析を行うAtomExプレーヤをデタッチします。
デタッチを行うと、以降の解析処理は行われなくなります。

注意:

アタッチ済みのプレーヤが音声を再生している状態で本関数を呼び出した場合、 強制的に再生を停止した上でデタッチが行われます。

アタッチしたAtomExプレーヤが既に破棄されていた場合はアクセス違反が発生します。
必ず本関数、またはCriAtomExOutputAnalyzer::Disposeを呼び出してから、 AtomExプレーヤを破棄するようにしてください。

参照

CriAtomExOutputAnalyzer::AttachExPlayer, CriAtomExOutputAnalyzer::Dispose

bool AttachDspBus ( string  busName )

inlineinherited

DSPバスのアタッチ

戻り値

アタッチが成功したかどうか（成功：True、失敗：False）

説明:

出力データ解析を行うDSPバスをアタッチします。
複数のDSPバスをアタッチすることは出来ません。 アタッチ中に別のDSPバスをアタッチした場合、アタッチ中のDSPバスはデタッチされます。

参照

CriAtomExOutputAnalyzer::DetachDspBus

void DetachDspBus ( )

inlineinherited

DSPバスのデタッチ

説明:

出力データ解析を行うDSPバスをデタッチします。
デタッチを行うと、以降の解析処理は行われなくなります。

参照

CriAtomExOutputAnalyzer::AttachDspBus, CriAtomExOutputAnalyzer::Dispose

float GetRms ( int  channel )

inlineinherited

アタッチ中の音声出力のRMSレベルの取得

引数

channel

チャンネル番号

戻り値

RMSレベル

説明:

アタッチ中の音声出力のRMSレベルを取得します。
本機能を利用する場合、ConfigのenableLevelmeterにTrueを指定してモジュールを作成してください。

参照

CriAtomExOutputAnalyzer::AttachExPlayer, CriAtomExOutputAnalyzer::AttachDspBus

void GetSpectrumLevels ( ref float[]  levels )

inlineinherited

スペクトル解析結果の取得

引数

levels

解析結果(帯域毎の振幅値)

説明:

スペクトラムアナライザによって解析された帯域ごとの振幅値を取得します。
配列の要素数はモジュールの作成時に指定したバンド数です。
本機能を利用する場合、ConfigのenableSpectrumAnalyzerにTrueを、numSpectrumAnalyzerBandsに MaximumSpectrumBands以下の正数を指定してモジュールを作成してください。 解析結果を市販のスペクトルアナライザのように表示させたい場合、 本関数が返す値をデシベル値に変換する必要があります。

例:

// 例：スペクトル解析結果を取得するコンポーネント
public class SpectrumLevelMeter : MonoBehaviour {
 private CriAtomExOutputAnalyzer analyzer;
 void Start() {
     // 引数 config については省略。モジュールの作成時に指定したバンド数は 8 とする
     this.analyzer = new CriAtomExOutputAnalyzer(config);
     // CriAtomExPlayer のアタッチについては省略
 }

 void Update() {
     // 音声再生中の実行
     float[] levels = new float[8];
     analyzer.GetSpectrumLevels (ref levels);
     // levelsの0帯域目の振幅値をデシベル値に変換
     float db = 20.0f * Mathf.Log10(levels[0]);
     Debug.Log (db);
 }
}

参照

CriAtomExOutputAnalyzer::AttachExPlayer, CriAtomExOutputAnalyzer::AttachDspBus

void GetPcmData ( ref float[]  data, int  ch  )

inlineinherited

アタッチ中の音声出力の波形データの取得

引数

data	出力データ
ch	チャンネル

説明:

アタッチ中の音声出力の波形データを取得します。
本機能を利用する場合、ConfigのenablePcmCaptureにTrueを、numCapturedPcmSamplesに 正数を指定してモジュールを作成してください。

注意:

引数の配列の長さが十分でない場合、関数内で配列の確保が行われます。
不要なGCの発生を避けるため、初期化コンフィグで指定したデータサンプル数以上の 長さの配列を引数に渡すようにしてください。 現状、取得可能なチャンネルはL/Rのみです。chには0か1を指定してください。

参照

CriAtomExOutputAnalyzer::AttachExPlayer, CriAtomExOutputAnalyzer::AttachDspBus

void SetPcmCaptureCallback ( PcmCaptureCallback  callback )

inlineinherited

波形データ取得コールバックの登録

説明:

出力データ取得用のコールバックを登録します。
コールバックによる波形データ取得を利用する場合、ExecutePcmCaptureCallbackの呼び出し前に 本関数によりコールバックの登録を行ってください。

void ExecutePcmCaptureCallback ( )

inlineinherited

波形データ取得コールバックの実行

説明:

出力データ取得用のコールバックを実効します。
本関数を呼び出すと、最後の実行時からの出力差分データを引数とするコールバックが 複数回呼び出されます。

注意:

コールバックによる波形データ取得を利用する場合、本関数を定期的に呼び出してください。
本関数が長時間呼び出されなかった場合、取得可能な波形データに欠落が生じます。

void ExecutePcmCaptureCallback ( PcmCaptureCallback  callback )

inlineinherited

非推奨:

削除予定の非推奨APIです。 SetPcmCaptureCallback(PcmCaptureCallback) と ExecutePcmCaptureCallback()の使用を検討してください。

メンバ詳解

const int MaximumSpectrumBands = 512

inherited

スペクトラムアナライザの最大バンド数

説明:

スペクトラムアナライザが出力できるバンド数の最大値です。

---

このクラス詳解は次のファイルから抽出されました:

• CriAtomExPlayerOutputAnalyzer.cs