class Audio ::AudioProcessingOptions

Représente les options de traitement audio utilisées avec la classe de configuration audio.

Membres

AudioProcessingOptions

Syntaxe : public inline explicit AudioProcessingOptions ( SPXAUDIOPROCESSINGOPTIONSHANDLE hoptions );

Crée une instance à l’aide du handle fourni.

Paramètres

  • hoptions Un handle vers les options de traitement audio.

~AudioProcessingOptions

Syntaxe : public ~AudioProcessingOptions ( ) = default;

Destructeur une instance de la classe AudioProcessingOptions.

opérateur SPXAUDIOPROCESSINGOPTIONSHANDLE

Syntaxe : public inline explicit operator SPXAUDIOPROCESSINGOPTIONSHANDLE ( ) const;

Opérateur interne utilisé pour obtenir la valeur de handle sous-jacente.

Retours

Un handle.

GetAudioProcessingFlags

Syntaxe : public inline int GetAudioProcessingFlags ( ) const;

Retourne le type de traitement audio effectué par le Kit de développement logiciel (SDK) Speech.

Retours

Or au niveau du bit des indicateurs de constante AUDIO_INPUT_PROCESSING_XXX indiquant le traitement audio d’entrée effectué par le SDK Speech.

GetPresetMicrophoneArrayGeometry

Syntaxe : public inline PresetMicrophoneArrayGeometry GetPresetMicrophoneArrayGeometry ( ) const;

Retourne la géométrie de tableau de microphones du microphone utilisé pour l’entrée audio.

Retours

Valeur de type PresetMicrophoneArrayGeometry enum.

GetMicrophoneArrayType

Syntaxe : public inline MicrophoneArrayType GetMicrophoneArrayType ( ) const;

Retourne le type de tableau de microphones utilisé pour l’entrée audio.

Retours

Valeur de type Énumération MicrophoneArrayType.

GetBeamformingStartAngle

Syntaxe : public inline uint16_t GetBeamformingStartAngle ( ) const;

Retourne l’angle de début utilisé pour la formation de faisceaux.

Retours

Angle de début du faisceau.

GetBeamformingEndAngle

Syntaxe : public inline uint16_t GetBeamformingEndAngle ( ) const;

Retourne l’angle de fin utilisé pour la formation de faisceaux.

Retours

Angle de fin du faisceau.

GetMicrophoneCoordinates

Syntaxe : public inline std::vector< MicrophoneCoordinates > GetMicrophoneCoordinates ( ) const;

Retourne les coordonnées des microphones dans le tableau de microphones utilisés pour l’entrée audio.

Retours

Vecteur std ::vector des éléments MicrophoneCoordinates.

GetSpeakerReferenceChannel

Syntaxe : public inline SpeakerReferenceChannel GetSpeakerReferenceChannel ( ) const;

Retourne la position du canal de référence de l’orateur dans l’entrée audio.

Retours

Valeur de type Enum SpeakerReferenceChannel.

GetSpeakerSignature

Syntaxe : public inline std::vector< float > GetSpeakerSignature ( ) const;

Récupère la signature du haut-parleur si elle est présente. Retourne un vecteur vide lorsqu’il est dédéfini. Réservé aux applications first-party Microsoft.

Retours

Un vecteur std ::de flottants contenant la signature du haut-parleur (128 flottants), ou un vecteur vide s’il n’est pas défini.

SetProperty

Syntaxe : public inline void SetProperty ( const std::string & name , const std::string & value );

Définit une valeur de propriété par nom.

Paramètres

  • name Le nom de la propriété.

  • value Valeur de la propriété.

SetProperty

Syntaxe : public inline void SetProperty ( PropertyId id , const std::string & value );

Définit une valeur de propriété par ID.

Paramètres

  • id l’ID de propriété.

  • value Valeur de la propriété.

GetProperty

Syntaxe : public inline std::string GetProperty ( const std::string & name ) const;

Obtient une valeur de propriété par nom.

Paramètres

  • name Le nom du paramètre.

Retours

Valeur de la propriété.

GetProperty

Syntaxe : public inline std::string GetProperty ( PropertyId id ) const;

Obtient une valeur de propriété par ID.

Paramètres

  • id l’ID de paramètre.

