說明

以下函數(shù)負(fù)責(zé)設(shè)置遠(yuǎn)程設(shè)備上的揚(yáng)聲器增益。此函數(shù)在成功執(zhí)行時(shí)返回零，而在出現(xiàn)任何錯誤時(shí)返回負(fù)值。如果 HF 設(shè)備支持遠(yuǎn)程音頻音量控制功能，則此函數(shù)有效。

參數(shù)

此命令只需要揚(yáng)聲器增益整數(shù)值作為參數(shù)。

命令調(diào)用示例

• "SetSpeakerGain 5"
• "SetSpeakerGain 6"

可能的返回值

• (0) 命令發(fā)送成功
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-4) FUNCTION_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-1000) BTHFRE_ERROR_INVALID_PARAMETER
• (-1001) BTHFRE_ERROR_NOT_INITIALIZED
• (-1002) BTHFRE_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1003) BTHFRE_ERROR_LIBRARY_INITIALIZATION_ERROR
• (-1004) BTHFRE_ERROR_INSUFFICIENT_RESOURCES
• (-1005) BTHFRE_ERROR_INVALID_OPERATION
• (-1006) BTHFRE_ERROR_INVALID_CODEC_ID

API 調(diào)用

HFRE_Set_Remote_Speaker_Gain(BluetoothStackID, CurrentClientPortID, TempParam->Params->intParam)

API 原型

BTPSAPI_DECLARATION int BTPSAPI HFRE_Set_Remote_Speaker_Gain(unsigned int BluetoothStackID, unsigned int HFREPortID, unsigned int SpeakerGain)

API 說明

此函數(shù)負(fù)責(zé)允許同步和設(shè)置遠(yuǎn)程設(shè)備揚(yáng)聲器增益。僅當(dāng)存在有效服務(wù)級別連接時(shí)，才能執(zhí)行此函數(shù)。由免提裝置調(diào)用時(shí)，此函數(shù)用于向遠(yuǎn)程音頻網(wǎng)關(guān)通知當(dāng)前揚(yáng)聲器增益值。由音頻網(wǎng)關(guān)調(diào)用時(shí)，此函數(shù)可為音頻網(wǎng)關(guān)提供一種方法來控制遠(yuǎn)程免提裝置的揚(yáng)聲器增益。該函數(shù)將以下內(nèi)容作為輸入?yún)?shù)：HFRE 端口 ID 有效的藍(lán)牙協(xié)議棧 ID 以及 HFRE 端口 ID。最后一個(gè)參數(shù)是要發(fā)送到遠(yuǎn)程設(shè)備的揚(yáng)聲器增益。揚(yáng)聲器增益參數(shù) *必須* 介于 HFRE_SPEAKER_GAIN_MINIMUM 和 HFRE_SPEAKER_GAIN_MAXIMUM 的值之間。如果成功，此函數(shù)返回零；如果出現(xiàn)錯誤，則返回負(fù)的錯誤代碼。