AudioUnit框架详细解析(六) —— 音频单元提供快速的模块化音频处理之使用标识符来指定和获取音频单元(三)

版本记录

版本号 时间
V1.0 2018.06.24

前言

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

Use Identifiers to Specify and Obtain Audio Units - 使用标识符来指定和获取音频单元

要在运行时查找音频单元,请首先在音频组件描述数据结构中指定其类型,子类型和制造商密钥。 无论使用音频单元还是音频处理图形API,都可以这样做。 Listing 1-1给出了怎么做。

// Listing 1-1 Creating an audio component description to identify an audio unit
 
AudioComponentDescription ioUnitDescription;
ioUnitDescription.componentType          = kAudioUnitType_Output;
ioUnitDescription.componentSubType       = kAudioUnitSubType_RemoteIO;
ioUnitDescription.componentManufacturer  = kAudioUnitManufacturer_Apple;
ioUnitDescription.componentFlags         = 0;
ioUnitDescription.componentFlagsMask     = 0;

此说明仅指定一个音频单元 - Remote I/O unit。 此音频和其他iOS音频单元的键在Identifier Keys for Audio Units中列出。 请注意,所有iOS音频设备都使用componentManufacturer字段的kAudioUnitManufacturer_Apple密钥。

要创建通配符描述,请将一个或多个类型/子类型字段设置为0。例如,要匹配所有I / O单元,请将列表1-1更改为对componentSubType字段使用值0。

通过描述,您可以使用两种API中的任何一种获得对指定音频单元(或音频单元集)的库的引用。 音频单元API如Listing 1-2所示。

Listing 1-2 Obtaining an audio unit instance using the audio unit API

  AudioComponent foundIoUnitReference = AudioComponentFindNext (
                                            NULL,
   AudioUnit ioUnitInstance;
   AudioComponentInstanceNew (
      foundIoUnitReference,
      &ioUnitInstance
  );

NULL传递给AudioComponentFindNext的第一个参数告诉该函数使用系统定义的顺序查找与描述匹配的第一个系统音频单元。 如果您改为在此参数中传递先前找到的音频单元引用,则该函数将找到与该描述匹配的下一个音频单元。 例如,此用法可让您通过重复调用AudioComponentFindNext来获取对所有I / O单元的引用。

AudioComponentFindNext调用的第二个参数是指Listing 1-1中定义的音频单元描述。

AudioComponentFindNext函数的结果是对定义音频单元的动态链接库的引用。 将引用传递给AudioComponentInstanceNew函数以实例化音频单元,如Listing 1-2所示。

您可以使用音频处理图API来实例化音频单元。 Listing 1-3显示了做法。

// Listing 1-3 Obtaining an audio unit instance using the audio processing graph API
// Declare and instantiate an audio processing graph
  AUGraph processingGraph;
  NewAUGraph (&processingGraph);
  // Add an audio unit node to the graph, then instantiate the audio unit
  AUNode ioNode;
  AUGraphAddNode (
      processingGraph,
      &ioUnitDescription,
      &ioNode
  );
  AUGraphOpen (processingGraph); // indirectly performs audio unit instantiation
  // Obtain a reference to the newly-instantiated I/O unit
  AudioUnit ioUnit;
  AUGraphNodeInfo (
       processingGraph,
 ioNode,
      NULL,
      &ioUnit
);

该代码清单引入了AUNode,这是一种不透明的类型,表示音频处理图形上下文中的音频单元。 在AUGraphNodeInfo函数调用的输出中,您将在ioUnit参数中收到对新音频单元实例的引用。
AUGraphAddNode调用的第二个参数引用了Listing 1-1中定义的音频单元描述。

获得音频单元实例后,您可以对其进行配置。 为此,您需要了解两个音频单元的特征,范围和元素(scopes and elements)

后记

本篇主要讲述了使用标识符来指定和获取音频单元,感兴趣的给个赞或者关注~~~~

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容