CriAtomExOutputAnalyzer类 参考

音频输出数据解析模块（Player/源/总线单位) 更多...

类 CriAtomExOutputAnalyzer 继承关系图:

类
struct	Config
	音频输出数据解析模块配置结构体 更多...

Public 成员函数
delegate void	PcmCaptureCallback (float[] dataL, float[] dataR, int numChannels, int numData)
	获取波形回调 更多...
	CriAtomExOutputAnalyzer (Config config)
	创建音频输出数据解析模块 更多...
override void	Dispose ()
	输出数据解析模块 更多...
bool	AttachExPlayer (CriAtomExPlayer player)
	添加AtomExPlayer 更多...
void	DetachExPlayer ()
	切断AtomExPlayer 更多...
bool	AttachDspBus (string busName)
	添加DSP总线 更多...
void	DetachDspBus ()
	切断DSP总线 更多...
float	GetRms (int channel)
	获取添加中的音频输出的RMS Level 更多...
void	GetSpectrumLevels (ref float[] levels)
	获取频谱解析结果 更多...
void	GetPcmData (ref float[] data, int ch)
	获取添加中的音频输出的波形数据 更多...
void	SetPcmCaptureCallback (PcmCaptureCallback callback)
	注册获取波形数据的回调 更多...
void	ExecutePcmCaptureCallback ()
	执行获取波形数据回调 更多...
void	ExecutePcmCaptureCallback (PcmCaptureCallback callback)

Public 属性
const int	MaximumSpectrumBands = 512
	频谱分析仪的最大带通数 更多...

详细描述

音频输出数据解析模块（Player/源/总线单位)

说明:

针对各CriAtomSource/CriAtomExPlayer或各总线执行音频输出解析。
提供电平表功能等。

注意:

如果添加在CriAtomSource/CriAtomExPlayer上，或使用HCA-MX和平台专用的 音频压缩编解码器时，无法进行解析。
请使用HCA或ADX编解码器。

构造及析构函数说明

CriAtomExOutputAnalyzer ( Config  config )

inline

创建音频输出数据解析模块

返回

音频输出数据解析模块

说明:

创建输出音频数据的解析模块。
创建的解析模块添加在CriAtomSource或CriAtomExPlayer，或者总线上使用。
针对添加的音频输出，进行电平表等解析。

// 解析モジュールの作成例

// コンフィグでSpectrumAnalyzerを有効にし、バンド数を指定
CriAtomExOutputAnalyzer.Config config = new CriAtomExOutputAnalyzer.Config();
config.enableSpectrumAnalyzer = true;
config.numSpectrumAnalyzerBands = 16;

// 出力データ解析モジュールを作成
this.analyzer = new CriAtomExOutputAnalyzer(config);

备注:

解析模块上可以添加的CriAtomSource/CriAtomExPlayer/总线仅限一个。
如果要重用解析模块时，请将其切断。

注意:

创建音频输出数据解析模块时，将会取得非托管的资源。
解析模块不再需要时，请务必调用 CriAtomExOutputAnalyzer.Dispose 方法。

成员函数说明

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

获取波形回调

说明:

用于获取输出的波形数据的回调。

override void Dispose ( )

inline

输出数据解析模块

说明:

丢弃输出数据解析模块。
一旦执行本函数，创建输出数据解析模块时在插件内取得的资源将全部被释放。
为防止内存泄露，当不再需要输出数据解析模块后，请调用本方法。

注意:

本函数是完成返回型函数。
如果有已添加的AtomExPlayer，则将会在本函数内进行切断。
请注意对象的AtomExPlayer正在播放的音频将会被强行停止。

参见

CriAtomExOutputAnalyzer::CriAtomExOutputAnalyzer

bool AttachExPlayer ( CriAtomExPlayer  player )

inline

添加AtomExPlayer

返回

添加是否成功（成功：True，失败：False）

说明:

添加用于解析输出数据的AtomExPlayer。
无法添加多个AtomExPlayer。 如果在添加状态下，添加了其他AtomExPlayer，则目前处于添加状态的AtomExPlayer将会被切断。

