CRIWARE Unity Plugin Manual  Last Updated: 2024-07-12
类 | Public 类型 | Public 成员函数 | 静态 Public 成员函数 | 属性 | 所有成员列表
CriAtomExStandardVoicePool类 参考
CRI Atom Native Wrapper

标准Voice池 更多...

类 CriAtomExStandardVoicePool 继承关系图:
CriAtomExVoicePool

类

struct  Config
 标准Voice池初始化配置 更多...
 

Public 类型

enum  VoicePoolId {
  StandardMemory = StandardMemoryAsrVoicePoolId, StandardStreaming = StandardStreamingAsrVoicePoolId, StandardMemory = StandardMemoryNsrVoicePoolId, StandardStreaming = StandardStreamingNsrVoicePoolId,
  HcaMxMemory = 4, HcaMxStreaming = 5, LowLatencyMemory = StandardMemoryNsrVoicePoolId, LowLatencyStreaming = StandardStreamingNsrVoicePoolId
}
 用于存取在插件内部创建的Voice池的ID 更多...
 
enum  PitchShifterMode : int
 移调器DSP的动作模式 更多...
 

Public 成员函数

 CriAtomExStandardVoicePool (Config config)
 创建另外添加的标准Voice池 更多...
 
 CriAtomExStandardVoicePool (int numVoices, int maxChannels, int maxSamplingRate, bool streamingFlag, uint identifier=0)
 创建另外添加的标准Voice池 更多...
 
UsedVoicesInfo GetNumUsedVoices ()
 获取Voice池的Voice使用情况 更多...
 
override void Dispose ()
 丢弃Voice池 更多...
 
void AttachDspTimeStretch ()
 添加时间拉伸DSP 更多...
 
void AttachDspPitchShifter (PitchShifterMode mode=PitchShifterMode.Music, int windosSize=1024, int overlapTimes=4)
 添加移调器DSP 更多...
 
void DetachDsp ()
 切断DSP 更多...
 

静态 Public 成员函数

static void SetDefaultConfigForStandardVoicePool (ref Config config)
 设置用于创建标准Voice池的配置结构体的预设值
 
static UsedVoicesInfo GetNumUsedVoices (VoicePoolId voicePoolId)
 获取Voice池的Voice使用情况 更多...
 

属性

uint identifier [get]
 Voice池标识符 更多...
 

详细描述

标准Voice池

成员枚举类型说明

enum VoicePoolId
stronginherited

用于存取在插件内部创建的Voice池的ID

参见
CriAtomExVoicePool.GetNumUsedVoices
枚举值
StandardMemory 

机型标准的内存播放Voice池ID

StandardStreaming 

机型标准的串流播放Voice池ID

StandardMemory 

机型标准的内存播放Voice池ID

StandardStreaming 

机型标准的串流播放Voice池ID

HcaMxMemory 

HCA-MX内存播放Voice池ID

HcaMxStreaming 

HCA-MX串流播放Voice池ID

LowLatencyMemory 

[Android] 低延迟内存播放Voice池ID

LowLatencyStreaming 

[Android] 低延迟串流播放Voice池ID

enum PitchShifterMode : int
stronginherited

移调器DSP的动作模式

说明:
指定移调的处理方法（算法）。
参见
CriAtomExVoicePool.AttachDspPitchShifter, CriAtomExPlayer.SetDspParameter

构造及析构函数说明

CriAtomExStandardVoicePool ( Config  config)
inline

创建另外添加的标准Voice池

参数
config标准Voice池初始化配置
返回
标准Voice池
说明:
创建额外的标准Voice Pool。
如果您想播放超过6个声道的音频或需要额外的Voice Pool，请使用此API创建Voice Pool。
注意:
请务必在播放完成后使用 Dispose 函数销毁对象。
需要对特定 CriAtomExPlayer 作显式设置使其从创建的Voice池中获取Voice时，请使用0（默认）以外的ID创建Voice池，
并调用 CriAtomExPlayer::SetVoicePoolIdentifier 函数。
参见
CriAtomExPlayer::SetVoicePoolIdentifier
CriAtomExStandardVoicePool ( int  numVoices,
int  maxChannels,
int  maxSamplingRate,
bool  streamingFlag,
uint  identifier = 0 
)
inline

创建另外添加的标准Voice池

