蜂窩數(shù)據(jù)

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

導(dǎo)入模塊

import data from '@ohos.telephony.data';

data.getDefaultCellularDataSlotId

getDefaultCellularDataSlotId(callback: AsyncCallback): void

獲取默認(rèn)移動(dòng)數(shù)據(jù)的SIM卡，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力 ：SystemCapability.Telephony.CellularData

參數(shù)：

示例：

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

data.getDefaultCellularDataSlotId

getDefaultCellularDataSlotId(): Promise

獲取默認(rèn)移動(dòng)數(shù)據(jù)的SIM卡，使用Promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力 ：SystemCapability.Telephony.CellularData

返回值：

示例：

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

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

系統(tǒng)能力 ：SystemCapability.Telephony.CellularData

參數(shù)：

示例：

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

data.getCellularDataFlowType

getCellularDataFlowType(): Promise

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

系統(tǒng)能力 ：SystemCapability.Telephony.CellularData

返回值：

示例：

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方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.Telephony.CellularData

參數(shù)：

示例：

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

data.getCellularDataState

getCellularDataState(): Promise

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

系統(tǒng)能力 ：SystemCapability.Telephony.CellularData

返回值：

示例：

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

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

需要權(quán)限 ：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力 ：SystemCapability.Telephony.CellularData

參數(shù)：

示例：

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

data.isCellularDataEnabled

isCellularDataEnabled(): Promise

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

需要權(quán)限 ：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力 ：SystemCapability.Telephony.CellularData

返回值：

示例：

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

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

需要權(quán)限 ：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力 ：SystemCapability.Telephony.CellularData

參數(shù)：

示例：

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

data.isCellularDataRoamingEnabled

isCellularDataRoamingEnabled(slotId: number): Promise

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

需要權(quán)限 ：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力 ：SystemCapability.Telephony.CellularData

參數(shù)：

返回值：

示例：

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

描述蜂窩數(shù)據(jù)流類型。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.CellularData。

DataConnectState

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

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Telephony.CellularData。

審核編輯 黃宇