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