Encodeur AAC et sortie M4A¶

Video Capture SDK .Net Video Edit SDK .Net Media Blocks SDK .Net

Le SDK VisioForge fournit plusieurs implémentations d'encodeurs AAC, chacune avec des caractéristiques et des cas d'usage spécifiques.

Qu'est-ce que la sortie M4A ?¶

M4A est un format de fichier utilisé pour stocker des données audio encodées avec le codec Advanced Audio Coding (AAC). Les SDK VisioForge .Net offrent une prise en charge robuste pour la création de fichiers audio M4A de haute qualité via leur classe dédiée M4AOutput. Ce format est largement utilisé pour la distribution audio numérique grâce à son excellente efficacité de compression et à sa qualité sonore.

Sortie M4A (AAC) multiplateforme¶

VideoCaptureCoreX VideoEditCoreX MediaBlocksPipeline

Les SDK avec capacités multiplateformes (VideoCaptureCoreX, VideoEditCoreX, MediaBlocksPipeline) permettent d'utiliser plusieurs implémentations d'encodeurs AAC via M4AOutput. Ce guide se concentre sur trois approches principales utilisant des objets de paramètres dédiés :

1. Encodeur AVENC AAC - Un encodeur multiplateforme riche en fonctionnalités.
2. Encodeur VO-AAC - Un encodeur multiplateforme simplifié.
3. Encodeur AAC Media Foundation - Un encodeur système spécifique à Windows, accessible sur les plateformes Windows via MFAACEncoderSettings.

Encodeur AVENC AAC¶

L'encodeur AVENC AAC offre les options de configuration les plus complètes pour l'encodage audio. Il fournit des paramètres avancés pour le codage stéréo, la prédiction et le modelage du bruit.

Caractéristiques principales¶

• Stratégies de codeur multiples
• Codage stéréo configurable
• Techniques avancées de bruit et de prédiction

Stratégies de codeur¶

L'encodeur AVENC AAC prend en charge trois stratégies de codeur :

