[ English | 简体中文 ]

网络服务 API

蜂窝网络注册、信号强度、运营商信息等。

头文件：#include <tapi_network.h>

openvela 实现说明

• 选网模式：支持自动选网（select_auto）和手动选网（select_manual）
• 扫描：tapi_network_scan 扫描可用的网络运营商
• 小区信息：get_serving_cellinfos 获取当前服务小区，get_neighbouring_cellinfos 获取相邻小区
• SIM 卡标识：大部分接口带 slot_id，区分不同 SIM 卡槽的网络状态
• 事件订阅：tapi_network_register / tapi_network_unregister 监听注册状态/信号强度变化

选网与扫描

tapi_network_select_auto

int tapi_network_select_auto(tapi_context context, int slot_id, int event_id, tapi_async_function p_handle);

自动选择网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• event_id 事件 ID，用于回调匹配。
• p_handle 异步回调函数。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_select_manual

int tapi_network_select_manual(tapi_context context, int slot_id, int event_id, tapi_operator_info* network, tapi_async_function p_handle);

手动选择网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• event_id 事件 ID，用于回调匹配。
• network 网络信息。
• p_handle 异步回调函数。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_scan

int tapi_network_scan(tapi_context context, int slot_id, int event_id, tapi_async_function p_handle);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• event_id 事件 ID，用于回调匹配。
• p_handle 异步回调函数。

返回值：

成功时返回 0，失败时返回负的错误码。

小区信息

tapi_network_get_serving_cellinfos

int tapi_network_get_serving_cellinfos(tapi_context context, int slot_id, int event_id, tapi_async_function p_handle);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• event_id 事件 ID，用于回调匹配。
• p_handle 异步回调函数。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_get_neighbouring_cellinfos

int tapi_network_get_neighbouring_cellinfos(tapi_context context, int slot_id, int event_id, tapi_async_function p_handle);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• event_id 事件 ID，用于回调匹配。
• p_handle 异步回调函数。

返回值：

成功时返回 0，失败时返回负的错误码。

语音网络状态

tapi_network_is_voice_registered

int tapi_network_is_voice_registered(tapi_context context, int slot_id, bool* out);

查询是否已注册语音服务。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• out 输出参数。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_is_voice_emergency_only

int tapi_network_is_voice_emergency_only(tapi_context context, int slot_id, bool* out);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• out 输出参数。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_get_voice_network_type

int tapi_network_get_voice_network_type(tapi_context context, int slot_id, tapi_network_type* out);

获取语音网络类型。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• out 输出参数。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_is_voice_roaming

int tapi_network_is_voice_roaming(tapi_context context, int slot_id, bool* out);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• out 输出参数。

返回值：

成功时返回 0，失败时返回负的错误码。

运营商信息

tapi_network_get_display_name

int tapi_network_get_display_name(tapi_context context, int slot_id, char** out);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• out 输出参数。

返回值：

成功时返回 0，失败时返回负的错误码。

信号强度

tapi_network_get_signalstrength

int tapi_network_get_signalstrength(tapi_context context, int slot_id, tapi_signal_strength* out);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• out 输出参数。

返回值：

成功时返回 0，失败时返回负的错误码。

注册信息

tapi_network_get_registration_info

int tapi_network_get_registration_info(tapi_context context, int slot_id, int event_id, tapi_async_function p_handle);

获取网络注册信息。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• event_id 事件 ID，用于回调匹配。
• p_handle 异步回调函数。

返回值：

成功时返回 0，失败时返回负的错误码。

上报频率与事件

tapi_network_set_cell_info_list_rate

int tapi_network_set_cell_info_list_rate(tapi_context context, int slot_id, int event_id, u_int32_t period, tapi_async_function p_handle);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• event_id 事件 ID，用于回调匹配。
• period 周期（毫秒）。
• p_handle 异步回调函数。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_register

int tapi_network_register(tapi_context context, int slot_id, tapi_indication_msg msg, void* user_obj, tapi_async_function p_handle);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• msg 消息内容。
• user_obj 用户对象指针。
• p_handle 异步回调函数。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_unregister

int tapi_network_unregister(tapi_context context, int watch_id);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• watch_id 监听 ID（用于取消监听）。

返回值：

成功时返回 0，失败时返回负的错误码。

MCC / MNC

tapi_network_get_mcc

int tapi_network_get_mcc(tapi_context context, int slot_id, char** mcc);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• mcc 移动国家码。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_get_mnc

int tapi_network_get_mnc(tapi_context context, int slot_id, char** mnc);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• mnc 移动网络码。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_get_operator_status

int tapi_network_get_operator_status(tapi_context context, int slot_id, int* out);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• out 输出参数。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_get_operator_name

int tapi_network_get_operator_name(tapi_context context, int slot_id, char** out);

获取运营商名称。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• out 输出参数。

返回值：

成功时返回 0，失败时返回负的错误码。

tapi_network_get_reg_state

int tapi_network_get_reg_state(tapi_context context, int slot_id, tapi_registration_state* out);

手动选择指定网络。

参数：

• context Telephony 上下文句柄。
• slot_id SIM 卡槽 ID（0 或 1）。
• out 输出参数。

返回值：

成功时返回 0，失败时返回负的错误码。