@ohos.telephony.sms (SMS)

The sms module provides basic SMS management functions. You can create and send SMS messages, and obtain and set the default SIM card for sending and receiving SMS messages. Besides, you can obtain and set the SMSC address, and check whether the current device can send and receive SMS messages.

NOTE

The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

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

sms.createMessage

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

Creates an SMS instance based on the protocol data unit (PDU) and specified SMS protocol. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
pdu	Array<number>	Yes	Protocol data unit, which is obtained from the received SMS message.
specification	string	Yes	SMS protocol type. - 3gpp: GSM/UMTS/LTE SMS - 3gpp2: CDMA SMS
callback	AsyncCallback<ShortMessage>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

const specification: string = '3gpp';
// Display PDUs using numbers in an array, for example, [0x08, 0x91, ...].
const pdu: Array<number> = [0x08, 0x91];
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&lt;number&gt;, specification: string): Promise<ShortMessage>

Creates an SMS instance based on the PDU and specified SMS protocol. This API uses a promise to return the result.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
pdu	Array<number>	Yes	Protocol data unit, which is obtained from the received SMS message.
specification	string	Yes	SMS protocol type. - 3gpp: GSM/UMTS/LTE SMS - 3gpp2: CDMA SMS

Return value

Type	Description
Promise<ShortMessage>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

const specification: string = '3gpp';
// Display PDUs using numbers in an array, for example, [0x08, 0x91, ...].
const pdu: Array<number> = [0x08, 0x91];
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

Sends an SMS message.

NOTE

This API is supported since API version 8 and deprecated since API version 10. You are advised to use sendShortMessage.

Required permissions: ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
options	SendMessageOptions	Yes	Options (including the callback) for sending SMS messages. For details, see SendMessageOptions.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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: 'SMS message content';
    destinationHost: '+861xxxxxxxxxx',
    serviceCenter: '+861xxxxxxxxxx',
    destinationPort: 1000,
    sendCallback: sendCallback,
    deliveryCallback: deliveryCallback
};
sms.sendMessage(options);

sms.sendShortMessage¹⁰⁺

sendShortMessage(options: SendMessageOptions, callback: AsyncCallback&lt;void&gt;): void

Sends an SMS message. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
options	SendMessageOptions	Yes	Options (including the callback) for sending SMS messages. For details, see SendMessageOptions.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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: 'SMS message 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&lt;void&gt;

Sends an SMS message. This API uses a promise to return the result.

Required permissions: ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
options	SendMessageOptions	Yes	Options (including the callback) for sending SMS messages. For details, see SendMessageOptions.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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: 'SMS message 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.sendMms¹¹⁺

sendMms(context: Context, mmsParams: MmsParams, callback: AsyncCallback&lt;void&gt;): void

Sends an MMS message. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
context	Context	Yes	Application context. For details about the application context of the FA model, see Context. For details about the application context of the stage model, see Context.
mmsParams	MmsParams	Yes	Parameters (including the callback) for sending MMS messages. For details, see MmsParams.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

FA model:

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';
import type Context from './application/BaseContext';

// Obtain the context.
import featureAbility from '@ohos.ability.featureAbility';
let context: Context = featureAbility.getContext();

// Configure the path for storing the PDU of the MMS message.
const sandBoxPath: string = '/data/storage/el2/base/files/';
let filePath: string  = sandBoxPath + 'SendReq.mms';

// Options for sending MMS messages (The MMSC is for reference only.)
let mmsPars: sms.MmsParam = {
  slotId : 0,
  mmsc: 'http://mmsc.myuni.com.cn',
  data: filePath,
  mmsConfig: {
   userAgent:'ua',
   userAgentProfile: 'uaprof'
  }
};

// Call the sendMms API.
sms.sendMms(context, mmsPars, async(err: BusinessError) =>{
  if (err) {
    console.log(`sendMms fail, err : ${String(err)}`);
    return;
  }
  console.log(`sendMms Success`);
})

Stage model:

import UIAbility from '@ohos.app.ability.UIAbility';

// Configure the path for storing the PDU of the MMS message.
const sandBoxPath = '/data/storage/el2/base/files/';
let filePath  = sandBoxPath + 'SendReq.mms';

