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