Condividi tramite


AudioGraph Classe

Definizione

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
Implementazioni

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

Vedi anche