Partager via

Ajouter des améliorations de qualité audio à votre expérience d’appel audio

  • Article

Les capacités de suppression du bruit d'Azure Communication Services peuvent améliorer vos appels audio en filtrant les bruits d’arrière-plan indésirables. La suppression de bruit est une technologie qui supprime les bruits d’arrière-plan des appels audio. L’élimination du bruit d’arrière-plan facilite la conversation et l’écoute. La suppression du bruit peut également réduire les distractions et la fatigue causées par des endroits bruyants. Par exemple, si vous prenez un appel WebJS Azure Communication Services dans un café bruyant, l’activation de la suppression du bruit peut améliorer l’expérience d’appel.

Utilisation des effets audio : installez le package NPM des effets d’appel

Important

Ce tutoriel utilise la version du Kit de développement logiciel (SDK) d’appel Azure Communication Services1.28.4 ou une version ultérieure, ainsi que la version du Kit de développement logiciel (SDK) Effets d’appel Azure Communication Services 1.1.2 ou une version ultérieure. La version stable 1.28.4 de la disponibilité générale (GA) et les versions ultérieures du Kit de développement logiciel (SDK) d’appel prennent en charge les fonctionnalités de suppression du bruit. Par ailleurs, si vous choisissez d’utiliser la version en préversion publique, les versions Kit de développement logiciel (SDK) d’appel 1.24.2-beta.1 et les versions ultérieures prennent également en charge la suppression du bruit.

La prise en charge actuelle du navigateur pour l’ajout d’effets de suppression de bruit audio est disponible uniquement sur les navigateurs bureau Chrome et Edge.

La bibliothèque des effets d’appel ne peut pas être utilisée de manière autonome. Il fonctionne uniquement lorsqu’il est utilisé avec la bibliothèque de client d’appel Azure Communication Services pour WebJS.

Utilisez la commande npm install pour installer le kit de développement logiciel (SDK) Azure Communication Services Audio Effects pour JavaScript.

Si vous utilisez la version en disponibilité générale du Kit de développement logiciel (SDK) d’appel, vous devez utiliser la version en disponibilité générale du kit de développement logiciel (SDK) d’effets d’appel.

@azure/communication-calling-effects/v/latest

Si vous utilisez la préversion publique du Kit de développement logiciel (SDK) d’appel, vous devez utiliser la version bêtadu kit de développement logiciel (SDK) d’effets d’appel.

@azure/communication-calling-effects/v/next

Chargez la bibliothèque des effets de suppression du bruit

Pour plus d’informations sur l’interface qui détaille les propriétés et méthodes des effets audio, consultez la page de documentation de l’API de l’interface de fonctionnalité effets audio.

Pour utiliser des effets audio de suppression de bruit dans le kit de développement logiciel (SDK) d’appel Azure Communication Services, vous devez disposer de la propriété LocalAudioStream qui est actuellement dans l’appel. Vous devez accéder à l’API AudioEffects du LocalAudioStream pour le démarrage et l’arrêt des effets audio.

import * as AzureCommunicationCallingSDK from '@azure/communication-calling'; 
import { DeepNoiseSuppressionEffect } from '@azure/communication-calling-effects'; 

// Get LocalAudioStream from the localAudioStream collection on the call object.
// 'call' here represents the call object.
const localAudioStreamInCall = call.localAudioStreams[0];

// Get the audio effects feature API from LocalAudioStream
const audioEffectsFeatureApi = localAudioStreamInCall.feature(AzureCommunicationCallingSDK.Features.AudioEffects);

// Subscribe to useful events that show audio effects status
audioEffectsFeatureApi.on('effectsStarted', (activeEffects: ActiveAudioEffects) => {
    console.log(`Current status audio effects: ${activeEffects}`);
});


audioEffectsFeatureApi.on('effectsStopped', (activeEffects: ActiveAudioEffects) => {
    console.log(`Current status audio effects: ${activeEffects}`);
});