// Configure the MMS user agent and profile. The default values are ua an uaprof, respectively. The configuration is subject to the carrier's requirements. 
let mmsConf = {
  userAgent:'ua',
  userAgentProfile: 'uaprof'
};

// Options for sending MMS messages (The MMSC is for reference only.)
let mmsPars = {
  slotId : DEFAULT_SLOTID,
  mmsc: 'http://mmsc.myuni.com.cn',
  data: filePath,
  mmsConfig: mmsConf
};

class EntryAbility extends UIAbility {
    onWindowStageCreate(windowStage) {
    sms.sendMms(this.context, mmsPars, async(err) =>{
        if (err) {
            console.log(`sendMms fail, err : ${String(err)}`);
            return;
        }
        console.log(`sendMms Success`);
        })
    }
}

sms.sendMms¹¹⁺

sendMms(context: Context, mmsParams: MmsParams): Promise&lt;void&gt;

Sends an MMS message. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
context	Context	Yes	Application context. For details about the application context of the FA model, see Context. For details about the application context of the stage model, see Context.
mmsParams	MmsParams	Yes	Parameters (including the callback) for sending MMS messages. For details, see MmsParams.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

FA model:

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';
import type Context from './application/BaseContext';
// Obtain the context.
import featureAbility from '@ohos.ability.featureAbility';
let context: Context = featureAbility.getContext();

// Configure the path for storing the PDU of the MMS message.
const sandBoxPath: string = '/data/storage/el2/base/files/';
let filePath: string = sandBoxPath + 'SendReq.mms';

// Options for sending MMS messages (The MMSC is for reference only.)
let mmsPars: sms.MmsParam = {
  slotId: 0,
  mmsc: 'http://mmsc.myuni.com.cn',
  data: filePath,
  mmsConfig: {
   userAgent:'ua',
   userAgentProfile: 'uaprof'
  }
};

// Call the sendMms API.
let promise = sms.sendMms(context, mmsPars);
promise.then(() => {
    console.log(`sendMms success`);
}).catch((err: BusinessError) => {
    console.error(`sendMms failed, promise: err->${JSON.stringify(err)}`);
});

Stage model:

import UIAbility from '@ohos.app.ability.UIAbility';

// Configure the path for storing the PDU of the MMS message.
const sandBoxPath = '/data/storage/el2/base/files/';
let filePath  = sandBoxPath + 'SendReq.mms';

// Configure the MMS user agent and profile. The default values are ua an uaprof, respectively. The configuration is subject to the carrier's requirements. 
let mmsConf = {
  userAgent:'ua',
  userAgentProfile: 'uaprof'
};

// Options for sending MMS messages (The MMSC is for reference only.)
let mmsPars = {
  slotId : DEFAULT_SLOTID,
  mmsc: 'http://mmsc.myuni.com.cn',
  data: filePath,
  mmsConfig: mmsConf
};

class EntryAbility extends UIAbility {
    onWindowStageCreate(windowStage) {
    let promise = sms.sendMms(this.context, mmsPars);
    promise.then(() => {
        console.log(`sendMms success`);
    }).catch(err => {
        console.error(`sendMms failed, promise: err->${JSON.stringify(err)}`);
    });
    }
}

sms.downloadMms¹¹⁺

downloadMms(context: Context, mmsParams: MmsParams, callback: AsyncCallback&lt;void&gt;): void

Downloads an MMS message. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_MMS

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
context	Context	Yes	Application context. For details about the application context of the FA model, see Context. For details about the application context of the stage model, see Context.
mmsParams	MmsParams	Yes	Parameters (including the callback) for downloading MMS messages. For details, see MmsParams.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

FA model:

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';
import type Context from './application/BaseContext';
// Obtain the context.
import featureAbility from '@ohos.ability.featureAbility';
let context: Context = featureAbility.getContext();

// Configure the path for storing the PDU of the MMS message.
const sandBoxPath: string = '/data/storage/el2/base/files/';
let filePath: string = sandBoxPath + 'RetrieveConf.mms';

// Parse the MMS URL from the WAP Push message.
let wapPushUrl: string = 'URL';

