AudioGraph Clase

Definición

Espacio de nombres:

Windows.Media.Audio

Representa un gráfico de audio de los nodos de entrada, salida y submezcla conectados que manipulan y enrutan 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

Herencia

Object Platform::Object IInspectable AudioGraph

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
Características de aplicaciones	backgroundMediaRecording

Comentarios

El gráfico de audio se compone de nodos de entrada, nodos de salida y nodos de submezcla. Los nodos de entrada incluyen archivos de audio, dispositivos de audio y código que genera datos de audio. Los nodos de salida también incluyen archivos de audio, dispositivos de audio y código que procesa datos de audio. Cuando se inicia el grafo, los datos de audio fluyen a través del grafo desde los nodos de entrada, a través de los nodos de submezcla, a los nodos de salida. Cada nodo puede tener cero o más efectos de audio que se aplican a los datos de audio antes de pasarlos al siguiente nodo. Esta clase y las API relacionadas permiten desarrollar aplicaciones de audio de forma más rápida y sencilla que las API COM XAudio2 de bajo nivel. Para obtener instrucciones paso a paso sobre el uso de gráficos de audio, consulte Gráficos de audio.

Obtenga una instancia de esta clase llamando a AudioGraph.CreateAsync.

Todo el gráfico de audio debe funcionar con la misma frecuencia de muestreo. Los orígenes pueden tener diferentes tasas de muestra, pero se vuelven a muestrear inmediatamente.

Nota:

Si no hay ningún dispositivo de audio disponible, no se puede crear una instancia del grafo de audio.

AudioGraph no se puede crear una instancia en las ediciones N y KN de Windows 8 y Windows 10, a menos que se haya instalado el Feature Pack multimedia opcional. Para obtener más información, consulta Media Feature Pack para ediciones de Windows N.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
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)

Propiedades

CompletedQuantumCount	Obtiene el recuento cuántico completado para el gráfico de audio.
EncodingProperties	Obtiene las propiedades de codificación del gráfico de audio.
LatencyInSamples	Obtiene la latencia de los ejemplos que admite el grafo de audio.
PrimaryRenderDevice	Obtiene el dispositivo de representación principal para el gráfico de audio.
RenderDeviceAudioProcessing	Obtiene un valor que indica el modo de procesamiento de audio para el gráfico de audio.
SamplesPerQuantum	Obtiene el número de muestras por cuanto en la que el grafo de audio está funcionando actualmente.

Métodos

Close()	Cierra el gráfico de audio y elimina los recursos asociados.
CreateAsync(AudioGraphSettings)	Crea un gráfico de audio con una configuración específica.
CreateBatchUpdater()	Crea un nuevo Objeto AudioGraphBatchUpdater para AudioGraph , lo que hace que todas las modificaciones posteriores en todos los nodos del grafo de audio se acumularán y, a continuación, se confirmarán una vez que la aplicación se cierre o elimine del objeto de actualizador por lotes.
CreateDeviceInputNodeAsync(MediaCategory)	Crea un AudioDeviceInputNode que introduce datos de audio en el gráfico de audio desde el dispositivo de entrada de audio predeterminado, como un micrófono o una tarjeta de audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)	Crea un AudioDeviceInputNode que introduce datos de audio en el gráfico de audio desde el dispositivo de entrada de audio predeterminado, como un micrófono o una tarjeta de audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)	Crea un AudioDeviceInputNode que introduce datos de audio en el gráfico de audio desde el dispositivo de entrada de audio especificado, como un micrófono o una tarjeta de audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter)	Crea un AudioDeviceInputNode habilitado para audio espacial que introduce datos de audio en el gráfico de audio desde el dispositivo de entrada de audio especificado, como un micrófono o una tarjeta de audio.
CreateDeviceOutputNodeAsync()	Crea un nuevo AudioDeviceOutputNode que genera datos de audio del gráfico de audio en el dispositivo de salida predeterminado del sistema, como altavoces o auriculares.
CreateFileInputNodeAsync(IStorageFile)	Crea un AudioFileInputNode que introduce datos de audio en el grafo de audio desde un archivo de almacenamiento.
CreateFileInputNodeAsync(IStorageFile, AudioNodeEmitter)	Crea un AudioFileInputNode habilitado para audio espacial que introduce datos de audio en el grafo de audio desde un archivo de almacenamiento.
CreateFileOutputNodeAsync(IStorageFile)	Crea un nuevo AudioFileOutputNode que genera datos de audio del grafo de audio en el archivo de almacenamiento especificado.
CreateFileOutputNodeAsync(IStorageFile, MediaEncodingProfile)	Crea un nuevo AudioFileOutuputNode que genera datos de audio del grafo de audio en el archivo de almacenamiento especificado.
CreateFrameInputNode()	Crea un AudioFrameInputNode que introduce los datos de audio generados por el código implementado por la aplicación en el gráfico de audio.
CreateFrameInputNode(AudioEncodingProperties)	Crea un AudioFrameInputNode, con las propiedades de codificación especificadas, que introduce datos de audio generados por el código implementado por la aplicación en el gráfico de audio.
CreateFrameInputNode(AudioEncodingProperties, AudioNodeEmitter)	Crea un AudioFrameInputNode habilitado para audio espacial, con las propiedades de codificación especificadas, que introduce datos de audio generados por el código implementado por la aplicación en el gráfico de audio.
CreateFrameOutputNode()	Crea un nuevo AudioFrameOutputNode que genera datos de audio del grafo de audio al código implementado por la aplicación.
CreateFrameOutputNode(AudioEncodingProperties)	Crea un nuevo AudioFrameOutputNode, con las propiedades de codificación especificadas, que genera datos de audio del grafo de audio al código implementado por la aplicación.
CreateMediaSourceAudioInputNodeAsync(MediaSource)	Crea un MediaSourceAudioInputNode que introduce datos de audio en el gráfico de audio desde el objeto MediaSource proporcionado.
CreateMediaSourceAudioInputNodeAsync(MediaSource, AudioNodeEmitter)	Crea un MediaSourceAudioInputNode habilitado para audio espacial que introduce datos de audio en el gráfico de audio desde el objeto MediaSource proporcionado.
CreateSubmixNode()	Crea un AudioSubmixNode que combina la salida de uno o varios nodos de grafo de audio en una única salida que se puede conectar a nodos de salida u otros nodos de submezcla.
CreateSubmixNode(AudioEncodingProperties)	Crea un AudioSubmixNode que combina la salida de uno o varios nodos de grafo de audio en una única salida que se puede conectar a nodos de salida u otros nodos de submezcla.
CreateSubmixNode(AudioEncodingProperties, AudioNodeEmitter)	Crea un AudioSubmixNode habilitado para audio espacial que mezcla la salida de uno o varios nodos de grafo de audio en una única salida que se puede conectar a los nodos de salida u otros nodos de submezcla.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
ResetAllNodes()	Restablece todos los nodos del gráfico de audio.
Start()	Inicia el gráfico de audio.
Stop()	Detiene el gráfico de audio.

Eventos

QuantumProcessed	Notifica que el gráfico de audio ha procesado el cuántico especificado.
QuantumStarted	Notifica que el grafo de audio ha empezado a procesar un nuevo cuántico.
UnrecoverableErrorOccurred	Notifica un error de audio irrecuperable en la operación del grafo de audio.

Consulte también

• IClosable
• Gráficos de audio
• Ejemplo de AudioGraph