audioEffectsFeatureApi.on('effectsError', (error: AudioEffectErrorPayload) => {
    console.log(`Error with audio effects: ${error.message}`);
});

Vérifiez les effets audio actifs

Pour vérifier quels effets de suppression de bruit sont actuellement actifs, vous pouvez utiliser la propriété activeEffects.

La propriété activeEffects retourne un objet avec les noms des effets actifs actuels.

// Use the audio effects feature API.
const currentActiveEffects = audioEffectsFeatureApi.activeEffects;

// Create the noise suppression instance.
const deepNoiseSuppression = new DeepNoiseSuppressionEffect();
// We recommend that you check support for the effect in the current environment by using the isSupported API 
// method. Remember that noise supression is only supported on desktop browsers for Chrome and Edge.

const isDeepNoiseSuppressionSupported = await audioEffectsFeatureApi.isSupported(deepNoiseSuppression);
if (isDeepNoiseSuppressionSupported) {
    console.log('Noise supression is supported in local browser environment');
}

// To start Communication Services Deep Noise Suppression
await audioEffectsFeatureApi.startEffects({
    noiseSuppression: deepNoiseSuppression
});

// To stop Communication Services Deep Noise Suppression
await audioEffectsFeatureApi.stopEffects({
    noiseSuppression: true
});

Démarrez un appel avec la suppression de bruit automatiquement activée

Vous pouvez démarrer un appel avec la suppression de bruit activée. Créez une propriété LocalAudioStream avec AudioDeviceInfo (la source LocalAudioStreamne doit pas être une propriété brute MediaStream pour utiliser des effets audio) et passez-la dans CallStartOptions.audioOptions :

// As an example, here we're simply creating LocalAudioStream by using the current selected mic on DeviceManager.
const audioDevice = deviceManager.selectedMicrophone;
const localAudioStreamWithEffects = new AzureCommunicationCallingSDK.LocalAudioStream(audioDevice);
const audioEffectsFeatureApi = localAudioStreamWithEffects.feature(AzureCommunicationCallingSDK.Features.AudioEffects);

// Start effect
await audioEffectsFeatureApi.startEffects({
    noiseSuppression: deepNoiseSuppression
});

// Pass LocalAudioStream in audioOptions in call start/accept options.
await call.startCall({
    audioOptions: {
        muted: false,
        localAudioStreams: [localAudioStreamWithEffects]
    }
});

Activez la suppression du bruit pendant un appel en cours

Vous pouvez démarrer un appel et ne pas activer la suppression du bruit. L’environnement peut devenir bruyant et il est donc nécessaire d’activer la suppression du bruit. Pour activer la suppression du bruit, vous pouvez utiliser l’API audioEffectsFeatureApi.startEffects.

// Create the noise supression instance 
const deepNoiseSuppression = new DeepNoiseSuppressionEffect();

// Get LocalAudioStream from the localAudioStream collection on the call object
// 'call' here represents the call object.
const localAudioStreamInCall = call.localAudioStreams[0];

// Get the audio effects feature API from LocalAudioStream
const audioEffectsFeatureApi = localAudioStreamInCall.feature(AzureCommunicationCallingSDK.Features.AudioEffects);

// We recommend that you check support for the effect in the current environment by using the isSupported method on the feature API. Remember that noise supression is only supported on desktop browsers for Chrome and Edge.
const isDeepNoiseSuppressionSupported = await audioEffectsFeatureApi.isSupported(deepNoiseSuppression);
if (isDeepNoiseSuppressionSupported) {
    console.log('Noise supression is supported in the current browser environment');
}

// To start Communication Services Deep Noise Suppression
await audioEffectsFeatureApi.startEffects({
    noiseSuppression: deepNoiseSuppression
});

// To stop Communication Services Deep Noise Suppression
await audioEffectsFeatureApi.stopEffects({
    noiseSuppression: true
});

Contenu connexe

Consultez la page de la documentation Interface de fonctionnalité des effets audio pour obtenir des détails sur les fonctionnalités de l’API étendue.

