1# @ohos.telephony.sms (短信服务) 2 3短信服务提供了管理短信的一些基础能力，包括创建、发送短信，获取、设置发送短信的默认SIM卡槽ID，获取、设置短信服务中心（SMSC）地址，以及检查当前设备是否具备短信发送和接收能力等。 4 5>**说明：** 6> 7>本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8 9## 导入模块 10 11```js 12import sms from '@ohos.telephony.sms'; 13``` 14 15## sms.createMessage 16 17createMessage\(pdu: Array<number>, specification: string, callback: AsyncCallback<ShortMessage\>\): void 18 19根据协议数据单元（PDU）和指定的短信协议创建短信实例。使用callback异步回调。 20 21**系统能力**：SystemCapability.Telephony.SmsMms 22 23**参数：** 24 25| 参数名 | 类型 | 必填 | 说明 | 26| ------------- | -------------------------------------------------- | ---- | ------------------------------------------------------------ | 27| pdu | Array<number> | 是 | 协议数据单元，从收到的信息中获取。 | 28| specification | string | 是 | 短信协议类型。<br/>- 3gpp：表示GSM/UMTS/LTE SMS<br/>- 3gpp2：表示CDMA SMS | 29| callback | AsyncCallback<[ShortMessage](#shortmessage)> | 是 | 回调函数。 | 30 31**示例：** 32 33```js 34const specification = '3gpp'; 35// 以数组的形式显示协议数据单元（PDU），类型为number，例如[0x08, 0x91, ...] 36const pdu = [0x08, 0x91]; 37sms.createMessage(pdu, specification, (err, data) => { 38 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 39}); 40``` 41 42 43## sms.createMessage 44 45createMessage\(pdu: Array<number>, specification: string\): Promise<ShortMessage\> 46 47根据协议数据单元（PDU）和指定的短信协议创建短信实例。使用Promise异步回调。 48 49**系统能力**：SystemCapability.Telephony.SmsMms 50 51**参数：** 52 53| 参数名 | 类型 | 必填 | 说明 | 54| ------------- | ------------------- | ---- | ------------------------------------------------------------ | 55| pdu | Array<number> | 是 | 协议数据单元，从收到的信息中获取。 | 56| specification | string | 是 | 短信协议类型。<br/>- 3gpp：表示GSM/UMTS/LTE SMS<br/>- 3gpp2：表示CDMA SMS | 57 58**返回值：** 59 60| 类型 | 说明 | 61| -------------------------------------------- | --------------------------------- | 62| Promise<[ShortMessage](#shortmessage)> | 以Promise形式返回创建的短信实例。 | 63 64**示例：** 65 66```js 67const specification = '3gpp'; 68// 以数组的形式显示协议数据单元（PDU），类型为number，例如[0x08, 0x91, ...] 69const pdu = [0x08, 0x91]; 70let promise = sms.createMessage(pdu, specification); 71promise.then(data => { 72 console.log(`createMessage success, promise: data->${JSON.stringify(data)}`); 73}).catch(err => { 74 console.error(`createMessage failed, promise: err->${JSON.stringify(err)}`); 75}); 76``` 77 78## sms.sendMessage 79 80sendMessage(options: SendMessageOptions): void 81 82发送短信。 83 84**需要权限**：ohos.permission.SEND_MESSAGES 85 86**系统能力**：SystemCapability.Telephony.SmsMms 87 88**参数：** 89 90| 参数名 | 类型 | 必填 | 说明 | 91| ------- | ----------------------------------------- | ---- | ------------------------------------------------------------ | 92| options | [SendMessageOptions](#sendmessageoptions) | 是 | 发送短信的参数和回调，参考[SendMessageOptions](#sendmessageoptions)。 | 93 94**错误码：** 95 96以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 97 98| 错误码ID | 错误信息 | 99| -------- | -------------------------------------------- | 100| 201 | Permission denied. | 101| 401 | Parameter error. | 102| 8300001 | Invalid parameter value. | 103| 8300002 | Operation failed. Cannot connect to service. | 104| 8300003 | System internal error. | 105| 8300999 | Unknown error code. | 106 107**示例：** 108 109```js 110let sendCallback = function (err, data) { 111 console.log(`sendCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 112} 113let deliveryCallback = function (err, data) { 114 console.log(`deliveryCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 115} 116let slotId = 0; 117let content = '短信内容'; 118let destinationHost = '+861xxxxxxxxxx'; 119let serviceCenter = '+861xxxxxxxxxx'; 120let destinationPort = 1000; 121let options = {slotId, content, destinationHost, serviceCenter, destinationPort, sendCallback, deliveryCallback}; 122sms.sendMessage(options); 123``` 124 125 126## sms.getDefaultSmsSlotId<sup>7+</sup> 127 128getDefaultSmsSlotId\(callback: AsyncCallback<number>\): void 129 130获取发送短信的默认SIM卡槽ID。使用callback异步回调。 131 132**系统能力**：SystemCapability.Telephony.SmsMms 133 134**参数：** 135 136| 参数名 | 类型 | 必填 | 说明 | 137| -------- | --------------------------- | ---- | ---------------------------------------- | 138| callback | AsyncCallback<number> | 是 | 回调函数。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 139 140**示例：** 141 142```js 143sms.getDefaultSmsSlotId((err, data) => { 144 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 145}); 146``` 147 148 149## sms.getDefaultSmsSlotId<sup>7+</sup> 150 151getDefaultSmsSlotId\(\): Promise<number> 152 153获取发送短信的默认SIM卡槽ID。使用Promise异步回调。 154 155**系统能力**：SystemCapability.Telephony.SmsMms 156 157**返回值：** 158 159| 类型 | 说明 | 160| --------------- | ------------------------------------------------------------ | 161| Promise<number> | 以Promise形式返回发送短信的默认SIM卡：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 162 163**示例：** 164 165```js 166let promise = sms.getDefaultSmsSlotId(); 167promise.then(data => { 168 console.log(`getDefaultSmsSlotId success, promise: data->${JSON.stringify(data)}`); 169}).catch(err => { 170 console.error(`getDefaultSmsSlotId failed, promise: err->${JSON.stringify(err)}`); 171}); 172``` 173 174## sms.setDefaultSmsSlotId<sup>7+</sup> 175 176setDefaultSmsSlotId\(slotId: number, callback: AsyncCallback<void>\): void 177 178设置发送短信的默认SIM卡槽ID。使用callback异步回调。 179 180**系统接口：** 此接口为系统接口。 181 182**需要权限**：ohos.permission.SET_TELEPHONY_STATE 183 184**系统能力**：SystemCapability.Telephony.SmsMms 185 186**参数：** 187 188| 参数名 | 类型 | 必填 | 说明 | 189| -------- | ------------------------- | ---- | ------------------------------------------------------------ | 190| slotId | number | 是 | SIM卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2<br/>- -1：清除默认配置 | 191| callback | AsyncCallback<void> | 是 | 回调函数。 | 192 193**错误码：** 194 195以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 196 197| 错误码ID | 错误信息 | 198| -------- | -------------------------------------------- | 199| 201 | Permission denied. | 200| 401 | Parameter error. | 201| 8300001 | Invalid parameter value. | 202| 8300002 | Operation failed. Cannot connect to service. | 203| 8300003 | System internal error. | 204| 8300004 | Do not have sim card. | 205| 8300999 | Unknown error code. | 206 207**示例：** 208 209```js 210sms.setDefaultSmsSlotId(0, (err) => { 211 console.log(`callback: err->${JSON.stringify(err)}.`); 212}); 213``` 214 215 216## sms.setDefaultSmsSlotId<sup>7+</sup> 217 218setDefaultSmsSlotId\(slotId: number\): Promise<void> 219 220设置发送短信的默认SIM卡槽ID。使用Promise异步回调。 221 222**系统接口：** 此接口为系统接口。 223 224**需要权限**：ohos.permission.SET_TELEPHONY_STATE 225 226**系统能力**：SystemCapability.Telephony.SmsMms 227 228**参数：** 229 230| 参数名 | 类型 | 必填 | 说明 | 231| ------ | ------ | ---- | ------------------------------------------------------------ | 232| slotId | number | 是 | SIM卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2<br/>- -1：清除默认配置 | 233 234**返回值：** 235 236| 类型 | 说明 | 237| --------------- | ------------------------------- | 238| Promise\<void\> | 以Promise形式异步返回设置结果。 | 239 240**错误码：** 241 242以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 243 244| 错误码ID | 错误信息 | 245| -------- | -------------------------------------------- | 246| 201 | Permission denied. | 247| 401 | Parameter error. | 248| 8300001 | Invalid parameter value. | 249| 8300002 | Operation failed. Cannot connect to service. | 250| 8300003 | System internal error. | 251| 8300004 | Do not have sim card. | 252| 8300999 | Unknown error code. | 253 254**示例：** 255 256```js 257let promise = sms.setDefaultSmsSlotId(0); 258promise.then(() => { 259 console.log(`setDefaultSmsSlotId success.`); 260}).catch((err) => { 261 console.error(`setDefaultSmsSlotId failed, promise: err->${JSON.stringify(err)}`); 262}); 263``` 264 265## sms.setSmscAddr<sup>7+</sup> 266 267setSmscAddr\(slotId: number, smscAddr: string, callback: AsyncCallback<void\>\): void 268 269设置短信服务中心（SMSC）地址。使用callback异步回调。 270 271**系统接口：** 此接口为系统接口。 272 273**需要权限**：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限 274 275**系统能力**：SystemCapability.Telephony.SmsMms 276 277**参数：** 278 279| 参数名 | 类型 | 必填 | 说明 | 280| -------- | ------------------------- | ---- | ----------------------------------------- | 281| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 282| smscAddr | string | 是 | 短信服务中心地址。 | 283| callback | AsyncCallback<void> | 是 | 回调函数。 | 284 285**错误码：** 286 287以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 288 289| 错误码ID | 错误信息 | 290| -------- | -------------------------------------------- | 291| 201 | Permission denied. | 292| 401 | Parameter error. | 293| 8300001 | Invalid parameter value. | 294| 8300002 | Operation failed. Cannot connect to service. | 295| 8300003 | System internal error. | 296| 8300999 | Unknown error code. | 297 298**示例：** 299 300```js 301let slotId = 0; 302let smscAddr = '+861xxxxxxxxxx'; 303sms.setSmscAddr(slotId, smscAddr, (err) => { 304 console.log(`callback: err->${JSON.stringify(err)}`); 305}); 306``` 307 308 309## sms.setSmscAddr<sup>7+</sup> 310 311setSmscAddr\(slotId: number, smscAddr: string\): Promise\<void\> 312 313设置短信服务中心（SMSC）地址。使用Promise异步回调。 314 315**系统接口：** 此接口为系统接口。 316 317**需要权限**：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限 318 319**系统能力**：SystemCapability.Telephony.SmsMms 320 321**参数：** 322 323| 参数名 | 类型 | 必填 | 说明 | 324| -------- | ------ | ---- | ----------------------------------------- | 325| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 326| smscAddr | string | 是 | 短信服务中心地址。 | 327 328**返回值：** 329 330| 类型 | 说明 | 331| ------------------- | ------------------------------- | 332| Promise<void> | 以Promise形式异步返回设置结果。 | 333 334**错误码：** 335 336以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 337 338| 错误码ID | 错误信息 | 339| -------- | -------------------------------------------- | 340| 201 | Permission denied. | 341| 401 | Parameter error. | 342| 8300001 | Invalid parameter value. | 343| 8300002 | Operation failed. Cannot connect to service. | 344| 8300003 | System internal error. | 345| 8300999 | Unknown error code. | 346 347**示例：** 348 349```js 350let slotId = 0; 351let smscAddr = '+861xxxxxxxxxx'; 352let promise = sms.setSmscAddr(slotId, smscAddr); 353promise.then(() => { 354 console.log(`setSmscAddr success.`); 355}).catch((err) => { 356 console.error(`setSmscAddr failed, promise: err->${JSON.stringify(err)}`); 357}); 358``` 359 360 361## sms.getSmscAddr<sup>7+</sup> 362 363getSmscAddr\(slotId: number, callback: AsyncCallback<string\>\): void 364 365获取短信服务中心（SMSC）地址。使用callback异步回调。 366 367**系统接口：** 此接口为系统接口。 368 369**需要权限**：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限 370 371**系统能力**：SystemCapability.Telephony.SmsMms 372 373**参数：** 374 375| 参数名 | 类型 | 必填 | 说明 | 376| -------- | --------------------------- | ---- | ----------------------------------------- | 377| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 378| callback | AsyncCallback<string> | 是 | 回调函数。 | 379 380**错误码：** 381 382以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 383 384| 错误码ID | 错误信息 | 385| -------- | -------------------------------------------- | 386| 201 | Permission denied. | 387| 401 | Parameter error. | 388| 8300001 | Invalid parameter value. | 389| 8300002 | Operation failed. Cannot connect to service. | 390| 8300003 | System internal error. | 391| 8300999 | Unknown error code. | 392 393**示例：** 394 395```js 396let slotId = 0; 397sms.getSmscAddr(slotId, (err, data) => { 398 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 399}); 400``` 401 402 403## sms.getSmscAddr<sup>7+</sup> 404 405getSmscAddr\(slotId: number\): Promise<string\> 406 407获取短信服务中心（SMSC）地址。使用Promise异步回调。 408 409**系统接口：** 此接口为系统接口。 410 411**需要权限**：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限 412 413**系统能力**：SystemCapability.Telephony.SmsMms 414 415**参数：** 416 417| 参数名 | 类型 | 必填 | 说明 | 418| ------ | ------ | ---- | ----------------------------------------- | 419| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 420 421**返回值：** 422 423| 类型 | 说明 | 424| --------------------- | --------------------------------------------- | 425| Promise<string> | 以Promise形式返回获取短信服务中心地址的结果。 | 426 427**错误码：** 428 429以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 430 431| 错误码ID | 错误信息 | 432| -------- | -------------------------------------------- | 433| 201 | Permission denied. | 434| 401 | Parameter error. | 435| 8300001 | Invalid parameter value. | 436| 8300002 | Operation failed. Cannot connect to service. | 437| 8300003 | System internal error. | 438| 8300999 | Unknown error code. | 439 440**示例：** 441 442```js 443let slotId = 0; 444let promise = sms.getSmscAddr(slotId); 445promise.then(data => { 446 console.log(`getSmscAddr success, promise: data->${JSON.stringify(data)}`); 447}).catch(err => { 448 console.error(`getSmscAddr failed, promise: err->${JSON.stringify(err)}`); 449}); 450``` 451 452## sms.hasSmsCapability<sup>7+</sup> 453 454hasSmsCapability(): boolean 455 456检查当前设备是否具备短信发送和接收能力，该方法是同步方法。 457 458**系统能力**：SystemCapability.Telephony.SmsMms 459 460**返回值：** 461 462| 类型 | 说明 | 463| ------- | ------------------------------------------------------------ | 464| boolean | - true：设备具备短信发送和接收能力。<br/>- false：设备不具备短信发送和接收能力。 | 465 466```js 467let result = sms.hasSmsCapability(); 468console.log(`hasSmsCapability: ${JSON.stringify(result)}`); 469``` 470 471## sms.splitMessage<sup>8+</sup> 472 473splitMessage(content: string, callback: AsyncCallback<Array<string\>>): void 474 475将长短信拆分为多个片段。使用callback异步回调。 476 477**系统接口：** 此接口为系统接口。 478 479**需要权限**：ohos.permission.SEND_MESSAGES 480 481**系统能力**：SystemCapability.Telephony.SmsMms 482 483**参数：** 484 485| 参数名 | 类型 | 必填 | 说明 | 486| -------- | ----------------------------- | ---- | ----------------------------- | 487| content | string | 是 | 指示短消息内容，不能为null。 | 488| callback | AsyncCallback<Array<string\>> | 是 | 回调函数。 | 489 490**错误码：** 491 492以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 493 494| 错误码ID | 错误信息 | 495| -------- | -------------------------------------------- | 496| 201 | Permission denied. | 497| 401 | Parameter error. | 498| 8300001 | Invalid parameter value. | 499| 8300002 | Operation failed. Cannot connect to service. | 500| 8300003 | System internal error. | 501| 8300999 | Unknown error code. | 502 503**示例：** 504 505```js 506let content = "long message"; 507sms.splitMessage(content, (err, data) => { 508 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 509}); 510``` 511 512 513## sms.splitMessage<sup>8+</sup> 514 515splitMessage(content: string): Promise<Array<string\>> 516 517将长短信拆分为多个片段。使用Promise异步回调。 518 519**系统接口：** 此接口为系统接口。 520 521**需要权限**：ohos.permission.SEND_MESSAGES 522 523**系统能力**：SystemCapability.Telephony.SmsMms 524 525**参数：** 526 527| 参数名 | 类型 | 必填 | 说明 | 528| ------- | ------ | ---- | ---------------------------- | 529| content | string | 是 | 指示短消息内容，不能为null。 | 530 531**返回值：** 532 533| 类型 | 说明 | 534| ----------------------- | ----------------------------------- | 535| Promise<Array<string\>> | 以Promise形式返回多个片段的的结果。 | 536 537**错误码：** 538 539以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 540 541| 错误码ID | 错误信息 | 542| -------- | -------------------------------------------- | 543| 201 | Permission denied. | 544| 401 | Parameter error. | 545| 8300001 | Invalid parameter value. | 546| 8300002 | Operation failed. Cannot connect to service. | 547| 8300003 | System internal error. | 548| 8300999 | Unknown error code. | 549 550**示例：** 551 552```js 553let content = "long message"; 554let promise = sms.splitMessage(content); 555promise.then(data => { 556 console.log(`splitMessage success, promise: data->${JSON.stringify(data)}`); 557}).catch(err => { 558 console.error(`splitMessage failed, promise: err->${JSON.stringify(err)}`); 559}); 560``` 561 562## sms.addSimMessage<sup>7+</sup> 563 564addSimMessage(options: SimMessageOptions, callback: AsyncCallback<void\>): void 565 566添加SIM卡消息。使用callback异步回调。 567 568**系统接口：** 此接口为系统接口。 569 570**需要权限**：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES 571 572**系统能力**：SystemCapability.Telephony.SmsMms 573 574**参数：** 575 576| 参数名 | 类型 | 必填 | 说明 | 577| -------- | ---------------------------------------- | ---- | --------------- | 578| options | [SimMessageOptions](#simmessageoptions7) | 是 | SIM卡消息选项。 | 579| callback | AsyncCallback<void> | 是 | 回调函数。 | 580 581**错误码：** 582 583以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 584 585| 错误码ID | 错误信息 | 586| -------- | -------------------------------------------- | 587| 201 | Permission denied. | 588| 401 | Parameter error. | 589| 8300001 | Invalid parameter value. | 590| 8300002 | Operation failed. Cannot connect to service. | 591| 8300003 | System internal error. | 592| 8300999 | Unknown error code. | 593 594**示例：** 595 596```js 597let simMessageOptions = { 598 slotId: 0, 599 smsc: "test", 600 pdu: "xxxxxx", 601 status: sms.SimMessageStatus.SIM_MESSAGE_STATUS_READ 602}; 603sms.addSimMessage(simMessageOptions, (err) => { 604 console.log(`callback: err->${JSON.stringify(err)}`); 605}); 606``` 607 608 609## sms.addSimMessage<sup>7+</sup> 610 611addSimMessage(options: SimMessageOptions): Promise<void\> 612 613添加SIM卡消息。使用Promise异步回调。 614 615**系统接口：** 此接口为系统接口。 616 617**需要权限**：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES 618 619**系统能力**：SystemCapability.Telephony.SmsMms 620 621**参数：** 622 623| 参数名 | 类型 | 必填 | 说明 | 624| ------- | ---------------------------------------- | ---- | --------------- | 625| options | [SimMessageOptions](#simmessageoptions7) | 是 | SIM卡消息选项。 | 626 627**返回值：** 628 629| 类型 | 说明 | 630| ------------------- | ----------------------------- | 631| Promise<void> | 以Promise形式返回添加的结果。 | 632 633**错误码：** 634 635以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 636 637| 错误码ID | 错误信息 | 638| -------- | -------------------------------------------- | 639| 201 | Permission denied. | 640| 401 | Parameter error. | 641| 8300001 | Invalid parameter value. | 642| 8300002 | Operation failed. Cannot connect to service. | 643| 8300003 | System internal error. | 644| 8300999 | Unknown error code. | 645 646**示例：** 647 648```js 649let simMessageOptions = { 650 slotId: 0, 651 smsc: "test", 652 pdu: "xxxxxx", 653 status: sms.SimMessageStatus.SIM_MESSAGE_STATUS_READ 654}; 655let promise = sms.addSimMessage(simMessageOptions); 656promise.then(() => { 657 console.log(`addSimMessage success.`); 658}).catch((err) => { 659 console.error(`addSimMessage failed, promise: err->${JSON.stringify(err)}`); 660}); 661``` 662 663## sms.delSimMessage<sup>7+</sup> 664 665delSimMessage(slotId: number, msgIndex: number, callback: AsyncCallback<void\>): void 666 667删除SIM卡消息。使用callback异步回调。 668 669**系统接口：** 此接口为系统接口。 670 671**需要权限**：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES 672 673**系统能力**：SystemCapability.Telephony.SmsMms 674 675**参数：** 676 677| 参数名 | 类型 | 必填 | 说明 | 678| -------- | ------------------------- | ---- | ----------------------------------------- | 679| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 680| msgIndex | number | 是 | 消息索引。 | 681| callback | AsyncCallback<void> | 是 | 回调函数。 | 682 683**错误码：** 684 685以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 686 687| 错误码ID | 错误信息 | 688| -------- | -------------------------------------------- | 689| 201 | Permission denied. | 690| 401 | Parameter error. | 691| 8300001 | Invalid parameter value. | 692| 8300002 | Operation failed. Cannot connect to service. | 693| 8300003 | System internal error. | 694| 8300999 | Unknown error code. | 695 696**示例：** 697 698```js 699let slotId = 0; 700let msgIndex = 1; 701sms.delSimMessage(slotId, msgIndex, (err) => { 702 console.log(`callback: err->${JSON.stringify(err)}`); 703}); 704``` 705 706 707## sms.delSimMessage<sup>7+</sup> 708 709delSimMessage(slotId: number, msgIndex: number): Promise<void\> 710 711删除SIM卡信息。使用Promise异步回调。 712 713**系统接口：** 此接口为系统接口。 714 715**需要权限**：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES 716 717**系统能力**：SystemCapability.Telephony.SmsMms 718 719**参数：** 720 721| 参数名 | 类型 | 必填 | 说明 | 722| -------- | ------ | ---- | ----------------------------------------- | 723| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 724| msgIndex | number | 是 | 消息索引。 | 725 726**返回值：** 727 728| 类型 | 说明 | 729| ------------------- | ----------------------------- | 730| Promise<void> | 以Promise形式返回删除的结果。 | 731 732**错误码：** 733 734以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 735 736| 错误码ID | 错误信息 | 737| -------- | -------------------------------------------- | 738| 201 | Permission denied. | 739| 401 | Parameter error. | 740| 8300001 | Invalid parameter value. | 741| 8300002 | Operation failed. Cannot connect to service. | 742| 8300003 | System internal error. | 743| 8300999 | Unknown error code. | 744 745**示例：** 746 747```js 748let slotId = 0; 749let msgIndex = 1; 750let promise = sms.delSimMessage(slotId, msgIndex); 751promise.then(() => { 752 console.log(`delSimMessage success.`); 753}).catch((err) => { 754 console.error(`delSimMessage failed, promise: err->${JSON.stringify(err)}`); 755}); 756``` 757 758## sms.updateSimMessage<sup>7+</sup> 759 760updateSimMessage(options: UpdateSimMessageOptions, callback: AsyncCallback<void\>): void 761 762更新SIM卡消息。使用callback异步回调。 763 764**系统接口：** 此接口为系统接口。 765 766**需要权限**：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES 767 768**系统能力**：SystemCapability.Telephony.SmsMms 769 770**参数：** 771 772| 参数名 | 类型 | 必填 | 说明 | 773| -------- | ---------------------------------------------------- | ---- | ------------------- | 774| options | [UpdateSimMessageOptions](#updatesimmessageoptions7) | 是 | 更新SIM卡消息选项。 | 775| callback | AsyncCallback<void> | 是 | 回调函数。 | 776 777**错误码：** 778 779以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 780 781| 错误码ID | 错误信息 | 782| -------- | -------------------------------------------- | 783| 201 | Permission denied. | 784| 401 | Parameter error. | 785| 8300001 | Invalid parameter value. | 786| 8300002 | Operation failed. Cannot connect to service. | 787| 8300003 | System internal error. | 788| 8300999 | Unknown error code. | 789 790**示例：** 791 792```js 793let updateSimMessageOptions = { 794 slotId: 0, 795 msgIndex: 1, 796 newStatus: sms.SimMessageStatus.SIM_MESSAGE_STATUS_FREE, 797 pdu: "xxxxxxx", 798 smsc: "test" 799}; 800sms.updateSimMessage(updateSimMessageOptions, (err) => { 801 console.log(`callback: err->${JSON.stringify(err)}`); 802}); 803``` 804 805 806## sms.updateSimMessage<sup>7+</sup> 807 808updateSimMessage(options: UpdateSimMessageOptions): Promise<void\> 809 810更新SIM卡消息。使用Promise异步回调。 811 812**系统接口：** 此接口为系统接口。 813 814**需要权限**：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES 815 816**系统能力**：SystemCapability.Telephony.SmsMms 817 818**参数：** 819 820| 参数名 | 类型 | 必填 | 说明 | 821| ------- | ---------------------------------------------------- | ---- | ------------------- | 822| options | [UpdateSimMessageOptions](#updatesimmessageoptions7) | 是 | 更新SIM卡消息选项。 | 823 824**返回值：** 825 826| 类型 | 说明 | 827| ------------------- | ----------------------------- | 828| Promise<void> | 以Promise形式返回更新的结果。 | 829 830**错误码：** 831 832以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 833 834| 错误码ID | 错误信息 | 835| -------- | -------------------------------------------- | 836| 201 | Permission denied. | 837| 401 | Parameter error. | 838| 8300001 | Invalid parameter value. | 839| 8300002 | Operation failed. Cannot connect to service. | 840| 8300003 | System internal error. | 841| 8300999 | Unknown error code. | 842 843**示例：** 844 845```js 846let updateSimMessageOptions = { 847 slotId: 0, 848 msgIndex: 1, 849 newStatus: sms.SimMessageStatus.SIM_MESSAGE_STATUS_FREE, 850 pdu: "xxxxxxx", 851 smsc: "test" 852}; 853let promise = sms.updateSimMessage(updateSimMessageOptions); 854promise.then(() => { 855 console.log(`updateSimMessage success.`); 856}).catch((err) => { 857 console.error(`updateSimMessage failed, promise: err->${JSON.stringify(err)}`); 858}); 859``` 860 861## sms.getAllSimMessages<sup>7+</sup> 862 863getAllSimMessages(slotId: number, callback: AsyncCallback<Array<SimShortMessage\>>): void 864 865获取所有SIM卡消息。使用callback异步回调。 866 867**系统接口：** 此接口为系统接口。 868 869**需要权限**：ohos.permission.RECEIVE_SMS 870 871**系统能力**：SystemCapability.Telephony.SmsMms 872 873**参数：** 874 875| 参数名 | 类型 | 必填 | 说明 | 876| -------- | ----------------------------------------------------------- | ---- | ----------------------------------------- | 877| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 878| callback | AsyncCallback<Array<[SimShortMessage](#simshortmessage7)\>> | 是 | 回调函数。 | 879 880**错误码：** 881 882以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 883 884| 错误码ID | 错误信息 | 885| -------- | -------------------------------------------- | 886| 201 | Permission denied. | 887| 401 | Parameter error. | 888| 8300001 | Invalid parameter value. | 889| 8300002 | Operation failed. Cannot connect to service. | 890| 8300003 | System internal error. | 891| 8300999 | Unknown error code. | 892 893**示例：** 894 895```js 896let slotId = 0; 897sms.getAllSimMessages(slotId, (err, data) => { 898 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 899}); 900``` 901 902 903## sms.getAllSimMessages<sup>7+</sup> 904 905getAllSimMessages(slotId: number): Promise<Array<SimShortMessage\>> 906 907获取所有SIM卡消息。使用Promise异步回调。 908 909**系统接口：** 此接口为系统接口。 910 911**需要权限**：ohos.permission.RECEIVE_SMS 912 913**系统能力**：SystemCapability.Telephony.SmsMms 914 915**参数：** 916 917| 参数名 | 类型 | 必填 | 说明 | 918| ------ | ------ | ---- | ----------------------------------------- | 919| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 920 921**返回值：** 922 923| 类型 | 说明 | 924| ------------------------------------------------------- | ---------------------------------- | 925| PromiseArray<[SimShortMessage](#simshortmessage7)\>> | 以Promise形式返回获取的SIM短消息。 | 926 927**错误码：** 928 929以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 930 931| 错误码ID | 错误信息 | 932| -------- | -------------------------------------------- | 933| 201 | Permission denied. | 934| 401 | Parameter error. | 935| 8300001 | Invalid parameter value. | 936| 8300002 | Operation failed. Cannot connect to service. | 937| 8300003 | System internal error. | 938| 8300999 | Unknown error code. | 939 940**示例：** 941 942```js 943let slotId = 0; 944let promise = sms.getAllSimMessages(slotId); 945promise.then(data => { 946 console.log(`getAllSimMessages success, promise: data->${JSON.stringify(data)}`); 947}).catch(err => { 948 console.error(`getAllSimMessages failed, promise: err->${JSON.stringify(err)}`); 949}); 950``` 951 952## sms.setCBConfig<sup>7+</sup> 953 954setCBConfig(options: CBConfigOptions, callback: AsyncCallback<void\>): void 955 956设置小区广播配置。使用callback异步回调。 957 958**系统接口：** 此接口为系统接口。 959 960**需要权限**：ohos.permission.RECEIVE_SMS 961 962**系统能力**：SystemCapability.Telephony.SmsMms 963 964**参数：** 965 966| 参数名 | 类型 | 必填 | 说明 | 967| -------- | ------------------------------------ | ---- | ------------ | 968| options | [CBConfigOptions](#cbconfigoptions7) | 是 | 小区广播配置选项。 | 969| callback | AsyncCallback<void> | 是 | 回调函数。 | 970 971**错误码：** 972 973以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 974 975| 错误码ID | 错误信息 | 976| -------- | -------------------------------------------- | 977| 201 | Permission denied. | 978| 401 | Parameter error. | 979| 8300001 | Invalid parameter value. | 980| 8300002 | Operation failed. Cannot connect to service. | 981| 8300003 | System internal error. | 982| 8300999 | Unknown error code. | 983 984**示例：** 985 986```js 987let cbConfigOptions = { 988 slotId: 0, 989 enable: true, 990 startMessageId: 100, 991 endMessageId: 200, 992 ranType: sms.RanType.TYPE_GSM 993}; 994sms.setCBConfig(cbConfigOptions, (err) => { 995 console.log(`callback: err->${JSON.stringify(err)}`); 996}); 997``` 998 999 1000## sms.setCBConfig<sup>7+</sup> 1001 1002setCBConfig(options: CBConfigOptions): Promise<void\> 1003 1004设置小区广播配置。使用Promise异步回调。 1005 1006**系统接口：** 此接口为系统接口。 1007 1008**需要权限**：ohos.permission.RECEIVE_SMS 1009 1010**系统能力**：SystemCapability.Telephony.SmsMms 1011 1012**参数：** 1013 1014| 参数名 | 类型 | 必填 | 说明 | 1015| ------- | ------------------------------------ | ---- | ------------ | 1016| options | [CBConfigOptions](#cbconfigoptions7) | 是 | 小区广播配置选项。 | 1017 1018**返回值：** 1019 1020| 类型 | 说明 | 1021| ------------------- | ----------------------------- | 1022| Promise<void> | 以Promise形式返回设置的结果。 | 1023 1024**错误码：** 1025 1026以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1027 1028| 错误码ID | 错误信息 | 1029| -------- | -------------------------------------------- | 1030| 201 | Permission denied. | 1031| 401 | Parameter error. | 1032| 8300001 | Invalid parameter value. | 1033| 8300002 | Operation failed. Cannot connect to service. | 1034| 8300003 | System internal error. | 1035| 8300999 | Unknown error code. | 1036 1037**示例：** 1038 1039```js 1040let cbConfigOptions = { 1041 slotId: 0, 1042 enable: true, 1043 startMessageId: 100, 1044 endMessageId: 200, 1045 ranType: sms.RanType.TYPE_GSM 1046}; 1047let promise = sms.setCBConfig(cbConfigOptions); 1048promise.then(() => { 1049 console.log(`setCBConfig success.`); 1050}).catch((err) => { 1051 console.error(`setCBConfig failed, promise: err->${JSON.stringify(err)}`); 1052}); 1053``` 1054 1055## sms.getSmsSegmentsInfo<sup>8+</sup> 1056 1057getSmsSegmentsInfo(slotId: number, message: string, force7bit: boolean, callback: AsyncCallback<SmsSegmentsInfo\>): void 1058 1059获取短信段信息。使用callback异步回调。 1060 1061**系统接口：** 此接口为系统接口。 1062 1063**系统能力**：SystemCapability.Telephony.SmsMms 1064 1065**参数：** 1066 1067| 参数名 | 类型 | 必填 | 说明 | 1068| --------- | ------------------------------------------------------------ | ---- | ----------------------------------------- | 1069| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1070| message | string | 是 | 消息。 | 1071| force7bit | boolean | 是 | 是否使用7 bit编码。 | 1072| callback | AsyncCallback<[SmsSegmentsInfo](#smssegmentsinfo8)> | 是 | 回调函数。 | 1073 1074**错误码：** 1075 1076以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1077 1078| 错误码ID | 错误信息 | 1079| -------- | -------------------------------------------- | 1080| 401 | Parameter error. | 1081| 8300001 | Invalid parameter value. | 1082| 8300002 | Operation failed. Cannot connect to service. | 1083| 8300003 | System internal error. | 1084| 8300999 | Unknown error code. | 1085 1086**示例：** 1087 1088```js 1089let slotId = 0; 1090sms.getSmsSegmentsInfo(slotId, "message", false, (err, data) => { 1091 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1092}); 1093``` 1094 1095 1096## sms.getSmsSegmentsInfo<sup>8+</sup> 1097 1098getSmsSegmentsInfo(slotId: number, message: string, force7bit: boolean): Promise<SmsSegmentsInfo\> 1099 1100获取短信段信息。使用Promise异步回调。 1101 1102**系统接口：** 此接口为系统接口。 1103 1104**系统能力**：SystemCapability.Telephony.SmsMms 1105 1106**参数：** 1107 1108| 参数名 | 类型 | 必填 | 说明 | 1109| --------- | ------- | ---- | ----------------------------------------- | 1110| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1111| message | string | 是 | 消息。 | 1112| force7bit | boolean | 是 | 是否使用7 bit编码。 | 1113 1114**返回值：** 1115 1116| 类型 | 说明 | 1117| ------------------------------------------------------- | ----------------------------- | 1118| Promise<[SmsSegmentsInfo](#smssegmentsinfo8)> | 以Promise形式返回短信段信息。 | 1119 1120**错误码：** 1121 1122以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1123 1124| 错误码ID | 错误信息 | 1125| -------- | -------------------------------------------- | 1126| 401 | Parameter error. | 1127| 8300001 | Invalid parameter value. | 1128| 8300002 | Operation failed. Cannot connect to service. | 1129| 8300003 | System internal error. | 1130| 8300999 | Unknown error code. | 1131 1132**示例：** 1133 1134```js 1135let slotId = 0; 1136let promise = sms.getSmsSegmentsInfo(slotId, "message", false); 1137promise.then(data => { 1138 console.log(`getSmsSegmentsInfo success, promise: data->${JSON.stringify(data)}`); 1139}).catch(err => { 1140 console.error(`getSmsSegmentsInfo failed, promise: err->${JSON.stringify(err)}`); 1141}); 1142``` 1143 1144## sms.isImsSmsSupported<sup>8+</sup> 1145 1146isImsSmsSupported(slotId: number, callback: AsyncCallback<boolean\>): void 1147 1148如果IMS已注册并且在IMS上支持SMS，则支持通过IMS发送SMS。使用callback异步回调。 1149 1150**系统接口：** 此接口为系统接口。 1151 1152**系统能力**：SystemCapability.Telephony.SmsMms 1153 1154**参数：** 1155 1156| 参数名 | 类型 | 必填 | 说明 | 1157| -------- | ---------------------------- | ---- | ---------- | 1158| slotId | number | 是 | SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1159| callback | AsyncCallback<boolean> | 是 | 回调函数。 | 1160 1161**错误码：** 1162 1163以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1164 1165| 错误码ID | 错误信息 | 1166| -------- | -------------------------------------------- | 1167| 401 | Parameter error. | 1168| 8300001 | Invalid parameter value. | 1169| 8300002 | Operation failed. Cannot connect to service. | 1170| 8300003 | System internal error. | 1171| 8300999 | Unknown error code. | 1172 1173**示例：** 1174 1175```js 1176let slotId = 0; 1177sms.isImsSmsSupported(slotId, (err, data) => { 1178 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1179}); 1180``` 1181 1182 1183## sms.isImsSmsSupported<sup>8+</sup> 1184 1185isImsSmsSupported(slotId: number): Promise<boolean\> 1186 1187如果IMS已注册并且在IMS上支持SMS，则支持通过IMS发送SMS。使用Promise异步回调。 1188 1189**系统接口：** 此接口为系统接口。 1190 1191**系统能力**：SystemCapability.Telephony.SmsMms 1192 1193**参数：** 1194 1195| 参数名 | 类型 | 必填 | 说明 | 1196| ------ | ------ | ---- | -------------------------------------- | 1197| slotId | number | 是 | 卡槽ID。<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1198 1199**返回值：** 1200 1201| 类型 | 说明 | 1202| ---------------------- | ----------------------- | 1203| Promise<boolean> | 以Promise形式返回结果。 | 1204 1205**错误码：** 1206 1207以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1208 1209| 错误码ID | 错误信息 | 1210| -------- | -------------------------------------------- | 1211| 401 | Parameter error. | 1212| 8300001 | Invalid parameter value. | 1213| 8300002 | Operation failed. Cannot connect to service. | 1214| 8300003 | System internal error. | 1215| 8300999 | Unknown error code. | 1216 1217**示例：** 1218 1219```js 1220let slotId = 0; 1221let promise = sms.isImsSmsSupported(slotId); 1222promise.then(data => { 1223 console.log(`isImsSmsSupported success, promise: data->${JSON.stringify(data)}`); 1224}).catch(err => { 1225 console.error(`isImsSmsSupported failed, promise: err->${JSON.stringify(err)}`); 1226}); 1227``` 1228 1229## sms.getImsShortMessageFormat<sup>8+</sup> 1230 1231getImsShortMessageFormat(callback: AsyncCallback<string\>): void 1232 1233获取IMS上支持的SMS格式。使用callback异步回调。 1234 1235**系统接口：** 此接口为系统接口。 1236 1237**系统能力**：SystemCapability.Telephony.SmsMms 1238 1239**参数：** 1240 1241| 参数名 | 类型 | 必填 | 说明 | 1242| -------- | --------------------------- | ---- | ---------- | 1243| callback | AsyncCallback<string> | 是 | 回调函数。 | 1244 1245**错误码：** 1246 1247以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1248 1249| 错误码ID | 错误信息 | 1250| -------- | -------------------------------------------- | 1251| 401 | Parameter error. | 1252| 8300001 | Invalid parameter value. | 1253| 8300002 | Operation failed. Cannot connect to service. | 1254| 8300003 | System internal error. | 1255| 8300999 | Unknown error code. | 1256 1257**示例：** 1258 1259```js 1260sms.getImsShortMessageFormat((err, data) => { 1261 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1262}); 1263``` 1264 1265 1266## sms.getImsShortMessageFormat<sup>8+</sup> 1267 1268getImsShortMessageFormat(): Promise<string\> 1269 1270获取IMS上支持的SMS格式。使用Promise异步回调。 1271 1272**系统接口：** 此接口为系统接口。 1273 1274**系统能力**：SystemCapability.Telephony.SmsMms 1275 1276**返回值：** 1277 1278| 类型 | 说明 | 1279| --------------------- | -------------------------- | 1280| Promise<string> | 以Promise形式返回SMS格式。 | 1281 1282**错误码：** 1283 1284以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1285 1286| 错误码ID | 错误信息 | 1287| -------- | -------------------------------------------- | 1288| 401 | Parameter error. | 1289| 8300001 | Invalid parameter value. | 1290| 8300002 | Operation failed. Cannot connect to service. | 1291| 8300003 | System internal error. | 1292| 8300999 | Unknown error code. | 1293 1294**示例：** 1295 1296```js 1297let promise = sms.getImsShortMessageFormat(); 1298promise.then(data => { 1299 console.log(`getImsShortMessageFormat success, promise: data->${JSON.stringify(data)}`); 1300}).catch(err => { 1301 console.error(`getImsShortMessageFormat failed, promise: err->${JSON.stringify(err)}`); 1302}); 1303``` 1304 1305## sms.decodeMms<sup>8+</sup> 1306 1307decodeMms(mmsFilePathName: string | Array<number\>, callback: AsyncCallback<MmsInformation\>): void 1308 1309彩信解码。使用callback异步回调。 1310 1311**系统接口：** 此接口为系统接口。 1312 1313**系统能力**：SystemCapability.Telephony.SmsMms 1314 1315**参数：** 1316 1317| 参数名 | 类型 | 必填 | 说明 | 1318| --------------- | ------------------------------------------------------- | ---- | -------------- | 1319| mmsFilePathName | string \|Array<number\> | 是 | 彩信文件路径名。 | 1320| callback | AsyncCallback<[MmsInformation](#mmsinformation8)> | 是 | 回调函数。 | 1321 1322**错误码：** 1323 1324以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1325 1326| 错误码ID | 错误信息 | 1327| -------- | -------------------------------------------- | 1328| 401 | Parameter error. | 1329| 8300001 | Invalid parameter value. | 1330| 8300002 | Operation failed. Cannot connect to service. | 1331| 8300003 | System internal error. | 1332| 8300999 | Unknown error code. | 1333 1334**示例：** 1335 1336```js 1337let mmsFilePathName = "filename"; 1338sms.decodeMms(mmsFilePathName, (err, data) => { 1339 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1340}); 1341``` 1342 1343 1344## sms.decodeMms<sup>8+</sup> 1345 1346decodeMms(mmsFilePathName: string | Array<number\>): Promise<MmsInformation\> 1347 1348彩信解码。使用Promise异步回调。 1349 1350**系统接口：** 此接口为系统接口。 1351 1352**系统能力**：SystemCapability.Telephony.SmsMms 1353 1354**参数：** 1355 1356| 参数名 | 类型 | 必填 | 说明 | 1357| --------------- | ----------------------- | ---- | -------------- | 1358| mmsFilePathName | string \|Array<number\> | 是 | 彩信文件路径名 | 1359 1360**返回值：** 1361 1362| 类型 | 说明 | 1363| --------------------------------------------------------- | --------------------------- | 1364| Promise<<[MmsInformation](#mmsinformation8)>> | 以Promise形式返回彩信信息。 | 1365 1366**错误码：** 1367 1368以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1369 1370| 错误码ID | 错误信息 | 1371| -------- | -------------------------------------------- | 1372| 401 | Parameter error. | 1373| 8300001 | Invalid parameter value. | 1374| 8300002 | Operation failed. Cannot connect to service. | 1375| 8300003 | System internal error. | 1376| 8300999 | Unknown error code. | 1377 1378**示例：** 1379 1380```js 1381let mmsFilePathName = "filename"; 1382let promise = sms.decodeMms(mmsFilePathName); 1383promise.then(data => { 1384 console.log(`decodeMms success, promise: data->${JSON.stringify(data)}`); 1385}).catch(err => { 1386 console.error(`decodeMms failed, promise: err->${JSON.stringify(err)}`); 1387}); 1388``` 1389 1390## sms.encodeMms<sup>8+</sup> 1391 1392encodeMms(mms: MmsInformation, callback: AsyncCallback<Array<number\>>): void 1393 1394彩信编码。使用callback异步回调。 1395 1396**系统接口：** 此接口为系统接口。 1397 1398**系统能力**：SystemCapability.Telephony.SmsMms 1399 1400**参数：** 1401 1402| 参数名 | 类型 | 必填 | 说明 | 1403| -------- | ----------------------------------- | ---- | ---------- | 1404| mms | [MmsInformation](#mmsinformation8) | 是 | 彩信信息。 | 1405| callback | AsyncCallback<Array<number\>> | 是 | 回调函数。 | 1406 1407**错误码：** 1408 1409以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1410 1411| 错误码ID | 错误信息 | 1412| -------- | -------------------------------------------- | 1413| 401 | Parameter error. | 1414| 8300001 | Invalid parameter value. | 1415| 8300002 | Operation failed. Cannot connect to service. | 1416| 8300003 | System internal error. | 1417| 8300999 | Unknown error code. | 1418 1419**示例：** 1420 1421```js 1422let mmsAcknowledgeInd = { 1423 transactionId: "100", 1424 version: sms.MmsVersionType.MMS_VERSION_1_0, 1425 reportAllowed: sms.ReportType.MMS_YES 1426}; 1427let mmsInformation = { 1428 messageType: sms.MessageType.TYPE_MMS_ACKNOWLEDGE_IND, 1429 mmsType: mmsAcknowledgeInd 1430}; 1431sms.encodeMms(mmsInformation, (err, data) => { 1432 console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 1433}); 1434``` 1435 1436 1437## sms.encodeMms<sup>8+</sup> 1438 1439encodeMms(mms: MmsInformation): Promise<Array<number\>> 1440 1441彩信编码。使用Promise异步回调。 1442 1443**系统接口：** 此接口为系统接口。 1444 1445**系统能力**：SystemCapability.Telephony.SmsMms 1446 1447**参数：** 1448 1449| 参数名 | 类型 | 必填 | 说明 | 1450| ------ | ---------------------------------- | ---- | ---------- | 1451| mms | [MmsInformation](#mmsinformation8) | 是 | 彩信信息。 | 1452 1453**返回值：** 1454 1455| 类型 | 说明 | 1456| ----------------------------- | ----------------------------------- | 1457| Promise<Array<number\>> | 以Promise形式返回彩信编码后的结果。 | 1458 1459**错误码：** 1460 1461以下错误码的详细介绍请参见[ohos.telephony(电话子系统)错误码](../../reference/errorcodes/errorcode-telephony.md)错误码。 1462 1463| 错误码ID | 错误信息 | 1464| -------- | -------------------------------------------- | 1465| 401 | Parameter error. | 1466| 8300001 | Invalid parameter value. | 1467| 8300002 | Operation failed. Cannot connect to service. | 1468| 8300003 | System internal error. | 1469| 8300999 | Unknown error code. | 1470 1471**示例：** 1472 1473```js 1474let mmsAcknowledgeInd = { 1475 transactionId: "100", 1476 version: sms.MmsVersionType.MMS_VERSION_1_0, 1477 reportAllowed: sms.ReportType.MMS_YES 1478}; 1479let mmsInformation = { 1480 messageType: sms.MessageType.TYPE_MMS_ACKNOWLEDGE_IND, 1481 mmsType: mmsAcknowledgeInd 1482}; 1483let promise = sms.encodeMms(mmsInformation); 1484promise.then(data => { 1485 console.log(`encodeMms success, promise: data->${JSON.stringify(data)}`); 1486}).catch(err => { 1487 console.error(`encodeMms failed, promise: err->${JSON.stringify(err)}`); 1488}); 1489``` 1490 1491## ShortMessage 1492 1493短信实例。 1494 1495**系统能力**：SystemCapability.Telephony.SmsMms 1496 1497| 名称 | 类型 | 必填 | 说明 | 1498| ------------------------ | --------------------------------------- | ---- | ------------------------------------------------------------ | 1499| hasReplyPath | boolean | 是 | 收到的短信是否包含“TP-Reply-Path”，默认为false。<br/>“TP-Reply-Path”：设备根据发送SMS消息的短消息中心进行回复。 | 1500| isReplaceMessage | boolean | 是 | 收到的短信是否为“替换短信”，默认为false。<br/>“替换短信”有关详细信息，参见 “3GPP TS 23.040 9.2.3.9”。 | 1501| isSmsStatusReportMessage | boolean | 是 | 当前消息是否为“短信状态报告”，默认为false。<br/>“短信状态报告”是一种特定格式的短信，被用来从Service Center到Mobile Station传送状态报告。| 1502| messageClass | [ShortMessageClass](#shortmessageclass) | 是 | 短信类型。 | 1503| pdu | Array<number> | 是 | SMS消息中的协议数据单元 （PDU）。 | 1504| protocolId | number | 是 | 发送短信时使用的协议标识。 | 1505| scAddress | string | 是 | 短消息服务中心（SMSC）地址。 | 1506| scTimestamp | number | 是 | SMSC时间戳。 | 1507| status | number | 是 | SMS-STATUS-REPORT消息中的短信状态指示短信服务中心（SMSC）发送的短信状态。 | 1508| visibleMessageBody | string | 是 | 短信正文。 | 1509| visibleRawAddress | string | 是 | 发送者地址。 | 1510 1511 1512## ShortMessageClass 1513 1514短信类型。 1515 1516**系统能力**：SystemCapability.Telephony.SmsMms 1517 1518| 名称 | 值 | 说明 | 1519| ---------------- | ---- | ---------------------------------------- | 1520| UNKNOWN | 0 | 未知类型。 | 1521| INSTANT_MESSAGE | 1 | 即时消息，收到后立即显示。 | 1522| OPTIONAL_MESSAGE | 2 | 存储在设备或SIM卡上的短信。 | 1523| SIM_MESSAGE | 3 | 包含SIM卡信息的短信，需要存储在SIM卡中。 | 1524| FORWARD_MESSAGE | 4 | 要转发到另一台设备的短信。 | 1525 1526 1527## SendMessageOptions 1528 1529发送短信的参数和回调。根据SendMessageOptions中的可选参数content的值判断短信类型。 1530 1531**系统能力**：SystemCapability.Telephony.SmsMms 1532 1533| 名称 | 类型 | 必填 | 说明 | 1534| ---------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1535| slotId | number | 是 | 用于发送短信的SIM卡槽ID：<br/>- 0：卡槽1<br/>- 1：卡槽2 | 1536| destinationHost | string | 是 | 短信的发送地址。 | 1537| content | string \| Array<number> | 是 | 如果内容是字符串，则这是一条文本短信。如果内容是字节数组，则这是一条数据短信。 | 1538| serviceCenter | string | 否 | 短信中心地址。默认使用SIM卡中的短信中心地址。 | 1539| destinationPort | number | 否 | 如果发送数据消息，destinationPort 是必需的。否则是可选的。 | 1540| sendCallback | AsyncCallback<[ISendShortMessageCallback](#isendshortmessagecallback)> | 否 | 短信发送结果回调，返回短信发送的结果，参考[ISendShortMessageCallback](#isendshortmessagecallback)。 | 1541| deliveryCallback | AsyncCallback<[IDeliveryShortMessageCallback](#ideliveryshortmessagecallback)> | 否 | 短信送达结果回调，返回短信递送报告，参考[IDeliveryShortMessageCallback](#ideliveryshortmessagecallback)。 | 1542 1543 1544## ISendShortMessageCallback 1545 1546回调实例。返回短信发送结果、存储已发送短信的URI和是否为长短信的最后一部分。 1547 1548**系统能力**：SystemCapability.Telephony.SmsMms 1549 1550| 名称 | 类型 | 必填 | 说明 | 1551| ---------- | ------------------------------- | ---- | ----------------------------------------------------------------------------------------- | 1552| isLastPart | boolean | 否 | 指定这是否是长短信的最后一部分。true表示这是长短信的最后一部分，false表示不是。默认为false。 | 1553| result | [SendSmsResult](#sendsmsresult) | 是 | 短信发送结果。 | 1554| url | string | 是 | 存储发送短信的URI。 | 1555 1556 1557## IDeliveryShortMessageCallback 1558 1559回调实例，返回短信送达报告。 1560 1561**系统能力**：SystemCapability.Telephony.SmsMms 1562 1563| 名称 | 类型 | 必填 | 说明 | 1564| ---- | ------------------- | ---- | -------------- | 1565| pdu | Array<number> | 是 | 短信送达报告。 | 1566 1567 1568## SendSmsResult 1569 1570短信发送结果。 1571 1572**系统能力**：SystemCapability.Telephony.SmsMms 1573 1574| 名称 | 值 | 说明 | 1575| ------------------------------------ | ---- | ------------------------------------------------------ | 1576| SEND_SMS_SUCCESS | 0 | 发送短信成功。 | 1577| SEND_SMS_FAILURE_UNKNOWN | 1 | 发送短信失败，原因未知。 | 1578| SEND_SMS_FAILURE_RADIO_OFF | 2 | 发送短信失败，原因为调制解调器关机。 | 1579| SEND_SMS_FAILURE_SERVICE_UNAVAILABLE | 3 | 发送短信失败，原因为网络不可用、不支持发送或接收短信。 | 1580 1581## MmsInformation<sup>8+</sup> 1582 1583彩信信息。 1584 1585**系统接口：** 此接口为系统接口。 1586 1587**系统能力**：SystemCapability.Telephony.SmsMms 1588 1589| 名称 | 类型 | 必填 | 说明 | 1590| ----------- | ------------------------------------------------------------ | ---- | ---------- | 1591| messageType | [MessageType](#messagetype8) | 是 | 消息类型。 | 1592| mmsType | [MmsSendReq](#mmssendreq8) \|[MmsSendConf](#mmssendconf8) \|[MmsNotificationInd](#mmsnotificationind8) \|[MmsRespInd](#mmsrespind8) \|[MmsRetrieveConf](#mmsretrieveconf8)\|[MmsAcknowledgeInd](#mmsacknowledgeind8)\|[MmsDeliveryInd](#mmsdeliveryind8)\|[MmsReadOrigInd](#mmsreadorigind8)\|[MmsReadRecInd](#mmsreadrecind8) | 是 | PDU头类型 | 1593| attachment | Array<[MmsAttachment](#mmsattachment8)\> | 否 | 附件 | 1594 1595## MmsSendReq<sup>8+</sup> 1596 1597彩信发送请求。 1598 1599**系统接口：** 此接口为系统接口。 1600 1601**系统能力**：SystemCapability.Telephony.SmsMms 1602 1603| 名称 | 类型 | 必填 | 说明 | 1604| ---------------- | ------------------------------------ | ---- | ------------ | 1605| from | [MmsAddress](#mmsaddress8) | 是 | 彩信来源 | 1606| transactionId | string | 是 | 事务ID | 1607| contentType | string | 是 | 内容类型 | 1608| version | [MmsVersionType](#mmsversiontype8) | 是 | 版本 | 1609| to | Array<[MmsAddress](#mmsaddress8)\> | 否 | 发送至 | 1610| date | number | 否 | 日期 | 1611| cc | Array<[MmsAddress](#mmsaddress8)\> | 否 | 抄送 | 1612| bcc | Array<[MmsAddress](#mmsaddress8)\> | 否 | 暗抄送 | 1613| subject | string | 否 | 主题 | 1614| messageClass | number | 否 | 消息类 | 1615| expiry | number | 否 | 到期 | 1616| priority | [MmsPriorityType](#mmsprioritytype8) | 否 | 优先 | 1617| senderVisibility | number | 否 | 发件人可见性 | 1618| deliveryReport | number | 否 | 交付报告 | 1619| readReport | number | 否 | 阅读报告 | 1620 1621## MmsSendConf<sup>8+</sup> 1622 1623彩信发送配置。 1624 1625**系统接口：** 此接口为系统接口。 1626 1627**系统能力**：SystemCapability.Telephony.SmsMms 1628 1629| 名称 | 类型 | 必填 | 说明 | 1630| ------------- | ---------------------------------- | ---- | -------- | 1631| responseState | number | 是 | 响应状态 | 1632| transactionId | string | 是 | 事务ID | 1633| version | [MmsVersionType](#mmsversiontype8) | 是 | 版本 | 1634| messageId | string | 否 | 消息ID | 1635 1636## MmsNotificationInd<sup>8+</sup> 1637 1638彩信通知索引。 1639 1640**系统接口：** 此接口为系统接口。 1641 1642**系统能力**：SystemCapability.Telephony.SmsMms 1643 1644| 名称 | 类型 | 必填 | 说明 | 1645| --------------- | ---------------------------------- | ---- | -------- | 1646| transactionId | string | 是 | 事务ID | 1647| messageClass | number | 是 | 消息类 | 1648| messageSize | number | 是 | 消息大小 | 1649| expiry | number | 是 | 到期 | 1650| contentLocation | string | 是 | 内容位置 | 1651| version | [MmsVersionType](#mmsversiontype8) | 是 | 版本 | 1652| from | [MmsAddress](#mmsaddress8) | 否 | 来源 | 1653| subject | string | 否 | 主题 | 1654| deliveryReport | number | 否 | 状态报告 | 1655| contentClass | number | 否 | 内容类 | 1656 1657## MmsAcknowledgeInd<sup>8+</sup> 1658 1659彩信确认索引。 1660 1661**系统接口：** 此接口为系统接口。 1662 1663**系统能力**：SystemCapability.Telephony.SmsMms 1664 1665| 名称 | 类型 | 必填 | 说明 | 1666| ------------- | ---------------------------------- | ---- | -------- | 1667| transactionId | string | 是 | 事务ID | 1668| version | [MmsVersionType](#mmsversiontype8) | 是 | 版本 | 1669| reportAllowed | [ReportType](#reporttype8) | 否 | 允许报告 | 1670 1671## MmsRetrieveConf<sup>8+</sup> 1672 1673彩信检索配置。 1674 1675**系统接口：** 此接口为系统接口。 1676 1677**系统能力**：SystemCapability.Telephony.SmsMms 1678 1679| 名称 | 类型 | 必填 | 说明 | 1680| -------------- | ------------------------------------ | ---- | -------- | 1681| transactionId | string | 是 | 事务ID | 1682| messageId | string | 是 | 消息ID | 1683| date | number | 是 | 日期 | 1684| contentType | string | 是 | 内容类型 | 1685| to | Array<[MmsAddress](#mmsaddress8)\> | 是 | 发送至 | 1686| version | [MmsVersionType](#mmsversiontype8) | 是 | 版本 | 1687| from | [MmsAddress](#mmsaddress8) | 否 | 来源 | 1688| cc | Array<[MmsAddress](#mmsaddress8)\> | 否 | 抄送 | 1689| subject | string | 否 | 主题 | 1690| priority | [MmsPriorityType](#mmsprioritytype8) | 否 | 优先级 | 1691| deliveryReport | number | 否 | 状态报告 | 1692| readReport | number | 否 | 阅读报告 | 1693| retrieveStatus | number | 否 | 检索状态 | 1694| retrieveText | string | 否 | 检索文本 | 1695 1696## MmsReadOrigInd<sup>8+</sup> 1697 1698彩信读取原始索引。 1699 1700**系统接口：** 此接口为系统接口。 1701 1702**系统能力**：SystemCapability.Telephony.SmsMms 1703 1704| 名称 | 类型 | 必填 | 说明 | 1705| ---------- | ---------------------------------- | ---- | -------- | 1706| version | [MmsVersionType](#mmsversiontype8) | 是 | 版本 | 1707| messageId | string | 是 | 消息ID | 1708| to | Array<[MmsAddress](#mmsaddress8)\> | 是 | 发送至 | 1709| from | [MmsAddress](#mmsaddress8) | 是 | 来源 | 1710| date | number | 是 | 日期 | 1711| readStatus | number | 是 | 阅读状态 | 1712 1713## MmsReadRecInd<sup>8+</sup> 1714 1715彩信读取记录索引。 1716 1717**系统接口：** 此接口为系统接口。 1718 1719**系统能力**：SystemCapability.Telephony.SmsMms 1720 1721| 名称 | 类型 | 必填 | 说明 | 1722| ---------- | ---------------------------------- | ---- | -------- | 1723| version | [MmsVersionType](#mmsversiontype8) | 是 | 版本 | 1724| messageId | string | 是 | 消息ID | 1725| to | Array<[MmsAddress](#mmsaddress8)\> | 是 | 发送至 | 1726| from | [MmsAddress](#mmsaddress8) | 是 | 来源 | 1727| readStatus | number | 是 | 阅读状态 | 1728| date | number | 否 | 日期 | 1729 1730## MmsAttachment<sup>8+</sup> 1731 1732彩信附件。 1733 1734**系统接口：** 此接口为系统接口。 1735 1736**系统能力**：SystemCapability.Telephony.SmsMms 1737 1738| 名称 | 类型 | 必填 | 说明 | 1739| ----------------------- | ------------------------------------ | ---- | ------------------ | 1740| contentId | string | 是 | 内容ID | 1741| contentLocation | string | 是 | 内容位置 | 1742| contentDisposition | [DispositionType](#dispositiontype8) | 是 | 内容处理 | 1743| contentTransferEncoding | string | 是 | 内容传输编码 | 1744| contentType | string | 是 | 内容类型 | 1745| isSmil | boolean | 是 | 同步多媒体集成语言 | 1746| path | string | 否 | 路径 | 1747| inBuff | Array<number\> | 否 | 缓冲区中 | 1748| fileName | string | 否 | 文件名 | 1749| charset | [MmsCharSets](#mmscharsets8) | 否 | 字符集 | 1750 1751## MmsAddress<sup>8+</sup> 1752 1753彩信地址。 1754 1755**系统接口：** 此接口为系统接口。 1756 1757**系统能力**：SystemCapability.Telephony.SmsMms 1758 1759| 名称 | 类型 | 必填 | 说明 | 1760| ------- | ---------------------------- | ---- | ------ | 1761| address | string | 是 | 地址 | 1762| charset | [MmsCharSets](#mmscharsets8) | 是 | 字符集 | 1763 1764## MessageType<sup>8+</sup> 1765 1766消息类型。 1767 1768**系统接口：** 此接口为系统接口。 1769 1770**系统能力**：SystemCapability.Telephony.SmsMms 1771 1772| 名称 | 值 | 说明 | 1773| ------------------------- | ---- | -------------------- | 1774| TYPE_MMS_SEND_REQ | 128 | 彩信发送请求类型 | 1775| TYPE_MMS_SEND_CONF | 129 | 彩信发送配置类型 | 1776| TYPE_MMS_NOTIFICATION_IND | 130 | 彩信通知索引类型 | 1777| TYPE_MMS_RESP_IND | 131 | 彩信回复索引类型 | 1778| TYPE_MMS_RETRIEVE_CONF | 132 | 彩信检索配置类型 | 1779| TYPE_MMS_ACKNOWLEDGE_IND | 133 | 彩信确认索引类型 | 1780| TYPE_MMS_DELIVERY_IND | 134 | 彩信传送索引类型 | 1781| TYPE_MMS_READ_REC_IND | 135 | 彩信读取接收索引类型 | 1782| TYPE_MMS_READ_ORIG_IND | 136 | 彩信读取原始索引类型 | 1783 1784## MmsPriorityType<sup>8+</sup> 1785 1786彩信优先级类型。 1787 1788**系统接口：** 此接口为系统接口。 1789 1790**系统能力**：SystemCapability.Telephony.SmsMms 1791 1792| 名称 | 值 | 说明 | 1793| ---------- | ---- | -------------- | 1794| MMS_LOW | 128 | 彩信优先级低 | 1795| MMS_NORMAL | 129 | 彩信优先级正常 | 1796| MMS_HIGH | 130 | 彩信优先级高 | 1797 1798## MmsVersionType<sup>8+</sup> 1799 1800彩信版本类型。 1801 1802**系统接口：** 此接口为系统接口。 1803 1804**系统能力**：SystemCapability.Telephony.SmsMms 1805 1806| 名称 | 值 | 说明 | 1807| --------------- | ---- | ----------- | 1808| MMS_VERSION_1_0 | 0x10 | 彩信版本1_0 | 1809| MMS_VERSION_1_1 | 0x11 | 彩信版本1_1 | 1810| MMS_VERSION_1_2 | 0x12 | 彩信版本1_2 | 1811| MMS_VERSION_1_3 | 0x13 | 彩信版本1_3 | 1812 1813## MmsCharSets<sup>8+</sup> 1814 1815彩信字符集。 1816 1817**系统接口：** 此接口为系统接口。 1818 1819**系统能力**：SystemCapability.Telephony.SmsMms 1820 1821| 名称 | 值 | 说明 | 1822| --------------- | ------ | ------------------- | 1823| BIG5 | 0X07EA | BIG5格式 | 1824| ISO_10646_UCS_2 | 0X03E8 | ISO_10646_UCS_2格式 | 1825| ISO_8859_1 | 0X04 | ISO_8859_1格式 | 1826| ISO_8859_2 | 0X05 | ISO_8859_2格式 | 1827| ISO_8859_3 | 0X06 | ISO_8859_3格式 | 1828| ISO_8859_4 | 0X07 | ISO_8859_4格式 | 1829| ISO_8859_5 | 0X08 | ISO_8859_5格式 | 1830| ISO_8859_6 | 0X09 | ISO_8859_6格式 | 1831| ISO_8859_7 | 0X0A | ISO_8859_7格式 | 1832| ISO_8859_8 | 0X0B | ISO_8859_8格式 | 1833| ISO_8859_9 | 0X0C | ISO_8859_9格式 | 1834| SHIFT_JIS | 0X11 | SHIFT_JIS格式 | 1835| US_ASCII | 0X03 | US_ASCII格式 | 1836| UTF_8 | 0X6A | UTF_8格式 | 1837 1838## DispositionType<sup>8+</sup> 1839 1840处理类型。 1841 1842**系统接口：** 此接口为系统接口。 1843 1844**系统能力**：SystemCapability.Telephony.SmsMms 1845 1846| 名称 | 值 | 说明 | 1847| ---------- | ---- | -------- | 1848| FROM_DATA | 0 | 数据来源 | 1849| ATTACHMENT | 1 | 附件 | 1850| INLINE | 2 | 内联 | 1851 1852## ReportType<sup>8+</sup> 1853 1854报告类型。 1855 1856**系统接口：** 此接口为系统接口。 1857 1858**系统能力**：SystemCapability.Telephony.SmsMms 1859 1860| 名称 | 值 | 说明 | 1861| ------- | ---- | ---- | 1862| MMS_YES | 128 | YES | 1863| MMS_NO | 129 | NO | 1864 1865## CBConfigOptions<sup>7+</sup> 1866 1867小区广播配置选项。 1868 1869**系统接口：** 此接口为系统接口。 1870 1871**系统能力**：SystemCapability.Telephony.SmsMms 1872 1873| 名称 | 类型 | 必填 | 说明 | 1874| -------------- | -------------------- | ---- | ------------ | 1875| slotId | number | 是 | 卡槽ID | 1876| enable | boolean | 是 | 可行 | 1877| startMessageId | number | 是 | 消息起始ID | 1878| endMessageId | number | 是 | 消息结束ID | 1879| ranType | [RanType](#rantype7) | 是 | 设备网络制式 | 1880 1881## SimMessageStatus<sup>7+</sup> 1882 1883SIM卡消息状态。 1884 1885**系统接口：** 此接口为系统接口。 1886 1887**系统能力**：SystemCapability.Telephony.SmsMms 1888 1889| 名称 | 值 | 说明 | 1890| ------------------------- | ---- | --------------------------- | 1891| SIM_MESSAGE_STATUS_FREE | 0 | SIM卡上的状态可用空间 | 1892| SIM_MESSAGE_STATUS_READ | 1 | 消息已读状态 | 1893| SIM_MESSAGE_STATUS_UNREAD | 3 | 消息未读状态 | 1894| SIM_MESSAGE_STATUS_SENT | 5 | 存储发送消息（仅适用于SMS） | 1895| SIM_MESSAGE_STATUS_UNSENT | 7 | 储未发送消息（仅适用于SMS） | 1896 1897## RanType<sup>7+</sup> 1898 1899设备网络制式。 1900 1901**系统接口：** 此接口为系统接口。 1902 1903**系统能力**：SystemCapability.Telephony.SmsMms 1904 1905| 名称 | 值 | 说明 | 1906| --------- | ---- | ---- | 1907| TYPE_GSM | 1 | GSM | 1908| TYPE_CDMA | 2 | CMDA | 1909 1910## SmsEncodingScheme<sup>8+</sup> 1911 1912短信编码方案。 1913 1914**系统接口：** 此接口为系统接口。 1915 1916**系统能力**：SystemCapability.Telephony.SmsMms 1917 1918| 名称 | 值 | 说明 | 1919| -------------------- | ---- | ------------ | 1920| SMS_ENCODING_UNKNOWN | 0 | 未知短信编码 | 1921| SMS_ENCODING_7BIT | 1 | 7位短信编码 | 1922| SMS_ENCODING_8BIT | 2 | 8位短信编码 | 1923| SMS_ENCODING_16BIT | 3 | 16位短信编码 | 1924 1925## SimMessageOptions<sup>7+</sup> 1926 1927SIM卡消息选项。 1928 1929**系统接口：** 此接口为系统接口。 1930 1931**系统能力**：SystemCapability.Telephony.SmsMms 1932 1933| 名称 | 类型 | 必填 | 说明 | 1934| ------ | -------------------------------------- | ---- | -------------- | 1935| slotId | number | 是 | 卡槽ID | 1936| smsc | string | 是 | 短消息业务中心 | 1937| pdu | string | 是 | 协议数据单元 | 1938| status | [SimMessageStatus](#simmessagestatus7) | 是 | 状态 | 1939 1940## UpdateSimMessageOptions<sup>7+</sup> 1941 1942更新SIM卡消息选项。 1943 1944**系统接口：** 此接口为系统接口。 1945 1946**系统能力**：SystemCapability.Telephony.SmsMms 1947 1948| 名称 | 类型 | 必填 | 说明 | 1949| --------- | -------------------------------------- | ---- | -------------- | 1950| slotId | number | 是 | 卡槽ID | 1951| msgIndex | number | 是 | 消息索引 | 1952| newStatus | [SimMessageStatus](#simmessagestatus7) | 是 | 新状态 | 1953| pdu | string | 是 | 协议数据单元 | 1954| smsc | string | 是 | 短消息业务中心 | 1955 1956## SimShortMessage<sup>7+</sup> 1957 1958SIM卡短消息。 1959 1960**系统接口：** 此接口为系统接口。 1961 1962**系统能力**：SystemCapability.Telephony.SmsMms 1963 1964| 名称 | 类型 | 必填 | 说明 | 1965| ---------------- | -------------------------------------- | ---- | ------------- | 1966| shortMessage | [ShortMessage](#shortmessage) | 是 | 短消息 | 1967| simMessageStatus | [SimMessageStatus](#simmessagestatus7) | 是 | SIM卡消息状态 | 1968| indexOnSim | number | 是 | SIM卡索引 | 1969 1970## MmsDeliveryInd<sup>8+</sup> 1971 1972彩信发送标识。 1973 1974**系统接口：** 此接口为系统接口。 1975 1976**系统能力**：SystemCapability.Telephony.SmsMms 1977 1978| 名称 | 类型 | 必填 | 说明 | 1979| --------- | ---------------------------------- | ---- | ------ | 1980| messageId | string | 是 | 消息ID | 1981| date | number | 是 | 日期 | 1982| to | Array<[MmsAddress](#mmsaddress8)\> | 是 | 发送至 | 1983| status | number | 是 | 状态 | 1984| version | [MmsVersionType](#mmsversiontype8) | 是 | 版本 | 1985 1986## MmsRespInd<sup>8+</sup> 1987 1988彩信回复标志。 1989 1990**系统接口：** 此接口为系统接口。 1991 1992**系统能力**：SystemCapability.Telephony.SmsMms 1993 1994| 名称 | 类型 | 必填 | 说明 | 1995| ------------- | ---------------------------------- | ---- | -------- | 1996| transactionId | string | 是 | 事件ID | 1997| status | number | 是 | 状态 | 1998| version | [MmsVersionType](#mmsversiontype8) | 是 | 版本 | 1999| reportAllowed | [ReportType](#reporttype8) | 否 | 允许报告 | 2000 2001## SmsSegmentsInfo<sup>8+</sup> 2002 2003短信段信息。 2004 2005**系统接口：** 此接口为系统接口。 2006 2007**系统能力**：SystemCapability.Telephony.SmsMms 2008 2009| 名称 | 类型 | 必填 | 说明 | 2010| -------------------- | ---------------------------------------- | ---- | ------------ | 2011| splitCount | number | 是 | 拆分计数 | 2012| encodeCount | number | 是 | 编码计数 | 2013| encodeCountRemaining | number | 是 | 剩余编码计数 | 2014| scheme | [SmsEncodingScheme](#smsencodingscheme8) | 是 | 短信编码方案 | 2015