蜂窝数据

简介
目录
约束
接口说明
使用说明
相关仓

简介

蜂窝数据模块作为电话子系统可裁剪部件，依赖于core_service核心服务、ril_adapter。具有蜂窝数据激活、蜂窝数据异常检测与恢复、蜂窝数据状态管理、蜂窝数据开关管理、蜂窝数据漫游管理、APN管理、网络管理交互等功能。

图 1 蜂窝数据模块架构图

base/telephony/cellular_data/
├── figures                              # Readme资源文件
├── frameworks                           # 框架层目录
│   ├── js                               # js相关代码
│   └── native                           # native相关代码
├── interfaces                           # 接口目录
│   ├── innerkits                        # 部件间的内部接口
│   └── kits                             # 对应用提供的接口（例如JS接口）
├── sa_profile                           # SA配置
├── services                             # 蜂窝数据服务代码目录
│   ├── include                          # 蜂窝数据服务头文件目录
│   └── src                              # 蜂窝数据服务实现代码目录
│       ├── apn_manager                  # APN管理代码目录
│       ├── state_machine                # 数据连接状态机代码目录
│       └── utils                        # 蜂窝数据工具代码目录
└── test                                 # 蜂窝数据测试代码目录
    └── unit_test                        # 单元测试相关代码

约束

开发语言：Java Script。
软件上，需要与以下服务配合使用：Telephony核心服务（core_service）、RIL适配（ril_adapter）。
硬件上，需要搭载的设备支持以下硬件：可以进行独立蜂窝通信的Modem以及SIM卡。

接口说明

表 1 蜂窝数据对外提供的接口

接口名称	接口描述	所需权限
function isCellularDataEnabled(callback: AsyncCallback<boolean>): void;	获取蜂窝数据开关是否打开	ohos.permission.GET_NETWORK_INFO
function getCellularDataState(callback: AsyncCallback<DataConnectState>): void;	获取蜂窝数据状态	无
function isCellularDataEnabledSync(): boolean;	获取蜂窝移动数据服务是否启用	ohos.permission.GET_NETWORK_INFO
function isCellularDataRoamingEnabledSync(slotId: number): boolean;	获取蜂窝数据漫游服务是否启用（参数slotId为SIM卡id，0表示卡一，1表示卡二）	ohos.permission.GET_NETWORK_INFO

完整的JS API说明以及实例代码请参考：蜂窝数据。

使用说明

获取蜂窝数据开关是否打开

可以通过callback或者Promise的方式调用isCellularDataEnabled获取蜂窝数据开关是否打开。

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

import data from "@ohos.telephony.data";

// 调用接口【callback方式】
data.isCellularDataEnabled((err, value) => {
  if (err) {
    // 接口调用失败，err非空
    console.error(`failed to isCellularDataEnabled because ${err.message}`);
    return;
  }
  // 接口调用成功，err为空
  console.log(`success to isCellularDataEnabled: ${value}`);
});

// 调用接口【Promise方式】
let promise = data.isCellularDataEnabled();
promise.then((value) => {
  // 接口调用成功，此处可以实现成功场景分支代码。
  console.log(`success to isCellularDataEnabled: ${value}`);
}).catch((err) => {
  // 接口调用失败，此处可以实现失败场景分支代码。
  console.error(`failed to isCellularDataEnabled because ${err.message}`);
});

获取蜂窝移动数据服务是否启用

可以通过调用isCellularDataEnabledSync获取蜂窝移动数据服务是否启用。

该接口为同步接口，相关执行结果会从isCellularDataEnabledSync中返回。

import data from "@ohos.telephony.data";

try {
	// 调用接口【Sync方式】
	let isEnabled: boolean = data.isCellularDataEnabledSync();
	// 调用接口成功
    console.log(`isCellularDataEnabledSync success : ${isEnabled}`);
} catch (error) {
	// 调用接口失败
    console.log(`isCellularDataEnabledSync failed`);  
}

获取蜂窝数据漫游服务是否启用

可以通过调用isCellularDataRoamingEnabledSync获取蜂窝数据漫游服务是否启用。

该接口为同步接口，相关执行结果会从isCellularDataRoamingEnabledSync中返回。

import data from "@ohos.telephony.data";

try {
	// 调用接口【Sync方式】
	let isEnabled: boolean = data.isCellularDataRoamingEnabledSync(0);
	// 调用接口成功
    console.log(`isCellularDataRoamingEnabledSync success : ${isEnabled}`);
} catch (error) {
	// 调用接口失败
    console.log(`isCellularDataRoamingEnabledSync failed`);  
}

获取蜂窝数据状态

表 2 DataConnectState枚举值

名称	值	说明
DATA_STATE_UNKNOWN	-1	未知
DATA_STATE_DISCONNECTED	0	连接断开
DATA_STATE_CONNECTING	1	连接中
DATA_STATE_CONNECTED	2	已连接
DATA_STATE_SUSPENDED	3	已挂起

可以通过callback或者Promise的方式调用getCellularDataState获取蜂窝数据状态。