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