AudioGraph Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Media.Audio

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta un grafico audio di nodi di input, output e submix connessi che modificano e instradano l'audio.

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

Ereditarietà: Object Platform::Object IInspectable AudioGraph

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni: IClosable IDisposable

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	backgroundMediaRecording

Commenti

Il grafico audio è costituito da nodi di input, nodi di output e nodi submix. I nodi di input includono file audio, dispositivi audio e codice che generano dati audio. I nodi di output includono anche file audio, dispositivi audio e codice che elaborano i dati audio. Al momento dell'avvio del grafico, i dati audio passano attraverso il grafico dai nodi di input, tramite qualsiasi nodo submix, ai nodi di output. Ogni nodo può avere zero o più effetti audio applicati ai dati audio prima di passare al nodo successivo. Questa classe e le API correlate consentono di sviluppare applicazioni audio più rapidamente e facilmente rispetto alle API COM XAudio2 di basso livello. Per indicazioni sull'uso di grafici audio, vedere Grafici audio.

Ottenere un'istanza di questa classe chiamando AudioGraph.CreateAsync.

L'intero grafico audio deve funzionare con la stessa frequenza di esempio. Le origini possono avere tassi di esempio diversi, ma vengono ricampionati immediatamente.

Nota

Se non sono disponibili dispositivi audio, non è possibile creare un'istanza del grafico audio.

Non è possibile creare un'istanza di AudioGraph nelle edizioni N e KN di Windows 8 e Windows 10, a meno che non sia stato installato il Feature Pack multimediale facoltativo. Per altre informazioni, vedere Media Feature Pack per le edizioni N di Windows.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
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)

Proprietà

CompletedQuantumCount	Ottiene il conteggio quantistico completato per il grafico audio.
EncodingProperties	Ottiene le proprietà di codifica per il grafico audio.
LatencyInSamples	Ottiene la latenza negli esempi supportati dal grafico audio.
PrimaryRenderDevice	Ottiene il dispositivo di rendering primario per il grafico audio.
RenderDeviceAudioProcessing	Ottiene un valore che indica la modalità di elaborazione audio per il grafico audio.
SamplesPerQuantum	Ottiene il numero di campioni per ogni quantistico in cui è attualmente operativo il grafico audio.

Metodi

Close()	Chiude il grafico audio e elimina le risorse associate.
CreateAsync(AudioGraphSettings)	Crea un grafico audio con impostazioni specifiche.
CreateBatchUpdater()	Crea un nuovo AudioGraphBatchUpdater per AudioGraph che causa l'accumulo di tutte le modifiche successive a tutti i nodi nel grafico audio e quindi il commit dopo che l'app chiude o elimina l'oggetto updater batch.
CreateDeviceInputNodeAsync(MediaCategory)	Crea un audioDeviceInputNode che inserisce dati audio nel grafico audio dal dispositivo di input audio predefinito, ad esempio un microfono o una scheda audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)	Crea un oggetto AudioDeviceInputNode che inserisce dati audio nel grafico audio dal dispositivo di input audio predefinito, ad esempio un microfono o una scheda audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)	Crea un audioDeviceInputNode che inserisce i dati audio nel grafico audio dal dispositivo di input audio specificato, ad esempio un microfono o una scheda audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter)	Crea un audio spaziale abilitato per AudioDeviceInputNode che immette dati audio nel grafico audio dal dispositivo di input audio specificato, ad esempio un microfono o una scheda audio.
CreateDeviceOutputNodeAsync()	Crea un nuovo audioDeviceOutputNode che restituisce dati audio dal grafico audio al dispositivo di output predefinito del sistema, ad esempio altoparlanti o cuffie.
CreateFileInputNodeAsync(IStorageFile)	Crea un audioFileInputNode che inserisce dati audio nel grafico audio da un file di archiviazione.
CreateFileInputNodeAsync(IStorageFile, AudioNodeEmitter)	Crea un audio spaziale abilitato per AudioFileInputNode che inserisce i dati audio nel grafico audio da un file di archiviazione.
CreateFileOutputNodeAsync(IStorageFile)	Crea un nuovo audioFileOutputNode che restituisce dati audio dal grafico audio al file di archiviazione specificato.
CreateFileOutputNodeAsync(IStorageFile, MediaEncodingProfile)	Crea un nuovo audioFileOutuputNode che restituisce dati audio dal grafico audio al file di archiviazione specificato.
CreateFrameInputNode()	Crea un audioFrameInputNode che inserisce i dati audio generati dal codice implementato dall'app nel grafico audio.
CreateFrameInputNode(AudioEncodingProperties)	Crea un audioFrameInputNode, con le proprietà di codifica specificate, che inserisce i dati audio generati dal codice implementato dall'app nel grafico audio.
CreateFrameInputNode(AudioEncodingProperties, AudioNodeEmitter)	Crea un audio spaziale abilitato per AudioFrameInputNode, con le proprietà di codifica specificate, che inserisce i dati audio generati dal codice implementato dall'app nel grafico audio.
CreateFrameOutputNode()	Crea un nuovo audioFrameOutputNode che restituisce dati audio dal grafico audio al codice implementato dall'app.
CreateFrameOutputNode(AudioEncodingProperties)	Crea un nuovo audioFrameOutputNode, con le proprietà di codifica specificate, che restituisce dati audio dal grafico audio al codice implementato dall'app.
CreateMediaSourceAudioInputNodeAsync(MediaSource)	Crea un oggetto MediaSourceAudioInputNode che inserisce i dati audio nel grafico audio dall'oggetto MediaSource specificato.
CreateMediaSourceAudioInputNodeAsync(MediaSource, AudioNodeEmitter)	Crea un oggetto MediaSourceAudioInputNode abilitato per l'audio che inserisce i dati audio nel grafico audio dall'oggetto MediaSource specificato.
CreateSubmixNode()	Crea un audioSubmixNode che combina l'output di uno o più nodi del grafico audio in un singolo output che può essere connesso ai nodi di output o ad altri nodi submix.
CreateSubmixNode(AudioEncodingProperties)	Crea un audioSubmixNode che combina l'output di uno o più nodi del grafico audio in un singolo output che può essere connesso ai nodi di output o ad altri nodi submix.
CreateSubmixNode(AudioEncodingProperties, AudioNodeEmitter)	Crea un audio spaziale abilitato per AudioSubmixNode che combina l'output di uno o più nodi del grafico audio in un singolo output che può essere connesso ai nodi di output o ad altri nodi submix.
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
ResetAllNodes()	Reimposta tutti i nodi nel grafico audio.
Start()	Avvia il grafico audio.
Stop()	Arresta il grafico audio.

Eventi

QuantumProcessed	Notifica che il grafico audio ha elaborato il quantistico specificato.
QuantumStarted	Notifica che il grafico audio ha avviato l'elaborazione di un nuovo quantistico.
UnrecoverableErrorOccurred	Notifica di un errore audio non recuperabile nell'operazione del grafico audio.

Si applica a