### Ahead AAC Decoder Library Documentation
#### 概述
本文档详细介绍了Ahead AAC解码库的API函数及其使用方法。该库支持多种AAC（Advanced Audio Coding）编解码标准，并且提供了丰富的配置选项，允许用户根据实际需求调整解码过程。本文档将深入探讨各个API函数的功能及使用方式。
#### 1. API规范
这一章节详细描述了Ahead AAC解码库的API函数，并解释了如何使用这些函数以及使用的顺序。
##### 1.1 NeAACDecGetCapabilities
**函数原型**：
```
unsigned long NEAACAPI NeAACDecGetCapabilities(void);
```
**功能说明**：
此函数返回解码器的能力值，该值是一个32位无符号整数。在该整数中的每个比特位表示解码库是否支持特定的能力。
**返回值**：
一个32位无符号整数，其中设置的比特位定义了解码库支持的能力。
**定义的能力**：
- `#define LC_DEC_CAP (1<<0)`：支持LC（Low Complexity）模式解码。
- `#define MAIN_DEC_CAP (1<<1)`：支持MAIN模式解码。
- `#define LTP_DEC_CAP (1<<2)`：支持LTP（Long Term Prediction）模式解码。
- `#define LD_DEC_CAP (1<<3)`：支持LD（Low Delay）模式解码。
- `#define ERROR_RESILIENCE_CAP (1<<4)`：支持错误恢复能力。
- `#define FIXED_POINT_CAP (1<<5)`：支持定点运算。
**调用时机**：
此函数可以随时调用。
##### 1.2 NeAACDecOpen
**函数原型**：
```
NeAACDecHandle NEAACAPI NeAACDecOpen(void);
```
**功能说明**：
此函数创建一个新的解码上下文并返回一个指向该上下文的句柄。
**返回值**：
返回一个解码器上下文的句柄。
**调用时机**：
在使用解码库之前调用此函数以初始化解码器上下文。
##### 1.3 NeAACDecClose
**函数原型**：
```
void NEAACAPI NeAACDecClose(NeAACDecHandle hDecoder);
```
**功能说明**：
此函数关闭由`NeAACDecOpen`创建的解码器上下文。
**参数**：
- `hDecoder`：解码器上下文句柄。
**调用时机**：
当不再需要解码器上下文时调用此函数。
##### 1.4 NeAACDecGetCurrentConfiguration
**函数原型**：
```
NeAACDecConfigurationPtr NEAACAPI NeAACDecGetCurrentConfiguration(NeAACDecHandle hDecoder);
```
**功能说明**：
此函数返回当前解码器上下文的配置结构指针。
**参数**：
- `hDecoder`：解码器上下文句柄。
**返回值**：
返回指向当前配置结构的指针。
**调用时机**：
在需要获取当前解码器配置时调用此函数。
##### 1.5 NeAACDecSetConfiguration
**函数原型**：
```
unsigned char NEAACAPI NeAACDecSetConfiguration(NeAACDecHandle hDecoder, NeAACDecConfigurationPtr config);
```
**功能说明**：
此函数用于设置解码器上下文的新配置。
**参数**：
- `hDecoder`：解码器上下文句柄。
- `config`：指向新配置结构的指针。
**返回值**：
- `0`：错误，无效配置。
- `1`：成功。
**调用时机**：
在需要更改解码器配置时调用此函数。
##### 1.6 NeAACDecInit
**函数原型**：
```
long NEAACAPI NeAACDecInit(NeAACDecHandle hDecoder, unsigned char *buffer, unsigned long buffer_size, unsigned long *samplerate, unsigned char *channels);
```
**功能说明**：
此函数初始化解码器库，使用AAC文件的部分信息完成初始化。如果提供了一个包含AAC文件头部信息的缓冲区，则可以从ADTS或ADIF头中读取必要的参数。
**参数**：
- `hDecoder`：解码器上下文句柄。
- `buffer`：指向包含AAC文件头部信息的缓冲区的指针。可以为`NULL`。
- `buffer_size`：缓冲区大小。
- `samplerate`：采样率的指针。
- `channels`：通道数的指针。
**返回值**：
- `<0`：错误。
- `>=0`：已读取的字节数。程序应该跳过这个数量的字节。
**调用时机**：
在解码AAC文件之前调用此函数进行初始化。
#### 结论
通过上述介绍，我们可以了解到Ahead AAC解码库提供了强大的AAC解码能力，包括支持多种AAC编解码标准、灵活的配置选项以及详细的初始化和控制功能。开发者可以根据自己的需求选择合适的能力组合，并通过API函数轻松地集成到自己的应用中。这些API函数不仅简化了AAC解码的过程，还确保了解码质量和效率的最大化。