// Configure the parameters (including the callback) for downloading MMS messages.
let mmsPars: sms.MmsParam = {
  slotId: 0,
  mmsc: wapPushUrl,
  data: filePath,
  mmsConfig: {
   userAgent:'ua',
   userAgentProfile: 'uaprof'
  }
};

// Call the downloadMms API.
mms.downloadMms(context, mmsPars, async(err: BusinessError) =>{
  if (err) {
    console.log(`downloadMms fail, err : ${toString(err)}`);
    return;
  }
  console.log(`downloadMms Success`);
}

Stage model:

import UIAbility from '@ohos.app.ability.UIAbility';

// Configure the path for storing the PDU of the MMS message.
const sandBoxPath = '/data/storage/el2/base/files/';
let filePath  = sandBoxPath + 'RetrieveConf.mms';

// Parse the MMS URL from the WAP Push message.
let wapPushUrl  = 'URL';

// Configure the MMS user agent and profile. The default values are ua an uaprof, respectively. The configuration is subject to the carrier's requirements. 
let mmsConf = {
  userAgent:'ua',
  userAgentProfile: 'uaprof'
};

// Configure the parameters (including the callback) for downloading MMS messages.
let mmsPars = {
  slotId : DEFAULT_SLOTID,
  mmsc: wapPushUrl,
  data: filePath,
  mmsConfig: mmsConf
};

class EntryAbility extends UIAbility {
    onWindowStageCreate(windowStage) {
    mms.downloadMms(this.context, mmsPars, async(err) =>{
        if (err) {
            console.log(`downloadMms fail, err : ${toString(err)}`);
            return;
        }
        console.log(`downloadMms Success`);
        }
    }
}

sms.downloadMms¹¹⁺

downloadMms(context: Context, mmsParams: MmsParams): Promise&lt;void&gt;

Sends an MMS message. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_MMS

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
context	Context	Yes	Application context. For details about the application context of the FA model, see Context. For details about the application context of the stage model, see Context.
mmsParams	MmsParams	Yes	Parameters (including the callback) for sending MMS messages. For details, see MmsParams.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

FA model:

import sms from '@ohos.telephony.sms';
import { BusinessError } from '@ohos.base';
import type Context from './application/BaseContext';
// Obtain the context.
import featureAbility from '@ohos.ability.featureAbility';
let context: Context = featureAbility.getContext();

// Configure the path for storing the PDU of the MMS message.
const sandBoxPath: string = '/data/storage/el2/base/files/';
let filePath: string = sandBoxPath + 'RetrieveConf.mms';

// Parse the MMS URL from the WAP Push message.
let wapPushUrl: string = 'URL';

// Configure the parameters (including the callback) for downloading MMS messages.
let mmsPars: sms.MmsParam = {
  slotId: 0,
  mmsc: wapPushUrl,
  data: filePath,
  mmsConfig: {
   userAgent:'ua',
   userAgentProfile: 'uaprof'
  }
};

// Call the sendMms API.
let promise = sms.downloadMms(context, mmsPars);
promise.then(() => {
    console.log(`downloadMms success`);
}).catch((err: BusinessError) => {
    console.error(`downloadMms failed, promise: err->${JSON.stringify(err)}`);
});

Stage model:

import UIAbility from '@ohos.app.ability.UIAbility';

// Configure the path for storing the PDU of the MMS message.
const sandBoxPath = '/data/storage/el2/base/files/';
let filePath  = sandBoxPath + 'RetrieveConf.mms';

// Parse the MMS URL from the WAP Push message.
let wapPushUrl  = 'URL';

// Configure the MMS user agent and profile. The default values are ua an uaprof, respectively. The configuration is subject to the carrier's requirements. 
let mmsConf = {
  userAgent:'ua',
  userAgentProfile: 'uaprof'
};

// Configure the parameters (including the callback) for downloading MMS messages.
let mmsPars = {
  slotId : DEFAULT_SLOTID,
  mmsc: wapPushUrl,
  data: filePath,
  mmsConfig: mmsConf
};

class EntryAbility extends UIAbility {
    onWindowStageCreate(windowStage) {
    let promise = sms.downloadMms(this.context, mmsPars);
    promise.then(() => {
        console.log(`downloadMms success`);
    }).catch(err => {
        console.error(`downloadMms failed, promise: err->${JSON.stringify(err)}`);
    });
    }
}

sms.getDefaultSmsSlotId⁷⁺

getDefaultSmsSlotId(callback: AsyncCallback&lt;number&gt;): void

Obtains the default slot ID of the SIM card used to send SMS messages. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<number>	Yes	Callback used to return the result. - 0: card slot 1 - 1: card slot 2

Example

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&lt;number&gt;

Obtains the default slot ID of the SIM card used to send SMS messages. This API uses a promise to return the result.

System capability: SystemCapability.Telephony.SmsMms

Return value

Type	Description
Promise<number>	Promise used to return the result. - 0: card slot 1 - 1: card slot 2

Example

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&lt;void&gt;): void

Sets the default slot ID of the SIM card used to send SMS messages. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2 - -1: Clears the default configuration.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300004	Do not have sim card.
8300999	Unknown error code.

Example

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&lt;void&gt;

Sets the default slot ID of the SIM card used to send SMS messages. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.SET_TELEPHONY_STATE

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2 - -1: Clears the default configuration.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300004	Do not have sim card.
8300999	Unknown error code.

Example

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

Sets the short message service center (SMSC) address. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.SET_TELEPHONY_STATE (a system permission)

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2
smscAddr	string	Yes	SMSC address.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>

Sets the SMSC address. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.SET_TELEPHONY_STATE (a system permission)

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2
smscAddr	string	Yes	SMSC address.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Obtains the SMSC address. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.GET_TELEPHONY_STATE (a system permission)

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2
callback	AsyncCallback<string>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>

Obtains the SMSC address. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.GET_TELEPHONY_STATE (a system permission)

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2

Return value

Type	Description
Promise<string>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Checks whether the current device can send and receive SMS messages. This API works in synchronous mode.

System capability: SystemCapability.Telephony.SmsMms

Return value

Type	Description
boolean	- true: The device can send and receive SMS messages. - false: The device cannot send or receive SMS messages.

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

Splits an SMS message into multiple segments. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
content	string	Yes	SMS message content. The value cannot be null.
callback	AsyncCallback>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>>

Splits an SMS message into multiple segments. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
content	string	Yes	SMS message content. The value cannot be null.

Return value

Type	Description
Promise>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Adds a SIM message. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_SMS and ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
options	SimMessageOptions	Yes	SIM message options.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>

Adds a SIM message. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_SMS and ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
options	SimMessageOptions	Yes	SIM message options.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Deletes a SIM message. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_SMS and ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2
msgIndex	number	Yes	Message index.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>

Deletes a SIM message. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_SMS and ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2
msgIndex	number	Yes	Message index.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Updates a SIM message. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_SMS and ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
options	UpdateSimMessageOptions	Yes	SIM message updating options.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>

Updates a SIM message. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_SMS and ohos.permission.SEND_MESSAGES

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
options	UpdateSimMessageOptions	Yes	SIM message updating options.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Obtains all SIM card messages. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_SMS

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2
callback	AsyncCallback>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>>

Obtains all SIM card messages. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_SMS

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2

Return value

Type	Description
PromiseArray<SimShortMessage>&gt;	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Sets the cell broadcast configuration. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_SMS

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
options	CBConfigOptions	Yes	Cell broadcast configuration options.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>

Sets the cell broadcast configuration. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.RECEIVE_SMS

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
options	CBConfigOptions	Yes	Cell broadcast configuration options.

Return value

Type	Description
Promise<void>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
201	Permission denied.
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Obtains SMS message segment information. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2
message	string	Yes	SMS message.
force7bit	boolean	Yes	Whether to use 7-bit coding.
callback	AsyncCallback<SmsSegmentsInfo>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>

Obtains SMS message segment information. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2
message	string	Yes	SMS message.
force7bit	boolean	Yes	Whether to use 7-bit coding.

Return value

Type	Description
Promise<SmsSegmentsInfo>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Checks whether SMS is supported on IMS. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	SIM card slot ID. - 0: card slot 1 - 1: card slot 2
callback	AsyncCallback<boolean>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>

Checks whether SMS is supported on IMS. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID. - 0: card slot 1 - 1: card slot 2

Return value

Type	Description
Promise<boolean>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Obtains the SMS format supported by the IMS. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<string>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>

Obtains the SMS format supported by the IMS. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Return value

Type	Description
Promise<string>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

Decodes MMS messages. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
mmsFilePathName	string |Array	Yes	MMS message file path.
callback	AsyncCallback<MmsInformation>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>

Decodes MMS messages. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
mmsFilePathName	string |Array	Yes	MMS message file path.

Return value

Type	Description
Promise<<MmsInformation>>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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

MMS message code. This API uses an asynchronous callback to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
mms	MmsInformation	Yes	MMS message information.
callback	AsyncCallback<Array>	Yes	Callback used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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>>

MMS message code. This API uses a promise to return the result.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
mms	MmsInformation	Yes	MMS message information.

Return value

Type	Description
Promise<Array>	Promise used to return the result.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
202	Non-system applications use system APIs.
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300999	Unknown error code.

Example

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&lt;number&gt;): void

