ril_client.h File Reference

RIL 客户端 GDBus 连接和生命周期 More...

#include <stdbool.h>
#include <gio/gio.h>
#include <tbox/sms.h>
#include <tbox/voice.h>

Go to the source code of this file.

Enumerations
enum	ril_client_domain_t {   RIL_CLIENT_CORE , RIL_CLIENT_DATA , RIL_CLIENT_RADIO , RIL_CLIENT_SIM ,   RIL_CLIENT_SMS , RIL_CLIENT_VOICE }
	RIL 客户端类型化 GDBus proxy 功能域。 More...

Functions
int	ril_client_call_begin (ril_client_domain_t domain, bool callback_safe, void **proxy)
	取得一次类型化调用使用的 proxy 引用。
int	ril_client_call_end (void *proxy, gboolean succeeded, GError **error, const char *method)
	结束一次类型化调用并映射 GError。
int	ril_client_register_sms_callback (tbox_sms_callback_t callback, void *context)
	注册短信接收回调。
int	ril_client_unregister_sms_callback (void)
	注销短信接收回调。
int	ril_client_register_voice_callback (tbox_voice_callback_t callback, void *context)
	注册语音和 eCall 事件回调。
int	ril_client_unregister_voice_callback (void)
	注销语音和 eCall 事件回调。

Detailed Description

RIL 客户端 GDBus 连接和生命周期

Version

1.0.0

Date

2026-07-21

Copyright

Copyright © 2026 Shenzhen One IOT World Co., Ltd. All rights reserved.

Enumeration Type Documentation

ril_client_domain_t

enum ril_client_domain_t

RIL 客户端类型化 GDBus proxy 功能域。

Enumerator
RIL_CLIENT_CORE	Core 功能域。
RIL_CLIENT_DATA	Data 功能域。
RIL_CLIENT_RADIO	Radio 功能域。
RIL_CLIENT_SIM	SIM 功能域。
RIL_CLIENT_SMS	SMS 功能域。
RIL_CLIENT_VOICE	Voice 功能域。

Function Documentation

ril_client_call_begin()

int ril_client_call_begin	(	ril_client_domain_t	domain,
		bool	callback_safe,
		void **	proxy )

取得一次类型化调用使用的 proxy 引用。

Parameters

domain	功能域。
callback_safe	是否允许从回调线程调用。
proxy	输出生成的 GDBus proxy。

Returns

TBOX_OK 成功，其他值失败。

ril_client_call_end()

int ril_client_call_end	(	void *	proxy,
		gboolean	succeeded,
		GError **	error,
		const char *	method )

结束一次类型化调用并映射 GError。

Parameters

proxy	ril_client_call_begin 返回的 proxy。
succeeded	生成 proxy 的调用结果。
error	生成 proxy 返回的详细错误；本函数负责释放。
method	用于日志的类型化方法名。

Returns

TBOX_OK 成功，其他值为映射后的现有错误码。

ril_client_register_sms_callback()

int ril_client_register_sms_callback	(	tbox_sms_callback_t	callback,
		void *	context )

注册短信接收回调。

Parameters

callback	短信接收回调。
context	回调上下文。

Returns

TBOX_OK 成功，其他值失败。

ril_client_register_voice_callback()

int ril_client_register_voice_callback	(	tbox_voice_callback_t	callback,
		void *	context )

注册语音和 eCall 事件回调。

Parameters

callback	语音事件回调。
context	回调上下文。

Returns

TBOX_OK 成功，其他值失败。

ril_client_unregister_sms_callback()

int ril_client_unregister_sms_callback

(

void

)

注销短信接收回调。

Returns

TBOX_OK 成功，其他值失败。

ril_client_unregister_voice_callback()

int ril_client_unregister_voice_callback

(

void

)

注销语音和 eCall 事件回调。

Returns

TBOX_OK 成功，其他值失败。