@ohos.telephony.sms (短信服务)

短信服务提供了管理短信的一些基础能力，包括创建、发送短信，获取、设置发送短信的默认SIM卡槽ID，获取、设置短信服务中心（SMSC）地址，以及检查当前设备是否具备短信发送和接收能力等。

说明：

本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import sms from '@ohos.telephony.sms';

sms.createMessage

createMessage(pdu: Array<number>, specification: string, callback: AsyncCallback<ShortMessage>): void

根据协议数据单元（PDU）和指定的短信协议创建短信实例。使用callback异步回调。

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

const specification: string = '3gpp';
// 以数组的形式显示协议数据单元（PDU），类型为number。
const pdu: Array<number> = [0x01, 0x00, 0x05, 0x81, 0x01, 0x80, 0xF6, 0x00, 0x00, 0x05, 0xE8, 0x32, 0x9B, 0xFD, 0x06];
sms.createMessage(pdu, specification, (err: BusinessError, data: sms.ShortMessage) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.createMessage

createMessage(pdu: Array<number>, specification: string): Promise<ShortMessage>

根据协议数据单元（PDU）和指定的短信协议创建短信实例。使用Promise异步回调。

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

const specification: string = '3gpp';
// 以数组的形式显示协议数据单元（PDU），类型为number。
const pdu: Array<number> = [0x01, 0x00, 0x05, 0x81, 0x01, 0x80, 0xF6, 0x00, 0x00, 0x05, 0xE8, 0x32, 0x9B, 0xFD, 0x06];
sms.createMessage(pdu, specification).then((data: sms.ShortMessage) => {
    console.log(`createMessage success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`createMessage failed, promise: err->${JSON.stringify(err)}`);
});

sms.sendMessage^(deprecated)

sendMessage(options: SendMessageOptions): void

发送短信。

说明：

从 API version 6开始支持，从API version 10开始废弃。建议使用sendShortMessage替代。

需要权限：ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { AsyncCallback } from '@ohos.base';
import { BusinessError } from '@ohos.base';

let sendCallback: AsyncCallback<sms.ISendShortMessageCallback> = (err: BusinessError, data: sms.ISendShortMessageCallback[]) => {
    console.log(`sendCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 
};
let deliveryCallback: AsyncCallback<sms.IDeliveryShortMessageCallback> = (err: BusinessError, data: sms.IDeliveryShortMessageCallback) => {
    console.log(`deliveryCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`); 
};
let options: sms.SendMessageOptions = {
    slotId: 0,
    content: '短信内容',
    destinationHost: '+861xxxxxxxxxx',
    serviceCenter: '+861xxxxxxxxxx',
    destinationPort: 1000,
    sendCallback: sendCallback,
    deliveryCallback: deliveryCallback
};
sms.sendMessage(options);

sms.sendShortMessage¹⁰⁺

sendShortMessage(options: SendMessageOptions, callback: AsyncCallback<void>): void

发送短信。使用callback异步回调。

需要权限：ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { AsyncCallback } from '@ohos.base';
import { BusinessError } from '@ohos.base';

let sendCallback: AsyncCallback<sms.ISendShortMessageCallback> = (err: BusinessError, data: sms.ISendShortMessageCallback) => {
    console.log(`sendCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
};
let deliveryCallback: AsyncCallback<sms.IDeliveryShortMessageCallback> = (err: BusinessError, data: sms.IDeliveryShortMessageCallback) => {
    console.log(`deliveryCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
};
let options: sms.SendMessageOptions = {
    slotId: 0,
    content: '短信内容',
    destinationHost: '+861xxxxxxxxxx',
    serviceCenter: '+861xxxxxxxxxx',
    destinationPort: 1000,
    sendCallback: sendCallback,
    deliveryCallback: deliveryCallback
};
sms.sendShortMessage(options, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}`);
});

sms.sendShortMessage¹⁰⁺

sendShortMessage(options: SendMessageOptions): Promise<void>

发送短信。使用Promise异步回调。

需要权限：ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { AsyncCallback } from '@ohos.base';
import { BusinessError } from '@ohos.base';

let sendCallback: AsyncCallback<sms.ISendShortMessageCallback> = (err: BusinessError, data: sms.ISendShortMessageCallback) => {
    console.log(`sendCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
};
let deliveryCallback: AsyncCallback<sms.IDeliveryShortMessageCallback> = (err: BusinessError, data: sms.IDeliveryShortMessageCallback) => {
    console.log(`deliveryCallback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
};
let options: sms.SendMessageOptions = {
    slotId: 0,
    content: '短信内容',
    destinationHost: '+861xxxxxxxxxx',
    serviceCenter: '+861xxxxxxxxxx',
    destinationPort: 1000,
    sendCallback: sendCallback,
    deliveryCallback: deliveryCallback
};
let promise = sms.sendShortMessage(options);
promise.then(() => {
    console.log(`sendShortMessage success`);
}).catch((err: BusinessError) => {
    console.error(`sendShortMessage failed, promise: err->${JSON.stringify(err)}`);
});

sms.getDefaultSmsSlotId⁷⁺

getDefaultSmsSlotId(callback: AsyncCallback<number>): void

获取发送短信的默认SIM卡槽ID。使用callback异步回调。

系统能力：SystemCapability.Telephony.SmsMms

参数：

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

sms.getDefaultSmsSlotId((err: BusinessError, data: number) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.getDefaultSmsSlotId⁷⁺

getDefaultSmsSlotId(): Promise<number>

获取发送短信的默认SIM卡槽ID。使用Promise异步回调。

系统能力：SystemCapability.Telephony.SmsMms

返回值：

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

sms.getDefaultSmsSlotId().then((data: number) => {
    console.log(`getDefaultSmsSlotId success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getDefaultSmsSlotId failed, promise: err->${JSON.stringify(err)}`);
});

sms.setDefaultSmsSlotId⁷⁺

setDefaultSmsSlotId(slotId: number, callback: AsyncCallback<void>): void

设置发送短信的默认SIM卡槽ID。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

sms.setDefaultSmsSlotId(0, (err: BusinessError) => {
    console.log(`callback: err->${JSON.stringify(err)}.`);
});

sms.setDefaultSmsSlotId⁷⁺

setDefaultSmsSlotId(slotId: number): Promise<void>

设置发送短信的默认SIM卡槽ID。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

sms.setDefaultSmsSlotId(0).then(() => {
    console.log(`setDefaultSmsSlotId success.`);
}).catch((err: BusinessError) => {
    console.error(`setDefaultSmsSlotId failed, promise: err->${JSON.stringify(err)}`);
});

sms.setSmscAddr⁷⁺

setSmscAddr(slotId: number, smscAddr: string, callback: AsyncCallback<void>): void

设置短信服务中心（SMSC）地址。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let smscAddr: string = '+861xxxxxxxxxx';
sms.setSmscAddr(slotId, smscAddr, (err: BusinessError) => {
      console.log(`callback: err->${JSON.stringify(err)}`);
});

sms.setSmscAddr⁷⁺

setSmscAddr(slotId: number, smscAddr: string): Promise<void>

设置短信服务中心（SMSC）地址。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SET_TELEPHONY_STATE，该权限为系统权限

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let smscAddr: string = '+861xxxxxxxxxx';
sms.setSmscAddr(slotId, smscAddr).then(() => {
    console.log(`setSmscAddr success.`);
}).catch((err: BusinessError) => {
    console.error(`setSmscAddr failed, promise: err->${JSON.stringify(err)}`);
});

sms.getSmscAddr⁷⁺

getSmscAddr(slotId: number, callback: AsyncCallback<string>): void

获取短信服务中心（SMSC）地址。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
sms.getSmscAddr(slotId, (err: BusinessError, data: string) => {
      console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.getSmscAddr⁷⁺

getSmscAddr(slotId: number): Promise<string>

获取短信服务中心（SMSC）地址。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.GET_TELEPHONY_STATE，该权限为系统权限

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
sms.getSmscAddr(slotId).then((data: string) => {
    console.log(`getSmscAddr success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getSmscAddr failed, promise: err->${JSON.stringify(err)}`);
});

sms.hasSmsCapability⁷⁺

hasSmsCapability(): boolean

检查当前设备是否具备短信发送和接收能力，该方法是同步方法。

系统能力：SystemCapability.Telephony.SmsMms

返回值：

import sms from '@ohos.telephony.sms';

let result = sms.hasSmsCapability(); 
console.log(`hasSmsCapability: ${JSON.stringify(result)}`);

sms.splitMessage⁸⁺

splitMessage(content: string, callback: AsyncCallback<Array<string>>): void

将长短信拆分为多个片段。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let content: string = "long message";
sms.splitMessage(content, (err: BusinessError, data: string[]) => {
      console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.splitMessage⁸⁺

splitMessage(content: string): Promise<Array<string>>

将长短信拆分为多个片段。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let content: string = "long message";
let promise = sms.splitMessage(content);
promise.then((data: string[]) => {
    console.log(`splitMessage success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`splitMessage failed, promise: err->${JSON.stringify(err)}`);
});

sms.addSimMessage⁷⁺

addSimMessage(options: SimMessageOptions, callback: AsyncCallback<void>): void

添加SIM卡消息，sim卡消息满，添加报错。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let simMessageOptions: sms.SimMessageOptions = {
    slotId: 0,
    smsc: "test",
    pdu: "xxxxxx",
    status: sms.SimMessageStatus.SIM_MESSAGE_STATUS_READ
};
sms.addSimMessage(simMessageOptions, (err: BusinessError) => {
      console.log(`callback: err->${JSON.stringify(err)}`);
});

sms.addSimMessage⁷⁺

addSimMessage(options: SimMessageOptions): Promise<void>

添加SIM卡消息，sim卡消息满，添加报错。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let simMessageOptions: sms.SimMessageOptions = {
    slotId: 0,
    smsc: "test",
    pdu: "xxxxxx",
    status: sms.SimMessageStatus.SIM_MESSAGE_STATUS_READ
};
sms.addSimMessage(simMessageOptions).then(() => {
    console.log(`addSimMessage success.`);
}).catch((err: BusinessError) => {
    console.error(`addSimMessage failed, promise: err->${JSON.stringify(err)}`);
});

sms.delSimMessage⁷⁺

delSimMessage(slotId: number, msgIndex: number, callback: AsyncCallback<void>): void

删除SIM卡消息，msgIndex无效时，删除报错。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let msgIndex: number = 1;
sms.delSimMessage(slotId, msgIndex, (err: BusinessError) => {
      console.log(`callback: err->${JSON.stringify(err)}`);
});

sms.delSimMessage⁷⁺

delSimMessage(slotId: number, msgIndex: number): Promise<void>

删除SIM卡消息，msgIndex无效时，删除报错。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let msgIndex: number = 1;
let promise = sms.delSimMessage(slotId, msgIndex);
promise.then(() => {
    console.log(`delSimMessage success.`);
}).catch((err: BusinessError) => {
    console.error(`delSimMessage failed, promise: err->${JSON.stringify(err)}`);
});

sms.updateSimMessage⁷⁺

updateSimMessage(options: UpdateSimMessageOptions, callback: AsyncCallback<void>): void

更新SIM卡消息。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let updateSimMessageOptions: sms.UpdateSimMessageOptions = {
    slotId: 0,
    msgIndex: 1,
    newStatus: sms.SimMessageStatus.SIM_MESSAGE_STATUS_FREE,
    pdu: "xxxxxxx",
    smsc: "test"
};
sms.updateSimMessage(updateSimMessageOptions, (err: BusinessError) => {
      console.log(`callback: err->${JSON.stringify(err)}`);
});

sms.updateSimMessage⁷⁺

updateSimMessage(options: UpdateSimMessageOptions): Promise<void>

更新SIM卡消息。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.RECEIVE_SMS,ohos.permission.SEND_MESSAGES

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let updateSimMessageOptions: sms.UpdateSimMessageOptions = {
    slotId: 0,
    msgIndex: 1,
    newStatus: sms.SimMessageStatus.SIM_MESSAGE_STATUS_FREE,
    pdu: "xxxxxxx",
    smsc: "test"
};
let promise = sms.updateSimMessage(updateSimMessageOptions);
promise.then(() => {
    console.log(`updateSimMessage success.`);
}).catch((err: BusinessError) => {
    console.error(`updateSimMessage failed, promise: err->${JSON.stringify(err)}`);
});

sms.getAllSimMessages⁷⁺

getAllSimMessages(slotId: number, callback: AsyncCallback<Array<SimShortMessage>>): void

获取所有SIM卡消息。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.RECEIVE_SMS

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
sms.getAllSimMessages(slotId, (err: BusinessError, data: sms.SimShortMessage[]) => {
      console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.getAllSimMessages⁷⁺

getAllSimMessages(slotId: number): Promise<Array<SimShortMessage>>

获取所有SIM卡消息。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.RECEIVE_SMS

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let promise = sms.getAllSimMessages(slotId);
promise.then((data: sms.SimShortMessage[]) => {
    console.log(`getAllSimMessages success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getAllSimMessages failed, promise: err->${JSON.stringify(err)}`);
});

sms.setCBConfig⁷⁺

setCBConfig(options: CBConfigOptions, callback: AsyncCallback<void>): void

设置小区广播配置。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.RECEIVE_SMS

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let cbConfigOptions: sms.CBConfigOptions = {
    slotId: 0,
    enable: true,
    startMessageId: 100,
    endMessageId: 200,
    ranType: sms.RanType.TYPE_GSM
};
sms.setCBConfig(cbConfigOptions, (err: BusinessError) => {
      console.log(`callback: err->${JSON.stringify(err)}`);
});

sms.setCBConfig⁷⁺

setCBConfig(options: CBConfigOptions): Promise<void>

设置小区广播配置。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限：ohos.permission.RECEIVE_SMS

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let cbConfigOptions: sms.CBConfigOptions = {
    slotId: 0,
    enable: true,
    startMessageId: 100,
    endMessageId: 200,
    ranType: sms.RanType.TYPE_GSM
};
let promise = sms.setCBConfig(cbConfigOptions);
promise.then(() => {
    console.log(`setCBConfig success.`);
}).catch((err: BusinessError) => {
    console.error(`setCBConfig failed, promise: err->${JSON.stringify(err)}`);
});

sms.getSmsSegmentsInfo⁸⁺

getSmsSegmentsInfo(slotId: number, message: string, force7bit: boolean, callback: AsyncCallback<SmsSegmentsInfo>): void

获取短信段信息。使用callback异步回调。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
sms.getSmsSegmentsInfo(slotId, "message", false, (err: BusinessError, data: sms.SmsSegmentsInfo) => {
      console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.getSmsSegmentsInfo⁸⁺

getSmsSegmentsInfo(slotId: number, message: string, force7bit: boolean): Promise<SmsSegmentsInfo>

获取短信段信息。使用Promise异步回调。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let promise = sms.getSmsSegmentsInfo(slotId, "message", false);
promise.then((data: sms.SmsSegmentsInfo) => {
    console.log(`getSmsSegmentsInfo success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getSmsSegmentsInfo failed, promise: err->${JSON.stringify(err)}`);
});

sms.isImsSmsSupported⁸⁺

isImsSmsSupported(slotId: number, callback: AsyncCallback<boolean>): void

如果IMS已注册并且在IMS上支持SMS，则支持通过IMS发送SMS。使用callback异步回调。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
sms.isImsSmsSupported(slotId, (err: BusinessError, data: boolean) => {
      console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.isImsSmsSupported⁸⁺

isImsSmsSupported(slotId: number): Promise<boolean>

如果IMS已注册并且在IMS上支持SMS，则支持通过IMS发送SMS。使用Promise异步回调。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let slotId: number = 0;
let promise = sms.isImsSmsSupported(slotId);
promise.then((data: boolean) => {
    console.log(`isImsSmsSupported success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`isImsSmsSupported failed, promise: err->${JSON.stringify(err)}`);
});

sms.getImsShortMessageFormat⁸⁺

getImsShortMessageFormat(callback: AsyncCallback<string>): void

获取IMS上支持的SMS格式。使用callback异步回调。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

sms.getImsShortMessageFormat((err: BusinessError, data: string) => {
      console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.getImsShortMessageFormat⁸⁺

getImsShortMessageFormat(): Promise<string>

获取IMS上支持的SMS格式。使用Promise异步回调。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

sms.getImsShortMessageFormat().then((data: string) => {
    console.log(`getImsShortMessageFormat success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getImsShortMessageFormat failed, promise: err->${JSON.stringify(err)}`);
});

sms.decodeMms⁸⁺

decodeMms(mmsFilePathName: string | Array<number>, callback: AsyncCallback<MmsInformation>): void

彩信解码。使用callback异步回调。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let mmsFilePathName: string = "filename";
sms.decodeMms(mmsFilePathName, (err: BusinessError, data: sms.MmsInformation) => {
      console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.decodeMms⁸⁺

decodeMms(mmsFilePathName: string | Array<number>): Promise<MmsInformation>

彩信解码。使用Promise异步回调。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let mmsFilePathName: string = "filename";
let promise = sms.decodeMms(mmsFilePathName);
promise.then((data: sms.MmsInformation) => {
    console.log(`decodeMms success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`decodeMms failed, promise: err->${JSON.stringify(err)}`);
});

sms.encodeMms⁸⁺

encodeMms(mms: MmsInformation, callback: AsyncCallback<Array<number>>): void

彩信编码。使用callback异步回调。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let mmsAcknowledgeInd: sms.MmsAcknowledgeInd = {
    transactionId: "100",
    version: sms.MmsVersionType.MMS_VERSION_1_0,
    reportAllowed: sms.ReportType.MMS_YES
};
let mmsInformation: sms.MmsInformation = {
    messageType: sms.MessageType.TYPE_MMS_ACKNOWLEDGE_IND,
    mmsType: mmsAcknowledgeInd
};
sms.encodeMms(mmsInformation, (err: BusinessError, data: number[]) => {
      console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.encodeMms⁸⁺

encodeMms(mms: MmsInformation): Promise<Array<number>>

彩信编码。使用Promise异步回调。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let mmsAcknowledgeInd: sms.MmsAcknowledgeInd = {
    transactionId: "100",
    version: sms.MmsVersionType.MMS_VERSION_1_0,
    reportAllowed: sms.ReportType.MMS_YES
};
let mmsInformation: sms.MmsInformation = {
    messageType: sms.MessageType.TYPE_MMS_ACKNOWLEDGE_IND,
    mmsType: mmsAcknowledgeInd
};
sms.encodeMms(mmsInformation).then((data: number[]) => {
    console.log(`encodeMms success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`encodeMms failed, promise: err->${JSON.stringify(err)}`);
});

sms.getDefaultSmsSimId¹⁰⁺

getDefaultSmsSimId(callback: AsyncCallback<number>): void

获取发送短信的默认SIM卡ID。使用callback异步回调。

系统能力：SystemCapability.Telephony.SmsMms

参数：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

sms.getDefaultSmsSimId((err: BusinessError, data: number) => {
    console.log(`callback: err->${JSON.stringify(err)}, data->${JSON.stringify(data)}`);
});

sms.getDefaultSmsSimId¹⁰⁺

getDefaultSmsSimId(): Promise<number>

获取发送短信的默认SIM卡ID。使用Promise异步回调。

系统能力：SystemCapability.Telephony.SmsMms

返回值：

错误码：

以下错误码的详细介绍请参见ohos.telephony(电话子系统)错误码。

示例：

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';

let promise = sms.getDefaultSmsSimId();
promise.then((data: number) => {
    console.log(`getDefaultSmsSimId success, promise: data->${JSON.stringify(data)}`);
}).catch((err: BusinessError) => {
    console.error(`getDefaultSmsSimId failed, promise: err->${JSON.stringify(err)}`);
});

ShortMessage

短信实例。

系统能力：SystemCapability.Telephony.SmsMms

ShortMessageClass

短信类型。

系统能力：SystemCapability.Telephony.SmsMms

SendMessageOptions

发送短信的参数和回调。根据SendMessageOptions中的可选参数content的值判断短信类型。

系统能力：SystemCapability.Telephony.SmsMms

ISendShortMessageCallback

回调实例。返回短信发送结果、存储已发送短信的URI和是否为长短信的最后一部分。

系统能力：SystemCapability.Telephony.SmsMms

IDeliveryShortMessageCallback

回调实例，返回短信送达报告。

系统能力：SystemCapability.Telephony.SmsMms

SendSmsResult

短信发送结果。

系统能力：SystemCapability.Telephony.SmsMms

MmsInformation⁸⁺

彩信信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsSendReq⁸⁺

彩信发送请求。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsSendConf⁸⁺

彩信发送配置。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsNotificationInd⁸⁺

彩信通知索引。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsAcknowledgeInd⁸⁺

彩信确认索引。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsRetrieveConf⁸⁺

彩信检索配置。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsReadOrigInd⁸⁺

彩信读取原始索引。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsReadRecInd⁸⁺

彩信读取记录索引。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsAttachment⁸⁺

彩信附件。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsAddress⁸⁺

彩信地址。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MessageType⁸⁺

消息类型。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsPriorityType⁸⁺

彩信优先级类型。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsVersionType⁸⁺

彩信版本类型。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsCharSets⁸⁺

彩信字符集。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

DispositionType⁸⁺

处理类型。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

ReportType⁸⁺

报告类型。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

CBConfigOptions⁷⁺

小区广播配置选项。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

SimMessageStatus⁷⁺

SIM卡消息状态。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

RanType⁷⁺

设备网络制式。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

SmsEncodingScheme⁸⁺

短信编码方案。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

SimMessageOptions⁷⁺

SIM卡消息选项。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

UpdateSimMessageOptions⁷⁺

更新SIM卡消息选项。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

SimShortMessage⁷⁺

SIM卡短消息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsDeliveryInd⁸⁺

彩信发送标识。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

MmsRespInd⁸⁺

彩信回复标志。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms

SmsSegmentsInfo⁸⁺

短信段信息。

系统接口： 此接口为系统接口。

系统能力：SystemCapability.Telephony.SmsMms