Découvrez comment configurer des filtres audio avec les kits de développement logiciel (SDK) d’appel natif

Les effets audio d'Azure Communication Services offrent des filtres qui peuvent améliorer votre appel audio. Pour les plateformes natives (Android, iOS et Windows), vous pouvez configurer les filtres suivants.

Annulation de l’écho

Vous pouvez éliminer l’écho acoustique provoqué par la voix de l’appelant qui se répercute dans le microphone après avoir été émise par le haut-parleur. L’annulation de l’écho garantit une communication claire.

Vous pouvez configurer le filtre avant et pendant un appel. Vous ne pouvez activer ou désactiver l’annulation de l’écho que si le mode musique est activé. Par défaut, ce filtre est activé.

Suppression du bruit

Vous pouvez améliorer la qualité audio en filtrant les bruits de fond indésirables comme la frappe, la climatisation ou les bruits de la rue. Cette technologie garantit une voix claire et nette pour une communication plus efficace.

Vous pouvez configurer le filtre avant et pendant un appel. Les modes actuellement disponibles sont Désactivé, Auto, Baset Élevé. Par défaut, cette fonctionnalité est définie sur le mode Élevé.

Contrôle automatique du gain

Vous pouvez ajuster automatiquement le volume du micro pour garantir des niveaux audio cohérents tout au long de l’appel.

  • Le contrôle de gain automatique analogique est un filtre disponible uniquement avant un appel. Par défaut, ce filtre est activé.
  • Le contrôle de gain automatique numérique est un filtre disponible uniquement avant un appel. Par défaut, ce filtre est activé.

Mode musique

Le mode musique est un filtre disponible avant et pendant un appel. Pour en savoir plus sur le mode musique, consultezMode musique sur le Kit de développement logiciel (SDK) d’appel natif. Le mode musique fonctionne uniquement sur des plateformes natives sur un ou des appels de groupe. Il ne fonctionne pas dans les appels un-à-un entre les plateformes natives et le Web. Par défaut, le mode musique est désactivé.

Prérequis

Installer le SDK

Recherchez votre fichier build.gradle au niveau du projet et ajoutez mavenCentral() à la liste des référentiels sous buildscript et allprojects :

buildscript {
    repositories {
    ...
        mavenCentral()
    ...
    }
}

allprojects {
    repositories {
    ...
        mavenCentral()
    ...
    }
}

Ensuite, dans votre fichier build.gradle au niveau du module, ajoutez les lignes suivantes à la section dependencies :

dependencies {
    ...
    implementation 'com.azure.android:azure-communication-calling:1.0.0'
    ...
}

Initialiser les objets nécessaires

Pour créer une instance CallAgent, vous devez appeler la méthode createCallAgent sur une instance CallClient. Cet appel retourne de façon asynchrone un objet d’instance CallAgent.

La méthode createCallAgent prend CommunicationUserCredential en tant qu’argument, qui encapsule un jeton d’accès.

Pour accéder à DeviceManager, vous devez d’abord créer une instance callAgent. Vous pouvez ensuite utiliser la méthode CallClient.getDeviceManager pour obtenir DeviceManager.

String userToken = '<user token>';
CallClient callClient = new CallClient();
CommunicationTokenCredential tokenCredential = new CommunicationTokenCredential(userToken);
android.content.Context appContext = this.getApplicationContext(); // From within an activity, for instance
CallAgent callAgent = callClient.createCallAgent(appContext, tokenCredential).get();
DeviceManager deviceManager = callClient.getDeviceManager(appContext).get();

Pour définir un nom d’affichage pour l’appelant, utilisez cette autre méthode :

String userToken = '<user token>';
CallClient callClient = new CallClient();
CommunicationTokenCredential tokenCredential = new CommunicationTokenCredential(userToken);
android.content.Context appContext = this.getApplicationContext(); // From within an activity, for instance
CallAgentOptions callAgentOptions = new CallAgentOptions();
callAgentOptions.setDisplayName("Alice Bob");
DeviceManager deviceManager = callClient.getDeviceManager(appContext).get();
CallAgent callAgent = callClient.createCallAgent(appContext, tokenCredential, callAgentOptions).get();

