diff --git a/zh-cn/readme/figures/zh-cn_architecture-of-telephony-subsystem.png b/zh-cn/readme/figures/zh-cn_architecture-of-telephony-subsystem.png index a7de4844d182c5214de31a389fb084ea5552a99e..de39bfae502cd4fc2fd39dcd35834a98e34bb2f6 100755 Binary files a/zh-cn/readme/figures/zh-cn_architecture-of-telephony-subsystem.png and b/zh-cn/readme/figures/zh-cn_architecture-of-telephony-subsystem.png differ diff --git "a/zh-cn/readme/\347\224\265\350\257\235\346\234\215\345\212\241\345\255\220\347\263\273\347\273\237.md" "b/zh-cn/readme/\347\224\265\350\257\235\346\234\215\345\212\241\345\255\220\347\263\273\347\273\237.md" old mode 100755 new mode 100644 index bf5a7381cd16ace76e26406e09734bf2d3009acc..af05135d8347c7fed29359967831f316a5056c8c --- "a/zh-cn/readme/\347\224\265\350\257\235\346\234\215\345\212\241\345\255\220\347\263\273\347\273\237.md" +++ "b/zh-cn/readme/\347\224\265\350\257\235\346\234\215\345\212\241\345\255\220\347\263\273\347\273\237.md" @@ -18,8 +18,11 @@ - 核心服务模块:主要功能是初始化RIL管理、SIM卡和搜网模块。 - 通话管理模块:主要功能是管理CS(Circuit Switch,电路交换)、IMS(IP Multimedia Subsystem,IP多媒体子系统)和OTT(over the top,OTT解决方案)三种类型的通话,申请通话所需要的音视频资源,处理多路通话时产生的各种冲突。 - 蜂窝通话模块:主要功能是实现基于运营商网络的基础通话。 +- 蜂窝数据模块:主要功能是实现基于运营商网络的蜂窝数据上网。 - 短彩信模块:主要功能是短信收发和彩信编解码。 -- 状态注册模块:主要功能是提供电话服务子系统各种消息事件的订阅以及取消订阅的API。 +- 状态订阅模块:主要功能是提供电话服务子系统各种消息事件的订阅以及取消订阅的API。 +- 数据存储模块:主要功能是持久化数据存储,提供DataAbility访问接口。 +- RIL Adapter模块: 主要功能是与modem通信接口的适配。 **图 1** 子系统架构图 @@ -32,16 +35,22 @@ base/telephony/ ├── core_service # 核心服务 ├── call_manager # 通话管理 ├── cellular_call # 蜂窝通话 +├── cellular_data # 蜂窝数据 ├── sms_mms # 短彩信 -└── state_registry # 状态注册 +├── state_registry # 状态订阅 +├── data_storage # 数据存储 +└── ril_adapter # RIL Adapter ``` ## 约束 -1. 目前开源的范围仅支持蜂窝通话(仅支持CS通话)和短信,不支持蜂窝数据上网,仅支持单SIM卡。 +1. 目前开源的范围包括蜂窝通话(仅支持CS通话)、短信、数据上网,支持双SIM卡框架。 +2. 南向HDI依赖芯片厂商适配,详见:[电话服务南向开发指导](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-tel.md)。 ## 使用说明 +具体请参考子模块README,下面以获取当前蜂窝网络信号信息和观察蜂窝网络状态变化为例,说明电话服务子系统接口调用请求和状态订阅的使用方法。 + ### 获取当前蜂窝网络信号信息 1. 从@ohos.telephony.radio.d.ts中导入radio命名空间。 @@ -54,7 +63,7 @@ base/telephony/ import radio from "@ohos.telephony.radio"; // 参数赋值 - let slotId = 1; + let slotId = 0; // 调用接口【callback方式】 radio.getSignalInformation(slotId, (err, value) => { @@ -96,14 +105,8 @@ base/telephony/ import observer from '@ohos.telephony.observer'; // 开启订阅 - observer.on('networkStateChange', {slotId: 1}, (err, value) => { - if (err) { - // 接口调用失败,err非空 - console.error(`failed, because ${err.message}`); - return; - } - // 接口调用成功,err为空 - console.log(`success on. network state is ` + value); + observer.on('networkStateChange', {slotId: 0}, (value) => { + console.log(`network state is ` + value); }); ``` @@ -111,22 +114,14 @@ base/telephony/ **停止观察** 1. 从@ohos.telephony.observer.d.ts中导入observer命名空间。 -2. 调用off\(type: 'networkStateChange'\)方法,传入添加观察事件时的callback对象。 +2. 调用off\(type: 'networkStateChange'\)方法,传入添加观察事件时的callback对象(可选)。 ``` // 引入包名 import observer from '@ohos.telephony.observer'; // 关闭订阅 - observer.off('networkStateChange', (err, value) => { - if (err) { - // 接口调用失败,err非空 - console.error(`failed, because ${err.message}`); - return; - } - // 接口调用成功,err为空 - console.log(`success off`); - }); + observer.off('networkStateChange'); ``` @@ -134,12 +129,18 @@ base/telephony/ **电话服务子系统** -[telephony_core_service](https://gitee.com/openharmony/telephony_core_service/blob/master/README_zh.md) +[telephony\_core\_service](https://gitee.com/openharmony/telephony_core_service/blob/master/README_zh.md) -[telephony_call_manager](https://gitee.com/openharmony/telephony_call_manager/blob/master/README_zh.md) +[telephony\_call\_manager](https://gitee.com/openharmony/telephony_call_manager/blob/master/README_zh.md) -[telephony_cellular_call](https://gitee.com/openharmony/telephony_cellular_call/blob/master/README_zh.md) +[telephony\_cellular\_call](https://gitee.com/openharmony/telephony_cellular_call/blob/master/README_zh.md) + +[telephony\_cellular\_data](https://gitee.com/openharmony/telephony_cellular_data/blob/master/README_zh.md) [telephony\_sms\_mms](https://gitee.com/openharmony/telephony_sms_mms/blob/master/README_zh.md) [telephony\_state\_registry](https://gitee.com/openharmony/telephony_state_registry/blob/master/README_zh.md) + +[telephony\_data\_storage](https://gitee.com/openharmony/telephony_data_storage/blob/master/README_zh.md) + +[telephony\_ril\_adapter](https://gitee.com/openharmony/telephony_ril_adapter/blob/master/README_zh.md) \ No newline at end of file