Partager via


AudioGraph Classe

Définition

Représente un graphique audio de nœuds d’entrée, de sortie et de sous-mix connectés qui manipulent et acheminent 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
Héritage
Object Platform::Object IInspectable AudioGraph
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application
backgroundMediaRecording

Remarques

Le graphique audio est constitué de nœuds d’entrée, de nœuds de sortie et de nœuds de sous-mixage. Les nœuds d’entrée incluent des fichiers audio, des périphériques audio et du code qui génère des données audio. Les nœuds de sortie incluent également des fichiers audio, des périphériques audio et du code qui traite les données audio. Lorsque le graphique est démarré, les données audio circulent à travers le graphe à partir des nœuds d’entrée, via tous les nœuds de sous-mélange, vers les nœuds de sortie. Chaque nœud peut avoir zéro ou plusieurs effets audio qui sont appliqués aux données audio avant qu’elles ne soient passées au nœud suivant. Cette classe et les API associées vous permettent de développer des applications audio plus rapidement et facilement que les API COM XAudio2 de bas niveau. Pour obtenir des conseils pratiques sur l’utilisation des graphiques audio, consultez Graphiques audio.

Obtenez un instance de cette classe en appelant AudioGraph.CreateAsync.

L’intégralité du graphique audio doit fonctionner à la même fréquence d’échantillonnage. Les sources peuvent avoir des taux d’échantillonnage différents, mais sont rééchantillonnées immédiatement.

Notes

Si aucun périphérique audio n’est disponible, le graphique audio ne peut pas être instancié.

AudioGraph ne peut pas être instancié sur les éditions N et KN de Windows 8 et Windows 10, sauf si le feature pack multimédia facultatif a été installé. Pour plus d’informations, consultez Media Feature Pack pour les éditions De Windows N.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
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)

Propriétés

CompletedQuantumCount

Obtient le nombre quantique terminé pour le graphique audio.

EncodingProperties

Obtient les propriétés d’encodage du graphique audio.

LatencyInSamples

Obtient la latence dans les exemples que le graphique audio prend en charge.

PrimaryRenderDevice

Obtient le périphérique de rendu principal pour le graphique audio.

RenderDeviceAudioProcessing

Obtient une valeur qui indique le mode de traitement audio pour le graphique audio.

SamplesPerQuantum

Obtient le nombre d’exemples par quantum auquel le graphique audio fonctionne actuellement.

Méthodes

Close()

Ferme le graphique audio et supprime les ressources associées.

CreateAsync(AudioGraphSettings)

Crée un graphique audio avec des paramètres spécifiques.

CreateBatchUpdater()

Crée un fichier AudioGraphBatchUpdater pour AudioGraph , ce qui entraîne l’accumulation de toutes les modifications ultérieures apportées à tous les nœuds du graphe audio, puis la validation une fois que votre application a fermé ou supprimé l’objet de mise à jour par lot.

CreateDeviceInputNodeAsync(MediaCategory)

Crée un élément AudioDeviceInputNode qui entre des données audio dans le graphique audio à partir du périphérique d’entrée audio par défaut, tel qu’un microphone ou un carte audio.

CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)

Crée un élément AudioDeviceInputNode qui entre des données audio dans le graphique audio à partir du périphérique d’entrée audio par défaut, tel qu’un microphone ou un carte audio.

CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)

Crée un AudioDeviceInputNode qui entre des données audio dans le graphique audio à partir du périphérique d’entrée audio spécifié, tel qu’un microphone ou un carte audio.

CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter)

Crée un audio spatial AudioDeviceInputNode qui entre des données audio dans le graphique audio à partir du périphérique d’entrée audio spécifié, tel qu’un microphone ou un carte audio.

CreateDeviceOutputNodeAsync()

Crée un nouvel objet AudioDeviceOutputNode qui génère des données audio du graphique audio vers le périphérique de sortie par défaut du système, tel que les haut-parleurs ou les écouteurs.

CreateFileInputNodeAsync(IStorageFile)

Crée un fichier AudioFileInputNode qui entre des données audio dans le graphique audio à partir d’un fichier de stockage.

CreateFileInputNodeAsync(IStorageFile, AudioNodeEmitter)

Crée un AudioFileInputNode prenant en charge l’audio spatial qui entre des données audio dans le graphique audio à partir d’un fichier de stockage.

CreateFileOutputNodeAsync(IStorageFile)

Crée un fichier AudioFileOutputNode qui génère des données audio du graphique audio vers le fichier de stockage spécifié.

CreateFileOutputNodeAsync(IStorageFile, MediaEncodingProfile)

Crée un fichier AudioFileOutuputNode qui génère des données audio du graphique audio vers le fichier de stockage spécifié.

CreateFrameInputNode()

Crée un AudioFrameInputNode qui entre les données audio générées par le code implémenté par l’application dans le graphique audio.

CreateFrameInputNode(AudioEncodingProperties)

Crée un AudioFrameInputNode, avec les propriétés d’encodage spécifiées, qui entre les données audio générées par le code implémenté par l’application dans le graphique audio.

CreateFrameInputNode(AudioEncodingProperties, AudioNodeEmitter)

Crée un AudioFrameInputNode prenant en charge l’audio spatial, avec les propriétés d’encodage spécifiées, qui entre les données audio générées par le code implémenté par l’application dans le graphique audio.

CreateFrameOutputNode()

Crée un fichier AudioFrameOutputNode qui génère des données audio à partir du graphique audio vers du code implémenté par l’application.

CreateFrameOutputNode(AudioEncodingProperties)

Crée un fichier AudioFrameOutputNode, avec les propriétés d’encodage spécifiées, qui génère des données audio du graphique audio vers le code implémenté par l’application.

CreateMediaSourceAudioInputNodeAsync(MediaSource)

Crée un Objet MediaSourceAudioInputNode qui entre des données audio dans le graphique audio à partir de l’objet MediaSource fourni.

CreateMediaSourceAudioInputNodeAsync(MediaSource, AudioNodeEmitter)

Crée un MediaSourceAudioInputNode prenant en charge l’audio spatial qui entre des données audio dans le graphique audio à partir de l’objet MediaSource fourni.

CreateSubmixNode()

Crée un AudioSubmixNode qui combine la sortie d’un ou de plusieurs nœuds de graphique audio en une seule sortie qui peut être connectée à des nœuds de sortie ou à d’autres nœuds de sous-mélange.

CreateSubmixNode(AudioEncodingProperties)

Crée un AudioSubmixNode qui combine la sortie d’un ou de plusieurs nœuds de graphique audio en une seule sortie qui peut être connectée à des nœuds de sortie ou à d’autres nœuds de sous-mélange.

CreateSubmixNode(AudioEncodingProperties, AudioNodeEmitter)

Crée un audiosubmixNode spatial qui mélange la sortie d’un ou de plusieurs nœuds de graphique audio en une seule sortie qui peut être connectée à des nœuds de sortie ou à d’autres nœuds de sous-mélange.

Dispose()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.

ResetAllNodes()

Réinitialise tous les nœuds dans le graphique audio.

Start()

Démarre le graphique audio.

Stop()

Arrête le graphique audio.

Événements

QuantumProcessed

Avertit que le graphique audio a traité le quantum spécifié.

QuantumStarted

Avertit que le graphique audio a commencé à traiter un nouveau quantum.

UnrecoverableErrorOccurred

Avertit d’une erreur audio irrécupérable dans l’opération de graphique audio.

S’applique à

Voir aussi