Obtains the default ID of the SIM card used to send SMS messages. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Telephony.SmsMms

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<number>	Yes	Callback used to return the result. The return value is bound to the SIM card and increases from 1.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
401	Parameter error.
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300004	Do not have sim card.
8300999	Unknown error code.
8301001	SIM card is not activated.

Example

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&lt;number&gt;

Obtains the default ID of the SIM card used to send SMS messages. This API uses a promise to return the result.

System capability: SystemCapability.Telephony.SmsMms

Return value

Type	Description
Promise<number>	Promise used to return the result. The return value is bound to the SIM card and increases from 1.

Error codes

For details about the following error codes, see Telephony Error Codes.

ID	Error Message
8300001	Invalid parameter value.
8300002	Operation failed. Cannot connect to service.
8300003	System internal error.
8300004	Do not have sim card.
8300999	Unknown error code.
8301001	SIM card is not activated.

Example

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

Defines an SMS message instance.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
hasReplyPath	boolean	Yes	Whether the received SMS contains TP-Reply-Path. The default value is false. TP-Reply-Path: The device returns a response based on the SMSC that sends the SMS message.
isReplaceMessage	boolean	Yes	Whether the received SMS message is a replace short message. The default value is false. For details, see section 9.2.3.9 in 3GPP TS 23.040.
isSmsStatusReportMessage	boolean	Yes	Whether the received SMS message is an SMS delivery report. The default value is false. SMS delivery report: a message sent from the SMSC to show the current status of the SMS message you delivered.
messageClass	ShortMessageClass	Yes	Enumerates SMS message types.
pdu	Array<number>	Yes	PDU in the SMS message.
protocolId	number	Yes	Protocol identifier used for delivering the SMS message.
scAddress	string	Yes	SMSC address.
scTimestamp	number	Yes	SMSC timestamp.
status	number	Yes	SMS message status sent by the SMSC in the SMS-STATUS-REPORT message.
visibleMessageBody	string	Yes	SMS message body.
visibleRawAddress	string	Yes	Sender address.

