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
|
備註
音訊圖表是由輸入節點、輸出節點和副混音節點所組成。 輸入節點包括音訊檔案、音訊裝置，以及產生音訊資料的程式碼。 輸出節點也包含音訊檔案、音訊裝置，以及處理音訊資料的程式碼。 當圖形啟動時，音訊資料會流經輸入節點、透過任何子混音節點的圖形流向輸出節點。 每個節點可以有零或多個音訊效果，這些效果會套用至音訊資料，然後再傳遞至下一個節點。 此類別和相關 API 可讓您比低階 COM XAudio2 API 更快速且輕鬆地開發音訊應用程式。 如需使用音訊圖形的作法指引，請參閱 音訊圖表。
藉由呼叫 AudioGraph.CreateAsync來取得這個類別的實例。
整個音訊圖表必須以相同的取樣率運作。 來源可以有不同的取樣率，但會立即重新取樣。
注意
如果沒有可用的音訊裝置，就無法具現化音訊圖形。
除非已安裝選擇性的媒體功能套件，否則 AudioGraph 無法在 Windows 8 和 Windows 10 的 N 和 KN 版本上具現化。 如需詳細資訊，請參閱 適用于 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 |
通知音訊圖形作業中無法復原的音訊錯誤。 |