Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 ff84eebd 编写于 作者: H Hongjin Li
浏览文件
操作

feat: 【资料】API文档补充：蜂窝数据，短信，通话 

Signed-off-by: NHongjin Li <lihongjin1@huawei.com>
Change-Id: Ie3908a7dd68e2f5cc9bc745ce279d4f13a11fe5b
上级 5241b375
显示空白变更内容
内联 并排
Showing with 462 addition and 19 deletion
zh-cn/application-dev/reference/apis/js-apis-call.md
浏览文件 @ ff84eebd
......@@ -17,7 +17,9 @@ dial\(phoneNumber: string, callback: AsyncCallback<boolean\>\): void
拨打电话，使用callback方式作为异步方法。
需要权限：ohos.permission.PLACE\_CALL权限，该权限为系统权限。
**需要权限**：ohos.permission.PLACE\_CALL，该权限为系统权限
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
......@@ -41,7 +43,9 @@ dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback<boolean
拨打电话，可设置通话参数，使用callback方式作为异步方法。
需要权限：ohos.permission.PLACE\_CALL权限，该权限为系统权限。
**需要权限**：ohos.permission.PLACE\_CALL，该权限为系统权限
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
......@@ -68,7 +72,9 @@ dial\(phoneNumber: string, options?: DialOptions\): Promise<boolean\>
拨打电话，可设置通话参数，使用promise方式作为异步方法。
需要权限：ohos.permission.PLACE\_CALL权限，该权限为系统权限。
**需要权限**：ohos.permission.PLACE\_CALL，该权限为系统权限
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
......@@ -102,6 +108,8 @@ hasCall\(callback: AsyncCallback<boolean\>\): void
判断是否存在通话，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
| 参数 | 类型 | 必填 | 说明 |
......@@ -123,6 +131,8 @@ hasCall\(\): Promise<boolean\>
判断是否存在通话，使用Promise方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CallManager
**返回值：**
| 类型 | 说明 |
......@@ -147,6 +157,8 @@ getCallState\(callback: AsyncCallback<CallState\>\): void
获取通话状态，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
| 参数 | 类型 | 必填 | 说明 |
......@@ -168,6 +180,8 @@ getCallState\(\): Promise<CallState\>
获取通话状态，使用Promise方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CallManager
**返回值：**
| 类型 | 说明 |
......@@ -191,6 +205,8 @@ isEmergencyPhoneNumber\(phoneNumber: string, callback: AsyncCallback<boolean\>\)
判断是否是紧急电话号码，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
| 参数 | 类型 | 必填 | 说明 |
......@@ -213,6 +229,8 @@ isEmergencyPhoneNumber\(phoneNumber: string, options: EmergencyNumberOptions, ca
判断是否是紧急电话号码，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
| 参数 | 类型 | 必填 | 说明 |
......@@ -236,6 +254,8 @@ isEmergencyPhoneNumber\(phoneNumber: string, options?: EmergencyNumberOptions\):
判断是否是紧急电话号码，使用promise方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
| 参数 | 类型 | 必填 | 说明 |
......@@ -266,6 +286,8 @@ formatPhoneNumber\(phoneNumber: string, callback: AsyncCallback<string\>\): void
格式化电话号码，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
| 参数 | 类型 | 必填 | 说明 |
......@@ -288,6 +310,8 @@ formatPhoneNumber\(phoneNumber: string, options: NumberFormatOptions, callback:
格式化电话号码，可设置格式化参数，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
| 参数 | 类型 | 必填 | 说明 |
......@@ -313,6 +337,8 @@ formatPhoneNumber\(phoneNumber: string, options?: NumberFormatOptions\): Promise
格式化电话号码，可设置格式化参数，使用promise方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
| 参数 | 类型 | 必填 | 说明 |
......@@ -349,6 +375,8 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string, callback: Asy
支持所有国家码。
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
| 参数 | 类型 | 必填 | 说明 |
......@@ -378,6 +406,8 @@ formatPhoneNumberToE164\(phoneNumber: string, countryCode: string\): Promise<str
支持所有国家码。
**系统能力**：SystemCapability.Telephony.CallManager
**参数：**
| 参数 | 类型 | 必填 | 说明 |
......@@ -407,6 +437,9 @@ promise.then(data => {
## DialOptions<a name=DialOptions></a>
拨打电话的可选参数。
**系统能力**：SystemCapability.Telephony.CallManager
| 参数 | 类型 | 必填 | 说明 |
| ------ | ------- | ---- | ------------------------------------------------------------ |
| extras | boolean | 否 | 根据extras的值判断是否为视频通话，默认为语音通话。<br/>- true：视频通话。<br/>- fasle：语音通话。 |
......@@ -414,16 +447,20 @@ promise.then(data => {
## CallState<a name=CallState></a>
通话状态码。
| 变量 | 值 | 说明 |
| ------------------ | ---- | ------------------------------------------------------------ |
| CALL_STATE_UNKNOWN | -1 | 无效状态，当获取呼叫状态失败时返回。 |
| CALL_STATE_IDLE | 0 | 表示没有正在进行的呼叫。 |
| CALL_STATE_RINGING | 1 | 表示来电正在振铃或等待。 |
| CALL_STATE_OFFHOOK | 2 | 表示至少有一个呼叫处于拨号、通话中或呼叫保持状态，并且没有新的来电振铃或等待。 |
| CALL_STATE_UNKNOWN | -1 | 无效状态，当获取呼叫状态失败时返回。<br />**系统能力**：SystemCapability.Telephony.CallManager |
| CALL_STATE_IDLE | 0 | 表示没有正在进行的呼叫。<br />**系统能力**：SystemCapability.Telephony.CallManager |
| CALL_STATE_RINGING | 1 | 表示来电正在振铃或等待。<br />**系统能力**：SystemCapability.Telephony.CallManager |
| CALL_STATE_OFFHOOK | 2 | 表示至少有一个呼叫处于拨号、通话中或呼叫保持状态，并且没有新的来电振铃或等待。<br />**系统能力**：SystemCapability.Telephony.CallManager |
## EmergencyNumberOptions<sup>7+</sup><a name=EmergencyNumberOptions></a>
判断是否是紧急电话号码的可选参数。
**系统能力**：SystemCapability.Telephony.CallManager
| 参数 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------------ |
| slotId | number | 否 | 卡槽ID：<br/>- 0：卡槽1。<br/>- 1：卡槽2。 |
......@@ -431,6 +468,9 @@ promise.then(data => {
## NumberFormatOptions<sup>7+</sup><a name=NumberFormatOptions></a>
格式化号码的可选参数。
**系统能力**：SystemCapability.Telephony.CallManager
| 参数 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------------------------------------------------------- |
| countryCode | string | 否 | 国家码，支持所有国家的国家码，如：中国（CN）。默认为：CN。 |
\ No newline at end of file
zh-cn/application-dev/reference/apis/js-apis-observer.md
浏览文件 @ ff84eebd
......@@ -177,3 +177,89 @@ observer.off('signalInfoChange', callback);
observer.off('signalInfoChange');
```
## observer.on('callStateChange')<a name=observer.on.callStateChange-callback></a>
on(type: 'callStateChange', callback: Callback\<{ state: [CallState](js-apis-call.md#CallState), number: string }\>): void;
订阅通话状态变化事件，使用callback方式作为异步方法。
**需要权限**：ohos.permission.READ_CALL_LOG
**系统能力**：SystemCapability.Telephony.StateRegistry
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 通话状态变化事件 |
| callback | Callback\<{ state: [CallState](js-apis-call.md#CallState), number: string }\> | 是 | 回调函数，参考call的[CallState](js-apis-call.md#CallState)<br />number：电话号码 |
**示例：**
```
observer.on('callStateChange', value =>{
console.log("on callStateChange, state:" + value.state + ", number:" + value.number);
});
```
## observer.on('callStateChange')<a name=observer.on.callStateChange.options-callback></a>
on(type: 'callStateChange', options: { slotId: number }, callback: Callback<{ state: [CallState](js-apis-call.md#CallState), number: string }>): void;
订阅通话状态变化事件，使用callback方式作为异步方法。
**需要权限**：ohos.permission.READ_CALL_LOG
**系统能力**：SystemCapability.Telephony.StateRegistry
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 通话状态变化事件 |
| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 |
| callback | Callback\<{ state: [CallState](js-apis-call.md#CallState), number: string }\> | 是 | 回调函数，参考call的[CallState](js-apis-call.md#CallState)<br />number：电话号码 |
**示例：**
```
observer.on('callStateChange', {slotId: 0}, value =>{
console.log("on callStateChange, state:" + value.state + ", number:" + value.number);
});
```
## observer.off('callStateChange')<a name=observer.off.callStateChange-callback></a>
off(type: 'callStateChange', callback?: Callback<{ state: [CallState](js-apis-call.md#CallState), number: string }>): void;
取消订阅通话状态变化事件，使用callback方式作为异步方法。
**需要权限**：ohos.permission.READ_CALL_LOG
>**说明：**
>
>可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
**系统能力**：SystemCapability.Telephony.StateRegistry
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| type | string | 是 | 通话状态变化事件 |
| callback | Callback\<{ state: [CallState](js-apis-call.md#CallState), number: string }\> | 否 | 回调函数，参考call的[CallState](js-apis-call.md#CallState)<br />number：电话号码 |
**示例：**
```
let callback = value => {
console.log("on callStateChange, state:" + value.state + ", number:" + value.number);
}
observer.on('callStateChange', callback);
// 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
observer.off('callStateChange', callback);
observer.off('callStateChange');
```
zh-cn/application-dev/reference/apis/js-apis-sms.md
浏览文件 @ ff84eebd
......@@ -16,6 +16,8 @@ createMessage\(pdu: Array<number\>, specification: string, callback: AsyncCallba
根据协议数据单元（PDU）和指定的短信协议创建短信实例，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -42,6 +44,8 @@ createMessage\(pdu: Array<number\>, specification: string\): Promise<ShortMessag
根据协议数据单元（PDU）和指定的短信协议创建短信实例，使用Promise方式作为异步方法。
**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -75,7 +79,9 @@ sendMessage(options: SendMessageOptions): void
发送短信。
需要ohos.permission.SEND_MESSAGES权限。
**需要权限**：ohos.permission.SEND_MESSAGES
**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
......@@ -108,6 +114,8 @@ getDefaultSmsSlotId\(callback: AsyncCallback<number\>\): void
获取发送短信的默认SIM卡槽ID，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
......@@ -129,6 +137,8 @@ getDefaultSmsSlotId\(\): Promise<number\>
获取发送短信的默认SIM卡槽ID，使用Promise方式作为异步方法。
**系统能力**：SystemCapability.Telephony.SmsMms
**返回值：**
| 类型 | 说明 |
......@@ -153,7 +163,9 @@ setSmscAddr\(slotId: number, smscAddr: string, callback: AsyncCallback<void\>\):
设置短信服务中心（SMSC）地址，使用callback方式作为异步方法。
需要ohos.permission.SET\_TELEPHONY\_STATE权限，该权限为系统权限。
**需要权限**：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限
**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
......@@ -180,7 +192,9 @@ setSmscAddr\(slotId: number, smscAddr: string\): Promise<void\>
设置短信服务中心（SMSC）地址，使用Promise方式作为异步方法。
需要ohos.permission.SET\_TELEPHONY\_STATE权限，该权限为系统权限。
**需要权限**：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限
**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
......@@ -215,7 +229,9 @@ getSmscAddr\(slotId: number, callback: AsyncCallback<string\>\): void
获取短信服务中心（SMSC）地址，使用callback方式作为异步方法。
需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。
**需要权限**：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限
**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
......@@ -240,7 +256,9 @@ getSmscAddr\(slotId: number\): Promise<string\>
获取短信服务中心（SMSC）地址，使用Promise方式作为异步方法。
需要ohos.permission.GET\_TELEPHONY\_STATE权限，该权限为系统权限。
**需要权限**：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限
**系统能力**：SystemCapability.Telephony.SmsMms
**参数：**
......@@ -271,6 +289,8 @@ promise.then(data => {
短信实例。
**系统能力**：SystemCapability.Telephony.SmsMms
| 变量 | 类型 | 说明 |
| ------------------------ | --------------------------------------- | ------------------------------------------------------------ |
| emailAddress | string | 电子邮件地址。 |
......@@ -295,12 +315,12 @@ promise.then(data => {
短信类型。
| 变量 | 值 | 说明 |
| ---------------- | ---- | ---------------------------------------- |
| UNKNOWN | 0 | 未知类型。 |
| INSTANT_MESSAGE | 1 | 即时消息，收到后立即显示。 |
| OPTIONAL_MESSAGE | 2 | 存储在设备或SIM卡上的短信。 |
| SIM_MESSAGE | 3 | 包含SIM卡信息的短信，需要存储在SIM卡中。 |
| FORWARD_MESSAGE | 4 | 要转发到另一台设备的短信。 |
| ---------------- | ---- | ------------------------------------------------------------ |
| UNKNOWN | 0 | 未知类型。<br />**系统能力**：SystemCapability.Telephony.SmsMms |
| INSTANT_MESSAGE | 1 | 即时消息，收到后立即显示。<br />**系统能力**：SystemCapability.Telephony.SmsMms |
| OPTIONAL_MESSAGE | 2 | 存储在设备或SIM卡上的短信。<br />**系统能力**：SystemCapability.Telephony.SmsMms |
| SIM_MESSAGE | 3 | 包含SIM卡信息的短信，需要存储在SIM卡中。<br />**系统能力**：SystemCapability.Telephony.SmsMms |
| FORWARD_MESSAGE | 4 | 要转发到另一台设备的短信。<br />**系统能力**：SystemCapability.Telephony.SmsMms |
## SendMessageOptions<a name=SendMessageOptions></a>
......@@ -309,6 +329,8 @@ promise.then(data => {
根据SendMessageOptions中的可选参数content的值判断短信类型。
**系统能力**：SystemCapability.Telephony.SmsMms
| 参数名 | 类型 | 必填 | 说明 |
| ---------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| slotId | number | 是 | 用于发送短信的SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 |
......@@ -324,6 +346,8 @@ promise.then(data => {
回调实例。返回短信发送结果、存储已发送短信的URI和是否为长短信的最后一部分。
**系统能力**：SystemCapability.Telephony.SmsMms
| 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------- | ---- | ------------------------------------------------------------ |
| isLastPart | boolean | 否 | 指定这是否是长短信的最后一部分。true表示这是长短信的最后一部分，false表示不是。默认为false。 |
......@@ -335,6 +359,8 @@ promise.then(data => {
回调实例。返回短信送达报告。
**系统能力**：SystemCapability.Telephony.SmsMms
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------------------- | ---- | -------------- |
| pdu | Array&lt;number&gt; | 是 | 短信送达报告。 |
......@@ -344,6 +370,8 @@ promise.then(data => {
短信发送结果。
**系统能力**：SystemCapability.Telephony.SmsMms
| 参数名 | 值 | 说明 |
| ------------------------------------ | ---- | ------------------------------------------------------ |
| SEND_SMS_SUCCESS | 0 | 发送短信成功。 |
......
zh-cn/application-dev/reference/apis/js-apis-telephony-data.md 0 → 100644
浏览文件 @ ff84eebd
# 蜂窝数据
>**说明：**
>
>本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
## 导入模块
```
import data from '@ohos.telephony.data';
```
## data.getDefaultCellularDataSlotId<a name=data.getDefaultCellularDataSlotId-callback></a>
getDefaultCellularDataSlotId(callback: AsyncCallback\<number\>): void
获取默认移动数据的SIM卡，使用callback方式作为异步方法。
**需要权限**：ohos.permission.GET_NETWORK_INFO
**系统能力**：SystemCapability.Telephony.CellularData
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | ------------------------------------------ |
| callback | AsyncCallback\<number\> | 是 | 回调函数。<br />0：卡槽1。<br />1：卡槽2。 |
**示例：**
```
data.getDefaultCellularDataSlotId((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## data.getDefaultCellularDataSlotId<a name=data.getDefaultCellularDataSlotId-promise></a>
getDefaultCellularDataSlotId(): Promise\<number\>
获取默认移动数据的SIM卡，使用Promise方式作为异步方法。
**需要权限**：ohos.permission.GET_NETWORK_INFO
**系统能力**：SystemCapability.Telephony.CellularData
**返回值：**
| 类型 | 说明 |
| ----------------- | ------------------------------------------------------------ |
| Promise\<number\> | 以Promise形式返回获取默认移动数据的SIM卡。<br />0：卡槽1。<br />1：卡槽2。 |
**示例：**
```
let promise = data.getDefaultCellularDataSlotId();
promise.then((data) => {
console.log(`test success, promise: data->${JSON.stringify(data)}`);
}).catch((err) => {
console.error(`test fail, promise: err->${JSON.stringify(err)}`);
});
```
## data.getCellularDataFlowType<a name=data.getCellularDataFlowType-callback></a>
getCellularDataFlowType(callback: AsyncCallback\<DataFlowType\>): void
获取蜂窝数据业务的上下行状态，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CellularData
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------------- | ---- | ---------- |
| callback | AsyncCallback\<[DataFlowType](#DataFlowType)\> | 是 | 回调函数。 |
**示例：**
```
data.getCellularDataFlowType((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## data.getCellularDataFlowType<a name=data.getCellularDataFlowType-promise></a>
getCellularDataFlowType(): Promise\<DataFlowType\>
获取蜂窝数据业务的上下行状态，使用Promise方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CellularData
**返回值：**
| 类型 | 说明 |
| ---------------------------------------- | ----------------------------------------------- |
| Promise\<[DataFlowType](#DataFlowType)\> | 以Promise形式返回获取蜂窝数据业务的上下行状态。 |
**示例：**
```
let promise = data.getCellularDataFlowType();
promise.then((data) => {
console.log(`test success, promise: data->${JSON.stringify(data)}`);
}).catch((err) => {
console.error(`test fail, promise: err->${JSON.stringify(err)}`);
});
```
## data.getCellularDataState<a name=data.getCellularDataState-callback></a>
getCellularDataState(callback: AsyncCallback\<DataConnectState\>): void
获取分组交换域（PS域）的连接状态，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CellularData
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------------ | ---- | ---------- |
| callback | AsyncCallback\<[DataConnectState](#DataConnectState)\> | 是 | 回调函数。 |
**示例：**
```
data.getCellularDataState((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## data.getCellularDataState<a name=data.getCellularDataState-promise></a>
getCellularDataState(): Promise\<DataConnectState\>
获取分组交换域(PS域)的连接状态，使用Promise方式作为异步方法。
**系统能力**：SystemCapability.Telephony.CellularData
**返回值：**
| 类型 | 说明 |
| ------------------------------------------------ | ------------------------------------- |
| Promise\<[DataConnectState](#DataConnectState)\> | 以Promise形式返回获取PS域的连接状态。 |
**示例：**
```
let promise = data.getCellularDataState();
promise.then((data) => {
console.log(`test success, promise: data->${JSON.stringify(data)}`);
}).catch((err) => {
console.error(`test fail, promise: err->${JSON.stringify(err)}`);
});
```
## data.isCellularDataEnabled<a name=data.isCellularDataEnabled-callback></a>
isCellularDataEnabled(callback: AsyncCallback\<boolean\>): void
检查蜂窝数据业务是否启用，使用callback方式作为异步方法。
**需要权限**：ohos.permission.GET_NETWORK_INFO
**系统能力**：SystemCapability.Telephony.CellularData
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------ | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback\<boolean\> | 是 | 回调函数。<br />true：蜂窝数据业务已启用。<br />false：蜂窝数据业务已禁用。 |
**示例：**
```
data.isCellularDataEnabled((err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## data.isCellularDataEnabled<a name=data.isCellularDataEnabled-promise></a>
isCellularDataEnabled(): Promise\<boolean\>
检查蜂窝数据业务是否启用，使用Promise方式作为异步方法。
**需要权限**：ohos.permission.GET_NETWORK_INFO
**系统能力**：SystemCapability.Telephony.CellularData
**返回值：**
| 类型 | 说明 |
| ------------------ | ------------------------------------------------------------ |
| Promise\<boolean\> | 以Promise形式返回检查蜂窝数据业务是否启用。<br />true：蜂窝数据业务已启用。<br />false：蜂窝数据业务已禁用。 |
**示例：**
```
let promise = data.isCellularDataEnabled();
promise.then((data) => {
console.log(`test success, promise: data->${JSON.stringify(data)}`);
}).catch((err) => {
console.error(`test fail, promise: err->${JSON.stringify(err)}`);
});
```
## data.isCellularDataRoamingEnabled<a name=data.isCellularDataRoamingEnabled-callback></a>
isCellularDataRoamingEnabled(slotId: number, callback: AsyncCallback\<boolean\>): void
检查蜂窝数据业务是否启用漫游，使用callback方式作为异步方法。
**需要权限**：ohos.permission.GET_NETWORK_INFO
**系统能力**：SystemCapability.Telephony.CellularData
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------ | ---- | ------------------------------------------------------------ |
| slotId | number | 是 | 卡槽ID。<br />0：卡槽1。<br />1：卡槽2。 |
| callback | AsyncCallback\<boolean\> | 是 | 回调函数。<br />true：蜂窝数据业务已启用漫游。<br />false：蜂窝数据业务已禁用漫游。 |
**示例：**
```
data.isCellularDataRoamingEnabled(0,(err, data) => {
console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});
```
## data.isCellularDataRoamingEnabled<a name=data.isCellularDataRoamingEnabled-promise></a>
isCellularDataRoamingEnabled(slotId: number): Promise\<boolean\>
检查蜂窝数据业务是否启用漫游，使用Promise方式作为异步方法。
**需要权限**：ohos.permission.GET_NETWORK_INFO
**系统能力**：SystemCapability.Telephony.CellularData
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------------------------------- |
| slotId | number | 是 | 卡槽ID。<br />0：卡槽1。<br />1：卡槽2。 |
**返回值：**
| 类型 | 说明 |
| ------------------ | ------------------------------------------------------------ |
| Promise\<boolean\> | 以Promise形式返回检查蜂窝数据业务是否启用漫游。<br />true：蜂窝数据业务已启用漫游。<br />false：蜂窝数据业务已禁用漫游。 |
**示例：**
```
let promise = data.isCellularDataRoamingEnabled(0);
promise.then((data) => {
console.log(`test success, promise: data->${JSON.stringify(data)}`);
}).catch((err) => {
console.error(`test fail, promise: err->${JSON.stringify(err)}`);
});
```
## DataFlowType<a name=DataFlowType></a>
描述蜂窝数据流类型。
| 参数名 | 值 | 说明 |
| ------ | ---------------------- | ------------------------------------------------------------ |
| 0 | DATA_FLOW_TYPE_NONE | 表示没有上行或下行数据。<br />**系统能力**：SystemCapability.Telephony.CellularData |
| 1 | DATA_FLOW_TYPE_DOWN | 表示只有下行数据。<br />**系统能力**：SystemCapability.Telephony.CellularData |
| 2 | DATA_FLOW_TYPE_UP | 表示只有上行数据。<br />**系统能力**：SystemCapability.Telephony.CellularData |
| 3 | DATA_FLOW_TYPE_UP_DOWN | 表示有上下行数据。<br />**系统能力**：SystemCapability.Telephony.CellularData |
| 4 | DATA_FLOW_TYPE_DORMANT | 表示没有上下行数据，底层链路处于休眠状态。<br />**系统能力**：SystemCapability.Telephony.CellularData |
## DataConnectState<a name=DataConnectState></a>
描述蜂窝数据链路连接状态。
| 参数名 | 值 | 说明 |
| ------ | ----------------------- | ------------------------------------------------------------ |
| -1 | DATA_STATE_UNKNOWN | 表示蜂窝数据链路未知。<br />**系统能力**：SystemCapability.Telephony.CellularData |
| 0 | DATA_STATE_DISCONNECTED | 表示蜂窝数据链路断开。<br />**系统能力**：SystemCapability.Telephony.CellularData |
| 1 | DATA_STATE_CONNECTING | 表示正在连接蜂窝数据链路。<br />**系统能力**：SystemCapability.Telephony.CellularData |
| 2 | DATA_STATE_CONNECTED | 表示蜂窝数据链路已连接。<br />**系统能力**：SystemCapability.Telephony.CellularData |
| 3 | DATA_STATE_SUSPENDED | 表示蜂窝数据链路被挂起。<br />**系统能力**：SystemCapability.Telephony.CellularData |
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或