ShortMessageClass

Enumerates SMS message types.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
UNKNOWN	0	Unknown type.
INSTANT_MESSAGE	1	Instant message, which is displayed immediately after being received.
OPTIONAL_MESSAGE	2	Message stored in the device or SIM card.
SIM_MESSAGE	3	Message containing SIM card information, which is to be stored in the SIM card.
FORWARD_MESSAGE	4	Message to be forwarded to another device.

SendMessageOptions

Provides the options (including callbacks) for sending SMS messages. For example, you can specify the SMS message type by the optional parameter content.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
slotId	number	Yes	Slot ID of the SIM card used for sending SMS messages. - 0: card slot 1 - 1: card slot 2
destinationHost	string	Yes	Destination address of the SMS message.
content	string |Array<number>	Yes	SMS message type. If the content is composed of character strings, the SMS message is a text message. If the content is composed of byte arrays, the SMS message is a data message.
serviceCenter	string	No	SMSC address. By default, the SMSC address in the SIM card is used.
destinationPort	number	No	Destination port of the SMS message. This field is mandatory only for a data message. Otherwise, it is optional.
sendCallback	AsyncCallback<ISendShortMessageCallback>	No	Callback used to return the SMS message sending result. For details, see ISendShortMessageCallback.
deliveryCallback	AsyncCallback<IDeliveryShortMessageCallback>	No	Callback used to return the SMS message delivery report. For details, see IDeliveryShortMessageCallback.

