程序包 ohos.telephony

类 ShortMessageManager

java.lang.Object

ohos.telephony.ShortMessageManager

public class ShortMessageManager
extends Object

Provides the capabilities and methods for obtaining Short Message Service (SMS) management objects.

This class is a singleton class. Applications can use the getInstance method to obtain an instance and then use the instance to invoke the methods to manage SMS operations, for example, sending SMS messages or checking whether a device supports SMS.

从以下版本开始:

1

方法概要

限定符和类型	方法	说明
int	getDefaultSmsSlotId()	Obtains the default SIM card for sending SMS messages.
static ShortMessageManager	getInstance(Context context)	Obtains an instance of ShortMessageManager.
String	getSmscAddr(int slotId)	Obtains the SMSC address based on a specified slot ID.
boolean	hasSmsCapability()	Returns whether a device is capable of sending and receiving SMS messages.
void	sendMessage(int slotId, String destinationHost, String serviceCenter, byte[] data, short destinationPort, ISendShortMessageCallback sendCallback, IDeliveryShortMessageCallback deliveryCallback)	Sends a data SMS message.
void	sendMessage(int slotId, String destinationHost, String serviceCenter, String content, ISendShortMessageCallback sendCallback, IDeliveryShortMessageCallback deliveryCallback)	Sends a text SMS message.
boolean	setSmscAddr(int slotId, String smscAddr)	Sets the address for the Short Message Service Center (SMSC) based on a specified slot ID.
ArrayList<String>	splitMessage(String content)	Splits a long SMS message into multiple fragments.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

getInstance

public static ShortMessageManager getInstance(Context context)

Obtains an instance of ShortMessageManager.

If the ID of the default SIM card used for sending SMS messages changes, the ShortMessageManager instance changes accordingly. You can obtain the default SIM card by using getDefaultSmsSlotId.

参数:

context - Indicates the context of the application to invoke.

返回:

Returns an instance of ShortMessageManager.

从以下版本开始:

1

getDefaultSmsSlotId

public int getDefaultSmsSlotId()

Obtains the default SIM card for sending SMS messages.

返回:

Returns 0 if the default SIM card for sending SMS messages is in card slot 1; returns 1 if the default SIM card for sending SMS messages is in card slot 2.

从以下版本开始:

1

hasSmsCapability

public boolean hasSmsCapability()

Returns whether a device is capable of sending and receiving SMS messages.

返回:

Returns true if the device is capable of sending and receiving SMS messages; returns false otherwise.

从以下版本开始:

4

splitMessage

public ArrayList<String> splitMessage(String content)

Splits a long SMS message into multiple fragments.

If the length of an SMS message exceeds the maximum length allowed (140 bytes), the SMS message is split into multiple segments for processing.

Applications must have the ohos.permission.SEND_MESSAGES permission to call this method.

参数:

content - Indicates the short message content, which cannot be null.

返回:

Returns a list of split segments, which can be combined into a complete SMS message; returns an empty string if no permission is granted or the short message content is null.

从以下版本开始:

4

另请参阅:

sendMessage(int, java.lang.String, java.lang.String, java.lang.String, ohos.telephony.ISendShortMessageCallback, ohos.telephony.IDeliveryShortMessageCallback)

sendMessage

public void sendMessage(int slotId,
                        String destinationHost,
                        String serviceCenter,
                        String content,
                        ISendShortMessageCallback sendCallback,
                        IDeliveryShortMessageCallback deliveryCallback)

Sends a text SMS message.

This method checks whether the length of an SMS message exceeds the maximum length. If the maximum length is exceeded, the SMS message is split into multiple parts and sent separately.

You need to obtain the following permission before calling this method: SystemPermission.SEND_MESSAGES

参数:

slotId - Indicates the ID of the SIM card slot used for sending the SMS message.

destinationHost - Indicates the address to which the SMS message is sent.

serviceCenter - Indicates the short message service center (SMSC) address. If the value is null, the default SMSC address of the SIM card is used.

content - Indicates the content of the SMS message. If the length of the content exceeds the maximum length, this SMS message is split into multiple parts.

sendCallback - Indicates the callback invoked after the SMS message is sent.

deliveryCallback - Indicates the callback invoked after the SMS message is delivered.

从以下版本开始:

4

sendMessage

public void sendMessage(int slotId,
                        String destinationHost,
                        String serviceCenter,
                        byte[] data,
                        short destinationPort,
                        ISendShortMessageCallback sendCallback,
                        IDeliveryShortMessageCallback deliveryCallback)

Sends a data SMS message.

You need to obtain the following permission before calling this method: SystemPermission.SEND_MESSAGES

参数:

slotId - Indicates the ID of the SIM card slot used for sending the SMS message.

destinationHost - Indicates the address to which the SMS message is sent.

serviceCenter - Indicates the SMSC address. If the value is null, the default SMSC address of the SIM card is used.

data - Indicates the content of the SMS message.

destinationPort - Indicates the destination port for sending the SMS message.

sendCallback - Indicates the callback invoked after the SMS message is sent.

deliveryCallback - Indicates the callback invoked after the SMS message is delivered.

抛出:

IllegalArgumentException - if the argument data is null or slotId is invalid.

从以下版本开始:

4

setSmscAddr

public boolean setSmscAddr(int slotId,
                           String smscAddr)

Sets the address for the Short Message Service Center (SMSC) based on a specified slot ID.

Permissions: SystemPermission.SET_TELEPHONY_STATE

参数:

slotId - Indicates the ID of the slot holding the SIM card for sending SMS messages.

smscAddr - Indicates the SMSC address.

返回:

Returns true if the operation is successful; returns false otherwise.

从以下版本开始:

5

getSmscAddr

public String getSmscAddr(int slotId)

Obtains the SMSC address based on a specified slot ID.

Permissions: SystemPermission.GET_TELEPHONY_STATE

参数:

slotId - Indicates the ID of the slot holding the SIM card for sending SMS messages.

返回:

Returns the SMSC address.

从以下版本开始:

5