Vous pouvez utiliser la fonctionnalité de filtre audio pour appliquer différentes options de prétraitement audio à l’audio sortant. Les deux types de filtres audio sont OutgoingAudioFilters et LiveOutgoingAudioFilters. Utilisez OutgoingAudioFilters pour modifier les paramètres avant le démarrage de l’appel. Utilisez LiveOutgoingAudioFilters pour modifier les paramètres pendant qu’un appel est en cours.

Vous devez d’abord importer le Kit de développement logiciel (SDK) d’appel et les classes associées :

import com.azure.android.communication.calling.OutgoingAudioOptions;
import com.azure.android.communication.calling.OutgoingAudioFilters;
import com.azure.android.communication.calling.LiveOutgoingAudioFilters;

Avant le démarrage d’un appel

Vous pouvez appliquer OutgoingAudioFilters au démarrage d’un appel.

Commencez par créer une propriété OutgoingAudioFilters et passez-la à OutgoingAudioOptions, comme indiqué dans le code suivant :

OutgoingAudioOptions outgoingAudioOptions = new OutgoingAudioOptions();
OutgoingAudioFilters filters = new OutgoingAudioFilters();
filters.setNoiseSuppressionMode(NoiseSuppressionMode.HIGH);
filters.setAnalogAutomaticGainControlEnabled(true);
filters.setDigitalAutomaticGainControlEnabled(true);
filters.setMusicModeEnabled(true);
filters.setAcousticEchoCancellationEnabled(true); 
outgoingAudioOptions.setAudioFilters(filters);

Pendant l’appel

Vous pouvez appliquer LiveOutgoingAudioFilters après le début d’un appel. Vous pouvez récupérer cet objet auprès de l’objet d’appel pendant l’appel. Pour modifier le paramètre dans LiveOutgoingAudioFilters, définissez les membres à l’intérieur de la classe sur une valeur valide et ils sont appliqués.

Seul un sous-ensemble des filtres disponibles dans OutgoingAudioFilters est disponible pendant un appel actif. Il s’agit du mode musique, de l’annulation de l’écho et du mode de suppression du bruit.

LiveOutgoingAudioFilters filters = call.getLiveOutgoingAudioFilters();
filters.setMusicModeEnabled(false);
filters.setAcousticEchoCancellationEnabled(false);
filters.setNoiseSuppressionMode(NoiseSuppressionMode.HIGH);

Découvrez comment configurer des filtres audio avec les kits de développement logiciel (SDK) d’appel natif

Les effets audio d'Azure Communication Services offrent des filtres qui peuvent améliorer votre appel audio. Pour les plateformes natives (Android, iOS et Windows), vous pouvez configurer les filtres suivants.

Annulation de l’écho

Vous pouvez éliminer l’écho acoustique provoqué par la voix de l’appelant qui se répercute dans le microphone après avoir été émise par le haut-parleur. L’annulation de l’écho garantit une communication claire.

Vous pouvez configurer le filtre avant et pendant un appel. Vous ne pouvez activer ou désactiver l’annulation de l’écho que si le mode musique est activé. Par défaut, ce filtre est activé.

Suppression du bruit

Vous pouvez améliorer la qualité audio en filtrant les bruits de fond indésirables comme la frappe, la climatisation ou les bruits de la rue. Cette technologie garantit une voix claire et nette pour une communication plus efficace.

Vous pouvez configurer le filtre avant et pendant un appel. Les modes actuellement disponibles sont Désactivé, Auto, Baset Élevé. Par défaut, cette fonctionnalité est définie sur le mode Élevé.

Contrôle automatique du gain