MmsParams¹¹⁺

Defines the parameters for sending SMS messages.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
slotId11+	number	Yes	Slot ID of the SIM card used for sending SMS messages. - 0: card slot 1 - 1: card slot 2
mmsc11+	string	Yes	MMSC address.
data11+	string	Yes	MMS PDU address.
mmsConfig11+	MmsConfig	No	MMS configuration file. For details, see MmsConfig.

MmsConfig¹¹⁺

MMS configuration file.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
userAgent11+	string	Yes	User agent.
userAgentProfile11+	string	Yes	User agent profile.

ISendShortMessageCallback

Provides the callback for the SMS message sending result. It consists of three parts: SMS message sending result, URI for storing the sent SMS message, and whether the SMS message is the last part of a long SMS message.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
isLastPart	boolean	No	Whether this SMS message is the last part of a long SMS message. The value true indicates that this SMS message is the last part of a long SMS message, and value false indicates the opposite. The default value is false.
result	SendSmsResult	Yes	SMS message sending result.
url	string	Yes	URI for storing the sent SMS message.

IDeliveryShortMessageCallback

Provides the callback for the SMS message delivery report.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
pdu	Array<number>	Yes	SMS message delivery report.

SendSmsResult

Enumerates SMS message sending results.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
SEND_SMS_SUCCESS	0	The SMS message is sent successfully.
SEND_SMS_FAILURE_UNKNOWN	1	Failed to send the SMS message due to an unknown reason.
SEND_SMS_FAILURE_RADIO_OFF	2	Failed to send the SMS message because the modem is shut down.
SEND_SMS_FAILURE_SERVICE_UNAVAILABLE	3	Failed to send the SMS message because the network is unavailable or SMS message sending or receiving is not supported.

MmsInformation⁸⁺

Defines the MMS message information.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
messageType	MessageType	Yes	Message type.
mmsType	MmsSendReq |MmsSendConf |MmsNotificationInd |MmsRespInd |MmsRetrieveConf|MmsAcknowledgeInd|MmsDeliveryInd|MmsReadOrigInd|MmsReadRecInd	Yes	PDU header type.
attachment	Array<MmsAttachment>	No	Attachment.

MmsSendReq⁸⁺

Defines an MMS message sending request.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
from	MmsAddress	Yes	MMS message source.
transactionId	string	Yes	Transaction ID.
contentType	string	Yes	Content type.
version	MmsVersionType	Yes	Version.
to	Array<MmsAddress>	No	Destination address.
date	number	No	Date.
cc	Array<MmsAddress>	No	Carbon copy.
bcc	Array<MmsAddress>	No	Blind carbon copy.
subject	string	No	Subject.
messageClass	number	No	Message class.
expiry	number	No	Expiration.
priority	MmsPriorityType	No	Priority.
senderVisibility	number	No	Sender visibility.
deliveryReport	number	No	Delivery report.
readReport	number	No	Read report.

MmsSendConf⁸⁺

Defines the MMS message sending configuration.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
responseState	number	Yes	Response status.
transactionId	string	Yes	Transaction ID.
version	MmsVersionType	Yes	Version.
messageId	string	No	Message ID.

MmsNotificationInd⁸⁺

Defines an MMS notification index.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
transactionId	string	Yes	Transaction ID.
messageClass	number	Yes	Message class.
messageSize	number	Yes	Message size.
expiry	number	Yes	Expiration.
contentLocation	string	Yes	Content location.
version	MmsVersionType	Yes	Version.
from	MmsAddress	No	Source address.
subject	string	No	Subject.
deliveryReport	number	No	Status report.
contentClass	number	No	Content class.

