> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAudio2 概述

> 面向 XBOX 游戏的 XAudio2 底层音频 API，提供低延迟、动态缓冲区和采样精确回放的信号处理与混音图。

XAudio2 是一种底层音频 API 架构，为游戏提供信号处理与混音的基础。

<a id="ID4EW" />

## 何时使用 XAudio2

XAudio2 主要用于为游戏开发高性能音频引擎。如果你要为游戏添加音效和背景音乐，XAudio2 提供了一个音频图、一个具有低延迟并支持动态缓冲区的混音引擎、同步且采样级精确的播放，以及隐式的源采样率转换。与 [WASAPI](/build/console-features/audio/overviews/wasapi-overview) 相比，即使实现复杂的音频方案，XAudio2 也只需极少量的代码。

XAudio2 是一套跨平台 API。有关更多信息，请参见 [XAudio2 入门](https://msdn.microsoft.com/library/windows/desktop/ee415762\(v=vs.85\).aspx)。

<a id="ID4ERB" />

## 暂停与恢复

要正确暂停 XAudio2——例如在游戏进入挂起模式时按用户要求暂停——游戏应调用 [StopEngine](https://learn.microsoft.com/windows/desktop/api/xaudio2/nf-xaudio2-ixaudio2-stopengine)。在执行 **恢复** 操作时，则必须调用 [StartEngine](https://learn.microsoft.com/windows/desktop/api/xaudio2/nf-xaudio2-ixaudio2-startengine)。

<a id="ID4E6B" />

## Microsoft Game Development Kit 独有的 XAPOFX 效果

[XAPOFX](https://msdn.microsoft.com/library/windows/desktop/ee415726\(v=vs.85\).aspx) 是一组实现了 XAPO 接口、供 XAudio2 使用的音频效果。XAPOFX 包含多个效果以及创建效果实例的通用机制。

下表列出了 XBOX One XDK 独有的 XAPOFX 效果。

| 效果         | 说明                                                                                                                                                                                                                                                                                                                                                                                | 参数结构                                                                                 | 要求                         |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -------------------------- |
| FXLoudness | 一个基于 ITU-R BS.1770-3 标准的响度计。有关 FXLoudness 用法的示例，请参见 [XBOX Game Developer (XGD)](https://developer.microsoft.com/games/xbox/partner/resources-softwaredownloads) 站点示例页上的 SimplePlaySound 示例。<br /><br /> 该效果使用以下计数器向 [PIX](/tools/tools-console/pix/pix) 提供实时信息： <br />瞬时响度 (LUFS)。<br />短期响度 (LUFS)。<br />集成响度 (LUFS)。<br />响度范围高 (LUFS)。<br />响度范围低 (LUFS)。<br />真峰值 (dB)。<br /> | [FXLOUDNESS\_PARAMETERS](/reference/audio/xaudio2xbox/structs/fxloudness_parameters) | 仅支持 48 KHz 的 FLOAT32 音频格式。 |

## 参考 API 文档

* [XAudio2Xbox (API 内容)](/reference/audio/xaudio2xbox/xaudio2xbox_members)
  * Structures
    * [FXLOUDNESS\_PARAMETERS](/reference/audio/xaudio2xbox/structs/fxloudness_parameters)

## 另请参阅

[使用 XAudio2 播放声音](/build/console-features/audio/overviews/xaudio2-play-sound) [ADPCM 概述](/build/console-features/audio/overviews/adpcm-overview) [ADPCM 命令行编码器](/build/console-features/audio/tools/adpcmencoder-tools)


## Related topics

- [ADPCM 概述](/zh-CN/build/console-features/audio/overviews/adpcm-overview.md)
- [使用 XAudio2 播放声音](/zh-CN/build/console-features/audio/overviews/xaudio2-play-sound.md)
- [XAudio2CreateWithSharedContexts](/zh-CN/reference/audio/xaudio2xbox/functions/xaudio2createwithsharedcontexts.md)
- [概述](/zh-CN/build/console-features/audio/overviews/index.md)
- [ACP 概述](/zh-CN/build/console-features/audio/overviews/acp-overview.md)