CRI ADX  Last Updated: 2024-07-17 10:48 p
调试日志功能
可以在游戏中获取声音播放日志。
可以在工具上复现该日志,查找故障和进行调整。
要使用日志功能,应用程序必须链接AtomExMonitor运行库。




获取日志的方法

获取日志有以下两种方法。
  1. 使用回调函数获取
    与错误回调一样,设置回调函数,由应用程序执行日志获取。
    在回调函数注册时,各种日志命令的内容描述字符串被传递给注册函数。
  2. 与Craft联动,在主机PC端获取(未实现)
    与Craft建立通信后,通过Craft端的操作来获取日志。

获取日志的内容

目前可获取以下项目的日志。
  1. 调用ADX运行库API
    • 初始化/结束系列API xxx_Initialize(), xxx_Finalize()等
      (目前不支持平台特定函数)
    • 创建/删除系列API xxx_Create(), xxx_Destroy()等
    • 播放控制API xxx_Start(), xxx_Stop(), xxx_Pause()等
    • 参数设置系列API(未实现) xxx_SetVolume(), xxx_SetPitch()等
    • 数据加载系列API (加载/释放ACF, ACB)
  2. 错误回调
    • 错误回调的内容
  3. 运行库内部的发声管理处理
    • 获取/释放CriAtomExPlaybackId (CriAtomExPlaybackInfo)
    • CriAtomSoundPlayer的播放控制
    • 获取/释放CriAtomSoundPlaybackId
    • 获取/释放CriAtomPlayerPoolPlayerInfo

      所有日志中将添加以下项目。
    • 标识符:#CRIATOM (命令描述使用#CRIATOMDEF)
    • 时间戳信息(AtomSoundTime:单位μsec)
    • 线程ID信息
    • 日志命令:用于识别日志内容
    • 命令信息:函数引数、结构体内容、句柄信息等
[备注]
该功能的实现级别为β级,计划在未来扩展功能。
如果有功能要求的话,请联系CRI支持部门。