openharmony 鸿蒙 js-apis-telephony-data-sys

2025-06-16 浏览 (1)

@ohos.telephony.data (蜂窝数据)(系统接口)

蜂窝数据提供了移动数据管理能力，包括设置默认移动数据的SIM卡，启用、禁用蜂窝数据服务和蜂窝数据漫游。

说明：

本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

当前页面仅包含本模块的系统接口，其他公开接口参见@ohos.telephony.data (蜂窝数据)。

导入模块

import { data } from '@kit.TelephonyKit';

data.setDefaultCellularDataSlotId

setDefaultCellularDataSlotId(slotId: number, callback: AsyncCallback<void>): void

设置默认移动数据的SIM卡，使用callback方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CellularData

参数：

参数名类型必填说明
slotIdnumber是SIM卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
callbackAsyncCallback<void>是以callback形式异步返回结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和ohos.telephony(电话子系统)错误码。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
8300001Invalid parameter value.
8300002Service connection failed.
8300003System internal error.
8300004No SIM card found.
8300999Internal error.
8301001SIM card is not activated.

示例：

import { data } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';

data.setDefaultCellularDataSlotId(0, (err: BusinessError) => {
    if(err){
        console.error(`setDefaultCellularDataSlotId fail,callback: err->${JSON.stringify(err)}.`);
    }else{
        console.log(`setDefaultCellularDataSlotId success`);
    }
});

data.setDefaultCellularDataSlotId

setDefaultCellularDataSlotId(slotId: number): Promise<void>

设置默认移动数据的SIM卡，使用Promise方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CellularData

参数：

参数名类型必填说明
slotIdnumber是SIM卡槽ID。
- 0：卡槽1。
- 1：卡槽2。

返回值：

类型说明
Promise<void>以Promise形式异步返回设置结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和ohos.telephony(电话子系统)错误码。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
8300001Invalid parameter value.
8300002Service connection failed.
8300003System internal error.
8300004No SIM card found.
8300999Internal error.
8301001SIM card is not activated.

示例：

import { data } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';

data.setDefaultCellularDataSlotId(0).then(() => {
    console.log(`setDefaultCellularDataSlotId success.`);
}).catch((err: BusinessError) => {
    console.error(`setDefaultCellularDataSlotId fail, promise: err->${JSON.stringify(err)}`);
});

data.enableCellularData

enableCellularData(callback: AsyncCallback<void>): void

启用蜂窝数据服务，使用callback方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CellularData

参数：

参数名类型必填说明
callbackAsyncCallback<void>是以callback形式异步返回结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和ohos.telephony(电话子系统)错误码。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
8300001Invalid parameter value.
8300002Service connection failed.
8300003System internal error.
8300999Internal error.

示例：

import { data } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';

data.enableCellularData((err: BusinessError) => {
    if(err){
        console.error(`enableCellularData fail,callback: callback: err->${JSON.stringify(err)}`);
    }else{
        console.log(`enableCellularData success`);
    }
});

data.enableCellularData

enableCellularData(): Promise<void>

启用蜂窝数据服务，使用Promise方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CellularData

返回值：

类型说明
Promise<void>以Promise形式返回结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和ohos.telephony(电话子系统)错误码。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
8300002Service connection failed.
8300003System internal error.
8300999Internal error.

示例：

import { data } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';

data.enableCellularData().then(() => {
    console.log(`enableCellularData success.`);
}).catch((err: BusinessError) => {
    console.error(`enableCellularData fail, promise: err->${JSON.stringify(err)}`);
});

data.disableCellularData

disableCellularData(callback: AsyncCallback<void>): void

禁用蜂窝数据服务，使用callback方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CellularData

参数：

参数名类型必填说明
callbackAsyncCallback<void>是以callback形式异步返回结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和ohos.telephony(电话子系统)错误码。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
8300001Invalid parameter value.
8300002Service connection failed.
8300003System internal error.
8300999Internal error.

示例：

import { data } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';

data.disableCellularData((err: BusinessError) => {
    if(err){
        console.error(`disableCellularData fail,callback: callback: err->${JSON.stringify(err)}`);
    }else{
        console.log(`disableCellularData success`);
    }
});

data.disableCellularData

disableCellularData(): Promise<void>

