diff --git a/zh-cn/application-dev/reference/apis/js-apis-call.md b/zh-cn/application-dev/reference/apis/js-apis-call.md index ea4ea2cbf1b6e6dfdee82a01fb68d69a05ccacbe..2319264154c907ca625343e05a9478a3321886b5 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-call.md +++ b/zh-cn/application-dev/reference/apis/js-apis-call.md @@ -17,7 +17,9 @@ dial\(phoneNumber: string, callback: AsyncCallback\): void 拨打电话,使用callback方式作为异步方法。 -需要权限:ohos.permission.PLACE\_CALL权限,该权限为系统权限。 +**需要权限**:ohos.permission.PLACE\_CALL,该权限为系统权限 + +**系统能力**:SystemCapability.Telephony.CallManager **参数:** @@ -41,7 +43,9 @@ dial\(phoneNumber: string, options: DialOptions, callback: AsyncCallback 拨打电话,可设置通话参数,使用promise方式作为异步方法。 -需要权限:ohos.permission.PLACE\_CALL权限,该权限为系统权限。 +**需要权限**:ohos.permission.PLACE\_CALL,该权限为系统权限 + +**系统能力**:SystemCapability.Telephony.CallManager **参数:** @@ -102,6 +108,8 @@ hasCall\(callback: AsyncCallback\): void 判断是否存在通话,使用callback方式作为异步方法。 +**系统能力**:SystemCapability.Telephony.CallManager + **参数:** | 参数 | 类型 | 必填 | 说明 | @@ -123,6 +131,8 @@ hasCall\(\): Promise 判断是否存在通话,使用Promise方式作为异步方法。 +**系统能力**:SystemCapability.Telephony.CallManager + **返回值:** | 类型 | 说明 | @@ -147,6 +157,8 @@ getCallState\(callback: AsyncCallback\): void 获取通话状态,使用callback方式作为异步方法。 +**系统能力**:SystemCapability.Telephony.CallManager + **参数:** | 参数 | 类型 | 必填 | 说明 | @@ -168,6 +180,8 @@ getCallState\(\): Promise 获取通话状态,使用Promise方式作为异步方法。 +**系统能力**:SystemCapability.Telephony.CallManager + **返回值:** | 类型 | 说明 | @@ -191,6 +205,8 @@ isEmergencyPhoneNumber\(phoneNumber: string, callback: AsyncCallback\) 判断是否是紧急电话号码,使用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\): 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 { ## DialOptions 拨打电话的可选参数。 + +**系统能力**:SystemCapability.Telephony.CallManager + | 参数 | 类型 | 必填 | 说明 | | ------ | ------- | ---- | ------------------------------------------------------------ | | extras | boolean | 否 | 根据extras的值判断是否为视频通话,默认为语音通话。
- true:视频通话。
- fasle:语音通话。 | @@ -414,16 +447,20 @@ promise.then(data => { ## CallState 通话状态码。 + | 变量 | 值 | 说明 | | ------------------ | ---- | ------------------------------------------------------------ | -| CALL_STATE_UNKNOWN | -1 | 无效状态,当获取呼叫状态失败时返回。 | -| CALL_STATE_IDLE | 0 | 表示没有正在进行的呼叫。 | -| CALL_STATE_RINGING | 1 | 表示来电正在振铃或等待。 | -| CALL_STATE_OFFHOOK | 2 | 表示至少有一个呼叫处于拨号、通话中或呼叫保持状态,并且没有新的来电振铃或等待。 | +| CALL_STATE_UNKNOWN | -1 | 无效状态,当获取呼叫状态失败时返回。
**系统能力**:SystemCapability.Telephony.CallManager | +| CALL_STATE_IDLE | 0 | 表示没有正在进行的呼叫。
**系统能力**:SystemCapability.Telephony.CallManager | +| CALL_STATE_RINGING | 1 | 表示来电正在振铃或等待。
**系统能力**:SystemCapability.Telephony.CallManager | +| CALL_STATE_OFFHOOK | 2 | 表示至少有一个呼叫处于拨号、通话中或呼叫保持状态,并且没有新的来电振铃或等待。
**系统能力**:SystemCapability.Telephony.CallManager | ## EmergencyNumberOptions7+ 判断是否是紧急电话号码的可选参数。 + +**系统能力**:SystemCapability.Telephony.CallManager + | 参数 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------------------------------------------ | | slotId | number | 否 | 卡槽ID:
- 0:卡槽1。
- 1:卡槽2。 | @@ -431,6 +468,9 @@ promise.then(data => { ## NumberFormatOptions7+ 格式化号码的可选参数。 + +**系统能力**:SystemCapability.Telephony.CallManager + | 参数 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------------------------------------------------- | | countryCode | string | 否 | 国家码,支持所有国家的国家码,如:中国(CN)。默认为:CN。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-observer.md b/zh-cn/application-dev/reference/apis/js-apis-observer.md index 6babbe512afb4d6a4518b0ced6d0a08adb6302bf..e020047aa5e967808761fede6d7c06e4e407b2d8 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-observer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-observer.md @@ -177,3 +177,89 @@ observer.off('signalInfoChange', callback); observer.off('signalInfoChange'); ``` + +## observer.on('callStateChange') + +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)
number:电话号码 | + +**示例:** + +``` +observer.on('callStateChange', value =>{ + console.log("on callStateChange, state:" + value.state + ", number:" + value.number); +}); +``` + + +## observer.on('callStateChange') + +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。
- 0:卡槽1
- 1:卡槽2 | +| callback | Callback\<{ state: [CallState](js-apis-call.md#CallState), number: string }\> | 是 | 回调函数,参考call的[CallState](js-apis-call.md#CallState)
number:电话号码 | + +**示例:** + +``` +observer.on('callStateChange', {slotId: 0}, value =>{ + console.log("on callStateChange, state:" + value.state + ", number:" + value.number); +}); +``` + + +## observer.off('callStateChange') + +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)
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'); +``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-sms.md b/zh-cn/application-dev/reference/apis/js-apis-sms.md index a4c3d545ad6fe9eb60f1a9744fcea86323027018..bad012c67faa9b803406a051265d0311d253cdac 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-sms.md +++ b/zh-cn/application-dev/reference/apis/js-apis-sms.md @@ -16,6 +16,8 @@ createMessage\(pdu: Array, specification: string, callback: AsyncCallba 根据协议数据单元(PDU)和指定的短信协议创建短信实例,使用callback方式作为异步方法。 +**系统能力**:SystemCapability.Telephony.SmsMms + **参数:** | 参数名 | 类型 | 必填 | 说明 | @@ -42,6 +44,8 @@ createMessage\(pdu: Array, specification: string\): Promise\): void 获取发送短信的默认SIM卡槽ID,使用callback方式作为异步方法。 +**系统能力**:SystemCapability.Telephony.SmsMms + **参数:** | 参数名 | 类型 | 必填 | 说明 | @@ -129,6 +137,8 @@ getDefaultSmsSlotId\(\): Promise 获取发送短信的默认SIM卡槽ID,使用Promise方式作为异步方法。 +**系统能力**:SystemCapability.Telephony.SmsMms + **返回值:** | 类型 | 说明 | @@ -153,7 +163,9 @@ setSmscAddr\(slotId: number, smscAddr: string, callback: AsyncCallback\): 设置短信服务中心(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 设置短信服务中心(SMSC)地址,使用Promise方式作为异步方法。 -需要ohos.permission.SET\_TELEPHONY\_STATE权限,该权限为系统权限。 +**需要权限**:ohos.permission.SET_TELEPHONY_STATE,该权限为系统权限 + +**系统能力**:SystemCapability.Telephony.SmsMms **参数:** @@ -215,7 +229,9 @@ getSmscAddr\(slotId: number, callback: AsyncCallback\): void 获取短信服务中心(SMSC)地址,使用callback方式作为异步方法。 -需要ohos.permission.GET\_TELEPHONY\_STATE权限,该权限为系统权限。 +**需要权限**:ohos.permission.GET_TELEPHONY_STATE,该权限为系统权限 + +**系统能力**:SystemCapability.Telephony.SmsMms **参数:** @@ -240,7 +256,9 @@ getSmscAddr\(slotId: number\): Promise 获取短信服务中心(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 | 未知类型。
**系统能力**:SystemCapability.Telephony.SmsMms | +| INSTANT_MESSAGE | 1 | 即时消息,收到后立即显示。
**系统能力**:SystemCapability.Telephony.SmsMms | +| OPTIONAL_MESSAGE | 2 | 存储在设备或SIM卡上的短信。
**系统能力**:SystemCapability.Telephony.SmsMms | +| SIM_MESSAGE | 3 | 包含SIM卡信息的短信,需要存储在SIM卡中。
**系统能力**:SystemCapability.Telephony.SmsMms | +| FORWARD_MESSAGE | 4 | 要转发到另一台设备的短信。
**系统能力**:SystemCapability.Telephony.SmsMms | ## SendMessageOptions @@ -309,6 +329,8 @@ promise.then(data => { 根据SendMessageOptions中的可选参数content的值判断短信类型。 +**系统能力**:SystemCapability.Telephony.SmsMms + | 参数名 | 类型 | 必填 | 说明 | | ---------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | slotId | number | 是 | 用于发送短信的SIM卡槽ID:
- 0:卡槽1
- 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<number> | 是 | 短信送达报告。 | @@ -344,6 +370,8 @@ promise.then(data => { 短信发送结果。 +**系统能力**:SystemCapability.Telephony.SmsMms + | 参数名 | 值 | 说明 | | ------------------------------------ | ---- | ------------------------------------------------------ | | SEND_SMS_SUCCESS | 0 | 发送短信成功。 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-telephony-data.md b/zh-cn/application-dev/reference/apis/js-apis-telephony-data.md new file mode 100644 index 0000000000000000000000000000000000000000..73240d2a2987245cae664a8df78563e482d77ffb --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-telephony-data.md @@ -0,0 +1,289 @@ +# 蜂窝数据 + +>**说明:** +> +>本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 + +## 导入模块 + +``` +import data from '@ohos.telephony.data'; +``` + +## data.getDefaultCellularDataSlotId + +getDefaultCellularDataSlotId(callback: AsyncCallback\): void + +获取默认移动数据的SIM卡,使用callback方式作为异步方法。 + +**需要权限**:ohos.permission.GET_NETWORK_INFO + +**系统能力**:SystemCapability.Telephony.CellularData + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ----------------------- | ---- | ------------------------------------------ | +| callback | AsyncCallback\ | 是 | 回调函数。
0:卡槽1。
1:卡槽2。 | + +**示例:** + +``` +data.getDefaultCellularDataSlotId((err, data) => { + console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); +}); +``` + +## data.getDefaultCellularDataSlotId + +getDefaultCellularDataSlotId(): Promise\ + +获取默认移动数据的SIM卡,使用Promise方式作为异步方法。 + +**需要权限**:ohos.permission.GET_NETWORK_INFO + +**系统能力**:SystemCapability.Telephony.CellularData + +**返回值:** + +| 类型 | 说明 | +| ----------------- | ------------------------------------------------------------ | +| Promise\ | 以Promise形式返回获取默认移动数据的SIM卡。
0:卡槽1。
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 + +getCellularDataFlowType(callback: AsyncCallback\): 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 + +getCellularDataFlowType(): Promise\ + +获取蜂窝数据业务的上下行状态,使用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 + +getCellularDataState(callback: AsyncCallback\): 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 + +getCellularDataState(): Promise\ + +获取分组交换域(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 + +isCellularDataEnabled(callback: AsyncCallback\): void + +检查蜂窝数据业务是否启用,使用callback方式作为异步方法。 + +**需要权限**:ohos.permission.GET_NETWORK_INFO + +**系统能力**:SystemCapability.Telephony.CellularData + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------ | ---- | ------------------------------------------------------------ | +| callback | AsyncCallback\ | 是 | 回调函数。
true:蜂窝数据业务已启用。
false:蜂窝数据业务已禁用。 | + +**示例:** + +``` +data.isCellularDataEnabled((err, data) => { + console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); +}); +``` + +## data.isCellularDataEnabled + +isCellularDataEnabled(): Promise\ + +检查蜂窝数据业务是否启用,使用Promise方式作为异步方法。 + +**需要权限**:ohos.permission.GET_NETWORK_INFO + +**系统能力**:SystemCapability.Telephony.CellularData + +**返回值:** + +| 类型 | 说明 | +| ------------------ | ------------------------------------------------------------ | +| Promise\ | 以Promise形式返回检查蜂窝数据业务是否启用。
true:蜂窝数据业务已启用。
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 + +isCellularDataRoamingEnabled(slotId: number, callback: AsyncCallback\): void + +检查蜂窝数据业务是否启用漫游,使用callback方式作为异步方法。 + +**需要权限**:ohos.permission.GET_NETWORK_INFO + +**系统能力**:SystemCapability.Telephony.CellularData + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------ | ---- | ------------------------------------------------------------ | +| slotId | number | 是 | 卡槽ID。
0:卡槽1。
1:卡槽2。 | +| callback | AsyncCallback\ | 是 | 回调函数。
true:蜂窝数据业务已启用漫游。
false:蜂窝数据业务已禁用漫游。 | + +**示例:** + +``` +data.isCellularDataRoamingEnabled(0,(err, data) => { + console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); +}); +``` + +## data.isCellularDataRoamingEnabled + +isCellularDataRoamingEnabled(slotId: number): Promise\ + +检查蜂窝数据业务是否启用漫游,使用Promise方式作为异步方法。 + +**需要权限**:ohos.permission.GET_NETWORK_INFO + +**系统能力**:SystemCapability.Telephony.CellularData + +**参数:** + +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ---------------------------------------- | +| slotId | number | 是 | 卡槽ID。
0:卡槽1。
1:卡槽2。 | + +**返回值:** + +| 类型 | 说明 | +| ------------------ | ------------------------------------------------------------ | +| Promise\ | 以Promise形式返回检查蜂窝数据业务是否启用漫游。
true:蜂窝数据业务已启用漫游。
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 + + 描述蜂窝数据流类型。 + +| 参数名 | 值 | 说明 | +| ------ | ---------------------- | ------------------------------------------------------------ | +| 0 | DATA_FLOW_TYPE_NONE | 表示没有上行或下行数据。
**系统能力**:SystemCapability.Telephony.CellularData | +| 1 | DATA_FLOW_TYPE_DOWN | 表示只有下行数据。
**系统能力**:SystemCapability.Telephony.CellularData | +| 2 | DATA_FLOW_TYPE_UP | 表示只有上行数据。
**系统能力**:SystemCapability.Telephony.CellularData | +| 3 | DATA_FLOW_TYPE_UP_DOWN | 表示有上下行数据。
**系统能力**:SystemCapability.Telephony.CellularData | +| 4 | DATA_FLOW_TYPE_DORMANT | 表示没有上下行数据,底层链路处于休眠状态。
**系统能力**:SystemCapability.Telephony.CellularData | + +## DataConnectState + + 描述蜂窝数据链路连接状态。 + +| 参数名 | 值 | 说明 | +| ------ | ----------------------- | ------------------------------------------------------------ | +| -1 | DATA_STATE_UNKNOWN | 表示蜂窝数据链路未知。
**系统能力**:SystemCapability.Telephony.CellularData | +| 0 | DATA_STATE_DISCONNECTED | 表示蜂窝数据链路断开。
**系统能力**:SystemCapability.Telephony.CellularData | +| 1 | DATA_STATE_CONNECTING | 表示正在连接蜂窝数据链路。
**系统能力**:SystemCapability.Telephony.CellularData | +| 2 | DATA_STATE_CONNECTED | 表示蜂窝数据链路已连接。
**系统能力**:SystemCapability.Telephony.CellularData | +| 3 | DATA_STATE_SUSPENDED | 表示蜂窝数据链路被挂起。
**系统能力**:SystemCapability.Telephony.CellularData | \ No newline at end of file