AudioGraph Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.IDisposablePublic NotInheritable Class AudioGraph
Implements IDisposable- Héritage
- 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. |