HFP HF API

结构体
struct	hfp_hf_calls_info_t
	定义电话呼叫信息。 更多...
struct	hfp_hf_callbacks_t
	HFP HF回调函数接口定义。 更多...

宏定义
#define	HFP_HF_MAX_VOLUME   15
	最大音量值范围。

类型定义
typedef void(*	hfp_hf_conn_state_changed_callback) (const bd_addr_t *bd_addr, profile_connect_state_t state)
	hfp连接状态更新回调函数。
typedef void(*	hfp_hf_sco_conn_state_changed_callback) (const bd_addr_t *bd_addr, hfp_sco_connect_state_t state)
	sco连接状态更新回调函数。
typedef void(*	hfp_hf_battery_level_changed_callback) (const bd_addr_t *bd_addr, int battery_level)
	收到AG电量变化指示回调函数。
typedef void(*	hfp_hf_signal_strength_changed_callback) (const bd_addr_t *bd_addr, int signal_strength)
	收到AG信号强度变化指示回调函数。
typedef void(*	hfp_hf_registration_status_changed_callback) (const bd_addr_t *bd_addr, int status)
	收到AG注册状态变化指示回调函数。
typedef void(*	hfp_hf_roaming_status_changed_callback) (const bd_addr_t *bd_addr, int status)
	收到AG漫游状态变化指示回调函数。
typedef void(*	hfp_hf_operator_selection_callback) (const bd_addr_t *bd_addr, unsigned char *name, unsigned int len)
	查询AG运营商信息收到AG回复后的回调函数。
typedef void(*	hfp_hf_subscriber_number_callback) (const bd_addr_t *bd_addr, unsigned char *number, unsigned int len)
	查询AG用户号码收到AG回复后的回调函数。
typedef void(*	hfp_hf_voice_recognition_status_changed_callback) (const bd_addr_t *bd_addr, int status)
	语音识别状态变化回调函数。
typedef void(*	hfp_hf_in_band_ring_tone_changed_callback) (const bd_addr_t *bd_addr, int status)
	带内铃声状态变化回调函数。
typedef void(*	hfp_hf_volume_changed_callback) (const bd_addr_t *bd_addr, hfp_volume_type_t type, unsigned char volume)
	AG端调整HF音量回调函数。
typedef void(*	hfp_hf_call_changed_callback) (const bd_addr_t *bd_addr, const hfp_hf_calls_info_t *call)
	通话状态变化回调函数。
typedef void(*	hfp_hf_dial_error_code_callback) (const bd_addr_t *bd_addr, int code)
	拨号错误回调函数。
typedef void(*	hfp_hf_codec_changed_callback) (const bd_addr_t *bd_addr, int codec)
	codec编码信息变化回调函数。

枚举
enum	hfp_hf_accept_call_action_type_t { HFP_HF_ACCEPT_CALL_ACTION_NONE = 0x00 , HFP_HF_ACCEPT_CALL_ACTION_HOLD = 0x01 , HFP_HF_ACCEPT_CALL_ACTION_FINISH = 0x02 }
	接受一路呼叫时对其他呼叫的操作策略。 更多...
enum	hfp_hf_call_state_t {   HFP_HF_CALL_STATE_ACTIVE = 0 , HFP_HF_CALL_STATE_HELD , HFP_HF_CALL_STATE_DIALING , HFP_HF_CALL_STATE_ALERTING ,   HFP_HF_CALL_STATE_INCOMING , HFP_HF_CALL_STATE_WAITING , HFP_HF_CALL_STATE_RESPONSE_HELD , HFP_HF_CALL_STATE_FINISHED }
	电话呼叫状态类型。 更多...
enum	hfp_hf_codec_id_t { HFP_HF_CODEC_ID_CVSD = 0x01 , HFP_HF_CODEC_ID_MSBC }
	定义codec编码信息。 更多...

函数
int	hfp_hf_connect (const bd_addr_t *bd_addr)
	建立与AG的SLC(service level connection)。
int	hfp_hf_disconnect (const bd_addr_t *bd_addr)
	释放与AG的SLC(service level connection)。
int	hfp_hf_connect_sco (const bd_addr_t *bd_addr)
	建立与AG的音频连接。
int	hfp_hf_disconnect_sco (const bd_addr_t *bd_addr)
	断开与AG的音频连接。
int	hfp_hf_get_device_connect_state (const bd_addr_t *bd_addr)
	通过设备地址查询设备hfp连接状态。
int	hfp_hf_get_sco_connect_state (const bd_addr_t *bd_addr)
	通过设备地址查询设备hfp sco连接状态。
int	hfp_hf_send_dtmf_tone (const bd_addr_t *bd_addr, unsigned char code)
	指示AG发送DTMF tone code。
int	hfp_hf_open_voice_recognition (const bd_addr_t *bd_addr)
	指示AG打开语音识别功能。
int	hfp_hf_close_voice_recognition (const bd_addr_t *bd_addr)
	指示AG关闭语音识别功能。
int	hfp_hf_accept_incoming_call (const bd_addr_t *bd_addr, hfp_hf_accept_call_action_type_t action_type)
	接听呼入电话。
int	hfp_hf_hold_active_call (const bd_addr_t *bd_addr)
	将当前通话状态是激活状态的通话保持。
int	hfp_hf_reject_incoming_call (const bd_addr_t *bd_addr)
	拒接呼入电话。
int	hfp_hf_finish_call (const bd_addr_t *bd_addr)
	结束通话。
int	hfp_hf_start_dial (const bd_addr_t *bd_addr, const unsigned char *number, unsigned char len)
	发起主叫。
int	hfp_hf_set_volume (const bd_addr_t *bd_addr, hfp_volume_type_t type, unsigned char volume)
	HF端发起音量调整。
int	hfp_hf_register_callbacks (hfp_hf_callbacks_t *func)
	注册上层应用的回调。

变量
bd_addr_t	hfp_hf_calls_info_t::bd_addr
int	hfp_hf_calls_info_t::id
int	hfp_hf_calls_info_t::state
char *	hfp_hf_calls_info_t::number
unsigned char	hfp_hf_calls_info_t::number_len
bt_uuid_t	hfp_hf_calls_info_t::uuid
bool	hfp_hf_calls_info_t::multi_party
bool	hfp_hf_calls_info_t::outgoing
bool	hfp_hf_calls_info_t::in_band_ring
long	hfp_hf_calls_info_t::creation_time
hfp_hf_conn_state_changed_callback	hfp_hf_callbacks_t::conn_state_changed_cb
hfp_hf_sco_conn_state_changed_callback	hfp_hf_callbacks_t::sco_conn_state_changed_cb
hfp_hf_battery_level_changed_callback	hfp_hf_callbacks_t::battery_level_changed_cb
hfp_hf_signal_strength_changed_callback	hfp_hf_callbacks_t::signal_strength_changed_cb
hfp_hf_registration_status_changed_callback	hfp_hf_callbacks_t::registration_status_changed_cb
hfp_hf_roaming_status_changed_callback	hfp_hf_callbacks_t::roaming_status_changed_cb
hfp_hf_operator_selection_callback	hfp_hf_callbacks_t::operator_selection_cb
hfp_hf_subscriber_number_callback	hfp_hf_callbacks_t::subscriber_number_cb
hfp_hf_voice_recognition_status_changed_callback	hfp_hf_callbacks_t::voice_recognition_status_changed_cb
hfp_hf_in_band_ring_tone_changed_callback	hfp_hf_callbacks_t::in_band_ring_tone_changed_cb
hfp_hf_volume_changed_callback	hfp_hf_callbacks_t::volume_changed_cb
hfp_hf_call_changed_callback	hfp_hf_callbacks_t::call_changed_cb
hfp_hf_dial_error_code_callback	hfp_hf_callbacks_t::dial_error_code_cb
hfp_hf_codec_changed_callback	hfp_hf_callbacks_t::codec_changed_cb

详细描述

宏定义说明

HFP_HF_MAX_VOLUME

#define HFP_HF_MAX_VOLUME   15

最大音量值范围。

类型定义说明

hfp_hf_battery_level_changed_callback

typedef void(* hfp_hf_battery_level_changed_callback) (const bd_addr_t *bd_addr, int battery_level)

收到AG电量变化指示回调函数。

hfp_hf_call_changed_callback

typedef void(* hfp_hf_call_changed_callback) (const bd_addr_t *bd_addr, const hfp_hf_calls_info_t *call)

通话状态变化回调函数。

hfp_hf_codec_changed_callback

typedef void(* hfp_hf_codec_changed_callback) (const bd_addr_t *bd_addr, int codec)

codec编码信息变化回调函数。

hfp_hf_conn_state_changed_callback

typedef void(* hfp_hf_conn_state_changed_callback) (const bd_addr_t *bd_addr, profile_connect_state_t state)

hfp连接状态更新回调函数。

hfp_hf_dial_error_code_callback

typedef void(* hfp_hf_dial_error_code_callback) (const bd_addr_t *bd_addr, int code)

拨号错误回调函数。

hfp_hf_in_band_ring_tone_changed_callback

typedef void(* hfp_hf_in_band_ring_tone_changed_callback) (const bd_addr_t *bd_addr, int status)

带内铃声状态变化回调函数。

hfp_hf_operator_selection_callback

typedef void(* hfp_hf_operator_selection_callback) (const bd_addr_t *bd_addr, unsigned char *name, unsigned int len)

查询AG运营商信息收到AG回复后的回调函数。

hfp_hf_registration_status_changed_callback

typedef void(* hfp_hf_registration_status_changed_callback) (const bd_addr_t *bd_addr, int status)

收到AG注册状态变化指示回调函数。

hfp_hf_roaming_status_changed_callback

typedef void(* hfp_hf_roaming_status_changed_callback) (const bd_addr_t *bd_addr, int status)

收到AG漫游状态变化指示回调函数。

hfp_hf_sco_conn_state_changed_callback

typedef void(* hfp_hf_sco_conn_state_changed_callback) (const bd_addr_t *bd_addr, hfp_sco_connect_state_t state)

sco连接状态更新回调函数。

hfp_hf_signal_strength_changed_callback

typedef void(* hfp_hf_signal_strength_changed_callback) (const bd_addr_t *bd_addr, int signal_strength)

收到AG信号强度变化指示回调函数。

hfp_hf_subscriber_number_callback

typedef void(* hfp_hf_subscriber_number_callback) (const bd_addr_t *bd_addr, unsigned char *number, unsigned int len)

查询AG用户号码收到AG回复后的回调函数。

hfp_hf_voice_recognition_status_changed_callback

typedef void(* hfp_hf_voice_recognition_status_changed_callback) (const bd_addr_t *bd_addr, int status)

语音识别状态变化回调函数。

hfp_hf_volume_changed_callback

typedef void(* hfp_hf_volume_changed_callback) (const bd_addr_t *bd_addr, hfp_volume_type_t type, unsigned char volume)

AG端调整HF音量回调函数。

枚举类型说明

hfp_hf_accept_call_action_type_t

enum hfp_hf_accept_call_action_type_t

接受一路呼叫时对其他呼叫的操作策略。

枚举值
HFP_HF_ACCEPT_CALL_ACTION_NONE	接受呼叫后无操作
HFP_HF_ACCEPT_CALL_ACTION_HOLD	接受呼叫保持当前通话
HFP_HF_ACCEPT_CALL_ACTION_FINISH	接受呼叫后结束当前通话

hfp_hf_call_state_t

enum hfp_hf_call_state_t

电话呼叫状态类型。

枚举值
HFP_HF_CALL_STATE_ACTIVE	HFP HF正在通话
HFP_HF_CALL_STATE_HELD	HFP HF呼叫保持通话
HFP_HF_CALL_STATE_DIALING	HFP HF呼叫正在拨号
HFP_HF_CALL_STATE_ALERTING	HFP HF呼叫正在响铃
HFP_HF_CALL_STATE_INCOMING	HFP HF呼叫接入
HFP_HF_CALL_STATE_WAITING	HFP HF呼叫等待
HFP_HF_CALL_STATE_RESPONSE_HELD	HFP HF呼叫响应保持
HFP_HF_CALL_STATE_FINISHED	HFP HF呼叫结束

hfp_hf_codec_id_t

enum hfp_hf_codec_id_t

定义codec编码信息。

枚举值
HFP_HF_CODEC_ID_CVSD	HFP HF 编码格式为CVSD
HFP_HF_CODEC_ID_MSBC	HFP HF 编码格式为MSBC

函数说明

hfp_hf_accept_incoming_call()

int hfp_hf_accept_incoming_call	(	const bd_addr_t *	bd_addr,
		hfp_hf_accept_call_action_type_t	action_type
	)

接听呼入电话。

hfp_hf_close_voice_recognition()

int hfp_hf_close_voice_recognition

(

const bd_addr_t *

bd_addr

)

指示AG关闭语音识别功能。

hfp_hf_connect()

int hfp_hf_connect

(

const bd_addr_t *

bd_addr

)

建立与AG的SLC(service level connection)。

hfp_hf_connect_sco()

int hfp_hf_connect_sco

(

const bd_addr_t *

bd_addr

)

建立与AG的音频连接。

hfp_hf_disconnect()

int hfp_hf_disconnect

(

const bd_addr_t *

bd_addr

)

释放与AG的SLC(service level connection)。

hfp_hf_disconnect_sco()

int hfp_hf_disconnect_sco

(

const bd_addr_t *

bd_addr

)

断开与AG的音频连接。

hfp_hf_finish_call()

int hfp_hf_finish_call

(

const bd_addr_t *

bd_addr

)

结束通话。

hfp_hf_get_device_connect_state()

int hfp_hf_get_device_connect_state

(

const bd_addr_t *

bd_addr

)

通过设备地址查询设备hfp连接状态。

hfp_hf_get_sco_connect_state()

int hfp_hf_get_sco_connect_state

(

const bd_addr_t *

bd_addr

)

通过设备地址查询设备hfp sco连接状态。

hfp_hf_hold_active_call()

int hfp_hf_hold_active_call

(

const bd_addr_t *

bd_addr

)

将当前通话状态是激活状态的通话保持。

hfp_hf_open_voice_recognition()

int hfp_hf_open_voice_recognition

(

const bd_addr_t *

bd_addr

)

指示AG打开语音识别功能。

hfp_hf_register_callbacks()

int hfp_hf_register_callbacks

(

hfp_hf_callbacks_t *

func

)

注册上层应用的回调。

hfp_hf_reject_incoming_call()

int hfp_hf_reject_incoming_call

(

const bd_addr_t *

bd_addr

)

拒接呼入电话。

hfp_hf_send_dtmf_tone()

int hfp_hf_send_dtmf_tone	(	const bd_addr_t *	bd_addr,
		unsigned char	code
	)

指示AG发送DTMF tone code。

hfp_hf_set_volume()

int hfp_hf_set_volume	(	const bd_addr_t *	bd_addr,
		hfp_volume_type_t	type,
		unsigned char	volume
	)

HF端发起音量调整。

hfp_hf_start_dial()

int hfp_hf_start_dial	(	const bd_addr_t *	bd_addr,
		const unsigned char *	number,
		unsigned char	len
	)

发起主叫。

变量说明

battery_level_changed_cb

hfp_hf_battery_level_changed_callback hfp_hf_callbacks_t::battery_level_changed_cb

bd_addr

bd_addr_t hfp_hf_calls_info_t::bd_addr

远端设备地址

call_changed_cb

hfp_hf_call_changed_callback hfp_hf_callbacks_t::call_changed_cb

codec_changed_cb

hfp_hf_codec_changed_callback hfp_hf_callbacks_t::codec_changed_cb

conn_state_changed_cb

hfp_hf_conn_state_changed_callback hfp_hf_callbacks_t::conn_state_changed_cb

creation_time

long hfp_hf_calls_info_t::creation_time

呼叫开始时间

dial_error_code_cb

hfp_hf_dial_error_code_callback hfp_hf_callbacks_t::dial_error_code_cb

id

int hfp_hf_calls_info_t::id

编号

in_band_ring

bool hfp_hf_calls_info_t::in_band_ring

inband-ring模式

in_band_ring_tone_changed_cb

hfp_hf_in_band_ring_tone_changed_callback hfp_hf_callbacks_t::in_band_ring_tone_changed_cb

multi_party

bool hfp_hf_calls_info_t::multi_party

多方电话

number

char* hfp_hf_calls_info_t::number

电话号码

number_len

unsigned char hfp_hf_calls_info_t::number_len

电话号码位数

operator_selection_cb

hfp_hf_operator_selection_callback hfp_hf_callbacks_t::operator_selection_cb

outgoing

bool hfp_hf_calls_info_t::outgoing

呼入/呼出

registration_status_changed_cb

hfp_hf_registration_status_changed_callback hfp_hf_callbacks_t::registration_status_changed_cb

roaming_status_changed_cb

hfp_hf_roaming_status_changed_callback hfp_hf_callbacks_t::roaming_status_changed_cb

sco_conn_state_changed_cb

hfp_hf_sco_conn_state_changed_callback hfp_hf_callbacks_t::sco_conn_state_changed_cb

signal_strength_changed_cb

hfp_hf_signal_strength_changed_callback hfp_hf_callbacks_t::signal_strength_changed_cb

state

int hfp_hf_calls_info_t::state

电话呼叫状态

subscriber_number_cb

hfp_hf_subscriber_number_callback hfp_hf_callbacks_t::subscriber_number_cb

uuid

bt_uuid_t hfp_hf_calls_info_t::uuid

电话服务uuid

voice_recognition_status_changed_cb

hfp_hf_voice_recognition_status_changed_callback hfp_hf_callbacks_t::voice_recognition_status_changed_cb

volume_changed_cb

hfp_hf_volume_changed_callback hfp_hf_callbacks_t::volume_changed_cb