【Android 高性能音频】AAudio 音频流 音频设备 相关配置 ( 音频设备ID | 音频流方向 | 音频设备共享模式 )（二）

VII . AAudio 音频流构建器 设置 音频设备共享模式 AAudioStreamBuilder_setSharingMode

AAudio 音频流设置 音频设备共享模式 :

① 函数原型 :

AAUDIO_API void AAudioStreamBuilder_setSharingMode(
  AAudioStreamBuilder *builder,
  aaudio_sharing_mode_t sharingMode
)

② 函数作用 : 设置音频设备的共享模式 ;

③ 参数 AAudioStreamBuilder *builder : AAudio 音频流构建器 ;

④ 参数 aaudio_sharing_mode_t sharingMode : 音频设备的共享模式 , AAUDIO_SHARING_MODE_SHARED ( 共享模式 ) , AAUDIO_SHARING_MODE_EXCLUSIVE ( 独占模式 ) ;

⑤ 默认模式 : 如果不调用该方法设置 音频设备的共享模式 , 那么默认为 AAUDIO_SHARING_MODE_SHARED 模式 ;

⑥ 设置失败的情况 : 如果该音频设备正在被其它音频流独占 , 那么该设置有可能会失败 ;

⑦ 共享模式性能分析 : 音频设备 在 AAUDIO_SHARING_MODE_SHARED 共享模式下 , 音频的延迟会高于独占模式 ;

⑧ 独占模式性能分析 : 音频设备 在 AAUDIO_SHARING_MODE_EXCLUSIVE 独占模式下 , 音频的延迟会降低的最低 , 性能很高 ;

⑨ 独占模式下资源释放 : 在独占模式下 , 如果不适用音频设备 , 应该马上释放该资源 , 以免影响其它音频流使用该音频设备 ;

⑩ 代码示例 :

   // 设置共享模式 , 独占模式性能更高 , 延迟更低 ; 如果 该音频设备正在被使用 , 设置失败会自动设置成 共享模式

AAudioStreamBuilder_setSharingMode(builder, AAUDIO_SHARING_MODE_EXCLUSIVE);

VIII . AAudio 音频设备 共享模式

AAudio 音频设备共享模式 :

① 代码定义 :

enum {
    /**
     * This will be the only stream using a particular source or sink.
     * This mode will provide the lowest possible latency.
     * You should close EXCLUSIVE streams immediately when you are not using them.
     */
            AAUDIO_SHARING_MODE_EXCLUSIVE,
    /**
     * Multiple applications will be mixed by the AAudio Server.
     * This will have higher latency than the EXCLUSIVE mode.
     */
            AAUDIO_SHARING_MODE_SHARED
};
typedef int32_t aaudio_sharing_mode_t;

② int32_t 类型 : 音频设备共享模式 类型为 int32_t 类型 ;

③ AAUDIO_SHARING_MODE_EXCLUSIVE 独占模式 :

a . 独占访问 : 只有该音频流能访问该音频设备 , 其它音频流拒绝访问 ;

b . 高性能 : 该模式下 音频流 性能高 , 延迟低 ;

c . 及时释放 : 如果不再使用该音频设备 , 需要马上释放音频流 , 以免影响其它音频流访问该音频设备 ;

④ AAUDIO_SHARING_MODE_SHARED 共享模式 :

a . 同时访问 : 多个音频流可以同时访问该音频设备 ;

b . 性能低于独占模式 : 该模式下音频的延迟略高于独占模式 ;

IX . AAudio 音频流 性能模式 设置 AAudioStreamBuilder_setPerformanceMode

AAudioStreamBuilder_setPerformanceMode 设置性能模式 :

① 函数原型 : 设置该 AAudio 音频流的性能模式 , 有省点模式 , 低延迟模式 , 和默认模式 三种选择 ;

AAUDIO_API void AAudioStreamBuilder_setPerformanceMode(
  AAudioStreamBuilder *builder,
  aaudio_performance_mode_t mode
)

② 代码示例 :

   // 设置性能模式

AAudioStreamBuilder_setPerformanceMode(builder, AAUDIO_PERFORMANCE_MODE_LOW_LATENCY

性能模式参数 :

① 代码定义 :

enum {
    /**
     * No particular performance needs. Default.
     */
    AAUDIO_PERFORMANCE_MODE_NONE = 10,
    /**
     * Extending battery life is more important than low latency.
     *
     * This mode is not supported in input streams.
     * For input, mode NONE will be used if this is requested.
     */
    AAUDIO_PERFORMANCE_MODE_POWER_SAVING,
    /**
     * Reducing latency is more important than battery life.
     */
    AAUDIO_PERFORMANCE_MODE_LOW_LATENCY
};
typedef int32_t aaudio_performance_mode_t;

② AAUDIO_PERFORMANCE_MODE_NONE : 默认值 , 没有设置特定的性能模式 ;

③ AAUDIO_PERFORMANCE_MODE_POWER_SAVING : 省电模式 , 电池使用时长比低延迟性能更重要 , 在 输入流 的情况下不支持该设置 ;

④ AAUDIO_PERFORMANCE_MODE_LOW_LATENCY : 低延迟 高性能 要不电池使用时间重要 ;

性能模式使用说明 :

① 默认值 : 默认状态下 , 如果不调用该方法设置性能模式 , 默认值是 AAUDIO_PERFORMANCE_MODE_NONE ;

② 获取性能模式 : 性能模式设置可能会失败 , 可以调用 AAudioStream_getPerformanceMode 方法获取最终的性能模式 ;