短信管理 API更新时间:2026-05-22 21:10:10
短信管理 API
短信发送和接收。
头文件:#include <tapi_sms.h>
openvela 实现说明
- 文本与数据短信:send_message 发送文本短信,send_data_message 发送二进制 PDU
- 服务中心地址:通过 set_service_center_address / get_service_center_address 配置运营商短信网关
- 送达报告:可通过 enable_delivery_report 开关送达报告
- SIM 卡存储:提供 get_all_messages_from_sim / copy_message_to_sim / delete_message_from_sim 操作 SIM 卡上的短信
- 事件订阅:tapi_sms_register 监听收件/发件事件
发送短信
tapi_sms_send_message
int tapi_sms_send_message(tapi_context context, int slot_id, int sms_id, char* number, char* text, int event_id, tapi_async_function p_handle);
发送短信。
参数:
- context Telephony 上下文句柄。
- slot_id SIM 卡槽 ID(0 或 1)。
- sms_id 短信 ID。
- number 电话号码。
- text 文本内容。
- event_id 事件 ID,用于回调匹配。
- p_handle 异步回调函数。
返回值:
成功时返回 0,失败时返回负的错误码。
tapi_sms_send_data_message
int tapi_sms_send_data_message(tapi_context context, int slot_id, int sms_id, char* dest_addr, unsigned int port, char* text, int event_id, tapi_async_function p_handle);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- slot_id SIM 卡槽 ID(0 或 1)。
- sms_id 短信 ID。
- dest_addr 目标号码。
- port 端口号。
- text 文本内容。
- event_id 事件 ID,用于回调匹配。
- p_handle 异步回调函数。
返回值:
成功时返回 0,失败时返回负的错误码。
服务中心与送达报告
tapi_sms_set_service_center_address
bool tapi_sms_set_service_center_address(tapi_context context, int slot_id, char* number);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- slot_id SIM 卡槽 ID(0 或 1)。
- number 电话号码。
返回值:
成功时返回 0,失败时返回负的错误码。
tapi_sms_get_service_center_address
int tapi_sms_get_service_center_address(tapi_context context, int slot_id, char** number);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- slot_id SIM 卡槽 ID(0 或 1)。
- number 电话号码。
返回值:
成功时返回 0,失败时返回负的错误码。
tapi_sms_enable_delivery_report
int tapi_sms_enable_delivery_report(tapi_context context, int slot_id, bool enable);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- slot_id SIM 卡槽 ID(0 或 1)。
- enable 是否启用。
返回值:
成功时返回 0,失败时返回负的错误码。
tapi_sms_get_delivery_report_status
int tapi_sms_get_delivery_report_status(tapi_context context, int slot_id, bool* out);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- slot_id SIM 卡槽 ID(0 或 1)。
- out 输出参数。
返回值:
成功时返回 0,失败时返回负的错误码。
SIM 卡短信存储
tapi_sms_get_all_messages_from_sim
int tapi_sms_get_all_messages_from_sim(tapi_context context, int slot_id, tapi_message_list* list, tapi_async_function p_handle);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- slot_id SIM 卡槽 ID(0 或 1)。
- list 列表。
- p_handle 异步回调函数。
返回值:
成功时返回 0,失败时返回负的错误码。
tapi_sms_copy_message_to_sim
int tapi_sms_copy_message_to_sim(tapi_context context, int slot_id, char* number, char* text, char* send_time, int type);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- slot_id SIM 卡槽 ID(0 或 1)。
- number 电话号码。
- text 文本内容。
- send_time 发送时间。
- type 类型。
返回值:
成功时返回 0,失败时返回负的错误码。
tapi_sms_delete_message_from_sim
int tapi_sms_delete_message_from_sim(tapi_context context, int slot_id, int index);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- slot_id SIM 卡槽 ID(0 或 1)。
- index 索引。
返回值:
成功时返回 0,失败时返回负的错误码。
事件订阅与默认卡
tapi_sms_register
int tapi_sms_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_sms_unregister
int tapi_sms_unregister(tapi_context context, int watch_id);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- watch_id 监听 ID(用于取消监听)。
返回值:
成功时返回 0,失败时返回负的错误码。
tapi_sms_set_default_slot
int tapi_sms_set_default_slot(tapi_context context, int slot_id);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- slot_id SIM 卡槽 ID(0 或 1)。
返回值:
成功时返回 0,失败时返回负的错误码。
tapi_sms_get_default_slot
int tapi_sms_get_default_slot(tapi_context context, int* out);
发送数据短信。
参数:
- context Telephony 上下文句柄。
- out 输出参数。
返回值:
成功时返回 0,失败时返回负的错误码。
文档内容是否有帮助?
有帮助
无帮助