CRIWARE Unity Plugin Manual  Last Updated: 2024-07-12
CriAtomExStandardVoicePool Class Reference

Standard Voice Pool More...

Inheritance diagram for CriAtomExStandardVoicePool:
CriAtomExVoicePool

Classes

struct  Config
 Configuration structure for the initialization of a standard Voice Pool More...
 

Public Types

enum  VoicePoolId {
  StandardMemory = StandardMemoryAsrVoicePoolId, StandardStreaming = StandardStreamingAsrVoicePoolId, StandardMemory = StandardMemoryNsrVoicePoolId, StandardStreaming = StandardStreamingNsrVoicePoolId,
  HcaMxMemory = 4, HcaMxStreaming = 5, LowLatencyMemory = StandardMemoryNsrVoicePoolId, LowLatencyStreaming = StandardStreamingNsrVoicePoolId
}
 The ID to access the Voice Pool created inside the plug-in More...
 
enum  PitchShifterMode : int
 Pitch shifter DSP operation mode More...
 

Public Member Functions

 CriAtomExStandardVoicePool (Config config)
 Creates an additional standard Voice Pool More...
 
 CriAtomExStandardVoicePool (int numVoices, int maxChannels, int maxSamplingRate, bool streamingFlag, uint identifier=0)
 Creates an additional standard Voice Pool More...
 
UsedVoicesInfo GetNumUsedVoices ()
 Gets the usage of Voices in the Voice Pool More...
 
override void Dispose ()
 Discards the Voice Pool More...
 
void AttachDspTimeStretch ()
 Attaches the time stretch DSP More...
 
void AttachDspPitchShifter (PitchShifterMode mode=PitchShifterMode.Music, int windosSize=1024, int overlapTimes=4)
 Attaches the pitch shifter DSP More...
 
void DetachDsp ()
 Detaches DSP More...
 

Static Public Member Functions

static void SetDefaultConfigForStandardVoicePool (ref Config config)
 Assign the default values to the configuration structure used to create a standard Voice Pool
 
static UsedVoicesInfo GetNumUsedVoices (VoicePoolId voicePoolId)
 Gets the usage of Voices in the Voice Pool More...
 

Properties

uint identifier [get]
 Voice Pool identifier More...
 

Detailed Description

Standard Voice Pool

Member Enumeration Documentation

enum VoicePoolId
stronginherited

The ID to access the Voice Pool created inside the plug-in

See also
CriAtomExVoicePool.GetNumUsedVoices
Enumerator
StandardMemory 

Model standard memory playback Voice Pool ID

StandardStreaming 

Model standard streaming playback Voice Pool ID

StandardMemory 

Model standard memory playback Voice Pool ID

StandardStreaming 

Model standard streaming playback Voice Pool ID

HcaMxMemory 

HCA-MX memory playback Voice Pool ID

HcaMxStreaming 

A Voice Pool ID for HCA-MX streaming playback

LowLatencyMemory 

[Android] Low latency memory playback Voice Pool ID

LowLatencyStreaming 

[Android] Low latency streaming playback Voice Pool ID

enum PitchShifterMode : int
stronginherited

Pitch shifter DSP operation mode

Description:
Specifies the pitch shift processing method (algorithm).
See also
CriAtomExVoicePool.AttachDspPitchShifter, CriAtomExPlayer.SetDspParameter

Constructor & Destructor Documentation

CriAtomExStandardVoicePool ( Config  config)
inline

Creates an additional standard Voice Pool

Parameters
configConfiguration structure for the initialization of a standard Voice Pool
Returns
Standard Voice Pool
Description:
Create an additional standard Voice Pool.
Please use this function if you want to play audio with more than 6 channels or need an additional Voice Pool.
Note:
Be sure to call the Dispose function to destroy the object after the playback is complete.
If you want to explicitly set a particular CriAtomExPlayer to get voices from the created voice pool,
please create the voice pool with a non-zero identifier (0 is the default identifier),
and call the CriAtomExPlayer::SetVoicePoolIdentifier function.
See also
CriAtomExPlayer::SetVoicePoolIdentifier
CriAtomExStandardVoicePool ( int  numVoices,
int  maxChannels,
int  maxSamplingRate,
bool  streamingFlag,
uint  identifier = 0 
)
inline