MmsAcknowledgeInd⁸⁺

Defines an MMS confirmation index.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
transactionId	string	Yes	Transaction ID.
version	MmsVersionType	Yes	Version.
reportAllowed	ReportType	No	Report allowed.

MmsRetrieveConf⁸⁺

Defines the MMS message retrieval configuration.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
transactionId	string	Yes	Transaction ID.
messageId	string	Yes	Message ID.
date	number	Yes	Date.
contentType	string	Yes	Content type.
to	Array<MmsAddress>	Yes	Destination address.
version	MmsVersionType	Yes	Version.
from	MmsAddress	No	Source address.
cc	Array<MmsAddress>	No	Carbon copy.
subject	string	No	Subject.
priority	MmsPriorityType	No	Priority.
deliveryReport	number	No	Status report.
readReport	number	No	Read report.
retrieveStatus	number	No	Retrieval status.
retrieveText	string	No	Retrieval text.

MmsReadOrigInd⁸⁺

Defines the original MMS message reading index.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
version	MmsVersionType	Yes	Version.
messageId	string	Yes	Message ID.
to	Array<MmsAddress>	Yes	Destination address.
from	MmsAddress	Yes	Source address.
date	number	Yes	Date.
readStatus	number	Yes	Read status.

MmsReadRecInd⁸⁺

Defines the MMS message reading index.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
version	MmsVersionType	Yes	Version.
messageId	string	Yes	Message ID.
to	Array<MmsAddress>	Yes	Destination address.
from	MmsAddress	Yes	Source address.
readStatus	number	Yes	Read status.
date	number	No	Date.

MmsAttachment⁸⁺

Defines the attachment of an MMS message.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
contentId	string	Yes	Content ID.
contentLocation	string	Yes	Content location.
contentDisposition	DispositionType	Yes	Content disposition.
contentTransferEncoding	string	Yes	Encoding for content transfer.
contentType	string	Yes	Content type.
isSmil	boolean	Yes	Whether the synchronized multimedia integration language is used.
path	string	No	Path.
inBuff	Array	No	Whether the message is in the buffer.
fileName	string	No	File name.
charset	MmsCharSets	No	Character set.

MmsAddress⁸⁺

Defines an MMSC address.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
address	string	Yes	Network address.
charset	MmsCharSets	Yes	Character set.

MessageType⁸⁺

Message type.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
TYPE_MMS_SEND_REQ	128	MMS message sending request.
TYPE_MMS_SEND_CONF	129	MMS message sending configuration.
TYPE_MMS_NOTIFICATION_IND	130	MMS notification index.
TYPE_MMS_RESP_IND	131	MMS message response index.
TYPE_MMS_RETRIEVE_CONF	132	MMS message retrieval configuration.
TYPE_MMS_ACKNOWLEDGE_IND	133	MMS message acknowledgement index.
TYPE_MMS_DELIVERY_IND	134	MMS message delivery index.
TYPE_MMS_READ_REC_IND	135	MMS message reading and receiving index.
TYPE_MMS_READ_ORIG_IND	136	Original MMS message reading index.

MmsPriorityType⁸⁺

Enumerates MMS message priorities.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
MMS_LOW	128	Low priority.
MMS_NORMAL	129	Normal priority.
MMS_HIGH	130	High priority.

MmsVersionType⁸⁺

Enumerates MMS versions.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
MMS_VERSION_1_0	0x10	MMS version 1_0.
MMS_VERSION_1_1	0x11	MMS version 1_1.
MMS_VERSION_1_2	0x12	MMS version 1_2.
MMS_VERSION_1_3	0x13	MMS version 1_3.

MmsCharSets⁸⁺

Enumerates MMS character sets.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
BIG5	0X07EA	BIG5 format.
ISO_10646_UCS_2	0X03E8	ISO_10646_UCS_2 format.
ISO_8859_1	0X04	ISO_8859_1 format.
ISO_8859_2	0X05	ISO_8859_2 format.
ISO_8859_3	0X06	ISO_8859_3 format.
ISO_8859_4	0X07	ISO_8859_4 format.
ISO_8859_5	0X08	ISO_8859_5 format.
ISO_8859_6	0X09	ISO_8859_6 format.
ISO_8859_7	0X0A	ISO_8859_7 format.
ISO_8859_8	0X0B	ISO_8859_8 format.
ISO_8859_9	0X0C	ISO_8859_9 format.
SHIFT_JIS	0X11	SHIFT_JIS format.
US_ASCII	0X03	US_ASCII format.
UTF_8	0X6A	UTF_8 format.

