AudioGraph 類別

參考

定義

命名空間:: Windows.Media.Audio

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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.IDisposable

Public NotInheritable Class AudioGraph
Implements IDisposable

繼承: Object Platform::Object IInspectable AudioGraph

屬性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作: IClosable 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	取得音訊圖表目前運作的每個量子樣本數目。

方法

Close()	關閉音訊圖表並處置相關聯的資源。
CreateAsync(AudioGraphSettings)	建立具有特定設定的音訊圖表。
CreateBatchUpdater()	為AudioGraph建立新的AudioGraphBatchUpdater，這會讓音訊圖形中的所有後續修改累積，然後在您的應用程式關閉或處置批次更新程式物件之後認可。
CreateDeviceInputNodeAsync(MediaCategory)	建立 AudioDeviceInputNode ，從預設音訊輸入裝置將音訊資料輸入到音訊圖形，例如麥克風或音訊卡。
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)	建立 AudioDeviceInputNode ，從預設音訊輸入裝置將音訊資料輸入到音訊圖形，例如麥克風或音訊卡。
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)	建立 AudioDeviceInputNode ，從指定的音訊輸入裝置將音訊資料輸入到音訊圖形，例如麥克風或音訊卡。
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter)	建立啟用空間音訊功能的 AudioDeviceInputNode ，從指定的音訊輸入裝置，例如麥克風或音訊卡，將音訊資料輸入到音訊圖形中。
CreateDeviceOutputNodeAsync()	建立新的 AudioDeviceOutputNode ，將音訊資料從音訊圖形輸出到系統的預設輸出裝置，例如喇叭或耳機。
CreateFileInputNodeAsync(IStorageFile)	建立 AudioFileInputNode ，從儲存體檔案將音訊資料輸入音訊圖形。
CreateFileInputNodeAsync(IStorageFile, AudioNodeEmitter)	建立空間音訊啟用的 AudioFileInputNode ，以從儲存檔案將音訊資料輸入音訊圖形。
CreateFileOutputNodeAsync(IStorageFile)	建立新的 AudioFileOutputNode ，將音訊資料從音訊圖形輸出到指定的儲存檔案。
CreateFileOutputNodeAsync(IStorageFile, MediaEncodingProfile)	建立新的 AudioFileOutuputNode ，將音訊資料從音訊圖形輸出至指定的儲存檔案。
CreateFrameInputNode()	建立 AudioFrameInputNode ，將應用程式實作程式碼所產生的音訊資料輸入音訊圖形。
CreateFrameInputNode(AudioEncodingProperties)	使用指定的編碼屬性建立 AudioFrameInputNode，以將應用程式實作程式碼所產生的音訊資料輸入音訊圖形。
CreateFrameInputNode(AudioEncodingProperties, AudioNodeEmitter)	建立具有指定編碼屬性的空間音訊啟用 AudioFrameInputNode，以將應用程式實作程式碼所產生的音訊資料輸入音訊圖形。
CreateFrameOutputNode()	建立新的 AudioFrameOutputNode ，將音訊資料從音訊圖形輸出至應用程式實作的程式碼。
CreateFrameOutputNode(AudioEncodingProperties)	使用指定的編碼屬性，建立新的 AudioFrameOutputNode，以將音訊資料從音訊圖形輸出到應用程式實作的程式碼。
CreateMediaSourceAudioInputNodeAsync(MediaSource)	建立 MediaSourceAudioInputNode ，從提供的 MediaSource 物件將音訊資料輸入音訊圖形。
CreateMediaSourceAudioInputNodeAsync(MediaSource, AudioNodeEmitter)	建立啟用空間音訊功能的 MediaSourceAudioInputNode ，以從提供的 MediaSource 物件將音訊資料輸入音訊圖形。
CreateSubmixNode()	建立 AudioSubmixNode ，將一或多個音訊圖形節點的輸出混合成可連線到輸出節點或其他副混音節點的單一輸出。
CreateSubmixNode(AudioEncodingProperties)	建立 AudioSubmixNode ，將一或多個音訊圖形節點的輸出混合成可連線到輸出節點或其他副混音節點的單一輸出。
CreateSubmixNode(AudioEncodingProperties, AudioNodeEmitter)	建立支援空間音訊的 AudioSubmixNode ，將一或多個音訊圖形節點的輸出混合成可連線到輸出節點或其他副混音節點的單一輸出。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
ResetAllNodes()	重設音訊圖表中的所有節點。
Start()	啟動音訊圖表。
Stop()	停止音訊圖表。

事件

QuantumProcessed	通知音訊圖形已處理指定的量子。
QuantumStarted	通知音訊圖形已開始處理新的量子。
UnrecoverableErrorOccurred	通知音訊圖形作業中無法復原的音訊錯誤。

適用於

AudioGraph 類別

定義

Windows 需求

備註

版本歷程記錄

屬性

方法

事件

適用於

另請參閱

意見反應

意見反應

其他資源