Vous pouvez ajuster automatiquement le volume du micro pour garantir des niveaux audio cohérents tout au long de l’appel.

  • Le contrôle de gain automatique analogique est un filtre disponible uniquement avant un appel. Par défaut, ce filtre est activé.
  • Le contrôle de gain automatique numérique est un filtre disponible uniquement avant un appel. Par défaut, ce filtre est activé.

Mode musique

Le mode musique est un filtre disponible avant et pendant un appel. Pour en savoir plus sur le mode musique, consultezMode musique sur le Kit de développement logiciel (SDK) d’appel natif. Le mode musique fonctionne uniquement sur des plateformes natives sur un ou des appels de groupe. Il ne fonctionne pas dans les appels un-à-un entre les plateformes natives et le Web. Par défaut, le mode musique est désactivé.

Prérequis

Configurer votre système

Effectuez les étapes suivantes pour configurer votre système.

Créer le projet Xcode

Dans Xcode, créez un projet iOS et sélectionnez le modèle Single View App. Cet article utilise l’infrastructure SwiftUI. Vous devez donc définir Langage sur Swift et Interface sur SwiftUI.

Vous n’allez pas créer de tests dans cet article. N’hésitez pas à désactiver la case Inclure des tests.

Capture d’écran montrant la fenêtre de création d’un projet dans Xcode.

Installer le package et les dépendances à l’aide de CocoaPods

  1. Créez un Podfile pour votre application, comme cet exemple :

    platform :ios, '13.0'
use_frameworks!
target 'AzureCommunicationCallingSample' do
    pod 'AzureCommunicationCalling', '~> 1.0.0'
end

  2. Exécutez pod install.

  3. Ouvrez .xcworkspace en utilisant Xcode.

Demander l’accès au microphone

Pour accéder au microphone de l’appareil, vous devez mettre à jour la liste des propriétés d’informations de votre application à l’aide de NSMicrophoneUsageDescription. Définissez la valeur associée à une chaîne qui est incluse dans la boîte de dialogue utilisée par le système pour demander l’accès à l’utilisateur.

Cliquez avec le bouton droit sur l’entrée Info.plist de l’arborescence du projet, puis sélectionnez Ouvrir en tant que>Code source. Ajoutez les lignes suivantes à la section <dict> tout en haut, puis enregistrez le fichier.

<key>NSMicrophoneUsageDescription</key>
<string>Need microphone access for VOIP calling.</string>

Configurer le framework d’application

Ouvrez le fichier ContentView.swift de votre projet. Ajoutez une déclaration import en haut du fichier pour importer la bibliothèque AzureCommunicationCalling. En outre, importez AVFoundation. Vous en avez besoin pour les demandes d’autorisations audio dans le code.

import AzureCommunicationCalling
import AVFoundation

Initialiser CallAgent

Pour créer une instance de CallAgent à partir de CallClient, vous devez utiliser une méthode callClient.createCallAgent qui retourne de manière asynchrone un objet CallAgent après qu’il a été initialisé.

Pour créer un client d’appel, transmettez un objet CommunicationTokenCredential :

import AzureCommunication

let tokenString = "token_string"
var userCredential: CommunicationTokenCredential?
do {
    let options = CommunicationTokenRefreshOptions(initialToken: token, refreshProactively: true, tokenRefresher: self.fetchTokenSync)
    userCredential = try CommunicationTokenCredential(withOptions: options)
} catch {
    updates("Couldn't created Credential object", false)
    initializationDispatchGroup!.leave()
    return
}

// tokenProvider needs to be implemented by Contoso, which fetches a new token
public func fetchTokenSync(then onCompletion: TokenRefreshOnCompletion) {
    let newToken = self.tokenProvider!.fetchNewToken()
    onCompletion(newToken, nil)
}

Transmettez l’objet CommunicationTokenCredential que vous avez créé à CallClient et définissez le nom complet :

self.callClient = CallClient()
let callAgentOptions = CallAgentOptions()
options.displayName = " iOS Azure Communication Services User"

