蜂窩數據

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。

導入模塊

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

獲取蜂窩數據業(yè)務的上下行狀態(tài)，使用callback方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CellularData

參數：

參數名	類型	必填	說明
callback	AsyncCallback<[DataFlowType]>	是	回調函數。

示例：

data.getCellularDataFlowType((err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

data.getCellularDataFlowType

getCellularDataFlowType(): Promise

獲取蜂窩數據業(yè)務的上下行狀態(tài)，使用Promise方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CellularData

返回值：

類型	說明
Promise<[DataFlowType]>	以Promise形式返回獲取蜂窩數據業(yè)務的上下行狀態(tài)。

示例：

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域）的連接狀態(tài)，使用callback方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CellularData

參數：

參數名	類型	必填	說明
callback	AsyncCallback<[DataConnectState]>	是	回調函數。

示例：

data.getCellularDataState((err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

data.getCellularDataState

getCellularDataState(): Promise

獲取分組交換域(PS域)的連接狀態(tài)，使用Promise方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CellularData

返回值：

類型	說明
Promise<[DataConnectState]>	以Promise形式返回獲取PS域的連接狀態(tài)。

示例：

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

檢查蜂窩數據業(yè)務是否啟用，使用callback方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CellularData

參數：

參數名	類型	必填	說明
callback	AsyncCallback	是	回調函數。 true：蜂窩數據業(yè)務已啟用。 false：蜂窩數據業(yè)務已禁用。

示例：

data.isCellularDataEnabled((err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

data.isCellularDataEnabled

isCellularDataEnabled(): Promise

檢查蜂窩數據業(yè)務是否啟用，使用Promise方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CellularData

返回值：

類型	說明
Promise	以Promise形式返回檢查蜂窩數據業(yè)務是否啟用。 true：蜂窩數據業(yè)務已啟用。 false：蜂窩數據業(yè)務已禁用。

示例：

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

檢查蜂窩數據業(yè)務是否啟用漫游，使用callback方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CellularData

參數：

參數名	類型	必填	說明
slotId	number	是	卡槽ID。 0：卡槽1。 1：卡槽2。
callback	AsyncCallback	是	回調函數。 true：蜂窩數據業(yè)務已啟用漫游。 false：蜂窩數據業(yè)務已禁用漫游。

示例：

data.isCellularDataRoamingEnabled(0,(err, data) = > {
    console.log(`callback: err- >${JSON.stringify(err)}, data- >${JSON.stringify(data)}`);
});

data.isCellularDataRoamingEnabled

isCellularDataRoamingEnabled(slotId: number): Promise

檢查蜂窩數據業(yè)務是否啟用漫游，使用Promise方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CellularData

參數：

參數名	類型	必填	說明
slotId	number	是	卡槽ID。 0：卡槽1。 1：卡槽2。

返回值：

類型	說明
Promise	以Promise形式返回檢查蜂窩數據業(yè)務是否啟用漫游。 true：蜂窩數據業(yè)務已啟用漫游。 false：蜂窩數據業(yè)務已禁用漫游。

示例：

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

描述蜂窩數據流類型。

系統能力 ：以下各項對應的系統能力均為SystemCapability.Telephony.CellularData。

名稱	值	說明
DATA_FLOW_TYPE_NONE	0	表示沒有上行或下行數據。
DATA_FLOW_TYPE_DOWN	1	表示只有下行數據。
DATA_FLOW_TYPE_UP	2	表示只有上行數據。
DATA_FLOW_TYPE_UP_DOWN	3	表示有上下行數據。
DATA_FLOW_TYPE_DORMANT	4	表示沒有上下行數據，底層鏈路處于休眠狀態(tài)。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

鴻蒙文檔.png

DataConnectState

描述蜂窩數據鏈路連接狀態(tài)。

系統能力 ：以下各項對應的系統能力均為SystemCapability.Telephony.CellularData。

名稱	值	說明
DATA_STATE_UNKNOWN	-1	表示蜂窩數據鏈路未知。
DATA_STATE_DISCONNECTED	0	表示蜂窩數據鏈路斷開。
DATA_STATE_CONNECTING	1	表示正在連接蜂窩數據鏈路。
DATA_STATE_CONNECTED	2	表示蜂窩數據鏈路已連接。
DATA_STATE_SUSPENDED	3	表示蜂窩數據鏈路被掛起。