com.nttdocomo.ui
インタフェース ParameterPushListener

public interface ParameterPushListener

[iアプリオプションAPI]

パラメータを受信した際のイベントのリスナを定義します。 プッシュ機能により JAM がパラメータを受信した際にイベントを受け取るオブジェクトが実装すべきインタフェースを定めます。

FOMA 端末では以下の場合にイベントが発生します。

• 通常実行時で受信した場合(サスペンド中も含む)
• 待ち受け実行時の活性化状態で受信した場合(サスペンド中も含む)
• 待ち受け実行時の非活性化状態で受信した場合(サスペンド中も含む)
• 待ち受け実行時の休眠状態で受信した場合(サスペンド中も含む)

なお、サスペンド中にパラメータを受信した場合、 サスペンド中に最後に受信したパラメータについてのみ、 レジュームの際にイベントが発生します。

イベントが発生した場合、このインターフェースを実装したオブジェクトの parameterPushed(PushManager) メソッドが呼び出されます。 このメソッドの引数として渡されるオブジェクトの PushManager.getParameter() メソッドや PushManager.getParameterPushedTime() メソッドを呼び出すことにより、 受信したパラメータの文字列や受信した時間を取得することができます。

なお、parameterPushed(PushManager) が呼び出されている間に新しくパラメータを受信した場合でも、 このメソッドがシステムから二重に呼ばれることはなく、 このメソッドからリターンするまで、引数 source から取得できるパラメータの値が変化することもありません。
そのような場合は、リターン直後に PushManager で取得できるパラメータの更新が行われ、 新しく受信したことによるイベントが発生し、再度 parameterPushed(PushManager) が呼び出されます。

導入されたバージョン:

DoJa-3.0 (506iC)、DoJa-3.5 (900iC)

関連項目:

PushManager

メソッドの概要

void	parameterPushed(PushManager source) JAM がパラメータを受信した際に呼び出されます。

メソッドの詳細

parameterPushed

public void parameterPushed(PushManager source)

JAM がパラメータを受信した際に呼び出されます。

パラメータ:

source - プッシュ機能の管理オブジェクトが渡されます。