表示與音訊組態類別搭配使用的音訊處理選項。
成員
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內。