蜂窝数据

简介
目录
约束
接口说明
使用说明
- 获取蜂窝数据开关是否打开
- 获取蜂窝数据状态
相关仓

简介

蜂窝数据模块作为电话子系统可裁剪部件，依赖于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;	获取蜂窝数据状态	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}`);
});

获取蜂窝数据状态

表 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获取蜂窝数据状态。

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

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

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

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

Aurora / telephony_cellular_data_1019_gy

蜂窝数据

简介

目录

约束

接口说明

使用说明

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

获取蜂窝数据状态

相关仓

简介

发行版

贡献者

近期动态

Aurora / telephony_cellular_data_1019_gy .gitee-modal { width: 500px !important; }

蜂窝数据

简介

目录

约束

接口说明

使用说明

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

获取蜂窝数据状态

相关仓

简介

发行版

贡献者

近期动态

搜索帮助

Aurora / telephony_cellular_data_1019_gy