共用方式為


AudioGraph 類別

定義

表示連接輸入、輸出和子混音節點的音訊圖形,這些節點會操作和路由音訊。

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
屬性
實作

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

通知音訊圖形作業中無法復原的音訊錯誤。

適用於

另請參閱