Retours

Valeur de la propriété.

Créer

Syntaxe : public inline static std::shared_ptr< AudioProcessingOptions > Create ( int audioProcessingFlags );

Crée une instance de la classe AudioProcessingOptions.

Paramètres

  • audioProcessingFlags Spécifie des indicateurs pour contrôler le traitement audio effectué par le Kit de développement logiciel (SDK) Speech. Il s’agit d’une or au niveau du bit des constantes AUDIO_INPUT_PROCESSING_XXX.

Retours

Le fichier AudioProcessingOptions nouvellement créé est encapsulé à l’intérieur d’un std ::shared_ptr.

Cette fonction ne doit être utilisée que lorsque l’entrée audio provient d’un tableau de microphones. Sur Windows, cette fonction tente d’interroger la géométrie du tableau de microphones à partir du pilote audio. Les données audio sont également lues à partir du canal de référence de l’orateur. Sur Linux, il part du principe que le microphone est un microphone à canal unique. Si le drapeau PNS est activé, la géométrie de la matrice de microphones est automatiquement réglée sur Mono.

Créer

Syntaxe : public inline static std::shared_ptr< AudioProcessingOptions > Create ( int audioProcessingFlags , PresetMicrophoneArrayGeometry microphoneArrayGeometry , SpeakerReferenceChannel speakerReferenceChannel );

Crée une instance de la classe AudioProcessingOptions avec une géométrie de tableau de microphone prédéfinie.

Paramètres

  • audioProcessingFlags Spécifie des indicateurs pour contrôler le traitement audio effectué par le Kit de développement logiciel (SDK) Speech. Il s’agit d’une or au niveau du bit des constantes AUDIO_INPUT_PROCESSING_XXX.

  • microphoneArrayGeometry Spécifie le type de géométrie du tableau de microphones.

  • speakerReferenceChannel Spécifie la position du canal de référence du haut-parleur dans l’audio d’entrée.

Retours

Le fichier AudioProcessingOptions nouvellement créé est encapsulé à l’intérieur d’un std ::shared_ptr.

Créer

Syntaxe : public inline static std::shared_ptr< AudioProcessingOptions > Create ( int audioProcessingFlags , SpeakerReferenceChannel speakerReferenceChannel , const std::vector< float > & speakerSignature );

Crée une nouvelle instance de la classe AudioProcessingOptions avec la position du canal de référence des haut-parleurs et la signature du haut-parleur pour le PNS. Le PNS ne prend en charge que l’entrée mono des microphones, donc la géométrie de la matrice de microphones est automatiquement réglée sur Mono.

Paramètres

  • audioProcessingFlags Spécifie des indicateurs pour contrôler le traitement audio effectué par le Kit de développement logiciel (SDK) Speech. Il s’agit d’une or au niveau du bit des constantes AUDIO_INPUT_PROCESSING_XXX.

  • speakerReferenceChannel Spécifie la position du canal de référence du haut-parleur dans l’audio d’entrée.

  • speakerSignature Spécifie la signature du haut-parleur (128 flotteurs) utilisée par la suppression personnalisée du bruit (PNS). Réservé aux applications first-party Microsoft.

Retours

Le fichier AudioProcessingOptions nouvellement créé est encapsulé à l’intérieur d’un std ::shared_ptr.

Créer

Syntaxe : public inline static std::shared_ptr< AudioProcessingOptions > Create ( int audioProcessingFlags , MicrophoneArrayGeometry microphoneArrayGeometry , SpeakerReferenceChannel speakerReferenceChannel );

Crée une instance de la classe AudioProcessingOptions avec la géométrie de tableau de microphones.

Paramètres

  • audioProcessingFlags Spécifie des indicateurs pour contrôler le traitement audio effectué par le Kit de développement logiciel (SDK) Speech. Il s’agit d’une or au niveau du bit des constantes AUDIO_INPUT_PROCESSING_XXX.

  • microphoneArrayGeometry Spécifie la géométrie du tableau de microphones.

  • speakerReferenceChannel Spécifie la position du canal de référence du haut-parleur dans l’audio d’entrée.

Retours

Le fichier AudioProcessingOptions nouvellement créé est encapsulé à l’intérieur d’un std ::shared_ptr.