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