Voice Priority

Samples Directory

/CRIWARE/SDK/pc/samples/criatomex/control_priority

Sample Description

In CRI Atom, since Voice, which performs actual playback, and player, which controls playback, are independent, players compete for Voices when multiple players are used for playback with smaller number of Voices.

• Setting priority
  When there are not enough voices, use the criAtomExPlayer_SetVoicePriority function to set the priority of players.
  
  
• Setting Voice control method (first-arrival priority or last-arrival priority)
  Whether first played player or last played player is given precedence when the priorities are the same is Set by the criAtomExPlayer_SetVoiceControlMethod function.
  

The following is a code to set priorities to players when there are not enough Voices.

#define SMP_PATH_LENGTH (256)
 
CriAtomExAdxVoicePoolConfig pool_config;
CriAtomExPlayerConfig player_config;
CriAtomExPlayerHn player[2];
 
    criAtomExVoicePool_SetDefaultConfigForAdxVoicePool(&pool_config);
    /* Set smaller number so that competition happens */
    pool_config.num_voices = 1;
    /* Set streaming playback */
    pool_config.player_config.streaming_flag = CRI_TRUE;
    /* Create Voice Pool */
    voice_pool = criAtomExVoicePool_AllocateAdxVoicePool(&pool_config, NULL, 0);
    
    criAtomExPlayer_SetDefaultConfig(&player_config);
    /* Set the size required for storing path */
    player_config.max_path = SMP_PATH_LENGTH;
    /* Create a player */
    player[0] = criAtomExPlayer_Create(&player_config, NULL, 0);
    player[1] = criAtomExPlayer_Create(&player_config, NULL, 0);
    
    /* Set the file to be played back to the player*/
    criAtomExPlayer_SetFile(player[0], NULL, PATH FILE1);
    criAtomExPlayer_SetFile(player[1], NULL, PATH FILE2);
    
    /* Set priorities */
    criAtomExPlayer_SetVoicePriority(player[0], 1); /* Relatively high priority */
    criAtomExPlayer_SetVoicePriority(player[1], 0); /* Relatively low priority */
    
    /* First-arrival priority (the player arrived later with the same priority cannot get a Voice) */
    criAtomExPlayer_SetVoiceControlMethod(player[0], CRIATOMEX_PREFER_FIRST);
    criAtomExPlayer_SetVoiceControlMethod(player[1], CRIATOMEX_PREFER_FIRST);
 
    /* Update information */
    criAtomExPlayer_UpdateAll(player[0]);
    criAtomExPlayer_UpdateAll(player[1]);
 
    /* Start playback */
    criAtomExPlayer_Start(player[0]);
    criAtomExPlayer_Start(player[1]);

In above sample code, when player[1] is played back first and then player[0] is played back, since there is only one Voice and player[0] has high priority, player[1] stops playback and player[0] starts playback.

If their priorities are the same, because first-arrival priority is set, player[1] continues playback and player[0] does not start playback and becomes playback finished states.

For priorities when playing back Cue, application does not have to do any operations since priorities set by the tool are applied. (Currently, operation is not allowed.)