com.docomo_um.module.net
インタフェース ShortMessageListener

public interface ShortMessageListener

メッセージの状態を通知するリスナクラスです。

メソッドの概要

void	onAreaMailReceived(ShortMessage message, boolean override) エリアメール(CBS・ETWS)を受信した場合にコールされます。
void	onSMSBoxFull(MessageBox messageBox) SMS、または、SMSステータスレポートを受信できなかった場合にコールされます。
void	onSMSReceived(MessageBox messageBox, int messageNumber, boolean override) SMS、または、SMSステータスレポートのメッセージを受信した場合にコールされます。

メソッドの詳細

onSMSReceived

void onSMSReceived(MessageBox messageBox,
                   int messageNumber,
                   boolean override)

SMS、または、SMSステータスレポートのメッセージを受信した場合にコールされます。

受信時のメッセージは ShortMessage.STAT_UNREAD 状態です。 本メソッドの引数messageBoxに設定するMessageBoxのインスタンスは、ShortMessageManager.getShortMessageBox()、 またはShortMessageManager.getSMSStatusReportBox()で取得するインスタンスと同一のインスタンスです。

パラメータ:

messageBox - 受信したメッセージを格納したメッセージボックスが設定されます。

messageNumber - 受信したメッセージのメッセージ番号が設定されます。

override - 受信メッセージが他のメッセージを上書きして保存された場合はtrue、それ以外の場合はfalseが指定されます。

onAreaMailReceived

void onAreaMailReceived(ShortMessage message,
                        boolean override)

エリアメール(CBS・ETWS)を受信した場合にコールされます。

本メソッドを用いてエリアメールを受信した際、メッセージは ShortMessage.STAT_READ 状態です。

パラメータ:

message - 受信したメッセージが設定されます。

override - 受信メッセージが他のメッセージを上書きして保存された場合はtrue、それ以外の場合はfalseが指定されます。

onSMSBoxFull

void onSMSBoxFull(MessageBox messageBox)

SMS、または、SMSステータスレポートを受信できなかった場合にコールされます。

本メソッドの引数messageBoxに設定するMessageBoxのインスタンスは、ShortMessageManager.getShortMessageBox()、 またはShortMessageManager.getSMSStatusReportBox()で取得するインスタンスと同一のインスタンスです。

SMS、または、SMSステータスレポートのメッセージを受信した際に、メッセージボックスに空きがなく、 且つ、保存されているメッセージがすべて未読(ShortMessage.STAT_UNREAD)である場合、 メッセージの受信が拒否され当該メソッドがコールされます。

任意のメッセージの状態が既読ShortMessage.STAT_READになる、または保存領域に空きができると、 システムは自動的にメッセージの受信を開始し、onSMSReceived(MessageBox, int, boolean) がコールされます。

パラメータ:

messageBox - 受信できなかったメッセージボックスが設定されます。