!1685 【3.1.5.3需求】【资料】电话子系统部件修改：蜂窝数据，短信

Merge pull request !1685 from Hongjin Li/local_dev

zh-cn/application-dev/reference/apis/js-apis-call.md

@@ -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

@@ -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

@@ -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                                  | 电子邮件地址。                                               |
@@ -294,13 +314,13 @@ 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

+# 蜂窝数据
+
+>**说明：** 
+>
+>本模块首批接口从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