AudioUnit框架详细解析(八) —— 音频单元提供快速的模块化音频处理之使用属性来配置音频单元(五)

版本记录

版本号 时间
V1.0 2018.06.25

前言

AudioUnit框架作为您的应用程序添加复杂的音频操作和处理功能。 创建在主机应用程序中生成或修改音频的音频单元扩展。接下来几篇我们就一起看一下这个框架,感兴趣的看上面几篇文章。
1. AudioUnit框架详细解析(一) —— 基本概览
2. AudioUnit框架详细解析(二) —— 关于Audio Unit Hosting之概览(一)
3. AudioUnit框架详细解析(三) —— 关于Audio Unit Hosting之如何使用本文档和参考资料(二)
4. AudioUnit框架详细解析(四) —— 音频单元提供快速的模块化音频处理之iOS中的Audio Units(一)
5. AudioUnit框架详细解析(五) —— 音频单元提供快速的模块化音频处理之在Concert中使用两个音频单元API(二)
6. AudioUnit框架详细解析(六) —— 音频单元提供快速的模块化音频处理之使用标识符来指定和获取音频单元(三)
7. AudioUnit框架详细解析(七) —— 音频单元提供快速的模块化音频处理之使用范围和元素来指定音频单元的部分(四)

Use Properties to Configure Audio Units - 使用属性来配置音频单元

音频单元属性audio unit property是可用于配置音频单元的键值对。 属性的key是具有关联助记符标识符的唯一整数,例如kAudioUnitProperty_MaximumFramesPerSlice = 14。 Apple保留从063999的属性键。在Mac OS X中,第三方音频单元使用此范围以上的键。

每个属性的值都是指定的数据类型,并具有指定的读/写访问权限,如Audio Unit Properties Reference中所述。 要在任何音频单元上设置任何属性,请使用一个灵活函数:AudioUnitSetPropertyListing 1-4显示了此函数的一个典型用法,注释强调了如何指定范围和元素scope and element以及指示属性的键和值。

// Listing 1-4 Using scope and element when setting a property

UInt32 busCount = 2;
OSStatus result = AudioUnitSetProperty (
      mixerUnit,
      kAudioUnitProperty_ElementCount,  // the property key
      kAudioUnitScope_Input,  // the scope to set the property on
      0,  // the element to set the property on
      &busCount,  // the property value
      sizeof (busCount)
); 

以下是在音频单元开发中经常使用的一些属性。 通过阅读其参考文档并探索Apple的音频单元示例代码项目(如音频混音器(MixerHost)),熟悉其中的每一个:

  • kAudioOutputUnitProperty_EnableIO,用于启用或禁用I / O单元上的输入或输出。 默认情况下,输出已启用,但输入已禁用。

  • kAudioUnitProperty_ElementCount,用于配置混音器单元上的输入元素数量。

  • kAudioUnitProperty_MaximumFramesPerSlice,用于指定音频单元响应于渲染调用应该准备产生的音频数据的最大帧数。 对于大多数音频单远,在大多数情况下,您必须按照参考文档中所述设置此属性。 如果你不这样做,当屏幕锁定时,你的音频将停止。

  • kAudioUnitProperty_StreamFormat,用于指定特定音频单元输入或输出总线的音频流数据格式。

大多数属性值只能在音频单元未初始化时设置。 这些属性不打算由用户改变。 尽管如此,某些iPod播放器EQ单元的kAudioUnitProperty_PresentPreset属性和语音处理I / O单元的kAUVoiceIOProperty_MuteOutput属性在播放音频时会更改。

要发现一个属性的可用性,访问其值,并监视其值的变化,请使用以下函数:

  • AudioUnitGetPropertyInfo - 发现某个属性是否可用; 如果是这样,你会得到数据大小的值,以及是否可以更改该值
  • AudioUnitGetProperty,AudioUnitSetProperty - 获取或设置属性的值
  • AudioUnitAddPropertyListener,AudioUnitRemovePropertyListenerWithUserData - 安装或删除回调函数以监视对属性值的更改

后记

本篇主要讲述了使用属性来配置音频单元,感兴趣的给个赞或者关注~~~~

AudioUnit框架详细解析(八) —— 音频单元提供快速的模块化音频处理之使用属性来配置音频单元(五)_第1张图片

你可能感兴趣的:(AudioUnit框架详细解析(八) —— 音频单元提供快速的模块化音频处理之使用属性来配置音频单元(五))