AudioGraph Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.IDisposablePublic NotInheritable Class AudioGraph
Implements IDisposable- Herencia
- Atributos
- Implementaciones
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. |