self.callClient!.createCallAgent(userCredential: userCredential!,
    options: callAgentOptions) { (callAgent, error) in
        if error == nil {
            print("Create agent succeeded")
            self.callAgent = callAgent
        } else {
            print("Create agent failed")
        }
})

Vous pouvez utiliser la fonctionnalité de filtre audio pour appliquer différentes options de prétraitement audio à l’audio sortant. Les deux types de filtres audio sont OutgoingAudioFilters et LiveOutgoingAudioFilters. Utilisez OutgoingAudioFilters pour modifier les paramètres avant le démarrage de l’appel. Utilisez LiveOutgoingAudioFilters pour modifier les paramètres pendant qu’un appel est en cours.

Vous devez d’abord importer le Kit de développement logiciel (SDK) Calling :

import AzureCommunicationCalling

Avant le démarrage de l’appel

Vous pouvez appliquer OutgoingAudioFilters au démarrage d’un appel.

Commencez par créer une propriété OutgoingAudioFilters et passez-la dans OutgoingAudioOptions, comme indiqué ici :

let outgoingAudioOptions = OutgoingAudioOptions()
let filters = OutgoingAudioFilters()
filters.NoiseSuppressionMode = NoiseSuppressionMode.high
filters.analogAutomaticGainControlEnabled = true
filters.digitalAutomaticGainControlEnabled = true
filters.musicModeEnabled = true
filters.acousticEchoCancellationEnabled = true
outgoingAudioOptions.audioFilters = filters

Pendant l’appel

Vous pouvez appliquer LiveOutgoingAudioFilters après le début d’un appel. Vous pouvez récupérer cet objet auprès de l’objet d’appel pendant l’appel. Pour modifier le paramètre dans LiveOutgoingAudioFilters, définissez les membres à l’intérieur de la classe sur une valeur valide et ils sont appliqués.

Seul un sous-ensemble des filtres disponibles dans OutgoingAudioFilters est disponible pendant un appel actif. Il s’agit du mode musique, de l’annulation de l’écho et du mode de suppression du bruit.

LiveOutgoingAudioFilters filters = call.liveOutgoingAudioFilters
filters.musicModeEnabled = true
filters.acousticEchoCancellationEnabled = true
filters.NoiseSuppressionMode = NoiseSuppressionMode.high

Découvrez comment configurer des filtres audio avec les kits de développement logiciel (SDK) d’appel natif

Les effets audio d'Azure Communication Services offrent des filtres qui peuvent améliorer votre appel audio. Pour les plateformes natives (Android, iOS et Windows), vous pouvez configurer les filtres suivants.

Annulation de l’écho

Vous pouvez éliminer l’écho acoustique provoqué par la voix de l’appelant qui se répercute dans le microphone après avoir été émise par le haut-parleur. L’annulation de l’écho garantit une communication claire.

Vous pouvez configurer le filtre avant et pendant un appel. Vous ne pouvez activer ou désactiver l’annulation de l’écho que si le mode musique est activé. Par défaut, ce filtre est activé.

Suppression du bruit

Vous pouvez améliorer la qualité audio en filtrant les bruits de fond indésirables comme la frappe, la climatisation ou les bruits de la rue. Cette technologie garantit une voix claire et nette pour une communication plus efficace.

Vous pouvez configurer le filtre avant et pendant un appel. Les modes actuellement disponibles sont Désactivé, Auto, Baset Élevé. Par défaut, cette fonctionnalité est définie sur le mode Élevé.

Contrôle automatique du gain

Vous pouvez ajuster automatiquement le volume du micro pour garantir des niveaux audio cohérents tout au long de l’appel.

  • Le contrôle de gain automatique analogique est un filtre disponible uniquement avant un appel. Par défaut, ce filtre est activé.
  • Le contrôle de gain automatique numérique est un filtre disponible uniquement avant un appel. Par défaut, ce filtre est activé.

Mode musique

