spatialaudiometadata.h 标头

此标头由核心音频 API 使用。 有关详细信息，请参阅：

• 核心音频 API

spatialaudiometadata.h 包含以下编程接口：

接口

ISpatialAudioMetadataClient 提供用于创建 ISpatialAudioMetadataItems、ISpatialAudioMetadataWriter、ISpatialAudioMetadataReader 和 ISpatialAudioMetadataCopier 对象的类工厂。
ISpatialAudioMetadataCopier 提供用于将所有或部分元数据项从源 SpatialAudioMetadataItems 复制到目标 SpatialAudioMetadataItems 的方法。
ISpatialAudioMetadataItems 表示空间音频元数据项的缓冲区。
ISpatialAudioMetadataItemsBuffer 提供将缓冲区附加到 SpatialAudioMetadataItems 的方法，以便就地存储数据。
ISpatialAudioMetadataReader 提供用于从 ISpatialAudioMetadataItems 对象中提取空间音频元数据项和项命令值对的方法。
ISpatialAudioMetadataWriter 提供用于存储位于相应音频帧范围内的空间音频元数据项的方法。
ISpatialAudioObjectForMetadataCommands 用于编写空间音频的元数据命令。
ISpatialAudioObjectForMetadataItems 用于为需要每个缓冲区多个元数据项且具有帧准确放置的应用程序编写空间音频元数据。
ISpatialAudioObjectRenderStreamForMetadata 提供用于控制元数据的空间音频对象呈现流的方法，包括启动、停止和重置流。

结构

SpatialAudioMetadataItemsInfo 提供有关 ISpatialAudioMetadataItems 对象的信息。 通过调用 GetInfo 获取此结构的副本。
SpatialAudioObjectRenderStreamForMetadataActivationParams 表示元数据的空间音频呈现流的激活参数。 激活流时，将此结构传递给 ISpatialAudioClient：：ActivateSpatialAudioStream。
SpatialAudioObjectRenderStreamForMetadataActivationParams2 表示元数据的空间音频呈现流的激活参数，扩展 SpatialAudioObjectRenderStreamForMetadataActivationParams 并指定流选项。

枚举

SpatialAudioMetadataCopyMode 指定调用 ISpatialAudioMetadataCopier：：CopyMetadataForFrames 时使用的复制模式。
SpatialAudioMetadataWriterOverflowMode 指定 ISpatialAudioMetadataWriter 尝试将比初始化客户端时指定更多的项写入元数据缓冲区时所需的行为。