類別音訊::AudioProcessingOptions

表示與音訊組態類別搭配使用的音訊處理選項。

成員

AudioProcessingOptions

語法:public inline explicit AudioProcessingOptions ( SPXAUDIOPROCESSINGOPTIONSHANDLE hoptions );

使用提供的句柄建立新的實例。

參數

  • hoptions 音訊處理選項的句柄。

~AudioProcessingOptions

語法:public ~AudioProcessingOptions ( ) = default;

解構 AudioProcessingOptions 類別的實例。

運算子 SPXAUDIOPROCESSINGOPTIONSHANDLE

語法:public inline explicit operator SPXAUDIOPROCESSINGOPTIONSHANDLE ( ) const;

用來取得基礎句柄值的內部運算子。

退貨

句柄。

GetAudioProcessingFlags

語法:public inline int GetAudioProcessingFlags ( ) const;

傳回語音 SDK 所執行的音訊處理類型。

退貨

AUDIO_INPUT_PROCESSING_XXX常數旗標的位 OR,表示語音 SDK 所執行的輸入音訊處理。

GetPresetMicrophoneArrayGeometry

語法:public inline PresetMicrophoneArrayGeometry GetPresetMicrophoneArrayGeometry ( ) const;

傳回用於音訊輸入之麥克風的麥克風陣組幾何。

退貨

PresetMicrophoneArrayGeometry 列舉類型的值。

GetMicrophoneArrayType

語法:public inline MicrophoneArrayType GetMicrophoneArrayType ( ) const;

傳回用於音訊輸入的麥克風麥克風數位型態。

退貨

MicrophoneArrayType 列舉類型的值。

GetBeamformingStartAngle

語法:public inline uint16_t GetBeamformingStartAngle ( ) const;

傳回用於梁形的開始角度。

退貨

梁形開始角度。

GetBeamformingEndAngle

語法:public inline uint16_t GetBeamformingEndAngle ( ) const;

傳回用於梁形的結束角度。

退貨

梁形結束角度。

GetMicrophoneCoordinates

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

傳回用於音訊輸入之麥克風數位中的麥克風座標。

退貨

MicrophoneCoordinates 元素的 std::vector。

GetSpeakerReferenceChannel

語法:public inline SpeakerReferenceChannel GetSpeakerReferenceChannel ( ) const;

傳回音訊輸入中的喇叭參考通道位置。

退貨

SpeakerReferenceChannel 列舉類型的值。

GetSpeakerSignature

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

如果有的話,會取得講者簽名。 當未設定時,會回傳一個空向量。 保留給 Microsoft 第一方應用程式。

退貨

一個包含喇叭簽名的浮點數向量(128 個浮點數),若未設定則為空向量。

SetPersonalizedNoiseSuppressionModel

語法:public inline void SetPersonalizedNoiseSuppressionModel ( const std::string & modelPath , const std::string & license );

設定個人化的噪音抑制模型及其授權。

參數

  • modelPath 授權 PNS 模型檔案的路徑。

  • license 授權文字嵌入在那個模型裡。 必須完全匹配。

個人化降噪需要有授權的型號;沒有授權是無法載入的。 透過此方法設定兩個值,可避免它們獨立更改。 保留給 Microsoft 第一方應用程式。

SetProperty

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

依名稱設定屬性值。

參數

  • name 屬性名稱。

  • value 屬性值。

SetProperty

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

依標識碼設定屬性值。

參數

  • id 屬性識別碼。

  • value 屬性值。

GetProperty

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

依名稱取得屬性值。

參數

  • name 屬性名稱。

退貨

屬性值。

GetProperty

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

依標識碼取得屬性值。

參數

  • id 屬性識別碼。

退貨

屬性值。

創造

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

建立 AudioProcessingOptions 類別的新實例。

參數

  • audioProcessingFlags 指定旗標來控制語音 SDK 所執行的音訊處理。 它是AUDIO_INPUT_PROCESSING_XXX常數位 OR。

退貨

新建立的 AudioProcessingOptions 包裝在 std::shared_ptr內。

只有當音訊輸入來自麥克風數位時,才應該使用這個函式。 在 Windows 上,此函式會嘗試從音訊驅動程式查詢麥克風陣列幾何。 音訊數據也會從說話者參考通道讀取。 在Linux上,它會假設麥克風是單一通道麥克風。 若設定 PNS 標誌,麥克風陣列幾何會自動設定為單聲道。

創造

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

使用預設麥克風陣列幾何建立 AudioProcessingOptions 類別的新實例。

參數

  • audioProcessingFlags 指定旗標來控制語音 SDK 所執行的音訊處理。 它是AUDIO_INPUT_PROCESSING_XXX常數位 OR。

  • microphoneArrayGeometry 指定麥克風陣列幾何的類型。

  • speakerReferenceChannel 指定輸入音訊中的喇叭參考通道位置。

退貨

新建立的 AudioProcessingOptions 包裝在 std::shared_ptr內。

創造

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

為 PNS 建立一個新的 AudioProcessingOptions 類別實例,包含喇叭參考通道位置與喇叭簽名。 PNS 只支援單聲道麥克風輸入,因此麥克風陣列幾何會自動設定為單聲道。

參數

  • audioProcessingFlags 指定旗標來控制語音 SDK 所執行的音訊處理。 它是AUDIO_INPUT_PROCESSING_XXX常數位 OR。

  • speakerReferenceChannel 指定輸入音訊中的喇叭參考通道位置。

  • speakerSignature 指定個人化降噪(PNS)所使用的喇叭特徵(128 浮點點)。 保留給 Microsoft 第一方應用程式。

退貨

新建立的 AudioProcessingOptions 包裝在 std::shared_ptr內。

創造

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

使用麥克風陣列幾何建立 AudioProcessingOptions 類別的新實例。

參數

  • audioProcessingFlags 指定旗標來控制語音 SDK 所執行的音訊處理。 它是AUDIO_INPUT_PROCESSING_XXX常數位 OR。

  • microphoneArrayGeometry 指定麥克風陣列幾何。

  • speakerReferenceChannel 指定輸入音訊中的喇叭參考通道位置。

退貨

新建立的 AudioProcessingOptions 包裝在 std::shared_ptr內。