Le mode musique est un filtre disponible avant et pendant un appel. Pour en savoir plus sur le mode musique, consultezMode musique sur le Kit de développement logiciel (SDK) d’appel natif. Le mode musique fonctionne uniquement sur des plateformes natives sur un ou des appels de groupe. Il ne fonctionne pas dans les appels un-à-un entre les plateformes natives et le Web. Par défaut, le mode musique est désactivé.

Prérequis

Configurer votre système

Effectuez les étapes suivantes pour configurer votre système.

Créer le projet Visual Studio

Pour une application de plateforme Windows universelle, dans Visual Studio 2022, créez un projet Application vide (Windows universel). Après avoir entré le nom du projet, n’hésitez pas à choisir un kit de développement logiciel (SDK) Windows d’une version ultérieure à 10.0.17763.0.

Pour une application WinUI 3, créez un projet avec le modèle Application vide, Empaquetée (WinUI 3 dans Desktop) pour configurer une application WinUI 3 monopage. Le SDK d’application Windows version 1.3 ou ultérieure est nécessaire.

Installer le package et les dépendances à l’aide du Gestionnaire de package NuGet

Les API et les bibliothèques du Kit de développement logiciel (SDK) Appel sont accessibles au public via un package NuGet.

Pour rechercher, télécharger et installer le package NuGet du SDK d’appel :

  1. Ouvrez le Gestionnaire de package NuGet en sélectionnant Outils>Gestionnaire de package NuGet>Gérer les packages NuGet pour la solution.
  2. Sélectionnez Parcourir, puis entrez Azure.Communication.Calling.WindowsClient dans la zone de recherche.
  3. Vérifiez que la case Inclure la préversion est cochée.
  4. Sélectionnez le package Azure.Communication.Calling.WindowsClient, puis Azure.Communication.Calling.WindowsClient 1.4.0-beta.1 ou une version plus récente.
  5. Cochez la case qui correspond au projet Azure Communication Services dans le volet de droite.
  6. Sélectionnez Installer.

La fonctionnalité de filtre audio vous permet d’appliquer différents prétraitements audio à l’audio sortant. Les deux types de filtres audio sont OutgoingAudioFilters et LiveOutgoingAudioFilters. Utilisez OutgoingAudioFilters pour modifier les paramètres avant le démarrage de l’appel. Utilisez LiveOutgoingAudioFilters pour modifier les paramètres pendant qu’un appel est en cours.

Vous devez d’abord importer le Kit de développement logiciel (SDK) Calling :

using Azure.Communication;
using Azure.Communication.Calling.WindowsClient;

Avant le démarrage d’un appel

Vous pouvez appliquer OutgoingAudioFilters au démarrage d’un appel.

Commencez par créer une propriété OutgoingAudioFilters et passez-la dans OutgoingAudioOptions, comme indiqué dans le code suivant :

var outgoingAudioOptions = new OutgoingAudioOptions();
var filters = new OutgoingAudioFilters()
{
    AnalogAutomaticGainControlEnabled = true,
    DigitalAutomaticGainControlEnabled = true,
    MusicModeEnabled = true,
    AcousticEchoCancellationEnabled = true,
    NoiseSuppressionMode = NoiseSuppressionMode.High
};
outgoingAudioOptions.Filters = filters;

Pendant l’appel

Vous pouvez appliquer LiveOutgoingAudioFilters après le début d’un appel. Vous pouvez récupérer cet objet à partir de l’objet de l’appel après le démarrage de l’appel. Pour modifier le paramètre dans LiveOutgoingAudioFilters, définissez les membres à l’intérieur de la classe sur une valeur valide et ils sont appliqués.

Seul un sous-ensemble des filtres disponibles dans OutgoingAudioFilters est disponible pendant un appel actif. Il s’agit du mode musique, de l’annulation de l’écho et du mode de suppression du bruit.

LiveOutgoingAudioFilters filter = call.LiveOutgoingAudioFilters;
filter.MusicModeEnabled = true;
filter.AcousticEchoCancellationEnabled = true;
filter.NoiseSuppressionMode = NoiseSuppressionMode.Auto;