Creates an additional standard Voice Pool

Parameters
numVoicesThe number of Voices
maxChannelsMaximum number of channels
maxSamplingRateMaximum sampling rate
streamingFlagStreaming playback flag
identifierVoice Pool identifier
Returns
Standard Voice Pool
Description:
Creates an additional standard Voice Pool.
If you want to play a sound with six or more channels, create a Voice Pool using this API.
If false is specified for streamingFlag, a voice pool for in-memory playback will be created.
If you specify true for streamingFlag, the created voice pool will be capable of streaming playback in addition to in-memory playback.
maxSamplingRate specifies the maximum sampling rate of the materials in the Cue to be played, which uses the voice pool being created.
If the audio pitch is expected to change, please select a maximum sampling rate based on the highest pitch.
If you want to use the time-stretch feature, you need to double the maximum sampling rate.
Note:
Be sure to call the Dispose function to destroy the object after the playback is complete.
If you want to explicitly set a particular CriAtomExPlayer to get voices from the created voice pool,
please create the voice pool with a non-zero identifier (0 is the default identifier),
and call the CriAtomExPlayer::SetVoicePoolIdentifier function.
See also
CriAtomExPlayer::SetVoicePoolIdentifier

Member Function Documentation

static UsedVoicesInfo GetNumUsedVoices ( VoicePoolId  voicePoolId)
inlinestaticinherited

Gets the usage of Voices in the Voice Pool

Parameters
voicePoolIdVoice Pool ID
Returns
Voice usage
Description:
Gets the Voice usage of the specified Voice Pool.
Note:
Use this function only for debugging purposes.
See also
CriAtomExVoicePool::VoicePoolId, CriAtomExVoicePool::UsedVoicesInfo
UsedVoicesInfo GetNumUsedVoices ( )
inlineinherited

Gets the usage of Voices in the Voice Pool

Returns
Voice usage
Description:
Gets the Voice usage.
Note:
Use this function only for debugging purposes.
See also
CriAtomExVoicePool::UsedVoicesInfo
override void Dispose ( )
inlineinherited

Discards the Voice Pool

Description:
Discards the Voice Pool object.
Be sure to discard the created object using this API. Otherwise, a resource leak occurs.
void AttachDspTimeStretch ( )
inlineinherited

Attaches the time stretch DSP

Description:
Adds a time stretch DSP to the Voice Pool.
Note:
This function is a return-on-complete function.
Calling this function blocks the server processing of the Atom library for a while.
If this function is called during sound playback, problems such as sound interruption may occur, so call this function at a timing when load fluctuations is accepted such as when switching scenes.
See also
CriAtomExVoicePool::DetachInsertionDsp
void AttachDspPitchShifter ( PitchShifterMode  mode = PitchShifterMode.Music,
int  windosSize = 1024,
int  overlapTimes = 4 
)
inlineinherited

Attaches the pitch shifter DSP

Parameters
modePitch shift mode
windosSizeWindow size
overlapTimesThe number of overlaps
Description:
Adds a pitch shifter DSP to the Voice Pool.
Note:
This function is a return-on-complete function.
Calling this function blocks the server processing of the Atom library for a while.
If this function is called during sound playback, problems such as sound interruption may occur, so call this function at a timing when load fluctuations is accepted such as when switching scenes.
See also
CriAtomExVoicePool::DetachInsertionDsp
void DetachDsp ( )
inlineinherited

Detaches DSP

Description:
Removes the DSP added to the Voice Pool.
Note:
This function is a return-on-complete function.
Calling this function blocks the server processing of the Atom library for a while.
If this function is called during sound playback, problems such as sound interruption may occur, so call this function at a timing when load fluctuations is accepted such as when switching scenes.
See also
CriAtomExVoicePool::AttachDspPitchShifter, CriAtomExVoicePool::AttachDspTimeStretch

Property Documentation

uint identifier
getinherited

Voice Pool identifier

Description:
The voice pool identifier is the ID used to identify the voice pool.
Note:
By setting the same identifier for both the player (CriAtomExPlayer.SetVoicePoolIdentifier) and the Voice Pool,
the player will only get Voices from the configured Voice Pool.
See also
CriAtomExVoicePool::VoicePoolId, CriAtomExVoicePool::UsedVoicesInfo

The documentation for this class was generated from the following file: