说明

以下函数负责停用音频网关上的语音识别激活以及更改免提装置上的语音识别激活状态。此函数在成功执行时返回零，而在出现任何错误时返回负值。

参数

语音识别命令仅接受一个参数，该值必须指定为 0（表示停用）或 1（表示激活）。

命令调用示例

"SetVoiceRecognitionActivation 0"

可能的返回值

• (0) 命令发送成功
• (-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 调用

HFRE_Set_Remote_Voice_Recognition_Activation(BluetoothStackID, CurrentClientPortID, (Boolean_t)TempParam->Params->intParam)

API 原型

BTPSAPI_DECLARATION int BTPSAPI HFRE_Set_Remote_Voice_Recognition_Activation(unsigned int BluetoothStackID, unsigned int HFREPortID, Boolean_tVoiceRecognitionActive)

API 说明

由免提装置调用时，此函数负责激活和停用位于远程音频网关上的语音识别。由音频网关调用时，此函数负责向远程免提装置通知本地语音识别功能的当前激活状态。此函数只能由为语音识别启用了受支持功能位的本地设备进行调用。该函数将以下内容作为输入参数：HFRE 端口 ID 有效的蓝牙协议栈 ID 以及 HFRE 端口 ID。最后一个参数是一个布尔标志，指定此调用要在远程音频网关上激活或停用此功能，还是指定为远程免提装置在本地激活或停语音识别。激活时，音频网关上的语音识别功能将打开；未激活时，音频网关上的语音识别功能将关闭。如果成功，此函数返回零；如果出现错误，则返回负的错误代码。