以音轨为单位控制音量

示例目录

/cri/pc/samples/criatomex/control_track_volume

示例描述

Atom运行库提供将多声道音频数据 作为多重音轨的音频数据处理的机制。

例如在播放6ch的音频数据时，该音频数据在预设状态下会以5.1ch的音频数据 （各频道对应于L, R, C, LFE, Ls, Rs的数据）处理。
但是，通过使用::criAtomExPlayer_SetTrackInfo函数，可以将6ch的音频数据作为单声道6音轨的音频数据及 立体声3音轨的音频数据进行控制。

    ：
/* 定义每个音轨的频道数量 */
/* 备注）在本示例中，将8ch的音频数据作为2频道×4音轨处理。 */
const CriSint32 channels_per_track[4] = { 2, 2, 2, 2 };
    ：
/* 创建可播放8ch HCA数据的Voice池 */
criAtomExVoicePool_SetDefaultConfigForHcaVoicePool(&voice_pool_config);
voice_pool_config.player_config.max_channels = 8;
app_obj->voice_pool
    = criAtomExVoicePool_AllocateHcaVoicePool(&voice_pool_config, NULL, 0);
 
/* 创建Player */
app_obj->player = criAtomExPlayer_Create(NULL, NULL, 0);
 
/* 设置要播放的音频数据的格式信息 */
/* 备注）由于要播放的数据为2频道×4音轨=8，           */
/* 　　　为criAtomExPlayer_SetNumChannels函数指定8。     */
criAtomExPlayer_SetFormat(app_obj->player, CRIATOMEX_FORMAT_HCA);
criAtomExPlayer_SetNumChannels(app_obj->player, 8);
criAtomExPlayer_SetSamplingRate(app_obj->player, 48000);
 
/* 指定音频数据的音轨信息 */
/* 备注）以下代码中，指定2频道×4音轨。 */
criAtomExPlayer_SetTrackInfo(app_obj->player, NUM_TRACKS, channels_per_track);
 
/* 设置音频数据 */
criAtomExPlayer_SetFile(app_obj->player, NULL, PATH FILE);
 
/* 开始播放 */
criAtomExPlayer_Start(app_obj->player);
    ：

执行以上设置，AtomExPlayer将8ch的音频数据作为立体声×4音轨的音频数据进行播放。
关于各音轨的音量，可以使用::criAtomExPlayer_SetTrackVolume函数单独控制。

    ：
/* 音轨2以外的声音静音 */
criAtomExPlayer_SetTrackVolume(app_obj->player, 0, 0.0f);
criAtomExPlayer_SetTrackVolume(app_obj->player, 1, 0.0f);
criAtomExPlayer_SetTrackVolume(app_obj->player, 2, 1.0f);
criAtomExPlayer_SetTrackVolume(app_obj->player, 3, 0.0f);
criAtomExPlayer_UpdateAll(app_obj->player);
    ：