如何获取、上传音频的 Dump 文件?
产品 / 插件:实时音视频 / 实时语音 / 超低延迟直播
平台 / 框架:iOS / Android / macOS / Windows / Linux / Flutter
更新时间:2023-10-13 19:20
在实时通话过程中,音频发生异常时,可以参考本文,将处理前后的音频 Dump 数据保存下来并上传,用于定位音频相关问题、提高问题排查效率、缩短接入时间。
操作步骤
以下以 Android 平台接口调用为例,其他平台同理。
- 调用 createEngine 接口之后,开发者可以在推流前后,获取音频的 Dump 文件。
- 调用 startDumpData 开始转储音频数据,并在 ZegoDumpDataConfig 参数中,配置需要 Dump 的数据类型为
Audio
(目前仅支持 Audio);同时通过 onStartDumpData 回调返回接口调用的结果。
- 调用 stopDumpData 结束转储音频数据,同时通过 onStopDumpData 回调返回接口调用的结果。接口调用成功后,回调中会返回 Dump 文件的目录路径。
- 调用 uploadDumpData 上传当次的 Dump 数据,同时通过 onUploadDumpData 回调返回接口调用的结果。
- 最后,可以通过 removeDumpData 接口,删除当次的音频转储数据。
注意事项
- 由于音频 Dump 文件属于用户的隐私敏感数据,因此开发者实现该能力时,请务必认真阅读 《即构隐私政策》 中关于 “使用音频 Dump 功能” 的内容。此外,在收集音频 Dump 文件时,请在获得用户授权同意时,同步注明 Express SDK 收集目的。
- 在上传音频 Dump 数据前,SDK 会自动检查 Dump 文件大小,超过 100 MB 上传失败。如果上传失败,开发者可以从设备上导出 Dump 文件,并联系 ZEGO 技术支持获取帮助。
- 音频的 Dump 文件只能保留转储过程中最后的 2~4 分钟的数据。