Klasse Audio::AudioProcessingOptions

Stellt Audioverarbeitungsoptionen dar, die mit der Audiokonfigurationsklasse verwendet werden.

Elemente

AudioProcessingOptions

Syntax: public inline explicit AudioProcessingOptions ( SPXAUDIOPROCESSINGOPTIONSHANDLE hoptions );

Erstellt eine neue Instanz mithilfe des bereitgestellten Handles.

Die Parameter

• hoptions Ein Handle für Audioverarbeitungsoptionen.

~AudioProcessingOptions

Syntax: public ~AudioProcessingOptions ( ) = default;

Destruktiert eine Instanz der AudioProcessingOptions-Klasse.

Operator SPXAUDIOPROCESSINGOPTIONSHANDLE

Syntax: public inline explicit operator SPXAUDIOPROCESSINGOPTIONSHANDLE ( ) const;

Interner Operator, der zum Abrufen eines zugrunde liegenden Handlewerts verwendet wird.

Rückgaben

Ein Handle.

GetAudioProcessingFlags

Syntax: public inline int GetAudioProcessingFlags ( ) const;

Gibt den Typ der Audioverarbeitung zurück, die vom Speech SDK ausgeführt wird.

Rückgaben

Bitweise OR von AUDIO_INPUT_PROCESSING_XXX Konstantenkennzeichnungen, die die vom Speech SDK ausgeführte Eingabeaudioverarbeitung angeben.

GetPresetMicrophoneArrayGeometry

Syntax: public inline PresetMicrophoneArrayGeometry GetPresetMicrophoneArrayGeometry ( ) const;

Gibt die Mikrofonarraygeometrie des Mikrofons zurück, das für die Audioeingabe verwendet wird.

Rückgaben

Ein Wert vom Typ PresetMicrophoneArrayGeometry.A value of type PresetMicrophoneArrayGeometry enum.

GetMicrophoneArrayType

Syntax: public inline MicrophoneArrayType GetMicrophoneArrayType ( ) const;

Gibt den Mikrofonarraytyp des Mikrofons zurück, das für die Audioeingabe verwendet wird.

Rückgaben

Ein Wert vom Typ MicrophoneArrayType-Enumeration.

GetBeamformingStartAngle

Syntax: public inline uint16_t GetBeamformingStartAngle ( ) const;

Gibt den Anfangswinkel zurück, der für die Strahlform verwendet wird.

Rückgaben

Strahlwinkel.

GetBeamformingEndAngle

Syntax: public inline uint16_t GetBeamformingEndAngle ( ) const;

Gibt den Endwinkel zurück, der für die Strahlform verwendet wird.

Rückgaben

Strahlwinkel.

GetMicrophoneCoordinates

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

Gibt die Koordinaten von Mikrofonen im Mikrofonarray zurück, das für die Audioeingabe verwendet wird.

Rückgaben

Ein std::vektor von Mikrofonkoordinaten-Elementen.

GetSpeakerReferenceChannel

Syntax: public inline SpeakerReferenceChannel GetSpeakerReferenceChannel ( ) const;

Gibt die Position des Lautsprecherbezugskanals in der Audioeingabe zurück.

Rückgaben

Ein Wert vom Typ SpeakerReferenceChannel-Enumeration.

GetSpeakerSignature

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

Ruft die Sprechersignatur ab, falls vorhanden. Gibt einen leeren Vektor zurück, wenn er nicht gesetzt ist. Nur intern.

Rückgaben

Ein std::Vektor von Floats, der die Sprechersignatur enthält (128 Floats), oder ein leerer Vektor, falls nicht gesetzt.

SetProperty

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

Legt einen Eigenschaftswert anhand des Namens fest.

Die Parameter

• name Der Eigenschaftenname.

• value Der Eigenschaftswert.

GetProperty

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

Ruft einen Eigenschaftswert anhand des Namens ab.

Die Parameter

• name Der Parametername.

Rückgaben

Der Eigenschaftswert.

Erstellen

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

Erstellt eine neue Instanz der AudioProcessingOptions-Klasse.

Die Parameter

• audioProcessingFlags Gibt Flags zum Steuern der vom Speech SDK ausgeführten Audioverarbeitung an. Es ist bitweise ODER von AUDIO_INPUT_PROCESSING_XXX Konstanten.

Rückgaben

Die neu erstellten AudioProcessingOptions sind in ein std::shared_ptr eingeschlossen.

Diese Funktion sollte nur verwendet werden, wenn die Audioeingabe von einem Mikrofonarray stammt. Unter Windows versucht diese Funktion, die Geometrie des Mikrofonarrays vom Audiotreiber abzufragen. Audiodaten werden auch vom Sprecherreferenzkanal gelesen. Unter Linux wird davon ausgegangen, dass es sich bei dem Mikrofon um ein Einzelnes Kanalmikrofon handelt. Wenn die PNS-Flagge gesetzt ist, wird die Geometrie des Mikrofonarrays automatisch auf Mono gesetzt.

Erstellen

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

Erstellt eine neue Instanz der AudioProcessingOptions-Klasse mit vordefinierter Mikrofonarraygeometrie.

Die Parameter

• audioProcessingFlags Gibt Flags zum Steuern der vom Speech SDK ausgeführten Audioverarbeitung an. Es ist bitweise ODER von AUDIO_INPUT_PROCESSING_XXX Konstanten.

• microphoneArrayGeometry Gibt den Typ der Mikrofonarraygeometrie an.

• speakerReferenceChannel Gibt die Position des Lautsprecherbezugskanals im Eingabeaudio an.

Rückgaben

Die neu erstellten AudioProcessingOptions sind in ein std::shared_ptr eingeschlossen.

Erstellen

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

Erstellt eine neue Instanz der AudioProcessingOptions-Klasse mit der Position des Referenzkanals und der Lautsprechersignatur für PNS. PNS unterstützt nur Mono-Mikrofon-Eingang, daher ist die Geometrie des Mikrofonarrays automatisch auf Mono eingestellt.

Die Parameter

• audioProcessingFlags Gibt Flags zum Steuern der vom Speech SDK ausgeführten Audioverarbeitung an. Es ist bitweise ODER von AUDIO_INPUT_PROCESSING_XXX Konstanten.

• speakerReferenceChannel Gibt die Position des Lautsprecherbezugskanals im Eingabeaudio an.

• speakerSignature Spezifiziert die Lautsprechersignatur (128 Floats), die von Personalized Noise Suppression (PNS) verwendet wird. Nur intern.

Rückgaben

Die neu erstellten AudioProcessingOptions sind in ein std::shared_ptr eingeschlossen.

Erstellen

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

Erstellt eine neue Instanz der AudioProcessingOptions-Klasse mit Mikrofonarraygeometrie.

Die Parameter

• audioProcessingFlags Gibt Flags zum Steuern der vom Speech SDK ausgeführten Audioverarbeitung an. Es ist bitweise ODER von AUDIO_INPUT_PROCESSING_XXX Konstanten.

• microphoneArrayGeometry Gibt die Geometrie des Mikrofonarrays an.

• speakerReferenceChannel Gibt die Position des Lautsprecherbezugskanals im Eingabeaudio an.

Rückgaben

Die neu erstellten AudioProcessingOptions sind in ein std::shared_ptr eingeschlossen.