要添加CriAtomSource时，请使用CriAtomSource::AttachToOutputAnalyzer。

注意:

如果在卸载之前先销毁了通过该函数挂载的 AtomExPlayer，则卸载时将发生非法访问。
请务必在销毁 AtomExPlayer 之前先执行卸载。

参见

CriAtomExOutputAnalyzer::DetachExPlayer, CriAtomSource::AttachToOutputAnalyzer

void DetachExPlayer ( )

inline

切断AtomExPlayer

说明:

切断用于解析输出数据的AtomExPlayer。
切断后，将无法再执行以后的解析处理。

注意:

如果挂载的 AtomEx 播放器已被销毁，则会发生非法访问。
在处置 AtomEx 播放器之前，请务必调用此函数或 CriAtomExOutputAnalyzer::Dispose 。

参见

CriAtomExOutputAnalyzer::AttachExPlayer, CriAtomExOutputAnalyzer::Dispose

bool AttachDspBus ( string  busName )

inline

添加DSP总线

返回

添加是否成功（成功：True，失败：False）

说明:

添加用于解析输出数据的DSP总线。
无法添加多个DSP总线。 如果在添加状态下，添加了其他DSP总线，则目前处于添加状态的DSP总线将会被切断。

参见

CriAtomExOutputAnalyzer::DetachDspBus

void DetachDspBus ( )

inline

切断DSP总线

说明:

切断用于解析输出数据的DSP总线。
切断后，将无法再执行以后的解析处理。

参见

CriAtomExOutputAnalyzer::AttachDspBus, CriAtomExOutputAnalyzer::Dispose

float GetRms ( int  channel )

inline

获取添加中的音频输出的RMS Level

参数

channel

声道编号

返回

RMS Level

说明:

获取添加中的音频输出的RMS Level。
如果使用本功能，请为Config的enableLevelmeter指定True来创建模块。

参见

CriAtomExOutputAnalyzer::AttachExPlayer, CriAtomExOutputAnalyzer::AttachDspBus

void GetSpectrumLevels ( ref float[]  levels )

inline

获取频谱解析结果

参数

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  )

inline

获取添加中的音频输出的波形数据

参数

data	输出数据
ch	声道

说明:

获取添加中的音频输出的波形数据。
如果使用本功能，请为Config的enablePcmCapture指定True，为numCapturedPcmSamples指定 正数来创建模块。

注意:

参数的数组长度不充分时，将会在函数内取得数组。
为防止发生不必要的GC，请为参数提供比初始化配置中指定的数据样本数的长度 更长的数组。 目前可以获取的声道只有L/R。请在ch指定0或1。

参见

CriAtomExOutputAnalyzer::AttachExPlayer, CriAtomExOutputAnalyzer::AttachDspBus

void SetPcmCaptureCallback ( PcmCaptureCallback  callback )

inline

注册获取波形数据的回调

说明:

注册输出数据获取用的回调。
如果使用回调的波形数据的获取，则在调用ExecutePcmCaptureCallback前， 请通过本函数注册回调。

void ExecutePcmCaptureCallback ( )

inline

执行获取波形数据回调

说明:

执行输出数据获取用的回调。
调用本函数后，将会多次返回以从最后一次执行时起的输出差分数据 为参数的回调。

注意:

如果要使用回调的波形数据获取，请定期调用本函数。
如果长时间不调用本函数，则可以获取的波形数据将会出现欠缺。

void ExecutePcmCaptureCallback ( PcmCaptureCallback  callback )

inline

弃用:

将被删除的非推荐API。 请考虑使用 SetPcmCaptureCallback(PcmCaptureCallback) 和 ExecutePcmCaptureCallback() 。

类成员变量说明

const int MaximumSpectrumBands = 512

频谱分析仪的最大带通数

说明:

是频谱分析仪可输出的带通数。

---

该类的文档由以下文件生成:

• CriAtomExOutputAnalyzer.cs