AudioGraph 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오디오를 조작하고 라우팅하는 연결된 입력, 출력 및 서브믹스 노드의 오디오 그래프를 나타냅니다.
public ref class AudioGraph sealed : IClosable/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AudioGraph final : IClosable[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AudioGraph : System.IDisposablePublic NotInheritable Class AudioGraph
Implements IDisposable- 상속
- 특성
- 구현
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
| 앱 기능 |
backgroundMediaRecording
|
설명
오디오 그래프는 입력 노드, 출력 노드 및 서브믹스 노드로 구성됩니다. 입력 노드에는 오디오 데이터를 생성하는 오디오 파일, 오디오 디바이스 및 코드가 포함됩니다. 출력 노드에는 오디오 파일, 오디오 디바이스 및 오디오 데이터를 처리하는 코드도 포함됩니다. 그래프가 시작되면 오디오 데이터는 입력 노드에서 서브믹스 노드를 통해 출력 노드로 그래프를 통해 흐릅니다. 각 노드는 다음 노드로 전달되기 전에 오디오 데이터에 적용되는 오디오 효과가 0개 이상 있을 수 있습니다. 이 클래스 및 관련 API를 사용하면 하위 수준 COM XAudio2 API보다 더 빠르고 쉽게 오디오 애플리케이션을 개발할 수 있습니다. 오디오 그래프 사용에 대한 방법 지침은 오디오 그래프를 참조하세요.
AudioGraph.CreateAsync를 호출하여 이 클래스의 instance 가져옵니다.
전체 오디오 그래프는 동일한 샘플 속도로 작동해야 합니다. 원본의 샘플 속도는 다를 수 있지만 즉시 다시 샘플링됩니다.
참고
사용할 수 있는 오디오 디바이스가 없으면 오디오 그래프를 인스턴스화할 수 없습니다.
선택적 미디어 기능 팩이 설치되지 않은 한 Windows 8 및 Windows 10 N 및 KN 버전에서는 AudioGraph를 인스턴스화할 수 없습니다. 자세한 내용은 Windows N 버전용 미디어 기능 팩을 참조하세요.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1607 | 14393 | CreateBatchUpdater |
| 1607 | 14393 | CreateDeviceInputNodeAsync(MediaCategory,AudioEncodingProperties,DeviceInformation,AudioNodeEmitter) |
| 1607 | 14393 | CreateFileInputNodeAsync(IStorageFile,AudioNodeEmitter) |
| 1607 | 14393 | CreateFrameInputNode(AudioEncodingProperties,AudioNodeEmitter) |
| 1607 | 14393 | CreateSubmixNode(AudioEncodingProperties,AudioNodeEmitter) |
| 1803 | 17134 | CreateMediaSourceAudioInputNodeAsync(MediaSource) |
| 1803 | 17134 | CreateMediaSourceAudioInputNodeAsync(MediaSource,AudioNodeEmitter) |
속성
| CompletedQuantumCount |
오디오 그래프에 대해 완료된 양자 수를 가져옵니다. |
| EncodingProperties |
오디오 그래프의 인코딩 속성을 가져옵니다. |
| LatencyInSamples |
오디오 그래프에서 지원하는 샘플의 대기 시간을 가져옵니다. |
| PrimaryRenderDevice |
오디오 그래프의 기본 렌더링 디바이스를 가져옵니다. |
| RenderDeviceAudioProcessing |
오디오 그래프의 오디오 처리 모드를 나타내는 값을 가져옵니다. |
| SamplesPerQuantum |
오디오 그래프가 현재 작동 중인 양자당 샘플 수를 가져옵니다. |
메서드
이벤트
| QuantumProcessed |
오디오 그래프가 지정된 양자를 처리했음을 알 수 있습니다. |
| QuantumStarted |
오디오 그래프가 새 양자 처리를 시작했음을 알 수 있습니다. |
| UnrecoverableErrorOccurred |
오디오 그래프 작업에서 복구할 수 없는 오디오 오류를 알 수 있습니다. |