Voice priority

Sample directory

/cri/pc/samples/criatomex/control_priority

Data used in the sample

/cri/common/smpdata/criatomex/

• music_tr.adx
• music_loop.adx
  

Sample description

In CRI Atom, the voice that actually processes the sound and the player that controls the playback are separate, so if multiple players are performing playback processing when there are few voices, the players will compete for the voices.

• Setting priority
  To set which player should be given priority when there are not enough voices, use the criAtomExPlayer_SetVoicePriority function.
  
  
• Setting the voice control method (first come first served/last come first served)
  When the priorities are the same, use the criAtomExPlayer_SetVoiceControlMethod function to set whether to give priority to the player who started playing first or the player who started playing last.

#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.)