核心服务

• 简介

• 目录

• 约束

• 接口说明

  • SIM卡对外提供的接口
  • 搜网服务对外提供的接口

• 使用说明

  • 搜网
  • SIM卡

• 相关仓

简介

核心服务模块主要功能是初始化SIM卡服务、搜网服务和RIL管理，以及获取RIL Adapter服务。

通过注册回调服务，实现与RIL Adapter进行通信；通过发布订阅，来实现与各功能模块的通信。

图 1 核心服务架构图

上图示中核心服务关联的业务服务包括SIM卡服务、搜网服务、RIL通信管理。

• SIM卡服务：主要是SIM卡初始化，文件读写，加载状态通知，单双卡控制，包括SIM卡状态查询、SIM卡管理、SIM卡控制、STK、联系人存储、短信存储。
• 搜网服务：主要是网络注册，网络状态获取，包括网络注册、网络模式查询、IMS网络状态上报、Radio状态查询、搜网管理、信号强度查询、小区管理、驻网管理、时间时区更新。
• RIL管理：提供主动回调服务，查询结果回调服务等。

目录

/base/telephony/core_service
├── figures                       # Readme资源文件
├── frameworks                    # 框架层目录
│   ├── js                        # js相关代码
│   └── native                    # native相关代码
├── interfaces                    # 接口目录
│   ├── innerkits                 # 部件间的内部接口
│   └── kits                      # 对应用提供的接口（例如JS接口）
├── sa_profile                    # 核心服务的启动文件目录
├── services                      # 核心服务实现代码目录
│   ├── core                      # 核心服务的核心文件目录
│   ├── etc                       # 核心服务的驱动脚本目录
|   ├── ims_service_interaction   # IMS网络状态上报实现代码目录
│   ├── network_search            # 搜网服务代码目录
│   ├── sim                       # SIM卡服务代码目录
│   └── tel_ril                   # 核心服务与RIL Adapter通信代码目录
├── test                          # 核心服务测试代码目录
│   ├── fuzztest                  # 模糊测试相关代码
│   └── unittest                  # 单元测试相关代码
└── utils                         # 核心服务工具代码目录
    ├── common                    # 核心服务通用工具目录
    ├── log                       # 核心服务日志工具目录
    └── preferences               # 核心服务属性偏好工具目录

约束

• 开发语言：C++ 、Java Script。
• 软件约束：需要与以下服务配合使用：HDF(drivers_interface，driver_peripheral)，RIL适配（ril_adapter），状态注册服务（state_registry）。
• 硬件约束：需要搭载的设备支持以下硬件：可以进行独立蜂窝通信的Modem以及SIM卡。

接口说明

核心服务模块需要提供SIM卡，搜网相关模块的接口。

SIM卡对外提供的接口

完整的JS API说明以及实例代码请参考：SIM卡管理。

搜网服务对外提供的接口

完整的JS API说明以及实例代码请参考：网络搜索。

说明：

RIL管理不对外暴露接口，由电话服务子系统其他各个模块调用。

使用说明

搜网

获取网络状态接口调用流程及示例代码：

1. 指定查询的slotId，若不指定默认查询主卡信息。

2. 可以通过callback或者Promise的方式调用getNetworkState方法，返回网络状态信息。

3. 该接口为异步接口，相关执行结果会从callback中返回。

   import radio from "@ohos.telephony.radio";
   
   // 参数赋值
   let slotId = 0;
   
   // 调用接口【callback方式】
   radio.getNetworkState(slotId, (err, value) => {
     if (err) {
       // 接口调用失败，err非空
       console.error(`failed to getNetworkState because ${err.message}`);
       return;
     }
     // 接口调用成功，err为空
     console.log(`success to getNetworkState: ${value}`);
   });
   
   // 调用接口【Promise方式】
   let promise = radio.getNetworkState(slotId);
   promise.then((value) => {
     // 接口调用成功，此处可以实现成功场景分支代码。
     console.log(`success to getNetworkState: ${value}`);
   }).catch((err) => {
     // 接口调用失败，此处可以实现失败场景分支代码。
     console.error(`failed to getNetworkState because ${err.message}`);
   });

SIM卡

查询指定SIM卡的状态接口调用流程及示例代码：

1. 指定查询的slotId。

2. 可以通过callback或者Promise的方式调用getSimState方法，返回卡状态信息。

3. 该接口为异步接口，相关执行结果会从callback中返回。

   import sim from "@ohos.telephony.sim";
   
   // 参数赋值
   let slotId = 0;
   
   // 调用接口【callback方式】
   sim.getSimState(slotId, (err, value) => {
     if (err) {
       // 接口调用失败，err非空
       console.error(`failed to getSimState because ${err.message}`);
       return;
     }
     // 接口调用成功，err为空
     console.log(`success to getSimState: ${value}`);
   });
   
   // 调用接口【Promise方式】
   let promise = sim.getSimState(slotId);
   promise.then((value) => {
     // 接口调用成功，此处可以实现成功场景分支代码。
     console.log(`success to getSimState: ${value}`);
   }).catch((err) => {
     // 接口调用失败，此处可以实现失败场景分支代码。
     console.error(`failed to getSimState because ${err.message}`);
   });

相关仓

电话服务子系统

telephony_core_service

telephony_sms_mms

drivers_interface

drivers_peripheral

telephony_ril_adapter