Voice事件回调

示例目录

/cri/pc/samples/criatomex/voice_event_callback

示例描述

Voice事件回调是与访问Voice池（获取／返回Voice）联动所发生的回调事件。

通过注册Voice事件回调，可以检查播放请求的数据是否在AtomExPlayer中正确播放。
（可以在应用程序级别确认对请求进行了什么处理，如分配Voice并执行了播放，因Voice不足而无法播放，因Voice限数处理而停止了其他发声等。）

Voice事件回调的使用方法如下。

1. 在应用程序中定义CriAtomExVoiceEventCbFunc型函数。
2. 使用criAtomEx_SetVoiceEventCallback函数注册步骤1.的函数。

/* 定义CriAtomExVoiceEventCbFunc型函数 */
static void user_voice_event_func(
    void *obj, CriAtomExVoiceEvent voice_event,
    const CriAtomExVoiceInfoDetail *request,
    const CriAtomExVoiceInfoDetail *removed,
    const CriAtomExVoiceInfoDetail *removed_in_group)
{
    /* 每次访问Voice池都会执行此函数。 */
}
 
main()
{
        ：
    /* 注册Voice事件回调 */
    /* 备注）为第二个参数所指定的值将原样传递给回调的第一个参数。 */
    criAtomEx_SetVoiceEventCallback(user_voice_event_func, user_obj);
        ：
}

通过以上操作，在Atom运行库中每次访问Voice池时都会调用已注册的函数。

可以用回调函数的第二个参数（CriAtomExVoiceEvent）来确定发生的事件类型。
关于各个CriAtomExVoiceEvent值的含义，请参照参考用的“ CriAtomExVoiceEventTag ”说明。

示例使用的数据中AtomCraft项目的目录

/cri/tools/criatomex/examples/for_voice_event_callback