禁用蜂窝数据服务，使用Promise方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CellularData

返回值：

类型说明
Promise<void>以Promise形式返回禁用结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和ohos.telephony(电话子系统)错误码。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
8300002Service connection failed.
8300003System internal error.
8300999Internal error.

示例：

import { data } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';

data.disableCellularData().then(() => {
    console.log(`disableCellularData success.`);
}).catch((err: BusinessError) => {
    console.error(`disableCellularData fail, promise: err->${JSON.stringify(err)}`);
});

data.enableCellularDataRoaming

enableCellularDataRoaming(slotId: number, callback: AsyncCallback<void>): void

启用蜂窝数据漫游，使用callback方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CellularData

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
callbackAsyncCallback<void>是以callback形式异步返回结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和ohos.telephony(电话子系统)错误码。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
8300001Invalid parameter value.
8300002Service connection failed.
8300003System internal error.
8300999Internal error.

示例：

import { data } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';

data.enableCellularDataRoaming(0, (err: BusinessError) => {
    if(err){
        console.error(`enableCellularDataRoaming fail,callback: err->${JSON.stringify(err)}`);
    }else{
        console.log(`enableCellularDataRoaming success`);
    }
});

data.enableCellularDataRoaming

enableCellularDataRoaming(slotId: number): Promise<void>

启用蜂窝数据漫游，使用Promise方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CellularData

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。

返回值：

类型说明
Promise<void>以Promise形式返回启用结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和ohos.telephony(电话子系统)错误码。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
8300001Invalid parameter value.
8300002Service connection failed.
8300003System internal error.
8300999Internal error.

示例：

import { data } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';

data.enableCellularDataRoaming(0).then(() => {
    console.log(`enableCellularDataRoaming success.`);
}).catch((err: BusinessError) => {
    console.error(`enableCellularDataRoaming fail, promise: err->${JSON.stringify(err)}`);
});

data.disableCellularDataRoaming

disableCellularDataRoaming(slotId: number, callback: AsyncCallback<void>): void

禁用蜂窝数据漫游，使用callback方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CellularData

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。
callbackAsyncCallback<void>是以callback形式异步返回结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和ohos.telephony(电话子系统)错误码。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
8300001Invalid parameter value.
8300002Service connection failed.
8300003System internal error.
8300999Internal error.

示例：

import { data } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';

data.disableCellularDataRoaming(0, (err: BusinessError) => {
    if(err){
        console.error(`disableCellularDataRoaming fail,callback: err->${JSON.stringify(err)}`);
    }else{
        console.log(`disableCellularDataRoaming success`);
    }
});

data.disableCellularDataRoaming

disableCellularDataRoaming(slotId: number): Promise<void>

禁用蜂窝数据漫游，使用Promise方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.CellularData

参数：

参数名类型必填说明
slotIdnumber是卡槽ID。
- 0：卡槽1。
- 1：卡槽2。

返回值：

类型说明
Promise<void>以Promise形式返回禁用结果。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和ohos.telephony(电话子系统)错误码。

错误码ID错误信息
201Permission denied.
202Non-system applications use system APIs.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
8300001Invalid parameter value.
8300002Service connection failed.
8300003System internal error.
8300999Internal error.

示例：

import { data } from '@kit.TelephonyKit';
import { BusinessError } from '@kit.BasicServicesKit';

data.disableCellularDataRoaming(0).then(() => {
    console.log(`disableCellularDataRoaming success.`);
}).catch((err: BusinessError) => {
    console.error(`disableCellularDataRoaming fail, promise: err->${JSON.stringify(err)}`);
});

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Telephony Kit（蜂窝通信服务）

harmony 鸿蒙Telephony_NetworkState

harmony 鸿蒙电话子系统错误码

harmony 鸿蒙js-apis-call-sys

harmony 鸿蒙@ohos.telephony.call (拨打电话)

harmony 鸿蒙@ohos.telephony.esim (eSIM卡管理) (系统接口)

harmony 鸿蒙@ohos.telephony.esim (eSIM卡管理)

harmony 鸿蒙@ohos.telephony.observer (observer)(系统接口)

harmony 鸿蒙@ohos.telephony.observer (observer)

harmony 鸿蒙@ohos.telephony.radio (网络搜索)（系统接口）

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/1316Bp