DispositionType⁸⁺

Enumerates disposition types.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
FROM_DATA	0	Data source.
ATTACHMENT	1	Attachment.
INLINE	2	Inlining.

ReportType⁸⁺

Enumerates report types.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
MMS_YES	128	YES
MMS_NO	129	NO

CBConfigOptions⁷⁺

Defines the cell broadcast configuration options.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID.
enable	boolean	Yes	Whether to enable cell broadcast.
startMessageId	number	Yes	Start message ID.
endMessageId	number	Yes	End message ID.
ranType	RanType	Yes	RAN type.

SimMessageStatus⁷⁺

Defines the SIM message status.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
SIM_MESSAGE_STATUS_FREE	0	Free state.
SIM_MESSAGE_STATUS_READ	1	Read state.
SIM_MESSAGE_STATUS_UNREAD	3	Unread state.
SIM_MESSAGE_STATUS_SENT	5	Storage of sent messages (applicable only to SMS).
SIM_MESSAGE_STATUS_UNSENT	7	Storage of unsent messages (applicable only to SMS).

RanType⁷⁺

RAN type.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
TYPE_GSM	1	GSM
TYPE_CDMA	2	CMDA

SmsEncodingScheme⁸⁺

Enumerates SMS encoding schemes.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Value	Description
SMS_ENCODING_UNKNOWN	0	Unknown code.
SMS_ENCODING_7BIT	1	7-digit code.
SMS_ENCODING_8BIT	2	8-digit code.
SMS_ENCODING_16BIT	3	16-digit code.

SimMessageOptions⁷⁺

Defines the SIM message options.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID.
smsc	string	Yes	Short message service center.
pdu	string	Yes	Protocol data unit.
status	SimMessageStatus	Yes	Status.

UpdateSimMessageOptions⁷⁺

Defines the updating SIM message options.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
slotId	number	Yes	Card slot ID.
msgIndex	number	Yes	Message index.
newStatus	SimMessageStatus	Yes	New status.
pdu	string	Yes	Protocol data unit.
smsc	string	Yes	Short message service center.

SimShortMessage⁷⁺

Defines a SIM message.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
shortMessage	ShortMessage	Yes	SMS message.
simMessageStatus	SimMessageStatus	Yes	SIM message status.
indexOnSim	number	Yes	SIM card index.

MmsDeliveryInd⁸⁺

Defines an MMS message delivery index.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
messageId	string	Yes	Message ID.
date	number	Yes	Date.
to	Array<MmsAddress>	Yes	Destination address.
status	number	Yes	Status.
version	MmsVersionType	Yes	Version.

MmsRespInd⁸⁺

Defines an MMS response index.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
transactionId	string	Yes	Event ID.
status	number	Yes	Status.
version	MmsVersionType	Yes	Version.
reportAllowed	ReportType	No	Report allowed.

SmsSegmentsInfo⁸⁺

Defines the SMS message segment information.

System API: This is a system API.

System capability: SystemCapability.Telephony.SmsMms

Name	Type	Mandatory	Description
splitCount	number	Yes	Split count.
encodeCount	number	Yes	Encoding count.
encodeCountRemaining	number	Yes	Remaining encoding count.
scheme	SmsEncodingScheme	Yes	Encoding scheme.

你可能感兴趣的鸿蒙文章

harmony 鸿蒙APIs

harmony 鸿蒙System Common Events (To Be Deprecated Soon)

harmony 鸿蒙System Common Events

harmony 鸿蒙API Reference Document Description

harmony 鸿蒙Enterprise Device Management Overview (for System Applications Only)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager)

harmony 鸿蒙@ohos.distributedBundle (Distributed Bundle Management)

harmony 鸿蒙@ohos.bundle (Bundle)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)