AudioGraph Classe
Definizione
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.
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.IDisposablePublic NotInheritable Class AudioGraph
Implements IDisposable- Ereditarietà
- 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. |