1# @ohos.telephony.radio (网络搜索) 2 3网络搜索模块提供管理网络搜索的一些基础功能，包括获取当前接入的CS域和PS域无线接入技术、获取网络状态、获取当前选网模式、获取注册网络所在国家的ISO国家码、获取主卡所在卡槽的索引号、获取指定SIM卡槽对应的注册网络信号强度信息列表、获取运营商名称、获取设备的指定卡槽的IMEI、获取设备的指定卡槽的MEID、获取设备的指定卡槽的唯一设备ID，判断当前设备是否支持5G\(NR\)、判断主卡的Radio是否打开等。 4 5>**说明：** 6> 7>本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8 9 10## 导入模块 11 12```ts 13import radio from '@ohos.telephony.radio'; 14``` 15 16## radio.getRadioTech 17 18getRadioTech\(slotId: number, callback: AsyncCallback<\{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology\}\>\): void 19 20获取当前接入的CS域和PS域无线接入技术。使用callback异步回调。 21 22**需要权限**：ohos.permission.GET_NETWORK_INFO 23 24**系统能力**：SystemCapability.Telephony.CoreService 25 26**参数：** 27 28| 参数名 | 类型 | 必填 | 说明 | 29| -------- | ------------------------------------------------------------ | ---- | -------------------------------------- | 30| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 31| callback | AsyncCallback\<{psRadioTech: [RadioTechnology](#radiotechnology), csRadioTech:[RadioTechnology](#radiotechnology)}\> | 是 | 回调函数。 | 32 33**错误码：** 34 35以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 36 37| 错误码ID | 错误信息 | 38| -------- | -------------------------------------------- | 39| 201 | Permission denied. | 40| 401 | Parameter error. | 41| 8300001 | Invalid parameter value. | 42| 8300002 | Operation failed. Cannot connect to service. | 43| 8300003 | System internal error. | 44| 8300999 | Unknown error code. | 45 46**示例：** 47 48```ts 49import { BusinessError } from '@ohos.base'; 50 51let slotId: number = 0; 52class Tech { 53 psRadioTech: radio.RadioTechnology = radio.RadioTechnology.RADIO_TECHNOLOGY_UNKNOWN; 54 csRadioTech: radio.RadioTechnology = radio.RadioTechnology.RADIO_TECHNOLOGY_UNKNOWN; 55} 56radio.getRadioTech(slotId, (err: BusinessError, data: Tech) => { 57 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 58}); 59``` 60 61 62## radio.getRadioTech 63 64getRadioTech\(slotId: number\): Promise<\{psRadioTech: RadioTechnology, csRadioTech: RadioTechnology\}\> 65 66获取当前接入的CS域和PS域无线接入技术。使用Promise异步回调。 67 68**需要权限**：ohos.permission.GET_NETWORK_INFO 69 70**系统能力**：SystemCapability.Telephony.CoreService 71 72**参数：** 73 74| 参数名 | 类型 | 必填 | 说明 | 75| ------ | ------ | ---- | -------------------------------------- | 76| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 77 78**返回值：** 79 80| 类型 | 说明 | 81| ------------------------------------------------------------ | ----------------------------------------------- | 82| Promise<{psRadioTech: [RadioTechnology](#radiotechnology), csRadioTech: [RadioTechnology](#radiotechnology)}> | 以Promise形式返回获取当前接入的CS域和PS域技术。 | 83 84**错误码：** 85 86以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 87 88| 错误码ID | 错误信息 | 89| -------- | -------------------------------------------- | 90| 201 | Permission denied. | 91| 401 | Parameter error. | 92| 8300001 | Invalid parameter value. | 93| 8300002 | Operation failed. Cannot connect to service. | 94| 8300003 | System internal error. | 95| 8300999 | Unknown error code. | 96 97**示例：** 98 99```ts 100import { BusinessError } from '@ohos.base'; 101 102let slotId: number = 0; 103class Tech { 104 psRadioTech: radio.RadioTechnology = radio.RadioTechnology.RADIO_TECHNOLOGY_UNKNOWN; 105 csRadioTech: radio.RadioTechnology = radio.RadioTechnology.RADIO_TECHNOLOGY_UNKNOWN; 106} 107radio.getRadioTech(slotId).then((data: Tech) => { 108 console.log(`getRadioTech success, data->${JSON.stringify(data)}`); 109}).catch((err: BusinessError) => { 110 console.log(`getRadioTech failed, err->${JSON.stringify(err)}`); 111}); 112``` 113 114 115## radio.getNetworkState 116 117getNetworkState\(callback: AsyncCallback\<NetworkState\>\): void 118 119获取网络状态。使用callback异步回调。 120 121**需要权限**：ohos.permission.GET_NETWORK_INFO 122 123**系统能力**：SystemCapability.Telephony.CoreService 124 125**参数：** 126 127| 参数名 | 类型 | 必填 | 说明 | 128| -------- | ---------------------------------------------- | ---- | ---------- | 129| callback | AsyncCallback\<[NetworkState](#networkstate)\> | 是 | 回调函数。 | 130 131**错误码：** 132 133以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 134 135| 错误码ID | 错误信息 | 136| -------- | -------------------------------------------- | 137| 201 | Permission denied. | 138| 401 | Parameter error. | 139| 8300001 | Invalid parameter value. | 140| 8300002 | Operation failed. Cannot connect to service. | 141| 8300003 | System internal error. | 142| 8300999 | Unknown error code. | 143 144**示例：** 145 146```ts 147import { BusinessError } from '@ohos.base'; 148 149radio.getNetworkState((err: BusinessError, data: radio.NetworkState) => { 150 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 151}); 152``` 153 154 155## radio.getNetworkState 156 157getNetworkState\(slotId: number, callback: AsyncCallback\<NetworkState\>\): void 158 159获取网络状态。使用callback异步回调。 160 161**需要权限**：ohos.permission.GET_NETWORK_INFO 162 163**系统能力**：SystemCapability.Telephony.CoreService 164 165**参数：** 166 167| 参数名 | 类型 | 必填 | 说明 | 168| -------- | ---------------------------------------------- | ---- | -------------------------------------- | 169| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 170| callback | AsyncCallback\<[NetworkState](#networkstate)\> | 是 | 回调函数。 | 171 172**错误码：** 173 174以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 175 176| 错误码ID | 错误信息 | 177| -------- | -------------------------------------------- | 178| 201 | Permission denied. | 179| 401 | Parameter error. | 180| 8300001 | Invalid parameter value. | 181| 8300002 | Operation failed. Cannot connect to service. | 182| 8300003 | System internal error. | 183| 8300999 | Unknown error code. | 184 185**示例：** 186 187```ts 188import { BusinessError } from '@ohos.base'; 189 190let slotId: number = 0; 191radio.getNetworkState(slotId, (err: BusinessError, data: radio.NetworkState) => { 192 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 193}); 194``` 195 196 197## radio.getNetworkState 198 199getNetworkState\(slotId?: number\): Promise\<NetworkState\> 200 201获取网络状态。使用Promise异步回调。 202 203**需要权限**：ohos.permission.GET_NETWORK_INFO 204 205**系统能力**：SystemCapability.Telephony.CoreService 206 207**参数：** 208 209| 参数名 | 类型 | 必填 | 说明 | 210| ------ | ------ | ---- | -------------------------------------- | 211| slotId | number | 否 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 212 213**返回值：** 214 215| 类型 | 说明 | 216| ---------------------------------------- | --------------------------- | 217| Promise\<[NetworkState](#networkstate)\> | 以Promise形式返回网络状态。 | 218 219**错误码：** 220 221以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 222 223| 错误码ID | 错误信息 | 224| -------- | -------------------------------------------- | 225| 201 | Permission denied. | 226| 401 | Parameter error. | 227| 8300001 | Invalid parameter value. | 228| 8300002 | Operation failed. Cannot connect to service. | 229| 8300003 | System internal error. | 230| 8300999 | Unknown error code. | 231 232**示例：** 233 234```ts 235import { BusinessError } from '@ohos.base'; 236 237let slotId: number = 0; 238radio.getNetworkState(slotId).then((data: radio.NetworkState) => { 239 console.log(`getNetworkState success, promise: data->${JSON.stringify(data)}`); 240}).catch((err: BusinessError) => { 241 console.log(`getNetworkState failed, promise: err->${JSON.stringify(err)}`); 242}); 243``` 244 245 246## radio.getNetworkSelectionMode 247 248getNetworkSelectionMode\(slotId: number, callback: AsyncCallback\<NetworkSelectionMode\>\): void 249 250获取当前选网模式。使用callback异步回调。 251 252**系统能力**：SystemCapability.Telephony.CoreService 253 254**参数：** 255 256| 参数名 | 类型 | 必填 | 说明 | 257| -------- | ------------------------------------------------------------ | ---- | -------------------------------------- | 258| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 259| callback | AsyncCallback\<[NetworkSelectionMode](#networkselectionmode)\> | 是 | 回调函数。 | 260 261**错误码：** 262 263以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 264 265| 错误码ID | 错误信息 | 266| -------- | -------------------------------------------- | 267| 401 | Parameter error. | 268| 8300001 | Invalid parameter value. | 269| 8300002 | Operation failed. Cannot connect to service. | 270| 8300003 | System internal error. | 271| 8300999 | Unknown error code. | 272 273**示例：** 274 275```ts 276import { BusinessError } from '@ohos.base'; 277 278let slotId: number = 0; 279radio.getNetworkSelectionMode(slotId, (err: BusinessError, data: radio.NetworkSelectionMode) => { 280 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 281}); 282``` 283 284 285## radio.getNetworkSelectionMode 286 287getNetworkSelectionMode\(slotId: number\): Promise\<NetworkSelectionMode\> 288 289获取当前选网模式。使用Promise异步回调。 290 291**系统能力**：SystemCapability.Telephony.CoreService 292 293**参数：** 294 295| 参数名 | 类型 | 必填 | 说明 | 296| ------ | ------ | ---- | -------------------------------------- | 297| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 298 299**返回值：** 300 301| 类型 | 说明 | 302| -------------------------------------------------------- | ------------------------------- | 303| Promise\<[NetworkSelectionMode](#networkselectionmode)\> | 以Promise形式返回当前选网模式。 | 304 305**错误码：** 306 307以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 308 309| 错误码ID | 错误信息 | 310| -------- | -------------------------------------------- | 311| 401 | Parameter error. | 312| 8300001 | Invalid parameter value. | 313| 8300002 | Operation failed. Cannot connect to service. | 314| 8300003 | System internal error. | 315| 8300999 | Unknown error code. | 316 317**示例：** 318 319```ts 320import { BusinessError } from '@ohos.base'; 321 322let slotId: number = 0; 323radio.getNetworkSelectionMode(slotId).then((data: radio.NetworkSelectionMode) => { 324 console.log(`getNetworkSelectionMode success, promise: data->${JSON.stringify(data)}`); 325}).catch((err: BusinessError) => { 326 console.log(`getNetworkSelectionMode failed, promise: err->${JSON.stringify(err)}`); 327}); 328``` 329 330 331## radio.getISOCountryCodeForNetwork<sup>7+</sup> 332 333getISOCountryCodeForNetwork\(slotId: number, callback: AsyncCallback\<string\>\): void 334 335获取注册网络所在国家的ISO国家码。使用callback异步回调。 336 337**系统能力**：SystemCapability.Telephony.CoreService 338 339**参数：** 340 341| 参数名 | 类型 | 必填 | 说明 | 342| -------- | ----------------------- | ---- | ---------------------------------------- | 343| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 344| callback | AsyncCallback\<string\> | 是 | 回调函数。返回国家码，例如：CN（中国）。 | 345 346**错误码：** 347 348以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 349 350| 错误码ID | 错误信息 | 351| -------- | -------------------------------------------- | 352| 401 | Parameter error. | 353| 8300001 | Invalid parameter value. | 354| 8300002 | Operation failed. Cannot connect to service. | 355| 8300003 | System internal error. | 356| 8300999 | Unknown error code. | 357 358**示例：** 359 360```ts 361import { BusinessError } from '@ohos.base'; 362 363let slotId: number = 0; 364radio.getISOCountryCodeForNetwork(slotId, (err: BusinessError, data: string) => { 365 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 366}); 367``` 368 369 370## radio.getISOCountryCodeForNetwork<sup>7+</sup> 371 372getISOCountryCodeForNetwork\(slotId: number\): Promise\<string\> 373 374获取注册网络所在国家的ISO国家码。使用Promise异步回调。 375 376**系统能力**：SystemCapability.Telephony.CoreService 377 378**参数：** 379 380| 参数名 | 类型 | 必填 | 说明 | 381| ------ | ------ | ---- | -------------------------------------- | 382| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 383 384**返回值：** 385 386| 类型 | 说明 | 387| ----------------- | ------------------------------------------------------------ | 388| Promise\<string\> | 以Promise形式返回注册网络所在国家的ISO国家码，例如CN（中国）。 | 389 390**错误码：** 391 392以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 393 394| 错误码ID | 错误信息 | 395| -------- | -------------------------------------------- | 396| 401 | Parameter error. | 397| 8300001 | Invalid parameter value. | 398| 8300002 | Operation failed. Cannot connect to service. | 399| 8300003 | System internal error. | 400| 8300999 | Unknown error code. | 401 402**示例：** 403 404```ts 405import { BusinessError } from '@ohos.base'; 406 407let slotId: number = 0; 408radio.getISOCountryCodeForNetwork(slotId).then((data: string) => { 409 console.log(`getISOCountryCodeForNetwork success, promise: data->${JSON.stringify(data)}`); 410}).catch((err: BusinessError) => { 411 console.log(`getISOCountryCodeForNetwork failed, promise: err->${JSON.stringify(err)}`); 412}); 413``` 414 415## radio.getISOCountryCodeForNetworkSync<sup>10+</sup> 416 417getISOCountryCodeForNetworkSync\(slotId: number\): string 418 419获取注册网络所在国家的ISO国家码。 420 421**系统能力**：SystemCapability.Telephony.CoreService 422 423**参数：** 424 425| 参数名 | 类型 | 必填 | 说明 | 426| ------ | ------ | ---- | -------------------------------------- | 427| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 428 429**返回值：** 430 431| 类型 | 说明 | 432| ----------------- | ------------------------------------------------------------ | 433| string | 返回注册网络所在国家的ISO国家码，例如CN（中国）。 | 434 435**示例：** 436 437```js 438let slotId = 0; 439let countryISO = radio.getISOCountryCodeForNetworkSync(slotId); 440console.log(`the country ISO is:` + countryISO); 441``` 442 443 444 445## radio.getPrimarySlotId<sup>7+</sup> 446 447getPrimarySlotId\(callback: AsyncCallback\<number\>\): void 448 449获取主卡所在卡槽的索引号。使用callback异步回调。 450 451**系统能力**：SystemCapability.Telephony.CoreService 452 453**参数：** 454 455| 参数名 | 类型 | 必填 | 说明 | 456| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 457| callback | AsyncCallback\<number\> | 是 | 回调函数 | 458 459**错误码：** 460 461以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 462 463| 错误码ID | 错误信息 | 464| -------- | -------------------------------------------- | 465| 8300001 | Invalid parameter value. | 466| 8300002 | Operation failed. Cannot connect to service. | 467| 8300003 | System internal error. | 468| 8300999 | Unknown error code. | 469 470**示例：** 471 472```ts 473import { BusinessError } from '@ohos.base'; 474 475radio.getPrimarySlotId((err: BusinessError, data: number) => { 476 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 477}); 478``` 479 480 481## radio.getPrimarySlotId<sup>7+</sup> 482 483getPrimarySlotId\(\): Promise\<number\> 484 485获取主卡所在卡槽的索引号。使用Promise异步回调。 486 487**系统能力**：SystemCapability.Telephony.CoreService 488 489**返回值：** 490 491| 类型 | 说明 | 492| ----------------------------------------------------------- | ------------------------------------------------------------ | 493| Promise\<number\> | 以Promise形式返回获取设备主卡所在卡槽的索引号的结果。 | 494 495**错误码：** 496 497以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 498 499| 错误码ID | 错误信息 | 500| -------- | -------------------------------------------- | 501| 8300002 | Operation failed. Cannot connect to service. | 502| 8300003 | System internal error. | 503| 8300999 | Unknown error code. | 504 505**示例：** 506 507```ts 508import { BusinessError } from '@ohos.base'; 509 510radio.getPrimarySlotId().then((data: number) => { 511 console.log(`getPrimarySlotId success, promise: data->${JSON.stringify(data)}`); 512}).catch((err: BusinessError) => { 513 console.error(`getPrimarySlotId failed, promise: err->${JSON.stringify(err)}`); 514}); 515``` 516 517 518## radio.getSignalInformation<sup>7+</sup> 519 520getSignalInformation\(slotId: number, callback: AsyncCallback\<Array\<SignalInformation\>\>\): void 521 522获取指定SIM卡槽对应的注册网络信号强度信息列表。使用callback异步回调。 523 524**系统能力**：SystemCapability.Telephony.CoreService 525 526**参数：** 527 528| 参数名 | 类型 | 必填 | 说明 | 529| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 530| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 531| callback | AsyncCallback\<Array\<[SignalInformation](#signalinformation)\>\> | 是 | 回调函数，返回[SignalInformation](#signalinformation)对象的数组。 | 532 533**错误码：** 534 535以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 536 537| 错误码ID | 错误信息 | 538| -------- | -------------------------------------------- | 539| 401 | Parameter error. | 540| 8300001 | Invalid parameter value. | 541| 8300002 | Operation failed. Cannot connect to service. | 542| 8300003 | System internal error. | 543| 8300999 | Unknown error code. | 544 545**示例：** 546 547```ts 548import { BusinessError } from '@ohos.base'; 549 550let slotId: number = 0; 551radio.getSignalInformation(slotId, (err: BusinessError, data: Array<radio.SignalInformation>) => { 552 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 553}); 554``` 555 556 557## radio.getSignalInformation<sup>7+</sup> 558 559getSignalInformation\(slotId: number\): Promise\<Array\<SignalInformation\>\> 560 561获取指定SIM卡槽对应的注册网络信号强度信息列表。使用Promise异步回调。 562 563**系统能力**：SystemCapability.Telephony.CoreService 564 565**参数：** 566 567| 参数名 | 类型 | 必填 | 说明 | 568| ------ | ------ | ---- | -------------------------------------- | 569| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 570 571**返回值：** 572 573| 类型 | 说明 | 574| ----------------------------------------------------------- | ------------------------------------------------------------ | 575| Promise\<Array\<[SignalInformation](#signalinformation)\>\> | 以Promise形式返回网络信号强度[SignalInformation](#signalinformation)对象的数组。 | 576 577**错误码：** 578 579以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 580 581| 错误码ID | 错误信息 | 582| -------- | -------------------------------------------- | 583| 401 | Parameter error. | 584| 8300001 | Invalid parameter value. | 585| 8300002 | Operation failed. Cannot connect to service. | 586| 8300003 | System internal error. | 587| 8300999 | Unknown error code. | 588 589**示例：** 590 591```ts 592import { BusinessError } from '@ohos.base'; 593 594let slotId: number = 0; 595radio.getSignalInformation(slotId).then((data: Array<radio.SignalInformation>) => { 596 console.log(`getSignalInformation success, promise: data->${JSON.stringify(data)}`); 597}).catch((err: BusinessError) => { 598 console.error(`getSignalInformation failed, promise: err->${JSON.stringify(err)}`); 599}); 600``` 601 602## radio.getSignalInformationSync<sup>10+</sup> 603 604getSignalInformationSync\(slotId: number\): Array\<SignalInformation\> 605 606获取指定SIM卡槽对应的注册网络信号强度信息列表。 607 608**系统能力**：SystemCapability.Telephony.CoreService 609 610**参数：** 611 612| 参数名 | 类型 | 必填 | 说明 | 613| ------ | ------ | ---- | -------------------------------------- | 614| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 615 616**返回值：** 617 618| 类型 | 说明 | 619| ----------------------------------------------------------- | ------------------------------------------------------------ | 620| Array\<[SignalInformation](#signalinformation)\>| 返回网络信号强度[SignalInformation](#signalinformation)对象的数组。 | 621 622 623**示例：** 624 625```js 626let slotId = 0; 627let signalInfo = radio.getSignalInformationSync(slotId); 628console.log(`signal information size is:` + signalInfo.length); 629``` 630 631## radio.isNrSupported<sup>(deprecated)</sup> 632 633isNrSupported\(\): boolean 634 635判断当前设备是否支持5G\(NR\)。 636 637> **说明：** 638> 639> 从 API version 7开始支持，从API version 9开始废弃。建议使用[isNRSupported](#radioisnrsupported9)替代。 640 641**系统能力**：SystemCapability.Telephony.CoreService 642 643**返回值：** 644 645| 类型 | 说明 | 646| ------- | -------------------------------- | 647| boolean | - true：支持<br/>- false：不支持 | 648 649**示例：** 650 651```ts 652let result: boolean = radio.isNrSupported(); 653console.log("Result: "+ result); 654``` 655 656## radio.isNrSupported<sup>(deprecated)</sup> 657 658isNrSupported\(slotId: number\): boolean 659 660判断当前设备是否支持5G\(NR\)。 661 662> **说明：** 663> 664> 从 API version 8开始支持，从API version 9开始废弃。建议使用[isNRSupported](#radioisnrsupported9-1)替代。 665 666**系统能力**：SystemCapability.Telephony.CoreService 667 668**参数：** 669 670| 参数名 | 类型 | 必填 | 说明 | 671| ------ | ------ | ---- | -------------------------------------- | 672| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 673 674**返回值：** 675 676| 类型 | 说明 | 677| ------------------ | ------------------------------------------------------------ | 678| boolean | - true：支持<br/>- false：不支持 | 679 680**示例：** 681 682```ts 683let slotId: number = 0; 684let result: boolean = radio.isNrSupported(slotId); 685console.log("Result: "+ result); 686``` 687 688 689## radio.isNRSupported<sup>9+</sup> 690 691isNRSupported\(\): boolean 692 693判断当前设备是否支持5G\(NR\)。 694 695**系统能力**：SystemCapability.Telephony.CoreService 696 697**返回值：** 698 699| 类型 | 说明 | 700| ------- | -------------------------------- | 701| boolean | - true：支持<br/>- false：不支持 | 702 703**示例：** 704 705```ts 706let result: boolean = radio.isNRSupported(); 707console.log("Result: "+ result); 708``` 709 710 711## radio.isNRSupported<sup>9+</sup> 712 713isNRSupported\(slotId: number\): boolean 714 715判断当前设备是否支持5G\(NR\)。 716 717**系统能力**：SystemCapability.Telephony.CoreService 718 719**参数：** 720 721| 参数名 | 类型 | 必填 | 说明 | 722| ------ | ------ | ---- | -------------------------------------- | 723| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 724 725**返回值：** 726 727| 类型 | 说明 | 728| ------------------ | ------------------------------------------------------------ | 729| boolean | - true：支持<br/>- false：不支持 | 730 731**示例：** 732 733```ts 734let slotId: number = 0; 735let result: boolean = radio.isNRSupported(slotId); 736console.log("Result: "+ result); 737``` 738 739 740## radio.isRadioOn<sup>7+</sup> 741 742isRadioOn\(callback: AsyncCallback\<boolean\>\): void 743 744判断主卡的Radio是否打开。使用callback异步回调。 745 746**需要权限**：ohos.permission.GET_NETWORK_INFO 747 748**系统能力**：SystemCapability.Telephony.CoreService 749 750**参数：** 751 752| 参数名 | 类型 | 必填 | 说明 | 753| -------- | ------------------------ | ---- | ------------------------------------------------------- | 754| callback | AsyncCallback\<boolean\> | 是 | 回调函数。<br/>- true：Radio打开<br/>- false：Radio关闭 | 755 756**错误码：** 757 758以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 759 760| 错误码ID | 错误信息 | 761| -------- | -------------------------------------------- | 762| 201 | Permission denied. | 763| 401 | Parameter error. | 764| 8300001 | Invalid parameter value. | 765| 8300002 | Operation failed. Cannot connect to service. | 766| 8300003 | System internal error. | 767| 8300999 | Unknown error code. | 768 769**示例：** 770 771```ts 772import { BusinessError } from '@ohos.base'; 773 774radio.isRadioOn((err: BusinessError, data: boolean) => { 775 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 776}); 777``` 778 779 780## radio.isRadioOn<sup>7+</sup> 781 782isRadioOn\(slotId: number, callback: AsyncCallback\<boolean\>\): void 783 784判断指定卡槽位的Radio是否打开。使用callback异步回调。 785 786**需要权限**：ohos.permission.GET_NETWORK_INFO 787 788**系统能力**：SystemCapability.Telephony.CoreService 789 790**参数：** 791 792| 参数名 | 类型 | 必填 | 说明 | 793| -------- | ------------------------ | ---- | ------------------------------------------------------- | 794| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 795| callback | AsyncCallback\<boolean\> | 是 | 回调函数。<br/>- true：Radio打开<br/>- false：Radio关闭 | 796 797**错误码：** 798 799以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 800 801| 错误码ID | 错误信息 | 802| -------- | -------------------------------------------- | 803| 201 | Permission denied. | 804| 401 | Parameter error. | 805| 8300001 | Invalid parameter value. | 806| 8300002 | Operation failed. Cannot connect to service. | 807| 8300003 | System internal error. | 808| 8300999 | Unknown error code. | 809 810**示例：** 811 812```ts 813import { BusinessError } from '@ohos.base'; 814 815let slotId: number = 0; 816radio.isRadioOn(slotId, (err: BusinessError, data: boolean) => { 817 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 818}); 819``` 820 821 822## radio.isRadioOn<sup>7+</sup> 823 824isRadioOn\(slotId?: number\): Promise\<boolean\> 825 826判断Radio是否打开。使用Promise异步回调。 827 828**需要权限**：ohos.permission.GET_NETWORK_INFO 829 830**系统能力**：SystemCapability.Telephony.CoreService 831 832**参数：** 833 834| 参数名 | 类型 | 必填 | 说明 | 835| ------ | ------ | ---- | -------------------------------------- | 836| slotId | number | 否 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2<br/>如果不指定slotId，默认判断主卡Radio是否打开 | 837 838**返回值：** 839 840| 类型 | 说明 | 841| ------------------ | ------------------------------------------------------------ | 842| Promise\<boolean\> | 以Promise形式返回判断Radio是否打开的结果。<br/>- true：Radio打开<br/>- false：Radio关闭 | 843 844**错误码：** 845 846以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 847 848| 错误码ID | 错误信息 | 849| -------- | -------------------------------------------- | 850| 201 | Permission denied. | 851| 401 | Parameter error. | 852| 8300001 | Invalid parameter value. | 853| 8300002 | Operation failed. Cannot connect to service. | 854| 8300003 | System internal error. | 855| 8300999 | Unknown error code. | 856 857**示例：** 858 859```ts 860import { BusinessError } from '@ohos.base'; 861 862let slotId: number = 0; 863radio.isRadioOn(slotId).then((data: boolean) => { 864 console.log(`isRadioOn success, promise: data->${JSON.stringify(data)}`); 865}).catch((err: BusinessError) => { 866 console.error(`isRadioOn failed, promise: err->${JSON.stringify(err)}`); 867}); 868``` 869 870 871## radio.getOperatorName<sup>7+</sup> 872 873getOperatorName\(slotId: number, callback: AsyncCallback\<string\>\): void 874 875获取运营商名称。使用callback异步回调。 876 877**系统能力**：SystemCapability.Telephony.CoreService 878 879**参数：** 880 881| 参数名 | 类型 | 必填 | 说明 | 882| -------- | ----------------------- | ---- | ------------------------------------------ | 883| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 884| callback | AsyncCallback\<string\> | 是 | 回调函数，返回运营商名称，例如：中国移动。 | 885 886**错误码：** 887 888以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 889 890| 错误码ID | 错误信息 | 891| -------- | -------------------------------------------- | 892| 401 | Parameter error. | 893| 8300001 | Invalid parameter value. | 894| 8300002 | Operation failed. Cannot connect to service. | 895| 8300003 | System internal error. | 896| 8300999 | Unknown error code. | 897 898**示例：** 899 900```ts 901import { BusinessError } from '@ohos.base'; 902 903let slotId: number = 0; 904radio.getOperatorName(slotId, (err: BusinessError, data: string) => { 905 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 906}); 907``` 908 909 910## radio.getOperatorName<sup>7+</sup> 911 912getOperatorName\(slotId: number\): Promise\<string\> 913 914获取运营商名称。使用Promise异步回调。 915 916**系统能力**：SystemCapability.Telephony.CoreService 917 918**参数：** 919 920| 参数名 | 类型 | 必填 | 说明 | 921| ------ | ------ | ---- | -------------------------------------- | 922| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 923 924**返回值：** 925 926| 类型 | 说明 | 927| ----------------- | ------------------------------------------------------------ | 928| Promise\<string\> | 以Promise形式返回运营商名称，例如：中国移动。 | 929 930**错误码：** 931 932以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 933 934| 错误码ID | 错误信息 | 935| -------- | -------------------------------------------- | 936| 401 | Parameter error. | 937| 8300001 | Invalid parameter value. | 938| 8300002 | Operation failed. Cannot connect to service. | 939| 8300003 | System internal error. | 940| 8300999 | Unknown error code. | 941 942**示例：** 943 944```ts 945import { BusinessError } from '@ohos.base'; 946 947let slotId: number = 0; 948radio.getOperatorName(slotId).then((data: string) => { 949 console.log(`getOperatorName success, promise: data->${JSON.stringify(data)}`); 950}).catch((err: BusinessError) => { 951 console.log(`getOperatorName failed, promise: err->${JSON.stringify(err)}`); 952}); 953``` 954 955## radio.getOperatorNameSync<sup>10+</sup> 956 957getOperatorNameSync\(slotId: number\): string 958 959获取运营商名称。 960 961**系统能力**：SystemCapability.Telephony.CoreService 962 963**参数：** 964 965| 参数名 | 类型 | 必填 | 说明 | 966| ------ | ------ | ---- | -------------------------------------- | 967| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 968 969**返回值：** 970 971| 类型 | 说明 | 972| ----------------- | ------------------------------------------------------------ | 973| string | 返回运营商名称，例如：中国移动。 | 974 975 976**示例：** 977 978```js 979let slotId = 0; 980let operatorName = radio.getOperatorNameSync(slotId); 981console.log(`operator name is:` + operatorName); 982``` 983 984## radio.setPrimarySlotId<sup>8+</sup> 985 986setPrimarySlotId\(slotId: number, callback: AsyncCallback\<void\>\): void 987 988设置主卡所在卡槽的索引号。使用callback异步回调。 989 990**系统接口：** 此接口为系统接口。 991 992**需要权限**：ohos.permission.SET_TELEPHONY_STATE 993 994**系统能力**：SystemCapability.Telephony.CoreService 995 996**参数：** 997 998| 参数名 | 类型 | 必填 | 说明 | 999| -------- | --------------------- | ---- | -------------------------------------- | 1000| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1001| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 1002 1003**错误码：** 1004 1005以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1006 1007| 错误码ID | 错误信息 | 1008| -------- | -------------------------------------------- | 1009| 201 | Permission denied. | 1010| 202 | Non-system applications use system APIs. | 1011| 401 | Parameter error. | 1012| 8300001 | Invalid parameter value. | 1013| 8300002 | Operation failed. Cannot connect to service. | 1014| 8300003 | System internal error. | 1015| 8300004 | Do not have sim card. | 1016| 8300999 | Unknown error code. | 1017 1018**示例：** 1019 1020```ts 1021import { BusinessError } from '@ohos.base'; 1022 1023let slotId: number = 0; 1024radio.setPrimarySlotId(slotId, (err: BusinessError) => { 1025 console.log(`callback: err->${JSON.stringify(err)}`); 1026}); 1027``` 1028 1029 1030## radio.setPrimarySlotId<sup>8+</sup> 1031 1032setPrimarySlotId\(slotId: number\): Promise\<void\> 1033 1034设置主卡所在卡槽的索引号。使用Promise异步回调。 1035 1036**系统接口：** 此接口为系统接口。 1037 1038**需要权限**：ohos.permission.SET_TELEPHONY_STATE 1039 1040**系统能力**：SystemCapability.Telephony.CoreService 1041 1042**参数：** 1043 1044| 参数名 | 类型 | 必填 | 说明 | 1045| ------ | ------ | ---- | -------------------------------------- | 1046| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1047 1048**返回值：** 1049 1050| 类型 | 说明 | 1051| --------------- | ------------------------------- | 1052| Promise\<void\> | 以Promise形式异步返回设置结果。 | 1053 1054**错误码：** 1055 1056以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1057 1058| 错误码ID | 错误信息 | 1059| -------- | -------------------------------------------- | 1060| 201 | Permission denied. | 1061| 202 | Non-system applications use system APIs. | 1062| 401 | Parameter error. | 1063| 8300001 | Invalid parameter value. | 1064| 8300002 | Operation failed. Cannot connect to service. | 1065| 8300003 | System internal error. | 1066| 8300004 | Do not have sim card. | 1067| 8300999 | Unknown error code. | 1068 1069**示例：** 1070 1071```ts 1072import { BusinessError } from '@ohos.base'; 1073 1074let slotId: number = 0; 1075radio.setPrimarySlotId(slotId).then(() => { 1076 console.log(`setPrimarySlotId success.`); 1077}).catch((err: BusinessError) => { 1078 console.log(`setPrimarySlotId failed, promise: err->${JSON.stringify(err)}`); 1079}); 1080``` 1081 1082## radio.getIMEI<sup>8+</sup> 1083 1084getIMEI\(callback: AsyncCallback\<string\>\): void 1085 1086获取设备的指定卡槽的IMEI。使用callback异步回调。 1087 1088**系统接口：** 此接口为系统接口。 1089 1090**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1091 1092**系统能力**：SystemCapability.Telephony.CoreService 1093 1094**参数：** 1095 1096| 参数名 | 类型 | 必填 | 说明 | 1097| -------- | ----------------------- | ---- | ------------------------------------------ | 1098| callback | AsyncCallback\<string\> | 是 | 回调函数，如果IMEI不存在，则返回空字符串。 | 1099 1100**错误码：** 1101 1102以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1103 1104| 错误码ID | 错误信息 | 1105| -------- | -------------------------------------------- | 1106| 201 | Permission denied. | 1107| 202 | Non-system applications use system APIs. | 1108| 401 | Parameter error. | 1109| 8300001 | Invalid parameter value. | 1110| 8300002 | Operation failed. Cannot connect to service. | 1111| 8300003 | System internal error. | 1112| 8300999 | Unknown error code. | 1113 1114**示例：** 1115 1116```ts 1117import { BusinessError } from '@ohos.base'; 1118 1119radio.getIMEI((err: BusinessError, data: string) => { 1120 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1121}); 1122``` 1123 1124 1125## radio.getIMEI<sup>8+</sup> 1126 1127getIMEI\(slotId: number, callback: AsyncCallback\<string\>\): void 1128 1129获取设备的指定卡槽的IMEI。使用callback异步回调。 1130 1131**系统接口：** 此接口为系统接口。 1132 1133**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1134 1135**系统能力**：SystemCapability.Telephony.CoreService 1136 1137**参数：** 1138 1139| 参数名 | 类型 | 必填 | 说明 | 1140| -------- | ----------------------- | ---- | ------------------------------------------ | 1141| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1142| callback | AsyncCallback\<string\> | 是 | 回调函数，如果IMEI不存在，则返回空字符串。 | 1143 1144**错误码：** 1145 1146以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1147 1148| 错误码ID | 错误信息 | 1149| -------- | -------------------------------------------- | 1150| 201 | Permission denied. | 1151| 202 | Non-system applications use system APIs. | 1152| 401 | Parameter error. | 1153| 8300001 | Invalid parameter value. | 1154| 8300002 | Operation failed. Cannot connect to service. | 1155| 8300003 | System internal error. | 1156| 8300999 | Unknown error code. | 1157 1158**示例：** 1159 1160```ts 1161import { BusinessError } from '@ohos.base'; 1162 1163let slotId: number = 0; 1164radio.getIMEI(slotId, (err: BusinessError, data: string) => { 1165 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1166}); 1167``` 1168 1169 1170## radio.getIMEI<sup>8+</sup> 1171 1172getIMEI\(slotId?: number\): Promise\<string\> 1173 1174获取设备的指定卡槽的IMEI。使用Promise异步回调。 1175 1176**系统接口：** 此接口为系统接口。 1177 1178**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1179 1180**系统能力**：SystemCapability.Telephony.CoreService 1181 1182**参数：** 1183 1184| 参数名 | 类型 | 必填 | 说明 | 1185| ------ | ------ | ---- | -------------------------------------- | 1186| slotId | number | 否 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1187 1188**返回值：** 1189 1190| 类型 | 说明 | 1191| ----------------- | ------------------------------------------ | 1192| Promise\<string\> | 以Promise形式异步返回IMEI；如果IMEI不存在，则返回空字符串。 | 1193 1194**错误码：** 1195 1196以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1197 1198| 错误码ID | 错误信息 | 1199| -------- | -------------------------------------------- | 1200| 201 | Permission denied. | 1201| 202 | Non-system applications use system APIs. | 1202| 401 | Parameter error. | 1203| 8300001 | Invalid parameter value. | 1204| 8300002 | Operation failed. Cannot connect to service. | 1205| 8300003 | System internal error. | 1206| 8300999 | Unknown error code. | 1207 1208**示例：** 1209 1210```ts 1211import { BusinessError } from '@ohos.base'; 1212 1213let slotId: number = 0; 1214radio.getIMEI(slotId).then((data: string) => { 1215 console.log(`getIMEI success, promise: data->${JSON.stringify(data)}`); 1216}).catch((err: BusinessError) => { 1217 console.error(`getIMEI failed, promise: err->${JSON.stringify(err)}`); 1218}); 1219``` 1220 1221## radio.getMEID<sup>8+</sup> 1222 1223getMEID\(callback: AsyncCallback\<string\>\): void 1224 1225获取设备的指定卡槽的MEID。使用callback异步回调。 1226 1227**系统接口：** 此接口为系统接口。 1228 1229**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1230 1231**系统能力**：SystemCapability.Telephony.CoreService 1232 1233**参数：** 1234 1235| 参数名 | 类型 | 必填 | 说明 | 1236| -------- | ----------------------- | ---- | ---------- | 1237| callback | AsyncCallback\<string\> | 是 | 回调函数。 | 1238 1239**错误码：** 1240 1241以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1242 1243| 错误码ID | 错误信息 | 1244| -------- | -------------------------------------------- | 1245| 201 | Permission denied. | 1246| 202 | Non-system applications use system APIs. | 1247| 401 | Parameter error. | 1248| 8300001 | Invalid parameter value. | 1249| 8300002 | Operation failed. Cannot connect to service. | 1250| 8300003 | System internal error. | 1251| 8300999 | Unknown error code. | 1252 1253**示例：** 1254 1255```ts 1256import { BusinessError } from '@ohos.base'; 1257 1258radio.getMEID((err: BusinessError, data: string) => { 1259 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1260}); 1261``` 1262 1263 1264## radio.getMEID<sup>8+</sup> 1265 1266getMEID\(slotId: number, callback: AsyncCallback\<string\>\): void 1267 1268获取设备的指定卡槽的MEID。使用callback异步回调。 1269 1270**系统接口：** 此接口为系统接口。 1271 1272**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1273 1274**系统能力**：SystemCapability.Telephony.CoreService 1275 1276**参数：** 1277 1278| 参数名 | 类型 | 必填 | 说明 | 1279| -------- | ----------------------- | ---- | -------------------------------------- | 1280| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1281| callback | AsyncCallback\<string\> | 是 | 回调函数。 | 1282 1283**错误码：** 1284 1285以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1286 1287| 错误码ID | 错误信息 | 1288| -------- | -------------------------------------------- | 1289| 201 | Permission denied. | 1290| 202 | Non-system applications use system APIs. | 1291| 401 | Parameter error. | 1292| 8300001 | Invalid parameter value. | 1293| 8300002 | Operation failed. Cannot connect to service. | 1294| 8300003 | System internal error. | 1295| 8300999 | Unknown error code. | 1296 1297**示例：** 1298 1299```ts 1300import { BusinessError } from '@ohos.base'; 1301 1302let slotId: number = 0; 1303radio.getMEID(slotId, (err: BusinessError, data: string) => { 1304 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1305}); 1306``` 1307 1308 1309## radio.getMEID<sup>8+</sup> 1310 1311getMEID\(slotId?: number\): Promise\<string\> 1312 1313获取设备的指定卡槽的MEID。使用Promise异步回调。 1314 1315**系统接口：** 此接口为系统接口。 1316 1317**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1318 1319**系统能力**：SystemCapability.Telephony.CoreService 1320 1321**参数：** 1322 1323| 参数名 | 类型 | 必填 | 说明 | 1324| ------ | ------ | ---- | -------------------------------------- | 1325| slotId | number | 否 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1326 1327**返回值：** 1328 1329| 类型 | 说明 | 1330| ----------------- | --------------------------------------- | 1331| Promise\<string\> | 以Promise形式返回设备的指定卡槽的MEID。 | 1332 1333**错误码：** 1334 1335以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1336 1337| 错误码ID | 错误信息 | 1338| -------- | -------------------------------------------- | 1339| 201 | Permission denied. | 1340| 202 | Non-system applications use system APIs. | 1341| 401 | Parameter error. | 1342| 8300001 | Invalid parameter value. | 1343| 8300002 | Operation failed. Cannot connect to service. | 1344| 8300003 | System internal error. | 1345| 8300999 | Unknown error code. | 1346 1347**示例：** 1348 1349```ts 1350import { BusinessError } from '@ohos.base'; 1351 1352let slotId: number = 0; 1353radio.getMEID(slotId).then((data: string) => { 1354 console.log(`getMEID success, promise: data->${JSON.stringify(data)}`); 1355}).catch((err: BusinessError) => { 1356 console.error(`getMEID failed, promise: err->${JSON.stringify(err)}`); 1357}); 1358``` 1359 1360## radio.getUniqueDeviceId<sup>8+</sup> 1361 1362getUniqueDeviceId\(callback: AsyncCallback\<string\>\): void 1363 1364获取设备的指定卡槽的唯一设备ID。使用callback异步回调。 1365 1366**系统接口：** 此接口为系统接口。 1367 1368**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1369 1370**系统能力**：SystemCapability.Telephony.CoreService 1371 1372**参数：** 1373 1374| 参数名 | 类型 | 必填 | 说明 | 1375| -------- | ----------------------- | ---- | ---------- | 1376| callback | AsyncCallback\<string\> | 是 | 回调函数。 | 1377 1378**错误码：** 1379 1380以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1381 1382| 错误码ID | 错误信息 | 1383| -------- | -------------------------------------------- | 1384| 201 | Permission denied. | 1385| 202 | Non-system applications use system APIs. | 1386| 401 | Parameter error. | 1387| 8300001 | Invalid parameter value. | 1388| 8300002 | Operation failed. Cannot connect to service. | 1389| 8300003 | System internal error. | 1390| 8300999 | Unknown error code. | 1391 1392**示例：** 1393 1394```ts 1395import { BusinessError } from '@ohos.base'; 1396 1397radio.getUniqueDeviceId((err: BusinessError, data: string) => { 1398 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1399}); 1400``` 1401 1402 1403## radio.getUniqueDeviceId<sup>8+</sup> 1404 1405getUniqueDeviceId\(slotId: number, callback: AsyncCallback\<string\>\): void 1406 1407获取设备的指定卡槽的唯一设备ID。使用callback异步回调。 1408 1409**系统接口：** 此接口为系统接口。 1410 1411**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1412 1413**系统能力**：SystemCapability.Telephony.CoreService 1414 1415**参数：** 1416 1417| 参数名 | 类型 | 必填 | 说明 | 1418| -------- | ----------------------- | ---- | -------------------------------------- | 1419| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1420| callback | AsyncCallback\<string\> | 是 | 回调函数。 | 1421 1422**错误码：** 1423 1424以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1425 1426| 错误码ID | 错误信息 | 1427| -------- | -------------------------------------------- | 1428| 201 | Permission denied. | 1429| 202 | Non-system applications use system APIs. | 1430| 401 | Parameter error. | 1431| 8300001 | Invalid parameter value. | 1432| 8300002 | Operation failed. Cannot connect to service. | 1433| 8300003 | System internal error. | 1434| 8300999 | Unknown error code. | 1435 1436**示例：** 1437 1438```ts 1439import { BusinessError } from '@ohos.base'; 1440 1441let slotId: number = 0; 1442radio.getUniqueDeviceId(slotId, (err: BusinessError, data: string) => { 1443 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1444}); 1445``` 1446 1447 1448## radio.getUniqueDeviceId<sup>8+</sup> 1449 1450getUniqueDeviceId\(slotId?: number\): Promise\<string\> 1451 1452获取设备的指定卡槽的唯一设备ID。使用Promise异步回调。 1453 1454**系统接口：** 此接口为系统接口。 1455 1456**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1457 1458**系统能力**：SystemCapability.Telephony.CoreService 1459 1460**参数：** 1461 1462| 参数名 | 类型 | 必填 | 说明 | 1463| ------ | ------ | ---- | -------------------------------------- | 1464| slotId | number | 否 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1465 1466**返回值：** 1467 1468| 类型 | 说明 | 1469| ----------------- | --------------------------------------------- | 1470| Promise\<string\> | 以Promise形式返回设备的指定卡槽的唯一设备ID。 | 1471 1472**错误码：** 1473 1474以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1475 1476| 错误码ID | 错误信息 | 1477| -------- | -------------------------------------------- | 1478| 201 | Permission denied. | 1479| 202 | Non-system applications use system APIs. | 1480| 401 | Parameter error. | 1481| 8300001 | Invalid parameter value. | 1482| 8300002 | Operation failed. Cannot connect to service. | 1483| 8300003 | System internal error. | 1484| 8300999 | Unknown error code. | 1485 1486**示例：** 1487 1488```ts 1489import { BusinessError } from '@ohos.base'; 1490 1491let slotId: number = 0; 1492radio.getUniqueDeviceId(slotId).then((data: string) => { 1493 console.log(`getUniqueDeviceId success, promise: data->${JSON.stringify(data)}`); 1494}).catch((err: BusinessError) => { 1495 console.error(`getUniqueDeviceId failed, promise: err->${JSON.stringify(err)}`); 1496}); 1497``` 1498 1499## radio.sendUpdateCellLocationRequest<sup>8+</sup> 1500 1501sendUpdateCellLocationRequest\(callback: AsyncCallback\<void\>\): void 1502 1503发送更新小区位置请求。使用callback异步回调。 1504 1505**系统接口：** 此接口为系统接口。 1506 1507**需要权限**：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION 1508 1509**系统能力**：SystemCapability.Telephony.CoreService 1510 1511**参数：** 1512 1513| 参数名 | 类型 | 必填 | 说明 | 1514| -------- | --------------------- | ---- | ---------- | 1515| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 1516 1517**错误码：** 1518 1519以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1520 1521| 错误码ID | 错误信息 | 1522| -------- | -------------------------------------------- | 1523| 201 | Permission denied. | 1524| 202 | Non-system applications use system APIs. | 1525| 401 | Parameter error. | 1526| 8300001 | Invalid parameter value. | 1527| 8300002 | Operation failed. Cannot connect to service. | 1528| 8300003 | System internal error. | 1529| 8300999 | Unknown error code. | 1530 1531**示例：** 1532 1533```ts 1534import { BusinessError } from '@ohos.base'; 1535 1536radio.sendUpdateCellLocationRequest((err: BusinessError) => { 1537 console.log(`callback: err->${JSON.stringify(err)}`); 1538}); 1539``` 1540 1541## radio.sendUpdateCellLocationRequest<sup>8+</sup> 1542 1543sendUpdateCellLocationRequest\(slotId: number, callback: AsyncCallback\<void\>\): void 1544 1545发送更新小区位置请求。使用callback异步回调。 1546 1547**系统接口：** 此接口为系统接口。 1548 1549**需要权限**：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION 1550 1551**系统能力**：SystemCapability.Telephony.CoreService 1552 1553**参数：** 1554 1555| 参数名 | 类型 | 必填 | 说明 | 1556| -------- | --------------------- | ---- | ---------- | 1557| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1558| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 1559 1560**错误码：** 1561 1562以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1563 1564| 错误码ID | 错误信息 | 1565| -------- | -------------------------------------------- | 1566| 201 | Permission denied. | 1567| 202 | Non-system applications use system APIs. | 1568| 401 | Parameter error. | 1569| 8300001 | Invalid parameter value. | 1570| 8300002 | Operation failed. Cannot connect to service. | 1571| 8300003 | System internal error. | 1572| 8300999 | Unknown error code. | 1573 1574**示例：** 1575 1576```ts 1577import { BusinessError } from '@ohos.base'; 1578 1579let slotId: number = 0; 1580radio.sendUpdateCellLocationRequest(slotId, (err: BusinessError) => { 1581 console.log(`callback: err->${JSON.stringify(err)}`); 1582}); 1583``` 1584 1585## radio.sendUpdateCellLocationRequest<sup>8+</sup> 1586 1587sendUpdateCellLocationRequest\(slotId?: number\): Promise\<void\> 1588 1589发送更新小区位置请求。使用Promise异步回调。 1590 1591**系统接口：** 此接口为系统接口。 1592 1593**需要权限**：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION 1594 1595**系统能力**：SystemCapability.Telephony.CoreService 1596 1597**参数：** 1598 1599| 参数名 | 类型 | 必填 | 说明 | 1600| ------ | ------ | ---- | -------------------------------------- | 1601| slotId | number | 否 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1602 1603**返回值：** 1604 1605| 类型 | 说明 | 1606| --------------- | ----------------------- | 1607| Promise\<void\> | 以Promise形式返回结果。 | 1608 1609**错误码：** 1610 1611以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1612 1613| 错误码ID | 错误信息 | 1614| -------- | -------------------------------------------- | 1615| 201 | Permission denied. | 1616| 202 | Non-system applications use system APIs. | 1617| 401 | Parameter error. | 1618| 8300001 | Invalid parameter value. | 1619| 8300002 | Operation failed. Cannot connect to service. | 1620| 8300003 | System internal error. | 1621| 8300999 | Unknown error code. | 1622 1623**示例：** 1624 1625```ts 1626import { BusinessError } from '@ohos.base'; 1627 1628let slotId: number = 0; 1629radio.sendUpdateCellLocationRequest(slotId).then(() => { 1630 console.log(`sendUpdateCellLocationRequest success.`); 1631}).catch((err: BusinessError) => { 1632 console.log(`sendUpdateCellLocationRequest failed, promise: err->${JSON.stringify(err)}`); 1633}); 1634``` 1635 1636## radio.getCellInformation<sup>8+</sup> 1637 1638getCellInformation\(callback: AsyncCallback\<Array\<CellInformation\>\>\): void 1639 1640获取小区信息。使用callback异步回调。 1641 1642**系统接口：** 此接口为系统接口。 1643 1644**需要权限**：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION 1645 1646**系统能力**：SystemCapability.Telephony.CoreService 1647 1648**参数：** 1649 1650| 参数名 | 类型 | 必填 | 说明 | 1651| -------- | ------------------------------------------------------------ | ---- | ------------------------ | 1652| callback | AsyncCallback\<Array<[CellInformation](#cellinformation8)\>\> | 是 | 回调函数。 | 1653 1654**错误码：** 1655 1656以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1657 1658| 错误码ID | 错误信息 | 1659| -------- | -------------------------------------------- | 1660| 201 | Permission denied. | 1661| 202 | Non-system applications use system APIs. | 1662| 401 | Parameter error. | 1663| 8300001 | Invalid parameter value. | 1664| 8300002 | Operation failed. Cannot connect to service. | 1665| 8300003 | System internal error. | 1666| 8300999 | Unknown error code. | 1667 1668**示例：** 1669 1670```ts 1671import { BusinessError } from '@ohos.base'; 1672 1673radio.getCellInformation((err: BusinessError, data: Array<radio.CellInformation>) => { 1674 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1675}); 1676``` 1677 1678 1679## radio.getCellInformation<sup>8+</sup> 1680 1681getCellInformation\(slotId: number, callback: AsyncCallback\<Array\<CellInformation\>\>\): void 1682 1683获取小区信息。使用callback异步回调。 1684 1685**系统接口：** 此接口为系统接口。 1686 1687**需要权限**：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION 1688 1689**系统能力**：SystemCapability.Telephony.CoreService 1690 1691**参数：** 1692 1693| 参数名 | 类型 | 必填 | 说明 | 1694| -------- | ------------------------------------------------------------ | ---- | -------------------------------------- | 1695| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1696| callback | AsyncCallback\<Array<[CellInformation](#cellinformation8)\>\> | 是 | 回调函数。 | 1697 1698**错误码：** 1699 1700以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1701 1702| 错误码ID | 错误信息 | 1703| -------- | -------------------------------------------- | 1704| 201 | Permission denied. | 1705| 202 | Non-system applications use system APIs. | 1706| 401 | Parameter error. | 1707| 8300001 | Invalid parameter value. | 1708| 8300002 | Operation failed. Cannot connect to service. | 1709| 8300003 | System internal error. | 1710| 8300999 | Unknown error code. | 1711 1712**示例：** 1713 1714```ts 1715import { BusinessError } from '@ohos.base'; 1716 1717let slotId: number = 0; 1718radio.getCellInformation(slotId, (err: BusinessError, data: Array<radio.CellInformation>) => { 1719 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1720}); 1721``` 1722 1723 1724## radio.getCellInformation<sup>8+</sup> 1725 1726getCellInformation\(slotId?: number\): Promise\<Array\<CellInformation\>\> 1727 1728获取小区信息。使用Promise异步回调。 1729 1730**系统接口：** 此接口为系统接口。 1731 1732**需要权限**：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION 1733 1734**系统能力**：SystemCapability.Telephony.CoreService 1735 1736**参数：** 1737 1738| 参数名 | 类型 | 必填 | 说明 | 1739| ------ | ------ | ---- | -------------------------------------- | 1740| slotId | number | 否 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1741 1742**返回值：** 1743 1744| 类型 | 说明 | 1745| ------------------------------------------------------- | ----------------------- | 1746| Promise\<Array<[CellInformation](#cellinformation8)\>\> | 以Promise形式返回结果。 | 1747 1748**错误码：** 1749 1750以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1751 1752| 错误码ID | 错误信息 | 1753| -------- | -------------------------------------------- | 1754| 201 | Permission denied. | 1755| 202 | Non-system applications use system APIs. | 1756| 401 | Parameter error. | 1757| 8300001 | Invalid parameter value. | 1758| 8300002 | Operation failed. Cannot connect to service. | 1759| 8300003 | System internal error. | 1760| 8300999 | Unknown error code. | 1761 1762**示例：** 1763 1764```ts 1765import { BusinessError } from '@ohos.base'; 1766 1767let slotId: number = 0; 1768radio.getCellInformation(slotId).then((data: Array<radio.CellInformation>) => { 1769 console.log(`getCellInformation success, promise: data->${JSON.stringify(data)}`); 1770}).catch((err: BusinessError) => { 1771 console.error(`getCellInformation failed, promise: err->${JSON.stringify(err)}`); 1772}); 1773``` 1774 1775## radio.setNetworkSelectionMode 1776 1777setNetworkSelectionMode\(options: NetworkSelectionModeOptions, callback: AsyncCallback\<void\>\): void 1778 1779设置网络选择模式。使用callback异步回调。 1780 1781**系统接口：** 此接口为系统接口。 1782 1783**需要权限**：ohos.permission.SET_TELEPHONY_STATE 1784 1785**系统能力**：SystemCapability.Telephony.CoreService 1786 1787**参数：** 1788 1789| 参数名 | 类型 | 必填 | 说明 | 1790| -------- | ----------------------------------------------------------- | ---- | ------------------ | 1791| options | [NetworkSelectionModeOptions](#networkselectionmodeoptions) | 是 | 网络选择模式选项。 | 1792| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 1793 1794**错误码：** 1795 1796以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1797 1798| 错误码ID | 错误信息 | 1799| -------- | -------------------------------------------- | 1800| 201 | Permission denied. | 1801| 202 | Non-system applications use system APIs. | 1802| 401 | Parameter error. | 1803| 8300001 | Invalid parameter value. | 1804| 8300002 | Operation failed. Cannot connect to service. | 1805| 8300003 | System internal error. | 1806| 8300999 | Unknown error code. | 1807 1808**示例：** 1809 1810```ts 1811import { BusinessError } from '@ohos.base'; 1812 1813let networkInformation: radio.NetworkInformation = { 1814 operatorName: "中国移动", 1815 operatorNumeric: "898600", 1816 state: radio.NetworkInformationState.NETWORK_AVAILABLE, 1817 radioTech: "CS" 1818} 1819let networkSelectionModeOptions: radio.NetworkSelectionModeOptions = { 1820 slotId: 0, 1821 selectMode: radio.NetworkSelectionMode.NETWORK_SELECTION_AUTOMATIC, 1822 networkInformation: networkInformation, 1823 resumeSelection: true 1824} 1825radio.setNetworkSelectionMode(networkSelectionModeOptions, (err: BusinessError) => { 1826 console.log(`callback: err->${JSON.stringify(err)}`); 1827}); 1828``` 1829 1830## radio.setNetworkSelectionMode 1831 1832setNetworkSelectionMode\(options: NetworkSelectionModeOptions\): Promise\<void\> 1833 1834设置网络选择模式。使用Promise异步回调。 1835 1836**系统接口：** 此接口为系统接口。 1837 1838**需要权限**：ohos.permission.SET_TELEPHONY_STATE 1839 1840**系统能力**：SystemCapability.Telephony.CoreService 1841 1842**参数：** 1843 1844| 参数名 | 类型 | 必填 | 说明 | 1845| ------- | ----------------------------------------------------------- | ---- | ------------------ | 1846| options | [NetworkSelectionModeOptions](#networkselectionmodeoptions) | 是 | 网络选择模式选项。 | 1847 1848**返回值：** 1849 1850| 类型 | 说明 | 1851| --------------- | ----------------------- | 1852| Promise\<void\> | 以Promise形式返回结果。 | 1853 1854**错误码：** 1855 1856以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1857 1858| 错误码ID | 错误信息 | 1859| -------- | -------------------------------------------- | 1860| 201 | Permission denied. | 1861| 202 | Non-system applications use system APIs. | 1862| 401 | Parameter error. | 1863| 8300001 | Invalid parameter value. | 1864| 8300002 | Operation failed. Cannot connect to service. | 1865| 8300003 | System internal error. | 1866| 8300999 | Unknown error code. | 1867 1868**示例：** 1869 1870```ts 1871import { BusinessError } from '@ohos.base'; 1872 1873let networkInformation: radio.NetworkInformation = { 1874 operatorName: "中国移动", 1875 operatorNumeric: "898600", 1876 state: radio.NetworkInformationState.NETWORK_AVAILABLE, 1877 radioTech: "CS" 1878} 1879let networkSelectionModeOptions: radio.NetworkSelectionModeOptions = { 1880 slotId: 0, 1881 selectMode: radio.NetworkSelectionMode.NETWORK_SELECTION_AUTOMATIC, 1882 networkInformation: networkInformation, 1883 resumeSelection: true 1884} 1885radio.setNetworkSelectionMode(networkSelectionModeOptions).then(() => { 1886 console.log(`setNetworkSelectionMode success.`); 1887}).catch((err: BusinessError) => { 1888 console.log(`setNetworkSelectionMode failed, promise: err->${JSON.stringify(err)}`); 1889}); 1890``` 1891 1892## radio.getNetworkSearchInformation 1893 1894getNetworkSearchInformation\(slotId: number, callback: AsyncCallback\<NetworkSearchResult\>\): void 1895 1896获取网络搜索信息。使用callback异步回调。 1897 1898**系统接口：** 此接口为系统接口。 1899 1900**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1901 1902**系统能力**：SystemCapability.Telephony.CoreService 1903 1904**参数：** 1905 1906| 参数名 | 类型 | 必填 | 说明 | 1907| -------- | ------------------------------------------------------------ | ---- | -------------------------------------- | 1908| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1909| callback | AsyncCallback\<[NetworkSearchResult](#networksearchresult)\> | 是 | 回调函数。 | 1910 1911**错误码：** 1912 1913以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1914 1915| 错误码ID | 错误信息 | 1916| -------- | -------------------------------------------- | 1917| 201 | Permission denied. | 1918| 202 | Non-system applications use system APIs. | 1919| 401 | Parameter error. | 1920| 8300001 | Invalid parameter value. | 1921| 8300002 | Operation failed. Cannot connect to service. | 1922| 8300003 | System internal error. | 1923| 8300999 | Unknown error code. | 1924 1925**示例：** 1926 1927```ts 1928import { BusinessError } from '@ohos.base'; 1929 1930radio.getNetworkSearchInformation(0, (err: BusinessError, data: radio.NetworkSearchResult) => { 1931 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1932}); 1933``` 1934 1935## radio.getNetworkSearchInformation 1936 1937getNetworkSearchInformation\(slotId: number\): Promise\<NetworkSearchResult\> 1938 1939获取网络搜索信息。使用Promise异步回调。 1940 1941**系统接口：** 此接口为系统接口。 1942 1943**需要权限**：ohos.permission.GET_TELEPHONY_STATE 1944 1945**系统能力**：SystemCapability.Telephony.CoreService 1946 1947**参数：** 1948 1949| 参数名 | 类型 | 必填 | 说明 | 1950| ------ | ------ | ---- | -------------------------------------- | 1951| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1952 1953**返回值：** 1954 1955| 类型 | 说明 | 1956| ------------------------------------------------------ | ----------------------- | 1957| Promise\<[NetworkSearchResult](#networksearchresult)\> | 以Promise形式返回结果。 | 1958 1959**错误码：** 1960 1961以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 1962 1963| 错误码ID | 错误信息 | 1964| -------- | -------------------------------------------- | 1965| 201 | Permission denied. | 1966| 202 | Non-system applications use system APIs. | 1967| 401 | Parameter error. | 1968| 8300001 | Invalid parameter value. | 1969| 8300002 | Operation failed. Cannot connect to service. | 1970| 8300003 | System internal error. | 1971| 8300999 | Unknown error code. | 1972 1973**示例：** 1974 1975```ts 1976import { BusinessError } from '@ohos.base'; 1977 1978radio.getNetworkSearchInformation(0).then((data: radio.NetworkSearchResult) => { 1979 console.log(`getNetworkSearchInformation success, promise: data->${JSON.stringify(data)}`); 1980}).catch((err: BusinessError) => { 1981 console.log(`getNetworkSearchInformation failed, promise: err->${JSON.stringify(err)}`); 1982}); 1983``` 1984 1985## radio.getNrOptionMode<sup>(deprecated)</sup> 1986 1987getNrOptionMode\(callback: AsyncCallback\<NrOptionMode\>\): void 1988 1989获取Nr选项模式 。使用callback异步回调。 1990 1991> **说明：** 1992> 1993> 从 API version 8开始支持，从API version 10开始废弃。建议使用[getNROptionMode](#radiogetnroptionmode10)替代。 1994 1995**系统接口：** 此接口为系统接口。 1996 1997**系统能力**：SystemCapability.Telephony.CoreService 1998 1999**参数：** 2000 2001| 参数名 | 类型 | 必填 | 说明 | 2002| -------- | ----------------------------------------------- | ---- | ---------- | 2003| callback | AsyncCallback\<[NrOptionMode](#nroptionmodedeprecated)\> | 是 | 回调函数。 | 2004 2005**错误码：** 2006 2007以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2008 2009| 错误码ID | 错误信息 | 2010| -------- | -------------------------------------------- | 2011| 202 | Non-system applications use system APIs. | 2012| 401 | Parameter error. | 2013| 8300001 | Invalid parameter value. | 2014| 8300002 | Operation failed. Cannot connect to service. | 2015| 8300003 | System internal error. | 2016| 8300999 | Unknown error code. | 2017 2018**示例：** 2019 2020```ts 2021import { BusinessError } from '@ohos.base'; 2022 2023radio.getNrOptionMode((err: BusinessError, data: radio.NrOptionMode) => { 2024 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 2025}); 2026``` 2027 2028 2029## radio.getNrOptionMode<sup>(deprecated)</sup> 2030 2031getNrOptionMode\(slotId: number, callback: AsyncCallback\<NrOptionMode\>\): void 2032 2033获取Nr选项模式 。使用callback异步回调。 2034 2035> **说明：** 2036> 2037> 从 API version 8开始支持，从API version 10开始废弃。建议使用[getNROptionMode](#radiogetnroptionmode10)替代。 2038 2039**系统接口：** 此接口为系统接口。 2040 2041**系统能力**：SystemCapability.Telephony.CoreService 2042 2043**参数：** 2044 2045| 参数名 | 类型 | 必填 | 说明 | 2046| -------- | ----------------------------------------------- | ---- | ------------------------------------- | 2047| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2048| callback | AsyncCallback\<[NrOptionMode](#nroptionmodedeprecated)\> | 是 | 回调函数。 | 2049 2050**错误码：** 2051 2052以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2053 2054| 错误码ID | 错误信息 | 2055| -------- | -------------------------------------------- | 2056| 202 | Non-system applications use system APIs. | 2057| 401 | Parameter error. | 2058| 8300001 | Invalid parameter value. | 2059| 8300002 | Operation failed. Cannot connect to service. | 2060| 8300003 | System internal error. | 2061| 8300999 | Unknown error code. | 2062 2063**示例：** 2064 2065```ts 2066import { BusinessError } from '@ohos.base'; 2067 2068let slotId: number = 0; 2069radio.getNrOptionMode(slotId, (err: BusinessError, data: radio.NrOptionMode) => { 2070 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 2071}); 2072``` 2073 2074 2075## radio.getNrOptionMode<sup>(deprecated)</sup> 2076 2077getNrOptionMode\(slotId?: number\): Promise\<NrOptionMode\> 2078 2079获取Nr选项模式 。使用Promise异步回调。 2080 2081> **说明：** 2082> 2083> 从 API version 8开始支持，从API version 10开始废弃。建议使用[getNROptionMode](#radiogetnroptionmode10)替代。 2084 2085**系统接口：** 此接口为系统接口。 2086 2087**系统能力**：SystemCapability.Telephony.CoreService 2088 2089**参数：** 2090 2091| 参数名 | 类型 | 必填 | 说明 | 2092| ------ | ------ | ---- | -------------------------------------- | 2093| slotId | number | 否 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2094 2095**返回值：** 2096 2097| 类型 | 说明 | 2098| -------------------------------------------------- | ----------------------- | 2099| Promise\<[NrOptionMode](#nroptionmodedeprecated)\> | 以Promise形式返回结果。 | 2100 2101**错误码：** 2102 2103以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2104 2105| 错误码ID | 错误信息 | 2106| -------- | -------------------------------------------- | 2107| 202 | Non-system applications use system APIs. | 2108| 401 | Parameter error. | 2109| 8300001 | Invalid parameter value. | 2110| 8300002 | Operation failed. Cannot connect to service. | 2111| 8300003 | System internal error. | 2112| 8300999 | Unknown error code. | 2113 2114**示例：** 2115 2116```ts 2117import { BusinessError } from '@ohos.base'; 2118 2119let slotId: number = 0; 2120radio.getNrOptionMode(slotId).then((data: radio.NrOptionMode) => { 2121 console.log(`getNrOptionMode success, promise: data->${JSON.stringify(data)}`); 2122}).catch((err: BusinessError) => { 2123 console.error(`getNrOptionMode failed, promise: err->${JSON.stringify(err)}`); 2124}); 2125``` 2126 2127## radio.turnOnRadio<sup>7+</sup> 2128 2129turnOnRadio\(callback: AsyncCallback\<void\>\): void 2130 2131打开Radio。使用callback异步回调。 2132 2133**系统接口：** 此接口为系统接口。 2134 2135**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2136 2137**系统能力**：SystemCapability.Telephony.CoreService 2138 2139**参数：** 2140 2141| 参数名 | 类型 | 必填 | 说明 | 2142| -------- | --------------------- | ---- | ---------- | 2143| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 2144 2145**错误码：** 2146 2147以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2148 2149| 错误码ID | 错误信息 | 2150| -------- | -------------------------------------------- | 2151| 201 | Permission denied. | 2152| 202 | Non-system applications use system APIs. | 2153| 401 | Parameter error. | 2154| 8300001 | Invalid parameter value. | 2155| 8300002 | Operation failed. Cannot connect to service. | 2156| 8300003 | System internal error. | 2157| 8300999 | Unknown error code. | 2158 2159**示例：** 2160 2161```ts 2162import { BusinessError } from '@ohos.base'; 2163 2164radio.turnOnRadio((err: BusinessError) => { 2165 console.log(`callback: err->${JSON.stringify(err)}`); 2166}); 2167``` 2168 2169 2170## radio.turnOnRadio<sup>7+</sup> 2171 2172turnOnRadio\(slotId: number, callback: AsyncCallback\<void\>\): void 2173 2174打开Radio。使用callback异步回调。 2175 2176**系统接口：** 此接口为系统接口。 2177 2178**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2179 2180**系统能力**：SystemCapability.Telephony.CoreService 2181 2182**参数：** 2183 2184| 参数名 | 类型 | 必填 | 说明 | 2185| -------- | --------------------- | ---- | -------------------------------------- | 2186| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2187| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 2188 2189**错误码：** 2190 2191以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2192 2193| 错误码ID | 错误信息 | 2194| -------- | -------------------------------------------- | 2195| 201 | Permission denied. | 2196| 202 | Non-system applications use system APIs. | 2197| 401 | Parameter error. | 2198| 8300001 | Invalid parameter value. | 2199| 8300002 | Operation failed. Cannot connect to service. | 2200| 8300003 | System internal error. | 2201| 8300999 | Unknown error code. | 2202 2203**示例：** 2204 2205```ts 2206import { BusinessError } from '@ohos.base'; 2207 2208let slotId: number = 0; 2209radio.turnOnRadio(slotId, (err: BusinessError) => { 2210 console.log(`callback: err->${JSON.stringify(err)}`); 2211}); 2212``` 2213 2214 2215## radio.turnOnRadio<sup>7+</sup> 2216 2217turnOnRadio(slotId?: number): Promise\<void\> 2218 2219打开Radio。使用Promise异步回调。 2220 2221**系统接口：** 此接口为系统接口。 2222 2223**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2224 2225**系统能力**：SystemCapability.Telephony.CoreService 2226 2227**参数：** 2228 2229| 参数名 | 类型 | 必填 | 说明 | 2230| ------ | ------ | ---- | -------------------------------------- | 2231| slotId | number | 否 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2232 2233**返回值：** 2234 2235| 类型 | 说明 | 2236| --------------- | ----------------------- | 2237| Promise\<void\> | 以Promise形式返回结果。 | 2238 2239**错误码：** 2240 2241以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2242 2243| 错误码ID | 错误信息 | 2244| -------- | -------------------------------------------- | 2245| 201 | Permission denied. | 2246| 202 | Non-system applications use system APIs. | 2247| 401 | Parameter error. | 2248| 8300001 | Invalid parameter value. | 2249| 8300002 | Operation failed. Cannot connect to service. | 2250| 8300003 | System internal error. | 2251| 8300999 | Unknown error code. | 2252 2253**示例：** 2254 2255```ts 2256import { BusinessError } from '@ohos.base'; 2257 2258let slotId: number = 0; 2259radio.turnOnRadio(slotId).then(() => { 2260 console.log(`turnOnRadio success.`); 2261}).catch((err: BusinessError) => { 2262 console.error(`turnOnRadio failed, promise: err->${JSON.stringify(err)}`); 2263}); 2264``` 2265 2266## radio.turnOffRadio<sup>7+</sup> 2267 2268turnOffRadio\(callback: AsyncCallback\<void\>\): void 2269 2270关闭Radio。使用callback异步回调。 2271 2272**系统接口：** 此接口为系统接口。 2273 2274**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2275 2276**系统能力**：SystemCapability.Telephony.CoreService 2277 2278**参数：** 2279 2280| 参数名 | 类型 | 必填 | 说明 | 2281| -------- | --------------------- | ---- | ---------- | 2282| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 2283 2284**错误码：** 2285 2286以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2287 2288| 错误码ID | 错误信息 | 2289| -------- | -------------------------------------------- | 2290| 201 | Permission denied. | 2291| 202 | Non-system applications use system APIs. | 2292| 401 | Parameter error. | 2293| 8300001 | Invalid parameter value. | 2294| 8300002 | Operation failed. Cannot connect to service. | 2295| 8300003 | System internal error. | 2296| 8300999 | Unknown error code. | 2297 2298**示例：** 2299 2300```ts 2301import { BusinessError } from '@ohos.base'; 2302 2303radio.turnOffRadio((err: BusinessError) => { 2304 console.log(`callback: err->${JSON.stringify(err)}`); 2305}); 2306``` 2307 2308 2309## radio.turnOffRadio<sup>7+</sup> 2310 2311turnOffRadio\(slotId: number, callback: AsyncCallback\<void\>\): void 2312 2313关闭Radio。使用callback异步回调。 2314 2315**系统接口：** 此接口为系统接口。 2316 2317**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2318 2319**系统能力**：SystemCapability.Telephony.CoreService 2320 2321**参数：** 2322 2323| 参数名 | 类型 | 必填 | 说明 | 2324| -------- | --------------------- | ---- | -------------------------------------- | 2325| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2326| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 2327 2328**错误码：** 2329 2330以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2331 2332| 错误码ID | 错误信息 | 2333| -------- | -------------------------------------------- | 2334| 201 | Permission denied. | 2335| 202 | Non-system applications use system APIs. | 2336| 401 | Parameter error. | 2337| 8300001 | Invalid parameter value. | 2338| 8300002 | Operation failed. Cannot connect to service. | 2339| 8300003 | System internal error. | 2340| 8300999 | Unknown error code. | 2341 2342**示例：** 2343 2344```ts 2345import { BusinessError } from '@ohos.base'; 2346 2347let slotId: number = 0; 2348radio.turnOffRadio(slotId, (err: BusinessError) => { 2349 console.log(`callback: err->${JSON.stringify(err)}`); 2350}); 2351``` 2352 2353 2354## radio.turnOffRadio<sup>7+</sup> 2355 2356turnOffRadio\(slotId?: number\): Promise\<void\> 2357 2358关闭Radio。使用Promise异步回调。 2359 2360**系统接口：** 此接口为系统接口。 2361 2362**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2363 2364**系统能力**：SystemCapability.Telephony.CoreService 2365 2366**参数：** 2367 2368| 参数名 | 类型 | 必填 | 说明 | 2369| ------ | ------ | ---- | -------------------------------------- | 2370| slotId | number | 否 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2371 2372**返回值：** 2373 2374| 类型 | 说明 | 2375| --------------- | ----------------------- | 2376| Promise\<void\> | 以Promise形式返回结果。 | 2377 2378**错误码：** 2379 2380以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2381 2382| 错误码ID | 错误信息 | 2383| -------- | -------------------------------------------- | 2384| 201 | Permission denied. | 2385| 202 | Non-system applications use system APIs. | 2386| 401 | Parameter error. | 2387| 8300001 | Invalid parameter value. | 2388| 8300002 | Operation failed. Cannot connect to service. | 2389| 8300003 | System internal error. | 2390| 8300999 | Unknown error code. | 2391 2392**示例：** 2393 2394```ts 2395import { BusinessError } from '@ohos.base'; 2396 2397let slotId: number = 0; 2398radio.turnOffRadio(slotId).then(() => { 2399 console.log(`turnOffRadio success.`); 2400}).catch((err: BusinessError) => { 2401 console.error(`turnOffRadio failed, promise: err->${JSON.stringify(err)}`); 2402}); 2403``` 2404 2405## radio.setPreferredNetwork<sup>8+</sup> 2406 2407setPreferredNetwork\(slotId: number, networkMode: PreferredNetworkMode, callback: AsyncCallback\<void\>\): void 2408 2409设置首选网络。使用callback异步回调。 2410 2411**系统接口：** 此接口为系统接口。 2412 2413**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2414 2415**系统能力**：SystemCapability.Telephony.CoreService 2416 2417**参数：** 2418 2419| 参数名 | 类型 | 必填 | 说明 | 2420| ----------- | ---------------------------------------------- | ---- | -------------------------------------- | 2421| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2422| networkMode | [PreferredNetworkMode](#preferrednetworkmode8) | 是 | 设置首选网络模式。 | 2423| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 2424 2425**错误码：** 2426 2427以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2428 2429| 错误码ID | 错误信息 | 2430| -------- | -------------------------------------------- | 2431| 201 | Permission denied. | 2432| 202 | Non-system applications use system APIs. | 2433| 401 | Parameter error. | 2434| 8300001 | Invalid parameter value. | 2435| 8300002 | Operation failed. Cannot connect to service. | 2436| 8300003 | System internal error. | 2437| 8300999 | Unknown error code. | 2438 2439**示例：** 2440 2441```ts 2442import { BusinessError } from '@ohos.base'; 2443 2444let slotId: number = 0; 2445let mode: radio.PreferredNetworkMode = radio.PreferredNetworkMode.PREFERRED_NETWORK_MODE_GSM; 2446radio.setPreferredNetwork(slotId, mode, (err: BusinessError) => { 2447 console.log(`callback: err->${JSON.stringify(err)}`); 2448}); 2449``` 2450 2451## radio.setPreferredNetwork<sup>8+</sup> 2452 2453setPreferredNetwork\(slotId: number, networkMode: PreferredNetworkMode\): Promise\<void\> 2454 2455设置首选网络。使用Promise异步回调。 2456 2457**系统接口：** 此接口为系统接口。 2458 2459**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2460 2461**系统能力**：SystemCapability.Telephony.CoreService 2462 2463**参数：** 2464 2465| 参数名 | 类型 | 必填 | 说明 | 2466| ----------- | ---------------------------------------------- | ---- | -------------------------------------- | 2467| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2468| networkMode | [PreferredNetworkMode](#preferrednetworkmode8) | 是 | 设置首选网络模式。 | 2469 2470**返回值：** 2471 2472| 类型 | 说明 | 2473| --------------- | ----------------------- | 2474| Promise\<void\> | 以Promise形式返回结果。 | 2475 2476**错误码：** 2477 2478以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2479 2480| 错误码ID | 错误信息 | 2481| -------- | -------------------------------------------- | 2482| 201 | Permission denied. | 2483| 202 | Non-system applications use system APIs. | 2484| 401 | Parameter error. | 2485| 8300001 | Invalid parameter value. | 2486| 8300002 | Operation failed. Cannot connect to service. | 2487| 8300003 | System internal error. | 2488| 8300999 | Unknown error code. | 2489 2490**示例：** 2491 2492```ts 2493import { BusinessError } from '@ohos.base'; 2494 2495let slotId: number = 0; 2496let mode: radio.PreferredNetworkMode = radio.PreferredNetworkMode.PREFERRED_NETWORK_MODE_GSM; 2497radio.setPreferredNetwork(slotId, mode).then(() => { 2498 console.log(`setPreferredNetwork success.`); 2499}).catch((err: BusinessError) => { 2500 console.log(`setPreferredNetwork failed, promise: err->${JSON.stringify(err)}`); 2501}); 2502``` 2503 2504## radio.getPreferredNetwork<sup>8+</sup> 2505 2506getPreferredNetwork\(slotId: number, callback: AsyncCallback\<PreferredNetworkMode\>\): void 2507 2508获取首选网络。使用callback异步回调。 2509 2510**系统接口：** 此接口为系统接口。 2511 2512**需要权限**：ohos.permission.GET_TELEPHONY_STATE 2513 2514**系统能力**：SystemCapability.Telephony.CoreService 2515 2516**参数：** 2517 2518| 参数名 | 类型 | 必填 | 说明 | 2519| -------- | --------------------------------------------------------------- | ---- | -------------------------------------- | 2520| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2521| callback | AsyncCallback\<[PreferredNetworkMode](#preferrednetworkmode8)\> | 是 | 回调函数。 | 2522 2523**错误码：** 2524 2525以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2526 2527| 错误码ID | 错误信息 | 2528| -------- | -------------------------------------------- | 2529| 201 | Permission denied. | 2530| 202 | Non-system applications use system APIs. | 2531| 401 | Parameter error. | 2532| 8300001 | Invalid parameter value. | 2533| 8300002 | Operation failed. Cannot connect to service. | 2534| 8300003 | System internal error. | 2535| 8300999 | Unknown error code. | 2536 2537**示例：** 2538 2539```ts 2540import { BusinessError } from '@ohos.base'; 2541 2542let slotId: number = 0; 2543radio.getPreferredNetwork(slotId, (err: BusinessError, data: radio.PreferredNetworkMode) => { 2544 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 2545}); 2546``` 2547 2548## radio.getPreferredNetwork<sup>8+</sup> 2549 2550getPreferredNetwork\(slotId: number\): Promise\<PreferredNetworkMode\> 2551 2552获取首选网络。使用Promise异步回调。 2553 2554**系统接口：** 此接口为系统接口。 2555 2556**需要权限**：ohos.permission.GET_TELEPHONY_STATE 2557 2558**系统能力**：SystemCapability.Telephony.CoreService 2559 2560**参数：** 2561 2562| 参数名 | 类型 | 必填 | 说明 | 2563| ------ | ------ | ---- | -------------------------------------- | 2564| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2565 2566**返回值：** 2567 2568| 类型 | 说明 | 2569| --------------- | ----------------------- | 2570| Promise\<[PreferredNetworkMode](#preferrednetworkmode8)\> | 以Promise形式返回结果。 | 2571 2572**错误码：** 2573 2574以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2575 2576| 错误码ID | 错误信息 | 2577| -------- | -------------------------------------------- | 2578| 201 | Permission denied. | 2579| 202 | Non-system applications use system APIs. | 2580| 401 | Parameter error. | 2581| 8300001 | Invalid parameter value. | 2582| 8300002 | Operation failed. Cannot connect to service. | 2583| 8300003 | System internal error. | 2584| 8300999 | Unknown error code. | 2585 2586**示例：** 2587 2588```ts 2589import { BusinessError } from '@ohos.base'; 2590 2591let slotId: number = 0; 2592radio.getPreferredNetwork(slotId).then((data: radio.PreferredNetworkMode) => { 2593 console.log(`getPreferredNetwork success, promise: data->${JSON.stringify(data)}`); 2594}).catch((err: BusinessError) => { 2595 console.log(`getPreferredNetwork failed, promise: err->${JSON.stringify(err)}`); 2596}); 2597``` 2598 2599## radio.getImsRegInfo<sup>9+</sup> 2600 2601getImsRegInfo\(slotId: number, imsType: ImsServiceType, callback: AsyncCallback\<ImsRegInfo\>\): void 2602 2603获取特定IMS服务类型的IMS注册状态信息。使用callback异步回调。 2604 2605**系统接口：** 此接口为系统接口。 2606 2607**需要权限**：ohos.permission.GET_TELEPHONY_STATE 2608 2609**系统能力**：SystemCapability.Telephony.CoreService 2610 2611**参数：** 2612 2613| 参数名 | 类型 | 必填 | 说明 | 2614| -------- | ------------------------------------------ | ---- | -------------------------------------- | 2615| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2616| imsType | [ImsServiceType](#imsservicetype9) | 是 | IMS服务类型。 | 2617| callback | AsyncCallback<[ImsRegInfo](#imsreginfo9)\> | 是 | 回调函数。 | 2618 2619**错误码：** 2620 2621以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2622 2623| 错误码ID | 错误信息 | 2624| -------- | -------------------------------------------- | 2625| 201 | Permission denied. | 2626| 202 | Non-system applications use system APIs. | 2627| 401 | Parameter error. | 2628| 8300001 | Invalid parameter value. | 2629| 8300002 | Operation failed. Cannot connect to service. | 2630| 8300003 | System internal error. | 2631| 8300999 | Unknown error code. | 2632 2633**示例：** 2634 2635```ts 2636import { BusinessError } from '@ohos.base'; 2637 2638let slotId: number = 0; 2639let mode: radio.ImsServiceType = radio.ImsServiceType.TYPE_VIDEO; 2640radio.getImsRegInfo(slotId, mode, (err: BusinessError, data: radio.ImsRegInfo) => { 2641 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 2642}); 2643``` 2644 2645## radio.getImsRegInfo<sup>9+</sup> 2646 2647getImsRegInfo\(slotId: number, imsType: ImsServiceType\): Promise\<ImsRegInfo\> 2648 2649获取特定IMS服务类型的IMS注册状态信息。使用Promise异步回调。 2650 2651**系统接口：** 此接口为系统接口。 2652 2653**需要权限**：ohos.permission.GET_TELEPHONY_STATE 2654 2655**系统能力**：SystemCapability.Telephony.CoreService 2656 2657**参数：** 2658 2659| 参数名 | 类型 | 必填 | 说明 | 2660| ------- | ---------------------------------- | ---- | -------------------------------------- | 2661| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2662| imsType | [ImsServiceType](#imsservicetype9) | 是 | IMS服务类型。 | 2663 2664**返回值：** 2665 2666| 类型 | 说明 | 2667| ------------------------------------- | ----------------------- | 2668| Promise\<[ImsRegInfo](#imsreginfo9)\> | 以Promise形式返回结果。 | 2669 2670**错误码：** 2671 2672以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2673 2674| 错误码ID | 错误信息 | 2675| -------- | -------------------------------------------- | 2676| 201 | Permission denied. | 2677| 202 | Non-system applications use system APIs. | 2678| 401 | Parameter error. | 2679| 8300001 | Invalid parameter value. | 2680| 8300002 | Operation failed. Cannot connect to service. | 2681| 8300003 | System internal error. | 2682| 8300999 | Unknown error code. | 2683 2684**示例：** 2685 2686```ts 2687import { BusinessError } from '@ohos.base'; 2688 2689let slotId: number = 0; 2690let mode: radio.ImsServiceType = radio.ImsServiceType.TYPE_VIDEO; 2691radio.getImsRegInfo(slotId, mode).then((data: radio.ImsRegInfo) => { 2692 console.log(`getImsRegInfo success, promise: data->${JSON.stringify(data)}`); 2693}).catch((err: BusinessError) => { 2694 console.log(`getImsRegInfo failed, promise: err->${JSON.stringify(err)}`); 2695}); 2696``` 2697 2698## radio.on('imsRegStateChange')<sup>9+</sup> 2699 2700on\(type: 'imsRegStateChange', slotId: number, imsType: ImsServiceType, callback: Callback\<ImsRegInfo\>\): void 2701 2702订阅imsRegStateChange事件，使用callback异步回调。 2703 2704**系统接口：** 此接口为系统接口。 2705 2706**需要权限**：ohos.permission.GET_TELEPHONY_STATE 2707 2708**系统能力**：SystemCapability.Telephony.CoreService 2709 2710**参数：** 2711 2712| 参数名 | 类型 | 必填 | 说明 | 2713| -------- | ------------------------------------ | ---- | -------------------------------------- | 2714| type | string | 是 | 监听IMS注册状态的变化。 | 2715| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2716| imsType | [ImsServiceType](#imsservicetype9) | 是 | IMS服务类型。 | 2717| callback | Callback<[ImsRegInfo](#imsreginfo9)> | 是 | 回调函数。 | 2718 2719**错误码：** 2720 2721以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2722 2723| 错误码ID | 错误信息 | 2724| -------- | -------------------------------------------- | 2725| 201 | Permission denied. | 2726| 202 | Non-system applications use system APIs. | 2727| 401 | Parameter error. | 2728| 8300001 | Invalid parameter value. | 2729| 8300002 | Operation failed. Cannot connect to service. | 2730| 8300003 | System internal error. | 2731| 8300999 | Unknown error code. | 2732 2733**示例：** 2734 2735```ts 2736import { BusinessError } from '@ohos.base'; 2737 2738let slotId: number = 0; 2739let mode: radio.ImsServiceType = radio.ImsServiceType.TYPE_VIDEO; 2740radio.on('imsRegStateChange', slotId, mode, (data: radio.ImsRegInfo) => { 2741 console.log(`callback: data->${JSON.stringify(data)}`); 2742}); 2743``` 2744 2745## radio.off('imsRegStateChange')<sup>9+</sup> 2746 2747off\(type: 'imsRegStateChange', slotId: number, imsType: ImsServiceType, callback?: Callback\<ImsRegInfo\>\): void 2748 2749取消订阅imsRegStateChange事件，使用callback异步回调。 2750 2751**系统接口：** 此接口为系统接口。 2752 2753**需要权限**：ohos.permission.GET_TELEPHONY_STATE 2754 2755**系统能力**：SystemCapability.Telephony.CoreService 2756 2757**参数：** 2758 2759| 参数名 | 类型 | 必填 | 说明 | 2760| -------- | ------------------------------------ | ---- | -------------------------------------- | 2761| type | string | 是 | 取消监听IMS注册状态的变化。 | 2762| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2763| imsType | [ImsServiceType](#imsservicetype9) | 是 | IMS服务类型。 | 2764| callback | Callback<[ImsRegInfo](#imsreginfo9)> | 否 | 回调函数。不填该参数不影响取消订阅。 | 2765 2766**错误码：** 2767 2768以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2769 2770| 错误码ID | 错误信息 | 2771| -------- | -------------------------------------------- | 2772| 201 | Permission denied. | 2773| 202 | Non-system applications use system APIs. | 2774| 401 | Parameter error. | 2775| 8300001 | Invalid parameter value. | 2776| 8300002 | Operation failed. Cannot connect to service. | 2777| 8300003 | System internal error. | 2778| 8300999 | Unknown error code. | 2779 2780**示例：** 2781 2782```ts 2783import { BusinessError } from '@ohos.base'; 2784 2785let slotId: number = 0; 2786let mode: radio.ImsServiceType = radio.ImsServiceType.TYPE_VIDEO; 2787radio.off('imsRegStateChange', slotId, mode, (data: radio.ImsRegInfo) => { 2788 console.log(`callback: data->${JSON.stringify(data)}`); 2789}); 2790``` 2791 2792 2793## radio.getBasebandVersion<sup>10+</sup> 2794 2795getBasebandVersion\(slotId: number, callback: AsyncCallback\<string\>\): void 2796 2797获取设备的基带版本号。使用callback异步回调。 2798 2799**系统接口：** 此接口为系统接口。 2800 2801**需要权限**：ohos.permission.GET_TELEPHONY_STATE 2802 2803**系统能力**：SystemCapability.Telephony.CoreService 2804 2805**参数：** 2806 2807| 参数名 | 类型 | 必填 | 说明 | 2808| -------- | ----------------------- | ---- | ------------------------------------- | 2809| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2810| callback | AsyncCallback\<string\> | 是 | 回调函数。获取的基带版本号。 | 2811 2812**错误码：** 2813 2814以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2815 2816| 错误码ID | 错误信息 | 2817| -------- | -------------------------------------------- | 2818| 201 | Permission denied. | 2819| 202 | Non-system applications use system APIs. | 2820| 401 | Parameter error. | 2821| 8300001 | Invalid parameter value. | 2822| 8300002 | Operation failed. Cannot connect to service. | 2823| 8300003 | System internal error. | 2824| 8300999 | Unknown error code. | 2825 2826**示例：** 2827 2828```ts 2829import { BusinessError } from '@ohos.base'; 2830 2831let slotId: number = 0; 2832radio.getBasebandVersion(slotId, (err: BusinessError, data: string) => { 2833 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 2834}); 2835``` 2836 2837 2838## radio.getBasebandVersion<sup>10+</sup> 2839 2840getBasebandVersion\(slotId: number\): Promise\<string\> 2841 2842获取设备的基带版本号。使用Promise异步回调。 2843 2844**系统接口：** 此接口为系统接口。 2845 2846**需要权限**：ohos.permission.GET_TELEPHONY_STATE 2847 2848**系统能力**：SystemCapability.Telephony.CoreService 2849 2850**参数：** 2851 2852| 参数名 | 类型 | 必填 | 说明 | 2853| -------- | ----------------------- | ---- | ------------------------------------- | 2854| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2855 2856**返回值：** 2857 2858| 类型 | 说明 | 2859| ----------------- | -------------------------------------- | 2860| Promise\<string\> | 以Promise形式返回设备的基带版本号。 | 2861 2862**错误码：** 2863 2864以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2865 2866| 错误码ID | 错误信息 | 2867| -------- | -------------------------------------------- | 2868| 201 | Permission denied. | 2869| 202 | Non-system applications use system APIs. | 2870| 401 | Parameter error. | 2871| 8300001 | Invalid parameter value. | 2872| 8300002 | Operation failed. Cannot connect to service. | 2873| 8300003 | System internal error. | 2874| 8300999 | Unknown error code. | 2875 2876**示例：** 2877 2878```ts 2879import { BusinessError } from '@ohos.base'; 2880 2881let slotId: number = 0; 2882radio.getBasebandVersion(slotId).then((data: string) => { 2883 console.log(`getBasebandVersion success, promise: data->${JSON.stringify(data)}`); 2884}).catch((err: BusinessError) => { 2885 console.error(`getBasebandVersion failed, promise: err->${JSON.stringify(err)}`); 2886}); 2887``` 2888 2889 2890## radio.setNROptionMode<sup>10+</sup> 2891 2892setNROptionMode\(slotId: number, mode: NROptionMode, callback: AsyncCallback\<void\>\): void 2893 2894设置Nr选项模式 。使用callback异步回调。 2895 2896**系统接口：** 此接口为系统接口。 2897 2898**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2899 2900**系统能力**：SystemCapability.Telephony.CoreService 2901 2902**参数：** 2903 2904| 参数名 | 类型 | 必填 | 说明 | 2905| -------- | ------------------------------------------------ | ---- | -------------------------------------- | 2906| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2907| mode | [NROptionMode](#nroptionmode10) | 是 | NR的选择模式。 | 2908| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 2909 2910**错误码：** 2911 2912以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2913 2914| 错误码ID | 错误信息 | 2915| -------- | -------------------------------------------- | 2916| 201 | Permission denied. | 2917| 202 | Non-system applications use system APIs. | 2918| 401 | Parameter error. | 2919| 8300001 | Invalid parameter value. | 2920| 8300002 | Operation failed. Cannot connect to service. | 2921| 8300003 | System internal error. | 2922| 8300999 | Unknown error code. | 2923 2924**示例：** 2925 2926```ts 2927import { BusinessError } from '@ohos.base'; 2928 2929let slotId: number = 0; 2930let mode: radio.NROptionMode = radio.NROptionMode.NR_OPTION_NSA_ONLY; 2931radio.setNROptionMode(slotId, mode, (err: BusinessError) => { 2932 console.log(`callback: err->${JSON.stringify(err)}`); 2933}); 2934``` 2935 2936 2937## radio.setNROptionMode<sup>10+</sup> 2938 2939setNROptionMode\(slotId: number, mode: NROptionMode\): Promise\<void\> 2940 2941设置Nr选项模式 。使用Promise异步回调。 2942 2943**系统接口：** 此接口为系统接口。 2944 2945**需要权限**：ohos.permission.SET_TELEPHONY_STATE 2946 2947**系统能力**：SystemCapability.Telephony.CoreService 2948 2949**参数：** 2950 2951| 参数名 | 类型 | 必填 | 说明 | 2952| ------ | ------------------------------- | ---- | ------------------------------------- | 2953| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 2954| mode | [NROptionMode](#nroptionmode10) | 是 | NR的选择模式。 | 2955 2956**返回值：** 2957 2958| 类型 | 说明 | 2959| ----------------- | ----------------------- | 2960| Promise\<void\> | 以Promise形式返回结果。 | 2961 2962**错误码：** 2963 2964以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 2965 2966| 错误码ID | 错误信息 | 2967| -------- | -------------------------------------------- | 2968| 201 | Permission denied. | 2969| 202 | Non-system applications use system APIs. | 2970| 401 | Parameter error. | 2971| 8300001 | Invalid parameter value. | 2972| 8300002 | Operation failed. Cannot connect to service. | 2973| 8300003 | System internal error. | 2974| 8300999 | Unknown error code. | 2975 2976**示例：** 2977 2978```ts 2979import { BusinessError } from '@ohos.base'; 2980 2981let slotId: number = 0; 2982let mode: radio.NROptionMode = radio.NROptionMode.NR_OPTION_NSA_ONLY; 2983radio.setNROptionMode(slotId, mode).then(() => { 2984 console.log(`setNROptionMode success`); 2985}).catch((err: BusinessError) => { 2986 console.error(`setNROptionMode failed, promise: err->${JSON.stringify(err)}`); 2987}); 2988``` 2989 2990 2991## radio.getNROptionMode<sup>10+</sup> 2992 2993getNROptionMode\(slotId: number, callback: AsyncCallback\<NROptionMode\>\): void 2994 2995获取Nr选项模式 。使用callback异步回调。 2996 2997**系统接口：** 此接口为系统接口。 2998 2999**系统能力**：SystemCapability.Telephony.CoreService 3000 3001**参数：** 3002 3003| 参数名 | 类型 | 必填 | 说明 | 3004| -------- | ------------------------------------------------ | ---- | -------------------------------------- | 3005| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3006| callback | AsyncCallback\<[NROptionMode](#nroptionmode10)\> | 是 | 回调函数。 | 3007 3008**错误码：** 3009 3010以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 3011 3012| 错误码ID | 错误信息 | 3013| -------- | -------------------------------------------- | 3014| 202 | Non-system applications use system APIs. | 3015| 401 | Parameter error. | 3016| 8300001 | Invalid parameter value. | 3017| 8300002 | Operation failed. Cannot connect to service. | 3018| 8300003 | System internal error. | 3019| 8300999 | Unknown error code. | 3020 3021**示例：** 3022 3023```ts 3024import { BusinessError } from '@ohos.base'; 3025 3026let slotId: number = 0; 3027radio.getNROptionMode(slotId, (err: BusinessError, data: radio.NROptionMode) => { 3028 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 3029}); 3030``` 3031 3032## radio.getNROptionMode<sup>10+</sup> 3033 3034getNROptionMode\(slotId: number\): Promise\<NROptionMode\> 3035 3036获取Nr选项模式 。使用Promise异步回调。 3037 3038**系统接口：** 此接口为系统接口。 3039 3040**系统能力**：SystemCapability.Telephony.CoreService 3041 3042**参数：** 3043 3044| 参数名 | 类型 | 必填 | 说明 | 3045| ------ | ------ | ---- | ------------------------------------- | 3046| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3047 3048**返回值：** 3049 3050| 类型 | 说明 | 3051| ----------------------------------------- | ----------------------- | 3052| Promise\<[NROptionMode](#nroptionmode10)\> | 以Promise形式返回结果。 | 3053 3054**错误码：** 3055 3056以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 3057 3058| 错误码ID | 错误信息 | 3059| -------- | -------------------------------------------- | 3060| 202 | Non-system applications use system APIs. | 3061| 401 | Parameter error. | 3062| 8300001 | Invalid parameter value. | 3063| 8300002 | Operation failed. Cannot connect to service. | 3064| 8300003 | System internal error. | 3065| 8300999 | Unknown error code. | 3066 3067**示例：** 3068 3069```ts 3070import { BusinessError } from '@ohos.base'; 3071 3072let slotId: number = 0; 3073radio.getNROptionMode(slotId).then((data: radio.NROptionMode) => { 3074 console.log(`getNROptionMode success, promise: data->${JSON.stringify(data)}`); 3075}).catch((err: BusinessError) => { 3076 console.error(`getNROptionMode failed, promise: err->${JSON.stringify(err)}`); 3077}); 3078``` 3079 3080 3081## radio.getNetworkCapability<sup>10+</sup> 3082 3083getNetworkCapability\(slotId: number, type: NetworkCapabilityType, callback: AsyncCallback\<NetworkCapabilityState\>\): void 3084 3085获取指定网络类型的开关状态。使用callback异步回调。 3086 3087**系统接口：** 此接口为系统接口。 3088 3089**需要权限**：ohos.permission.GET_TELEPHONY_STATE 3090 3091**系统能力**：SystemCapability.Telephony.CoreService 3092 3093**参数：** 3094 3095| 参数名 | 类型 | 必填 | 说明 | 3096| -------- | -----------------------------------------------------------------------| ---- | ----------------------------------- | 3097| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3098| type | [NetworkCapabilityType](#networkcapabilitytype10) | 是 | 网络能力类型。 | 3099| callback | AsyncCallback\<[NetworkCapabilityState](#networkcapabilitystate10)\> | 是 | 回调函数。 | 3100 3101**错误码：** 3102 3103以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 3104 3105| 错误码ID | 错误信息 | 3106| -------- | -------------------------------------------- | 3107| 201 | Permission denied. | 3108| 202 | Non-system applications use system APIs. | 3109| 401 | Parameter error. | 3110| 8300001 | Invalid parameter value. | 3111| 8300002 | Operation failed. Cannot connect to service. | 3112| 8300003 | System internal error. | 3113| 8300999 | Unknown error code. | 3114 3115**示例：** 3116 3117```ts 3118import { BusinessError } from '@ohos.base'; 3119 3120let slotId: number = 0; 3121let type: radio.NetworkCapabilityType = radio.NetworkCapabilityType.SERVICE_TYPE_NR; 3122radio.getNetworkCapability(slotId, type, (err: BusinessError, data: radio.NetworkCapabilityState) => { 3123 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 3124}); 3125``` 3126 3127 3128## radio.getNetworkCapability<sup>10+</sup> 3129 3130getNetworkCapability\(slotId: number, type: NetworkCapabilityType\): Promise\<NetworkCapabilityState\> 3131 3132获取指定网络类型的开关状态。使用Promise异步回调。 3133 3134**系统接口：** 此接口为系统接口。 3135 3136**需要权限**：ohos.permission.GET_TELEPHONY_STATE 3137 3138**系统能力**：SystemCapability.Telephony.CoreService 3139 3140**参数：** 3141 3142| 参数名 | 类型 | 必填 | 说明 | 3143| -------- | --------------------------------------------------------------- | ---- | -------------------------------------- | 3144| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3145| type | [NetworkCapabilityType](#networkcapabilitytype10) | 是 | 网络能力类型。 | 3146 3147**返回值：** 3148 3149| 类型 | 说明 | 3150| ------------------------------------------------------------- | ----------------------- | 3151| Promise\<[NetworkCapabilityState](#networkcapabilitystate10)\> | 以Promise形式返回结果。 | 3152 3153**错误码：** 3154 3155以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 3156 3157| 错误码ID | 错误信息 | 3158| -------- | -------------------------------------------- | 3159| 201 | Permission denied. | 3160| 202 | Non-system applications use system APIs. | 3161| 401 | Parameter error. | 3162| 8300001 | Invalid parameter value. | 3163| 8300002 | Operation failed. Cannot connect to service. | 3164| 8300003 | System internal error. | 3165| 8300999 | Unknown error code. | 3166 3167**示例：** 3168 3169```ts 3170import { BusinessError } from '@ohos.base'; 3171 3172let slotId: number = 0; 3173let type: radio.NetworkCapabilityType = radio.NetworkCapabilityType.SERVICE_TYPE_NR; 3174radio.getNetworkCapability(slotId, type).then((data: radio.NetworkCapabilityState) => { 3175 console.log(`getNetworkCapability success, promise: data->${JSON.stringify(data)}`); 3176}).catch((err: BusinessError) => { 3177 console.log(`getNetworkCapability failed, promise: err->${JSON.stringify(err)}`); 3178}); 3179``` 3180 3181 3182## radio.setNetworkCapability<sup>10+</sup> 3183 3184setNetworkCapability\(slotId: number, type: NetworkCapabilityType, state: NetworkCapabilityState, 3185 callback: AsyncCallback\<void\>\): void 3186 3187设置指定网络类型的开关状态。使用callback异步回调。 3188 3189**系统接口：** 此接口为系统接口。 3190 3191**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3192 3193**系统能力**：SystemCapability.Telephony.CoreService 3194 3195**参数：** 3196 3197| 参数名 | 类型 | 必填 | 说明 | 3198| -------- | --------------------------------------------------------------- | ---- | -------------------------------------- | 3199| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3200| type | [NetworkCapabilityType](#networkcapabilitytype10) | 是 | 网络能力类型。 | 3201| state | [NetworkCapabilityState](#networkcapabilitystate10) | 是 | 网络能力状态。 | 3202| callback | AsyncCallback\<void\> | 是 | 回调函数。 | 3203 3204**错误码：** 3205 3206以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 3207 3208| 错误码ID | 错误信息 | 3209| -------- | -------------------------------------------- | 3210| 201 | Permission denied. | 3211| 202 | Non-system applications use system APIs. | 3212| 401 | Parameter error. | 3213| 8300001 | Invalid parameter value. | 3214| 8300002 | Operation failed. Cannot connect to service. | 3215| 8300003 | System internal error. | 3216| 8300999 | Unknown error code. | 3217 3218**示例：** 3219 3220```ts 3221import { BusinessError } from '@ohos.base'; 3222 3223let slotId: number = 0; 3224let type: radio.NetworkCapabilityType = radio.NetworkCapabilityType.SERVICE_TYPE_NR; 3225let state: radio.NetworkCapabilityState = radio.NetworkCapabilityState.SERVICE_CAPABILITY_ON; 3226radio.setNetworkCapability(slotId, type, state, (err: BusinessError) => { 3227 console.log(`callback: err->${JSON.stringify(err)}`); 3228}); 3229``` 3230 3231 3232## radio.setNetworkCapability<sup>10+</sup> 3233 3234setNetworkCapability\(slotId: number, type: NetworkCapabilityType, state: NetworkCapabilityState\): Promise\<void\> 3235 3236设置指定网络类型的开关状态。使用Promise异步回调。 3237 3238**系统接口：** 此接口为系统接口。 3239 3240**需要权限**：ohos.permission.SET_TELEPHONY_STATE 3241 3242**系统能力**：SystemCapability.Telephony.CoreService 3243 3244**参数：** 3245 3246| 参数名 | 类型 | 必填 | 说明 | 3247| -------- | --------------------------------------------------------------- | ---- | -------------------------------------- | 3248| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3249| type | [NetworkCapabilityType](#networkcapabilitytype10) | 是 | 网络能力类型。 | 3250| state | [NetworkCapabilityState](#networkcapabilitystate10) | 是 | 网络能力状态。 | 3251 3252**返回值：** 3253 3254| 类型 | 说明 | 3255| --------------- | ----------------------- | 3256| Promise\<void\> | 以Promise形式返回结果。 | 3257 3258**错误码：** 3259 3260以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)。 3261 3262| 错误码ID | 错误信息 | 3263| -------- | -------------------------------------------- | 3264| 201 | Permission denied. | 3265| 202 | Non-system applications use system APIs. | 3266| 401 | Parameter error. | 3267| 8300001 | Invalid parameter value. | 3268| 8300002 | Operation failed. Cannot connect to service. | 3269| 8300003 | System internal error. | 3270| 8300999 | Unknown error code. | 3271 3272**示例：** 3273 3274```ts 3275import { BusinessError } from '@ohos.base'; 3276 3277let slotId: number = 0; 3278let type: radio.NetworkCapabilityType = radio.NetworkCapabilityType.SERVICE_TYPE_NR; 3279let state: radio.NetworkCapabilityState = radio.NetworkCapabilityState.SERVICE_CAPABILITY_ON; 3280radio.setNetworkCapability(slotId, type, state).then(() => { 3281 console.log(`setNetworkCapability success`); 3282}).catch((err: BusinessError) => { 3283 console.log(`setNetworkCapability failed, promise: err->${JSON.stringify(err)}`); 3284}); 3285``` 3286 3287 3288## RadioTechnology 3289 3290无线接入技术。 3291 3292**系统能力**：SystemCapability.Telephony.CoreService 3293 3294| 名称 | 值 | 说明 | 3295| ------------------------- | ---- | ------------------------------------------------------------ | 3296| RADIO_TECHNOLOGY_UNKNOWN | 0 | 未知无线接入技术（RAT）。 | 3297| RADIO_TECHNOLOGY_GSM | 1 | 无线接入技术GSM（Global System For Mobile Communication）。 | 3298| RADIO_TECHNOLOGY_1XRTT | 2 | 无线接入技术1XRTT（Single-Carrier Radio Transmission Technology）。 | 3299| RADIO_TECHNOLOGY_WCDMA | 3 | 无线接入技术WCDMA（Wideband Code Division Multiple Access）。 | 3300| RADIO_TECHNOLOGY_HSPA | 4 | 无线接入技术HSPA（High Speed Packet Access）。 | 3301| RADIO_TECHNOLOGY_HSPAP | 5 | 无线接入技术HSPAP（High Speed packet access (HSPA+) ）。 | 3302| RADIO_TECHNOLOGY_TD_SCDMA | 6 | 无线接入技术TDSCDMA（TimeDivision-Synchronous Code Division Multiple Access）。 | 3303| RADIO_TECHNOLOGY_EVDO | 7 | 无线接入技术EVDO（Evolution Data Only）。 | 3304| RADIO_TECHNOLOGY_EHRPD | 8 | 无线接入技术EHRPD（Evolved High Rate Package Data）。 | 3305| RADIO_TECHNOLOGY_LTE | 9 | 无线接入技术LTE（Long Term Evolution）。 | 3306| RADIO_TECHNOLOGY_LTE_CA | 10 | 无线接入技术LTE_CA（Long Term Evolution_Carrier Aggregation）。 | 3307| RADIO_TECHNOLOGY_IWLAN | 11 | 无线接入技术IWLAN（Industrial Wireless LAN）。 | 3308| RADIO_TECHNOLOGY_NR | 12 | 无线接入技术NR（New Radio）。 | 3309 3310 3311## SignalInformation 3312 3313网络信号强度信息对象。 3314 3315**系统能力**：SystemCapability.Telephony.CoreService 3316 3317| 名称 | 类型 | 必填 | 说明 | 3318| --------------- | --------------------------- | ---- | ------------------ | 3319| signalType | [NetworkType](#networktype) | 是 | 网络信号强度类型。 | 3320| signalLevel | number | 是 | 网络信号强度等级。 | 3321| dBm<sup>9+</sup>| number | 是 | 网络信号强度。 | 3322 3323## NetworkType 3324 3325网络类型。 3326 3327**系统能力**：SystemCapability.Telephony.CoreService 3328 3329| 名称 | 值 | 说明 | 3330| -------------------- | ---- | ------------------------------------------------------------ | 3331| NETWORK_TYPE_UNKNOWN | 0 | 未知网络类型。 | 3332| NETWORK_TYPE_GSM | 1 | 网络类型为GSM（Global System For Mobile Communication）。 | 3333| NETWORK_TYPE_CDMA | 2 | 网络类型为CDMA（Code Division Multiple Access）。 | 3334| NETWORK_TYPE_WCDMA | 3 | 网络类型为WCDMA（Wideband Code Division Multiple Access）。 | 3335| NETWORK_TYPE_TDSCDMA | 4 | 网络类型为TDSCDMA（TimeDivision-Synchronous Code Division Multiple Access）。 | 3336| NETWORK_TYPE_LTE | 5 | 网络类型为LTE（Long Term Evolution）。 | 3337| NETWORK_TYPE_NR | 6 | 网络类型为5G NR（New Radio）。 | 3338 3339## NetworkState 3340 3341网络注册状态。 3342 3343**系统能力**：SystemCapability.Telephony.CoreService 3344 3345| 名称 | 类型 | 必填 | 说明 | 3346| -------------------- | ----------------------------------- | ---- | ------------------------------------------------------------ | 3347| longOperatorName | string | 是 | 注册网络的长运营商名称。 | 3348| shortOperatorName | string | 是 | 注册网络的短运营商名称。 | 3349| plmnNumeric | string | 是 | 注册网络的PLMN码。 | 3350| isRoaming | boolean | 是 | 是否处于漫游状态。 | 3351| regState | [RegState](#regstate) | 是 | 设备的网络注册状态。 | 3352| cfgTech<sup>8+</sup> | [RadioTechnology](#radiotechnology) | 是 | 设备的无线接入技术。 | 3353| nsaState | [NsaState](#nsastate) | 是 | 设备的NSA网络注册状态。 | 3354| isCaActive | boolean | 是 | CA的状态。 | 3355| isEmergency | boolean | 是 | 此设备是否只允许拨打紧急呼叫。 | 3356 3357 3358## RegState 3359 3360网络注册状态。 3361 3362**系统能力**：SystemCapability.Telephony.CoreService 3363 3364| 名称 | 值 | 说明 | 3365| ----------------------------- | ---- | -------------------------- | 3366| REG_STATE_NO_SERVICE | 0 | 设备不能使用任何服务，包括数据业务、短信、通话等。 | 3367| REG_STATE_IN_SERVICE | 1 | 设备可以正常使用服务，包括数据业务、短信、通话等。 | 3368| REG_STATE_EMERGENCY_CALL_ONLY | 2 | 设备只能使用紧急呼叫业务。 | 3369| REG_STATE_POWER_OFF | 3 | 蜂窝无线电已关闭，modem下电，无法和网侧进行通信。 | 3370 3371 3372## NsaState 3373 3374非独立组网状态。 3375 3376**系统能力**：SystemCapability.Telephony.CoreService 3377 3378| 名称 | 值 | 说明 | 3379| -------------------------- | ---- | ---------------------------------------------------------- | 3380| NSA_STATE_NOT_SUPPORT | 1 | 设备在不支持NSA的LTE小区下处于空闲状态或连接状态。 | 3381| NSA_STATE_NO_DETECT | 2 | 在支持NSA但不支持NR覆盖检测的LTE小区下，设备处于空闲状态。 | 3382| NSA_STATE_CONNECTED_DETECT | 3 | 设备在LTE小区下连接到LTE网络支持NSA和NR覆盖检测。 | 3383| NSA_STATE_IDLE_DETECT | 4 | 支持NSA和NR覆盖检测的LTE小区下设备处于空闲状态。 | 3384| NSA_STATE_DUAL_CONNECTED | 5 | 设备在支持NSA的LTE小区下连接到LTE + NR网络。 | 3385| NSA_STATE_SA_ATTACHED | 6 | 设备在5GC附着时在NG-RAN小区下空闲或连接到NG-RAN小区。 | 3386 3387 3388## NetworkSelectionMode 3389 3390选网模式。 3391 3392**系统能力**：SystemCapability.Telephony.CoreService 3393 3394| 名称 | 值 | 说明 | 3395| --------------------------- | ---- | -------------- | 3396| NETWORK_SELECTION_UNKNOWN | 0 | 未知选网模式。 | 3397| NETWORK_SELECTION_AUTOMATIC | 1 | 自动选网模式。 | 3398| NETWORK_SELECTION_MANUAL | 2 | 手动选网模式。 | 3399 3400## PreferredNetworkMode<sup>8+</sup> 3401 3402首选网络模式。 3403 3404**系统接口：** 此接口为系统接口。 3405 3406**系统能力**：SystemCapability.Telephony.CoreService 3407 3408| 名称 | 值 | 说明 | 3409| --------------------------------------------------------- | ---- | --------------------------------------------- | 3410| PREFERRED_NETWORK_MODE_GSM | 1 | 首选GSM网络模式。 | 3411| PREFERRED_NETWORK_MODE_WCDMA | 2 | 首选WCDMA网络模式。 | 3412| PREFERRED_NETWORK_MODE_LTE | 3 | 首选LTE网络模式。 | 3413| PREFERRED_NETWORK_MODE_LTE_WCDMA | 4 | 首选LTE WCDMA网络模式。 | 3414| PREFERRED_NETWORK_MODE_LTE_WCDMA_GSM | 5 | 首选LTE WCDMA GSM网络模式。 | 3415| PREFERRED_NETWORK_MODE_WCDMA_GSM | 6 | 首选WCDMA GSM网络模式。 | 3416| PREFERRED_NETWORK_MODE_CDMA | 7 | 首选CDMA网络模式。 | 3417| PREFERRED_NETWORK_MODE_EVDO | 8 | 首选EVDO网络模式。 | 3418| PREFERRED_NETWORK_MODE_EVDO_CDMA | 9 | 首选EVDO CDMA网络模式。 | 3419| PREFERRED_NETWORK_MODE_WCDMA_GSM_EVDO_CDMA | 10 | 首选WCDMA GSM EVDO CDMA网络模式。 | 3420| PREFERRED_NETWORK_MODE_LTE_EVDO_CDMA | 11 | 首选LTE EVDO CDMA网络模式。 | 3421| PREFERRED_NETWORK_MODE_LTE_WCDMA_GSM_EVDO_CDMA | 12 | 首选LTE WCDMA GSM EVDO CDMA网络模式。 | 3422| PREFERRED_NETWORK_MODE_TDSCDMA | 13 | 首选TDSCDMA网络模式。 | 3423| PREFERRED_NETWORK_MODE_TDSCDMA_GSM | 14 | 首选TDSCDMA GSM网络模式。 | 3424| PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA | 15 | 首选TDSCDMA_WCDMA网络模式。 | 3425| PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA_GSM | 16 | 首选TDSCDMA_WCDMA_GSM网络模式。 | 3426| PREFERRED_NETWORK_MODE_LTE_TDSCDMA | 17 | 首选LTE TDSCDMA网络模式。 | 3427| PREFERRED_NETWORK_MODE_LTE_TDSCDMA_GSM | 18 | 首选LTE TDSCDMA GSM网络模式。 | 3428| PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA | 19 | 首选LTE TDSCDMA WCDMA网络模式。 | 3429| PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA_GSM | 20 | 首选LTE TDSCDMA WCDMA GSM网络模式。 | 3430| PREFERRED_NETWORK_MODE_TDSCDMA_WCDMA_GSM_EVDO_CDMA | 21 | 首选TDSCDMA WCDMA GSM EVDO CDMA网络模式。 | 3431| PREFERRED_NETWORK_MODE_LTE_TDSCDMA_WCDMA_GSM_EVDO_CDMA | 22 | 首选LTE TDSCDMA WCDMA GSM EVDO CDMA网络模式。 | 3432| PREFERRED_NETWORK_MODE_NR | 31 | 首选NR网络模式。 | 3433| PREFERRED_NETWORK_MODE_NR_LTE | 32 | 首选NR LTE网络模式。 | 3434| PREFERRED_NETWORK_MODE_NR_LTE_WCDMA | 33 | 首选NR LTE WCDMA网络模式。 | 3435| PREFERRED_NETWORK_MODE_NR_LTE_WCDMA_GSM | 34 | 首选NR LTE WCDMA GSM网络模式。 | 3436| PREFERRED_NETWORK_MODE_NR_LTE_EVDO_CDMA | 35 | 首选NR LTE EVDO CDMA网络模式。 | 3437| PREFERRED_NETWORK_MODE_NR_LTE_WCDMA_GSM_EVDO_CDMA | 36 | 首选NR LTE WCDMA GSM EVDO CDMA网络模式。 | 3438| PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA | 37 | 首选NR LTE TDSCDMA网络模式。 | 3439| PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_GSM | 38 | 首选NR LTE TDSCDMA GSM网络模式。 | 3440| PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA | 39 | 首选NR LTE TDSCDMA WCDMA网络模式。 | 3441| PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA_GSM | 40 | 首选NR LTE TDSCDMA WCDMA GSM网络模式。 | 3442| PREFERRED_NETWORK_MODE_NR_LTE_TDSCDMA_WCDMA_GSM_EVDO_CDMA | 41 | 首选NR LTE TDSCDMA WCDMA GSM网络模式。 | 3443| PREFERRED_NETWORK_MODE_MAX_VALUE | 99 | 首选网络模式最大值。 | 3444 3445## CellInformation<sup>8+</sup> 3446 3447小区信息。 3448 3449**系统能力**：SystemCapability.Telephony.CoreService 3450 3451| 名称 | 类型 | 必填 | 说明 | 3452| ----------------- | --------------------------------------- | ---- | ------------------------------------------------------------ | 3453| networkType | [NetworkType](#networktype) | 是 | 获取服务单元的网络类型。 | 3454| isCamped | boolean | 是 | 获取服务单元的状态。<br>**系统接口：** 此接口为系统接口。 | 3455| timeStamp | number | 是 | 获取单元格信息时获取时间戳。<br>**系统接口：** 此接口为系统接口。 | 3456| signalInformation | [SignalInformation](#signalinformation) | 是 | 信号信息。 | 3457| data | [CdmaCellInformation](#cdmacellinformation8) \| [GsmCellInformation](#gsmcellinformation8) \| [LteCellInformation](#ltecellinformation8) \| [NrCellInformation](#nrcellinformation8) \| [TdscdmaCellInformation](#tdscdmacellinformation8) | 是 | Cdma小区信息 \|Gsm小区信息\|Lte小区信息\|Nr小区信息\|Tdscdma小区信息 <br>**系统接口：** 此接口为系统接口。| 3458 3459## CdmaCellInformation<sup>8+</sup> 3460 3461CDMA小区信息。 3462 3463**系统接口：** 此接口为系统接口。 3464 3465**系统能力**：SystemCapability.Telephony.CoreService 3466 3467| 名称 | 类型 | 必填 | 说明 | 3468| --------- | ------ | ---- | ------------ | 3469| baseId | number | 是 | 基站Id。 | 3470| latitude | number | 是 | 经度。 | 3471| longitude | number | 是 | 纬度。 | 3472| nid | number | 是 | 网络识别码。 | 3473| sid | number | 是 | 系统识别码。 | 3474 3475## GsmCellInformation<sup>8+</sup> 3476 3477GSM小区信息。 3478 3479**系统接口：** 此接口为系统接口。 3480 3481**系统能力**：SystemCapability.Telephony.CoreService 3482 3483| 名称 | 类型 | 必填 | 说明 | 3484| ------ | ------ | ---- | -------------------- | 3485| lac | number | 是 | 位置区编号。 | 3486| cellId | number | 是 | 小区号。 | 3487| arfcn | number | 是 | 绝对无线频率信道号。 | 3488| bsic | number | 是 | 基站识别号。 | 3489| mcc | string | 是 | 移动国家码。 | 3490| mnc | string | 是 | 移动网号。 | 3491 3492## LteCellInformation<sup>8+</sup> 3493 3494LTE小区信息。 3495 3496**系统接口：** 此接口为系统接口。 3497 3498**系统能力**：SystemCapability.Telephony.CoreService 3499 3500| 名称 | 类型 | 必填 | 说明 | 3501| ------------- | ------- | ---- | ----------------------- | 3502| cgi | number | 是 | 小区全球标识。 | 3503| pci | number | 是 | 物理小区识别。 | 3504| tac | number | 是 | 跟踪区域代码。 | 3505| earfcn | number | 是 | 绝对无线频率信道号。 | 3506| bandwidth | number | 是 | 带宽。 | 3507| mcc | string | 是 | 移动国家码。 | 3508| mnc | string | 是 | 移动网号。 | 3509| isSupportEndc | boolean | 是 | 是否支持新无线电_双连接 | 3510 3511## NrCellInformation<sup>8+</sup> 3512 3513NR小区信息。 3514 3515**系统接口：** 此接口为系统接口。 3516 3517**系统能力**：SystemCapability.Telephony.CoreService 3518 3519| 名称 | 类型 | 必填 | 说明 | 3520| ------- | ------ | ---- | ---------------- | 3521| nrArfcn | number | 是 | 5G频点号。 | 3522| pci | number | 是 | 物理小区识别。 | 3523| tac | number | 是 | 跟踪区域代码。 | 3524| nci | number | 是 | 5G网络小区标识。 | 3525| mcc | string | 是 | 移动国家码。 | 3526| mnc | string | 是 | 移动网号。 | 3527 3528## TdscdmaCellInformation<sup>8+</sup> 3529 3530TD-SCDMA小区信息。 3531 3532**系统接口：** 此接口为系统接口。 3533 3534**系统能力**：SystemCapability.Telephony.CoreService 3535 3536| 名称 | 类型 | 必填 | 说明 | 3537| ------ | ------ | ---- | ------------ | 3538| lac | number | 是 | 位置区编号。 | 3539| cellId | number | 是 | 小区号。 | 3540| cpid | number | 是 | 小区参数Id。 | 3541| uarfcn | number | 是 | 绝对射频号。 | 3542| mcc | string | 是 | 移动国家码。 | 3543| mnc | string | 是 | 移动网号。 | 3544 3545## WcdmaCellInformation<sup>8+</sup> 3546 3547WCDMA小区信息。 3548 3549**系统接口：** 此接口为系统接口。 3550 3551**系统能力**：SystemCapability.Telephony.CoreService 3552 3553| 名称 | 类型 | 必填 | 说明 | 3554| ------ | ------ | ---- | ------------ | 3555| lac | number | 是 | 位置区编号。 | 3556| cellId | number | 是 | 小区号。 | 3557| psc | number | 是 | 主扰码。 | 3558| uarfcn | number | 是 | 绝对射频号。 | 3559| mcc | string | 是 | 移动国家码。 | 3560| mnc | string | 是 | 移动网号。 | 3561 3562## NrOptionMode<sup>(deprecated)</sup> 3563 3564NR的选择模式。 3565 3566> **说明：** 3567> 3568> 从 API version 8开始支持，从API version 10开始废弃。建议使用[NROptionMode](#nroptionmode10)替代。 3569 3570**系统接口：** 此接口为系统接口。 3571 3572**系统能力**：SystemCapability.Telephony.CoreService 3573 3574| 名称 | 值 | 说明 | 3575| -------------------- | ---- | ---------------------------------- | 3576| NR_OPTION_UNKNOWN | 0 | 未知的NR选择模式。 | 3577| NR_OPTION_NSA_ONLY | 1 | 仅非独立组网的NR选择模式。 | 3578| NR_OPTION_SA_ONLY | 2 | 仅独立组网的NR选择模式。 | 3579| NR_OPTION_NSA_AND_SA | 3 | 非独立组网和独立组网的NR选择模式。 | 3580 3581## NROptionMode<sup>10+</sup> 3582 3583NR的选择模式。 3584 3585**系统接口：** 此接口为系统接口。 3586 3587**系统能力**：SystemCapability.Telephony.CoreService 3588 3589| 名称 | 值 | 说明 | 3590| -------------------- | ---- | --------------------------------- | 3591| NR_OPTION_UNKNOWN | 0 | 未知的NR选择模式。 | 3592| NR_OPTION_NSA_ONLY | 1 | 仅非独立组网的NR选择模式。 | 3593| NR_OPTION_SA_ONLY | 2 | 仅独立组网的NR选择模式。 | 3594| NR_OPTION_NSA_AND_SA | 3 | 非独立组网和独立组网的NR选择模式。 | 3595 3596## NetworkSearchResult 3597 3598网络搜索结果。 3599 3600**系统接口：** 此接口为系统接口。 3601 3602**系统能力**：SystemCapability.Telephony.CoreService 3603 3604| 名称 | 类型 | 必填 | 说明 | 3605| ---------------------- | ------------------------------------------------- | ---- | -------------- | 3606| isNetworkSearchSuccess | boolean | 是 | 网络搜索成功。 | 3607| networkSearchResult | Array<[NetworkInformation](#networkinformation)\> | 是 | 网络搜索结果。 | 3608 3609## NetworkInformation 3610 3611网络信息。 3612 3613**系统接口：** 此接口为系统接口。 3614 3615**系统能力**：SystemCapability.Telephony.CoreService 3616 3617| 名称 | 类型 | 必填 | 说明 | 3618| --------------- | --------------------------------------------------- | ---- | -------------- | 3619| operatorName | string | 是 | 运营商的名称。 | 3620| operatorNumeric | string | 是 | 运营商数字。 | 3621| state | [NetworkInformationState](#networkinformationstate) | 是 | 网络信息状态。 | 3622| radioTech | string | 是 | 无线电技术。 | 3623 3624## NetworkInformationState 3625 3626网络信息状态。 3627 3628**系统接口：** 此接口为系统接口。 3629 3630**系统能力**：SystemCapability.Telephony.CoreService 3631 3632| 名称 | 值 | 说明 | 3633| ----------------- | ---- | ---------------- | 3634| NETWORK_UNKNOWN | 0 | 网络状态未知。 | 3635| NETWORK_AVAILABLE | 1 | 网络可用于注册。 | 3636| NETWORK_CURRENT | 2 | 已在网络中注册。 | 3637| NETWORK_FORBIDDEN | 3 | 网络无法注册。 | 3638 3639## NetworkSelectionModeOptions 3640 3641网络选择模式选项。 3642 3643**系统接口：** 此接口为系统接口。 3644 3645**系统能力**：SystemCapability.Telephony.CoreService 3646 3647| 名称 | 类型 | 必填 | 说明 | 3648| ------------------ | --------------------------------------------- | ---- | -------------------------------------- | 3649| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 3650| selectMode | [NetworkSelectionMode](#networkselectionmode) | 是 | 网络选择模式。 | 3651| networkInformation | [NetworkInformation](#networkinformation) | 是 | 网络信息。 | 3652| resumeSelection | boolean | 是 | 继续选择。 | 3653 3654## ImsRegState<sup>9+</sup> 3655 3656IMS注册状态。 3657 3658**系统接口：** 此接口为系统接口。 3659 3660**系统能力**：SystemCapability.Telephony.CoreService 3661 3662| 名称 | 值 | 说明 | 3663| ---------------- | ---- | -------- | 3664| IMS_UNREGISTERED | 0 | 未注册。 | 3665| IMS_REGISTERED | 1 | 已注册。 | 3666 3667## ImsRegTech<sup>9+</sup> 3668 3669IMS注册技术。 3670 3671**系统接口：** 此接口为系统接口。 3672 3673**系统能力**：SystemCapability.Telephony.CoreService 3674 3675| 名称 | 值 | 说明 | 3676| ----------------------- | ---- | --------------- | 3677| REGISTRATION_TECH_NONE | 0 | 无注册技术。 | 3678| REGISTRATION_TECH_LTE | 1 | LTE注册技术。 | 3679| REGISTRATION_TECH_IWLAN | 2 | IWLAN注册技术。 | 3680| REGISTRATION_TECH_NR | 3 | NR注册技术。 | 3681 3682## ImsRegInfo<sup>9+</sup> 3683 3684IMS注册信息。 3685 3686**系统接口：** 此接口为系统接口。 3687 3688**系统能力**：SystemCapability.Telephony.CoreService 3689 3690| 名称 | 类型 | 必填 | 说明 | 3691| ----------- | ---------------------------- | ---- | ------------- | 3692| imsRegState | [ImsRegState](#imsregstate9) | 是 | IMS注册状态。 | 3693| imsRegTech | [ImsRegTech](#imsregtech9) | 是 | IMS注册技术。 | 3694 3695## ImsServiceType<sup>9+</sup> 3696 3697IMS服务类型。 3698 3699**系统接口：** 此接口为系统接口。 3700 3701**系统能力**：SystemCapability.Telephony.CoreService 3702 3703| 名称 | 值 | 说明 | 3704| ---------- | ---- | ---------- | 3705| TYPE_VOICE | 0 | 语音服务。 | 3706| TYPE_VIDEO | 1 | 视频服务。 | 3707| TYPE_UT | 2 | UT服务。 | 3708| TYPE_SMS | 3 | 短讯服务。 | 3709 3710## NetworkCapabilityType<sup>10+</sup> 3711 3712网络能力类型。 3713 3714**系统接口：** 此接口为系统接口。 3715 3716**系统能力**：SystemCapability.Telephony.CoreService 3717 3718| 名称 | 值 | 说明 | 3719| -----------------| ---- | ---------- | 3720| SERVICE_TYPE_LTE | 0 | LTE服务类型。 | 3721| SERVICE_TYPE_NR | 1 | NR服务类型。 | 3722 3723## NetworkCapabilityState<sup>10+</sup> 3724 3725网络能力开关状态。 3726 3727**系统接口：** 此接口为系统接口。 3728 3729**系统能力**：SystemCapability.Telephony.CoreService 3730 3731| 名称 | 值 | 说明 | 3732| -----------------------| ---- | ---------- | 3733| SERVICE_CAPABILITY_OFF | 0 | 网络能力关闭。 | 3734| SERVICE_CAPABILITY_ON | 1 | 网络能力打开。 |