文章目录
一、检查 Oboe 音频流属性
二、开始播放
三、停止播放
四、关闭音频流
五、重新配置 Oboe 音频流属性
Oboe GitHub 主页 : GitHub/Oboe
① 简单使用 : Getting Started
② Oboe 全指南 : Full Guide To Oboe
③ Oboe API 参考 : API reference
④ Android 音频框架发展 : Android audio history
在 【Android 高性能音频】Oboe 开发流程 ( 导入 Oboe 库 | 使用预构建的二进制库和头文件 | 编译 Oboe 源码 ) 博客中介绍了 如何导入 Oboe 函数库到项目中 , 本博客中在导入 Oboe 函数库的基础上 , 进行 Oboe 播放器功能开发 ;
在 【Android 高性能音频】Oboe 开发流程 ( 包含头 Oboe 头文件 | 创建音频流 | 设置音频流 | 音频流回调类 AudioStreamCallback ) 介绍了如何创建 AudioStreamBuilder , 以及 创建 AudioStreamCallback 回调 ;
在 【Android 高性能音频】Oboe 开发流程 ( 创建并设置 AudioStreamCallback 对象 | 打开 Oboe 音频流 | 日志封装 logging_macros.h ) 博客中介绍了 设置 AudioStreamCallback 对象 , 打开 Oboe 音频流 操作 , 以及 Google 官方提供的日志封装有文件 ;
一、检查 Oboe 音频流属性
检查已创建的 Oboe 音频流属性 , 如果没有指定 声道数 , 采样率 , 采样格式 , 需要检查其默认的 Oboe 音频流配置 , 如果指定了这三个属性中的任意一个值 , 就会得到指定的值 ;
推荐手动设置上述三个值 , 不要让系统自动设置 ;
采样格式 属性指定的是 oboe::AudioStreamCallback 中的 onAudioReady 回调方法的 void *audioData 缓冲区的音频类型 ;
virtual DataCallbackResult onAudioReady( AudioStream *oboeStream, void *audioData, int32_t numFrames) = 0;
获取音频采样格式 , 并打印出来 :
// 获取采样格式 oboe::AudioFormat format = stream->getFormat();
// 打印采样格式 LOGI("AudioStream format is %s", oboe::convertToText(format));
二、开始播放
调用 oboe::ManagedStream 音频流的 requestStart() 方法 , 可以开启 Oboe 音频播放 ;
// 3. 开始播放 result = managedStream->requestStart(); LOGI("requestStart result : %s", oboe::convertToText(result));
三、停止播放
调用 oboe::ManagedStream 音频流的 requestStop() 方法 , 可以停止 Oboe 音频播放 ;
// 停止播放 result = managedStream->requestStop(); LOGI("requestStart result : %s", oboe::convertToText(result));
四、关闭音频流
当不使用 Oboe 音频流时 , 必须关闭该音频流 , 因为 Oboe 音频流会占用音频设备资源 ;
尤其是设置的 Oboe 音频流 共享模式 SharingMode 是独占模式 Exclusive 时 , 只要该音频流不关闭 , 其它的音频流将无法访问该低延迟音频流 ;
不再播放音频时 , 要及时关闭 Oboe 音频流 , 建议在 Activity 界面中的 onPause 方法中关闭音频流 ;
显示关闭 Oboe 音频流 : 直接 调用音频流的 close() 方法 , 显示关闭音频流 ; 该方法是一个阻塞调用 , 调用后 , 会停止音频流播放 ;
managedStream ->close();
Oboe 音频流超出作用域自动关闭 : 栈内存音频流超出作用域时 , 会自动关闭该 Oboe 音频流 ;
{ ManagedStream mStream; AudioStreamBuilder().build(mStream); mStream->requestStart(); } // 超出作用域音频流自动关闭
五、重新配置 Oboe 音频流属性
如果要修改现有 Oboe 音频流的配置 , 只需要 先设置对应属性 后 , 再调用 oboe::AudioStreamBuilder 构建器的 openManagedStream 方法 即可 , 调用该方法后, 会关闭销毁现有的 Oboe 音频流 , 然后会 重新创建新的 Oboe 音频流 ;
// 在 Oboe 音频流运行时 , 通过构建器修改音频流属性 builder.setDeviceId(MY_DEVICE_ID); // 重新打开设置了新属性的音频流 // 旧的 Oboe 音频流会被自动关闭并销毁 builder.openManagedStream(managedStream);
最佳实践 :
手动关闭销毁 : 使用 Oboe 音频流 ManagedStream 时 , 需要 手动负责关闭 和 销毁操作 ;
自动关闭销毁 : 如果在自动分配上下文的环境中 , 如该 音频流作为类的成员变量 , 当应用中不再使用音频流时 , 确保该 Oboe 音频流对象超出了封闭的作用范围 ;
