網絡搜索

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

本模塊首批接口從API version 6開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。

導入模塊

import radio from '@ohos.telephony.radio'

radio.getRadioTech

getRadioTech(slotId: number, callback: AsyncCallback<{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology}>): void

獲取當前接入的CS域和PS域無線接入技術，使用callback方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CoreService

參數：

示例：

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

radio.getRadioTech

getRadioTech(slotId: number): Promise<{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology}>

獲取當前接入的CS域和PS域無線接入技術，使用Promise方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CoreService

參數：

返回值：

示例：

let slotId = 0;
let promise = radio.getRadioTech(slotId);
promise.then(data = > {
    console.log(`getRadioTech success, data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getRadioTech fail, err- >${JSON.stringify(err)}`);
});

radio.getNetworkState

getNetworkState(callback: AsyncCallback): void

獲取網絡狀態，使用callback方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CoreService

參數：

示例：

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

radio.getNetworkState

getNetworkState(slotId: number, callback: AsyncCallback): void

獲取網絡狀態，使用callback方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CoreService

參數：

示例：

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

radio.getNetworkState

getNetworkState(slotId?: number): Promise

獲取網絡狀態，使用Promise方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CoreService

參數：

返回值：

示例：

let slotId = 0;
let promise = radio.getNetworkState(slotId);
promise.then(data = > {
    console.log(`getNetworkState success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getNetworkState fail, promise: err- >${JSON.stringify(err)}`);
});

radio.getNetworkSelectionMode

getNetworkSelectionMode(slotId: number, callback: AsyncCallback): void

獲取當前選網模式，使用callback方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CoreService

參數：

示例：

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

radio.getNetworkSelectionMode

getNetworkSelectionMode(slotId: number): Promise

獲取當前選網模式，使用Promise方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CoreService

參數：

返回值：

示例：

let slotId = 0;
let promise = radio.getNetworkSelectionMode(slotId);
promise.then(data = > {
    console.log(`getNetworkSelectionMode success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getNetworkSelectionMode fail, promise: err- >${JSON.stringify(err)}`);
});

radio.getISOCountryCodeForNetwork7+

getISOCountryCodeForNetwork(slotId: number, callback: AsyncCallback): void

獲取注冊網絡所在國家的ISO國家碼，使用callback方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CoreService

參數：

示例：

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

radio.getISOCountryCodeForNetwork7+

getISOCountryCodeForNetwork(slotId: number): Promise

獲取注冊網絡所在國家的ISO國家碼，使用Promise方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CoreService

參數：

返回值：

示例：

let slotId = 0;
let promise = radio.getISOCountryCodeForNetwork(slotId);
promise.then(data = > {
    console.log(`getISOCountryCodeForNetwork success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getISOCountryCodeForNetwork fail, promise: err- >${JSON.stringify(err)}`);
});

radio.getPrimarySlotId7+

getPrimarySlotId(callback: AsyncCallback): void

獲取主卡所在卡槽的索引號，使用callback方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CoreService

參數：

示例：

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

radio.getPrimarySlotId7+

getPrimarySlotId(): Promise

獲取主卡所在卡槽的索引號，使用Promise方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CoreService

返回值：

示例：

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

radio.getSignalInformation7+

getSignalInformation(slotId: number, callback: AsyncCallback>): void

獲取指定SIM卡槽對應的注冊網絡信號強度信息列表，使用callback方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CoreService

參數：

示例：

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

radio.getSignalInformation7+

getSignalInformation(slotId: number): Promise>

獲取指定SIM卡槽對應的注冊網絡信號強度信息列表，使用Promise方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CoreService

參數：

返回值：

示例：

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

radio.isNrSupported8+

isNrSupported(slotId: number): boolean

判斷當前設備是否支持5G(NR)。

系統能力 ：SystemCapability.Telephony.CoreService

參數：

返回值：

示例：

let slotId = 0;
let result = radio.isNrSupported(slotId);
console.log("Result: "+ result);

radio.isRadioOn7+

isRadioOn(callback: AsyncCallback): void

判斷主卡的Radio是否打開，使用callback方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CoreService

參數：

示例：

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

radio.isRadioOn7+

isRadioOn(slotId: number, callback: AsyncCallback): void

判斷指定卡槽位的Radio是否打開，使用callback方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CoreService

參數：

示例：

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

radio.isRadioOn7+

isRadioOn(slotId?: number): Promise

判斷Radio是否打開，使用Promise方式作為異步方法。

需要權限 ：ohos.permission.GET_NETWORK_INFO

系統能力 ：SystemCapability.Telephony.CoreService

參數：

返回值：

示例：

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

radio.getOperatorName7+

getOperatorName(slotId: number, callback: AsyncCallback): void

獲取運營商名稱，使用callback方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CoreService

參數：

示例：

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

radio.getOperatorName7+

getOperatorName(slotId: number): Promise

獲取運營商名稱，使用Promise方式作為異步方法。

系統能力 ：SystemCapability.Telephony.CoreService

參數：

返回值：

示例：

let slotId = 0;
let promise = radio.getOperatorName(slotId);
promise.then(data = > {
    console.log(`getOperatorName success, promise: data- >${JSON.stringify(data)}`);
}).catch(err = > {
    console.log(`getOperatorName fail, promise: err- >${JSON.stringify(err)}`);
});

RadioTechnology

無線接入技術。

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

SignalInformation

網絡信號強度信息對象。

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

NetworkType

網絡類型。

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

NetworkState

網絡注冊狀態。

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

RegState

網絡注冊狀態。

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

NsaState

非獨立組網狀態。

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

NetworkSelectionMode

選網模式。

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

審核編輯 黃宇