蜂窩數據
說明:
開發前請熟悉鴻蒙開發指導文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
本模塊首批接口從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]> | 是 | 回調函數。 |
示例:
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]> | 以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]> | 是 | 回調函數。 |
示例:
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]> | 以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
描述蜂窩數據流類型。
系統能力 :以下各項對應的系統能力均為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 | 表示沒有上下行數據,底層鏈路處于休眠狀態。HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
DataConnectState
描述蜂窩數據鏈路連接狀態。
系統能力 :以下各項對應的系統能力均為SystemCapability.Telephony.CellularData。
名稱 | 值 | 說明 |
---|---|---|
DATA_STATE_UNKNOWN | -1 | 表示蜂窩數據鏈路未知。 |
DATA_STATE_DISCONNECTED | 0 | 表示蜂窩數據鏈路斷開。 |
DATA_STATE_CONNECTING | 1 | 表示正在連接蜂窩數據鏈路。 |
DATA_STATE_CONNECTED | 2 | 表示蜂窩數據鏈路已連接。 |
DATA_STATE_SUSPENDED | 3 | 表示蜂窩數據鏈路被掛起。 |
審核編輯 黃宇
-
蜂窩數據
+關注
關注
0文章
13瀏覽量
7732 -
鴻蒙
+關注
關注
57文章
2362瀏覽量
42883
發布評論請先 登錄
相關推薦
評論