网络搜索

说明：

• 从 API Version 6 开始支持。
• 标记⁷⁺的接口从API Version 7开始支持。

导入模块

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权限。

• 参数

  参数名	类型	必填	说明
  slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
  callback	AsyncCallback<{psRadioTech: RadioTechnology, csRadioTech:RadioTechnology}>	是	回调函数。

• 示例

  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权限。

• 参数

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

• 返回值

  类型	说明
  Promise<{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology}>	以Promise形式返回获取当前接入的CS域和PS域技术。

• 示例

  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<NetworkState>): void

获取网络状态，使用callback方式作为异步方法。

需要ohos.permission.GET_NETWORK_INFO权限。

• 参数

  参数名	类型	必填	说明
  callback	AsyncCallback<NetworkState>	是	回调函数。

• 示例

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

radio.getNetworkState

getNetworkState(slotId: number, callback: AsyncCallback<NetworkState>): void

获取网络状态，使用callback方式作为异步方法。

需要ohos.permission.GET_NETWORK_INFO权限。

• 参数

  参数名	类型	必填	说明
  slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
  callback	AsyncCallback<NetworkState>	是	回调函数。

• 示例

  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<NetworkState>

获取网络状态，使用Promise方式作为异步方法。

需要ohos.permission.GET_NETWORK_INFO权限。

• 参数

  参数名	类型	必填	说明
  slotId	number	否	卡槽ID。 - 0：卡槽1 - 1：卡槽2

• 返回值

  类型	说明
  Promise<NetworkState>	以Promise形式返回网络状态。

• 示例

  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<NetworkSelectionMode>): void

获取当前选网模式，使用callback方式作为异步方法。

• 参数

  参数名	类型	必填	说明
  slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
  callback	AsyncCallback<NetworkSelectionMode>	是	回调函数。

• 示例

  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<NetworkSelectionMode>

获取当前选网模式，使用Promise方式作为异步方法。

• 参数

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

• 返回值

  类型	说明
  Promise<NetworkSelectionMode>	以Promise形式返回当前选网模式。

• 示例

  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.getISOCountryCodeForNetwork⁷⁺

getISOCountryCodeForNetwork(slotId: number, callback: AsyncCallback<string>): void

获取注册网络所在国家的ISO国家码，使用callback方式作为异步方法。

• 参数

  参数名	类型	必填	说明
  slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
  callback	AsyncCallback<string>	是	回调函数。返回国家码，例如：CN（中国）。

• 示例

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

radio.getISOCountryCodeForNetwork⁷⁺

getISOCountryCodeForNetwork(slotId: number): Promise<string>

获取注册网络所在国家的ISO国家码，使用Promise方式作为异步方法。

• 参数

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

• 返回值

  类型	说明
  Promise<string>	以Promise形式返回注册网络所在国家的ISO国家码，例如CN（中国）。

• 示例

  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.getSignalInformation

getSignalInformation(slotId: number, callback: AsyncCallback<Array<SignalInformation>>): void

获取指定SIM卡槽对应的注册网络信号强度信息列表，使用callback方式作为异步方法。

• 参数

  参数名	类型	必填	说明
  slotId	number	是	卡槽ID。 - 0：卡槽1 - 1：卡槽2
  callback	AsyncCallback<Array<SignalInformation>>	是	回调函数，返回SignalInformation对象的数组。

• 示例

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

radio.getSignalInformation

getSignalInformation(slotId: number): Promise<Array<SignalInformation>>

获取指定SIM卡槽对应的注册网络信号强度信息列表，使用Promise方式作为异步方法。

• 参数

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

• 返回值

  类型	说明
  Promise<Array<SignalInformation>>	以Promise形式返回网络信号强度SignalInformation对象的数组。

• 示例

  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.isRadioOn⁷⁺

isRadioOn(callback: AsyncCallback<boolean>): void

判断Radio是否打开，使用callback方式作为异步方法。

需要ohos.permission.GET_NETWORK_INFO权限。

• 参数

  参数名	类型	必填	说明
  callback	AsyncCallback<boolean>	是	回调函数。 - true：Radio打开 - false：Radio关闭

• 示例

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

radio.isRadioOn⁷⁺

isRadioOn(): Promise<boolean>

判断Radio是否打开，使用Promise方式作为异步方法。

需要ohos.permission.GET_NETWORK_INFO权限。

• 返回值

  类型	说明
  Promise<boolean>	以Promise形式返回判断Radio是否打开的结果。 - true：Radio打开 - false：Radio关闭

• 示例

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

RadioTechnology

无线接入技术。

SignalInformation

网络信号强度信息对象。

NetworkType

网络类型。

NetworkState

网络注册状态。

RegState

网络注册状态。

NsaState

非独立组网状态。

NetworkSelectionMode

选网模式。