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가 클라이언트를 초기화할 때 지정한 것보다 더 많은 항목을 메타데이터 버퍼에 쓰려고 할 때 원하는 동작을 지정합니다.