• ANMR : Méthode avancée de modélisation et de réduction du bruit
• TwoLoop : Méthode de recherche à deux boucles pour l'optimisation
• Fast : Algorithme de recherche rapide par défaut (recommandé pour la plupart des cas d'usage)

Exemple de configuration¶

var aacSettings = new AVENCAACEncoderSettings
{
    Coder = AVENCAACEncoderCoder.Fast,
    Bitrate = 192,
    IntensityStereo = true,
    ForceMS = AVENCAACTrilian.Auto,
    TNS = true
};

Paramètres pris en charge¶

• Débits : 0, 32, 64, 96, 128, 160, 192, 224, 256, 320 kbps
• Fréquences d'échantillonnage : 7350 à 96000 Hz
• Canaux : 1 à 6 canaux

Encodeur VO-AAC¶

L'encodeur VO-AAC est un encodeur plus simplifié avec des options de configuration plus simples.

Caractéristiques principales¶

• Configuration simplifiée
• Contrôles directs du débit et de la fréquence d'échantillonnage
• Limité à l'audio stéréo

Exemple de configuration¶

var aacSettings = new VOAACEncoderSettings
{
    Bitrate = 128
};

Paramètres pris en charge¶

• Débits : 32, 64, 96, 128, 160, 192, 224, 256, 320 kbps
• Fréquences d'échantillonnage : 8000 à 96000 Hz
• Canaux : 1-2 canaux

Encodeur AAC Media Foundation (Windows uniquement)¶

Cet encodeur est spécifique aux plateformes Windows et offre une solution d'encodage limitée mais optimisée pour les performances.

Caractéristiques principales¶

• Implémentation spécifique à Windows
• Options de débit prédéfinies
• Prise en charge limitée des fréquences d'échantillonnage

Paramètres pris en charge¶

• Débits : 0 (Auto), 96, 128, 160, 192, 576, 768, 960, 1152 kbps
• Fréquences d'échantillonnage : 44100, 48000 Hz
• Canaux : 1, 2, 6 canaux

Disponibilité et sélection de l'encodeur¶

Chaque encodeur fournit une méthode statique IsAvailable() pour vérifier s'il peut être utilisé dans l'environnement courant. C'est utile pour les vérifications de compatibilité à l'exécution.

if (AVENCAACEncoderSettings.IsAvailable())
{
    // Utiliser l'encodeur AVENC AAC
}
else if (VOAACEncoderSettings.IsAvailable())
{
    // Solution de repli vers l'encodeur VO-AAC
}

Prise en main de M4AOutput¶

L'implémentation multiplateforme utilise la classe M4AOutput comme base pour la création de fichiers M4A. Pour commencer à utiliser cette fonctionnalité, initialisez la classe avec le nom de fichier de sortie souhaité :

var output = new M4AOutput("output.m4a");

Basculement entre encodeurs¶

La sélection par défaut de l'encodeur dépend de la plateforme :

• Environnements Windows : MF AAC
• Autres plateformes : VO-AAC

Vous pouvez remplacer cette sélection par défaut en définissant explicitement la propriété Audio :

// Pour l'encodeur VO-AAC
output.Audio = new VOAACEncoderSettings();

// Pour l'encodeur AVENC AAC
output.Audio = new AVENCAACEncoderSettings();

// Pour l'encodeur MF AAC (Windows uniquement)
#if NET_WINDOWS
output.Audio = new MFAACEncoderSettings();
#endif

Configuration des paramètres du puits MP4¶

Comme les fichiers M4A reposent sur le format de conteneur MP4, vous pouvez ajuster divers paramètres de sortie via la propriété Sink :

// Modifier le nom de fichier de sortie
output.Sink.Filename = "new_output.m4a";

Traitement audio avancé¶

Pour les flux de travail nécessitant un traitement audio spécialisé, la classe M4AOutput prend en charge des processeurs audio personnalisés :

// Implémentez votre logique de traitement audio personnalisée
output.CustomAudioProcessor = new MyCustomAudioProcessor(); 

Méthodes clés pour la gestion des fichiers¶

La classe M4AOutput fournit plusieurs méthodes pour gérer les fichiers et récupérer des informations sur l'encodeur :

// Obtenir le nom de fichier de sortie actuel
string currentFile = output.GetFilename();

// Mettre à jour le nom de fichier de sortie
output.SetFilename("updated_file.m4a");

// Récupérer les encodeurs audio disponibles
var audioEncoders = output.GetAudioEncoders();

Utilisation de la sortie M4A dans différents SDK¶

Chaque SDK VisioForge a une approche légèrement différente pour implémenter la sortie M4A :

Avec Video Capture SDK¶

var core = new VideoCaptureCoreX();
core.Outputs_Add(output, true);

Avec Video Edit SDK¶

var core = new VideoEditCoreX();
core.Output_Format = output;

Avec Media Blocks SDK¶

var aac = new VOAACEncoderSettings();
var sinkSettings = new MP4SinkSettings("output.m4a");
var m4aOutput = new M4AOutputBlock(sinkSettings, aac);

Considérations sur le contrôle de débit¶

1. Encodeur AVENC AAC :
2. Contrôle de débit le plus flexible
3. Prend en charge le débit constant (CBR)

4. Plusieurs stratégies d'encodage affectent la qualité et les performances

5. Encodeur VO-AAC :

6. Contrôle simple de débit constant
7. Recommandé pour les besoins d'encodage simples

8. Configuration avancée limitée

9. Encodeur Media Foundation :

10. Limité à des débits prédéfinis
11. Bon pour un encodage rapide basé sur Windows
12. Option de débit automatique disponible

Recommandations¶

• Pour l'encodage audio avancé avec un contrôle maximal, utilisez l'encodeur AVENC AAC
• Pour un encodage simple et multiplateforme, utilisez l'encodeur VO-AAC
• Pour un encodage optimisé spécifique à Windows, utilisez l'encodeur Media Foundation

Considérations de performance et de qualité¶

• Débit vs qualité vs taille de fichier : Des débits plus élevés produisent généralement une meilleure qualité audio mais aboutissent également à des fichiers plus volumineux. Expérimentez avec différents débits pour trouver l'équilibre optimal pour votre contenu spécifique et vos besoins de distribution.
• Correspondance de la fréquence d'échantillonnage : Essayez toujours de choisir des fréquences d'échantillonnage qui correspondent à votre audio source. Cela évite un rééchantillonnage inutile, qui peut potentiellement dégrader la qualité audio.
• Caractéristiques des encodeurs :
• Encodeur AVENC AAC : Offre les options de configuration les plus étendues, permettant un contrôle fin de la qualité et des performances. Idéal pour les cas d'usage avancés.
• Encodeur VO-AAC : Offre un bon équilibre entre simplicité, compatibilité multiplateforme et qualité. Un choix solide pour de nombreux scénarios courants.
• Encodeur AAC Media Foundation : Tire parti des capacités de traitement audio intégrées à Windows. Il peut être efficace sur Windows mais offre moins de flexibilité de configuration qu'AVENC.
• Configuration des canaux (mono vs stéréo) :
• Pour le contenu vocal uniquement, l'utilisation de l'encodage mono (1 canal) peut réduire significativement la taille du fichier sans perte notable de qualité pour la parole. Vérifiez si les paramètres de l'encodeur choisi (par ex. AVENCAACEncoderSettings.Channels) autorisent une configuration explicite des canaux.
• Pour la musique et les environnements audio riches, la stéréo (2 canaux) est généralement préférée.
• Plages de débit selon le contenu : Si plus élevé est souvent meilleur, le « meilleur » débit dépend du contenu audio :
• Parole/voix : 64-96 kbps peut suffire.
• Musique générale : 128-192 kbps est une cible courante pour une bonne qualité.
• Audio haute fidélité : 256-320 kbps ou plus peut être utilisé lorsque la qualité immaculée est critique. Ces valeurs sont indicatives ; testez toujours avec votre audio spécifique.
• Audience cible et plateforme : Tenez compte de qui écoutera et sur quels appareils. Par exemple, si l'audio est principalement destiné au streaming web vers des appareils mobiles, des débits extrêmement élevés pourraient entraîner des problèmes de mise en mémoire tampon ou une consommation de données inutile. Adaptez votre choix d'encodeur et vos paramètres en conséquence.

Exemple de code¶

• Consultez le guide sortie MP4 pour des exemples de code.
• Consultez le bloc d'encodeur AAC pour des exemples de code.

Sortie AAC Windows uniquement¶

VideoCaptureCore VideoEditCore

M4AOutput est la classe principale pour configurer les paramètres de sortie M4A (AAC). Elle implémente à la fois les interfaces IVideoEditBaseOutput et IVideoCaptureBaseOutput.

Propriétés¶

Méthodes¶

GetInternalTypeVC()¶

• Retour : VideoCaptureOutputFormat.M4A
• Objectif : Obtient le format de sortie interne pour la capture vidéo

GetInternalTypeVE()¶

• Retour : VideoEditOutputFormat.M4A
• Objectif : Obtient le format de sortie interne pour l'édition vidéo

Save()¶

• Retour : Représentation JSON de l'objet M4AOutput sous forme de chaîne
• Objectif : Sérialise la configuration actuelle en JSON

Load(string json)¶

• Paramètres : Chaîne JSON contenant la configuration M4AOutput
• Retour : Nouvelle instance M4AOutput
• Objectif : Crée une nouvelle instance M4AOutput à partir d'une configuration JSON

Énumérations associées¶

AACVersion¶

Définit la version AAC à utiliser :

AACObject¶

Spécifie le type d'objet de flux de l'encodeur AAC :

AACOutput¶

Détermine le type de sortie du flux de l'encodeur AAC :

Exemple d'utilisation¶

// Créer une nouvelle configuration de sortie M4A
var core = new VideoCaptureCore();
core.Mode = VideoCaptureMode.VideoCapture;
core.Output_Filename = "output.m4a";

var output = new M4AOutput
{
    Bitrate = 192,
    Version = AACVersion.MPEG4,
    Object = AACObject.Low,
    Output = AACOutput.ADTS
};

core.Output_Format = output; // core est une instance de VideoCaptureCore ou VideoEditCore

Choisir le bon débit¶

Le débit optimal dépend du type de contenu et des exigences de qualité :

• 64-96 kbps : Convient aux enregistrements vocaux et au contenu parlé
• 128-192 kbps : Recommandé pour la musique générale et le contenu audio
• 256-320 kbps : Idéal pour la musique haute fidélité où la qualité est primordiale

Choix du profil approprié¶

• Utilisez AACObject.Low pour la plupart des applications car il offre un excellent équilibre entre qualité et efficacité d'encodage
• Réservez AACObject.Main aux cas d'usage spécialisés nécessitant une qualité maximale
• Évitez AACObject.Undefined car ce n'est pas une option d'encodage valide

Choix du format de conteneur¶

• AACOutput.ADTS offre une meilleure compatibilité avec divers lecteurs et appareils
• AACOutput.RAW est préférable lorsque le flux AAC sera intégré dans un autre format de conteneur