参数
numVoicesVoice数
maxChannels最大声道数
maxSamplingRate最大采样率
streamingFlag串流播放标记
identifierVoice池标识符
返回
标准Voice池
说明:
追加创建标准Voice池。
要播放 6 声道以上的音频时，请使用本 API 创建Voice池。
如果指定 streamingFlag 为 false，则会创建一个可进行内存播放的Voice池。
如果指定 streamingFlag 为 true，则会创建一个Voice池，除内存播放外，还允许串流播放。
maxSamplingRate 指定将要创建的Voice池中预计播放的Cue中所包含的素材的最大采样率。
如果音高会发生改变，请指定其最高音高的最大采样率。
如果要使用时间拉伸功能，则需要将最大采样率提高至原来的2倍。
注意:
请务必在播放完成后使用 Dispose 函数销毁对象。
需要对特定 CriAtomExPlayer 作显式设置使其从创建的Voice池中获取Voice时，请使用0（默认）以外的ID创建Voice池，
并调用 CriAtomExPlayer::SetVoicePoolIdentifier 函数。
参见
CriAtomExPlayer::SetVoicePoolIdentifier

成员函数说明

static UsedVoicesInfo GetNumUsedVoices ( VoicePoolId  voicePoolId)
inlinestaticinherited

获取Voice池的Voice使用情况

参数
voicePoolIdVoice池的ID
返回
Voice使用情况
说明:
获取指定的Voice池的Voice使用情况。
注意:
请仅将本函数用于调试目的。
参见
CriAtomExVoicePool::VoicePoolId, CriAtomExVoicePool::UsedVoicesInfo
UsedVoicesInfo GetNumUsedVoices ( )
inlineinherited

获取Voice池的Voice使用情况

返回
Voice使用情况
说明:
获取Voice使用情况。
注意:
请仅将本函数用于调试目的。
参见
CriAtomExVoicePool::UsedVoicesInfo
override void Dispose ( )
inlineinherited

丢弃Voice池

说明:
对Voice池对象进行丢弃。
如果不用本API丢弃创建的对象，则会发生资源泄露，因此请务必将其丢弃。
void AttachDspTimeStretch ( )
inlineinherited

添加时间拉伸DSP

说明:
在Voice池中添加时间拉伸DSP。
注意:
本函数是完成返回型函数。
执行本函数后，一段时间内，Atom运行库的Server处理将被阻断。
如果在音频播放过程中执行本函数，则可能会发生声音中断等异常， 要调用本函数时，请在场景切换等能够承受负荷变动的时机上进行调用。
参见
CriAtomExVoicePool::DetachInsertionDsp
void AttachDspPitchShifter ( PitchShifterMode  mode = PitchShifterMode.Music,
int  windosSize = 1024,
int  overlapTimes = 4 
)
inlineinherited

添加移调器DSP

参数
mode移调模式
windosSize窗口大小
overlapTimes重叠次数
说明:
在Voice池中添加移调器DSP。
注意:
本函数是完成返回型函数。
执行本函数后，一段时间内，Atom运行库的Server处理将被阻断。
如果在音频播放过程中执行本函数，则可能会发生声音中断等异常， 要调用本函数时，请在场景切换等能够承受负荷变动的时机上进行调用。
参见
CriAtomExVoicePool::DetachInsertionDsp
void DetachDsp ( )
inlineinherited

切断DSP

说明:
删除Voice池中添加的DSP。
注意:
本函数是完成返回型函数。
执行本函数后，一段时间内，Atom运行库的Server处理将被阻断。
如果在音频播放过程中执行本函数，则可能会发生声音中断等异常， 要调用本函数时，请在场景切换等能够承受负荷变动的时机上进行调用。
参见
CriAtomExVoicePool::AttachDspPitchShifter, CriAtomExVoicePool::AttachDspTimeStretch

属性说明

uint identifier
getinherited

Voice池标识符

说明:
Voice池标识符是唯一标识Voice池的ID。
备注:
通过为播放器 (CriAtomExPlayer.SetVoicePoolIdentifier) 和Voice Pool设置相同的标识符，
播放器将仅从配置的Voice Pool中获取Voice。
参见
CriAtomExVoicePool::VoicePoolId, CriAtomExVoicePool::UsedVoicesInfo
该类的文档由以下文件生成: