com.docomostar
クラス StarApplicationManager

Object
  上位を拡張 com.docomostar.StarApplicationManager

public final class StarApplicationManager
extends Object

アプリケーションマネージャ を表すクラスです。 原則として アプリケーションマネージャ とやりとりするメソッドが定義されています。 ただし、アプリケーションライフサイクルに関するメソッドや、 リスナ登録に関するメソッドなど、 アプリケーション基底として最低限必要なメソッドについては StarApplication に定義されています。

このクラスのインスタンスを取得するには、 StarApplication.getStarApplicationManager() を呼び出してください。

導入されたバージョン:
Star-1.0
関連項目:
StarApplication.getStarApplicationManager()

フィールドの概要
static int SUSPEND_BY_NATIVE
          サスペンドの理由を表す属性の一つで、 アプリケーション以外からの割り込みによりサスペンドされたことを表します(=1)。
static int SUSPEND_BY_STARAPPLI
          サスペンドの理由を表す属性の一つで、 アプリケーションからのメソッド呼び出しを契機としてサスペンドされたことを表します(=2)。
static int SUSPEND_CALL_IN
          サスペンド理由やサスペンド中の事象を表す属性の一つで、 着信履歴に残る着信があったことを表します(=0x0400)。
static int SUSPEND_CALL_OUT
          サスペンド理由やサスペンド中の事象を表す属性の一つで、 発信履歴に残る発信があったことを表します(=0x0200)。
static int SUSPEND_MAIL_RECEIVE
           サスペンド理由やサスペンド中の事象を表す属性の一つで、 着信記録が残るメール着信 (SMS 着信や エリアメール着信も含みます) があったことを表します(=0x1000)。
static int SUSPEND_MAIL_SEND
          サスペンド理由やサスペンド中の事象を表す属性の一つで、 発信記録が残るメール発信 (SMS 発信も含みます) があったことを表します(=0x0800)。
static int SUSPEND_MESSAGE_RECEIVE
          サスペンド理由やサスペンド中の事象を表す属性の一つで、 着信記録が残るメッセージ(リクエスト、フリー)着信があったことを表します(=0x2000)。
static int SUSPEND_MULTITASK_APPLICATION
           サスペンド中の事象を表す属性の一つで、 マルチタスク機能によって他のアプリケーションに切り替えられたことを表します(=0x8000)。
static int SUSPEND_PACKETIN
          サスペンド理由やサスペンド中の事象を表す属性の一つで、 パケット着信(プッシュ)があったことを表します(=0x0100)。
static int SUSPEND_SCHEDULE_NOTIFY
          サスペンド理由やサスペンド中の事象を表す属性の一つで、 スケジューラからの通知があったことを表します(=0x4000)。
 
メソッドの概要
 void addRemoteLauncher(RemoteDevice launcher) [iアプリオプションAPI]
           指定された Bluetooth 外部機器を、 アプリケーションマネージャ の起動可能外部機器リストに追加します。
 boolean allowAudioOutput()
           この Star アプリにおいて音声鳴動させることを許可します。
 void clearMoved() [iアプリオプションAPI]
           このアプリケーションが端末外部から移されたことを示す情報に false を設定します。
static String[] getArgs()
           アプリケーションの起動パラメータを取得します。
 ScheduleDate getLaunchTime(int index)
           このアプリケーションの自動起動時刻を取得します。
static String getParameter(String key)
           ブラウザなどのネイティブアプリケーションまたはStar アプリから起動された場合の パラメータを取得します。
 StarEventObject getPushedEvent(int starEvent)
           直近の Terminated 状態下に、 このアプリケーションに対して発生していたイベントのパラメータを取得します。
 String[] getRemoteLauncherList() [iアプリオプションAPI]
           アプリケーションマネージャ の起動可能外部機器リストの内、 この Star アプリケーションから登録したすべての外部機器の Bluetooth アドレスを取得します。
static String getSourceURL()
          アプリケーションがダウンロードされた元の URL を取得します。
 int getSuspendInfo()
           直前のサスペンドの理由およびそのサスペンド中に起こった事象を取得します。
 boolean isAllowedAudioOutput()
           この Star アプリにおいて音声鳴動が許可されているかどうかを取得します。
 boolean isMoved() [iアプリオプションAPI]
           このアプリケーションが端末外部から移されたかどうかを調べます。
 boolean isMovedFromOtherTerminal() [iアプリオプションAPI]
           このアプリケーションの移動で、 移動先と移動元の端末が異なるかどうかを調べます。
 boolean removeRemoteLauncher(RemoteDevice launcher) [iアプリオプションAPI]
           指定された Bluetooth 外部機器を、 アプリケーションマネージャ の起動可能外部機器リストから削除します。
 void setLaunchTime(int index, ScheduleDate date)
           このアプリケーションの自動起動時刻を設定します。
 void upgrade()
          アプリケーションマネージャ を起動して実行中のアプリケーションの自動バージョンアップを行います。
 
クラス Object から継承されたメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

SUSPEND_BY_NATIVE

public static final int SUSPEND_BY_NATIVE
サスペンドの理由を表す属性の一つで、 アプリケーション以外からの割り込みによりサスペンドされたことを表します(=1)。

関連項目:
StarApplication.activated(int), 定数フィールド値

SUSPEND_BY_STARAPPLI

public static final int SUSPEND_BY_STARAPPLI
サスペンドの理由を表す属性の一つで、 アプリケーションからのメソッド呼び出しを契機としてサスペンドされたことを表します(=2)。

関連項目:
StarApplication.activated(int), 定数フィールド値

SUSPEND_PACKETIN

public static final int SUSPEND_PACKETIN
サスペンド理由やサスペンド中の事象を表す属性の一つで、 パケット着信(プッシュ)があったことを表します(=0x0100)。
サスペンドの契機となったパケット着信も含みます。 すなわち、 パケット着信後にメールやメッセージ(R,F)を受信するためにサスペンドする場合がありますが、 どちらの場合でもサスペンドが発生すると、 getSuspendInfo()の戻り値には SUSPEND_PACKETIN が設定されています。

関連項目:
getSuspendInfo(), 定数フィールド値

SUSPEND_CALL_OUT

public static final int SUSPEND_CALL_OUT
サスペンド理由やサスペンド中の事象を表す属性の一つで、 発信履歴に残る発信があったことを表します(=0x0200)。

ここでいう発信履歴に残る発信とは、以下の発信種別が該当します。

関連項目:
getSuspendInfo(), 定数フィールド値

SUSPEND_CALL_IN

public static final int SUSPEND_CALL_IN
サスペンド理由やサスペンド中の事象を表す属性の一つで、 着信履歴に残る着信があったことを表します(=0x0400)。

ここでいう着信履歴に残る着信とは、以下の着信種別が該当します。

関連項目:
getSuspendInfo(), 定数フィールド値

SUSPEND_MAIL_SEND

public static final int SUSPEND_MAIL_SEND
サスペンド理由やサスペンド中の事象を表す属性の一つで、 発信記録が残るメール発信 (SMS 発信も含みます) があったことを表します(=0x0800)。

関連項目:
getSuspendInfo(), 定数フィールド値

SUSPEND_MAIL_RECEIVE

public static final int SUSPEND_MAIL_RECEIVE

サスペンド理由やサスペンド中の事象を表す属性の一つで、 着信記録が残るメール着信 (SMS 着信や エリアメール着信も含みます) があったことを表します(=0x1000)。

関連項目:
getSuspendInfo(), 定数フィールド値

SUSPEND_MESSAGE_RECEIVE

public static final int SUSPEND_MESSAGE_RECEIVE
サスペンド理由やサスペンド中の事象を表す属性の一つで、 着信記録が残るメッセージ(リクエスト、フリー)着信があったことを表します(=0x2000)。

関連項目:
getSuspendInfo(), 定数フィールド値

SUSPEND_SCHEDULE_NOTIFY

public static final int SUSPEND_SCHEDULE_NOTIFY
サスペンド理由やサスペンド中の事象を表す属性の一つで、 スケジューラからの通知があったことを表します(=0x4000)。
アラームからの通知を含みます。

関連項目:
getSuspendInfo(), 定数フィールド値

SUSPEND_MULTITASK_APPLICATION

public static final int SUSPEND_MULTITASK_APPLICATION

サスペンド中の事象を表す属性の一つで、 マルチタスク機能によって他のアプリケーションに切り替えられたことを表します(=0x8000)。
マルチタスク機能を搭載している端末でのみ使用されます。

ミニアプリにおいては、Widget View が非表示状態(待ち受け画面)に遷移した場合にも、 このフラグがセットされます。

関連項目:
getSuspendInfo(), 定数フィールド値
メソッドの詳細

isMoved

public boolean isMoved() [iアプリオプションAPI]

このアプリケーションが端末外部から移されたかどうかを調べます。

本メソッドは、 このアプリケーションがメディア等により端末外部から移されたことを示す情報 (以下、移動情報) の値を返します。

このアプリケーションが移されたタイミングで移動情報に true が設定されます。 また、アプリケーションプログラマが clearMoved() を呼び出すと移動情報に false が設定されます。 アプリケーションの終了や、 端末の電源オフによって移動情報が変更されることはありません。 移動情報を false から true とするには、 再び外部から端末にこのアプリケーションを移さなければなりません。

本メソッドと clearMoved() をアプリケーションプログラマが用いることで、 アプリケーションが移された直後に任意の処理を行うことができます。 なお、このアプリケーションの移動で移動先と移動元の端末が異なるかどうかの判定が必要である場合には、 isMovedFromOtherTerminal() を参照して下さい。

端末によっては、外部メモリへの Star アプリケーション移動の操作をサポートしていない場合があります。 その場合、このメソッドは false を返します。

戻り値:
このアプリケーションがメディア等により端末外部から移された場合は true を返します。 このアプリケーションが clearMoved() を呼び出した場合、 または、ダウンロードされてから端末外部に移されていない場合は false を返します。
関連項目:
clearMoved(), isMovedFromOtherTerminal()

clearMoved

public void clearMoved() [iアプリオプションAPI]

このアプリケーションが端末外部から移されたことを示す情報に false を設定します。

設定した値の詳細については isMoved() を参照して下さい。

端末によっては、外部メモリへの Star アプリケーション移動の操作をサポートしていない場合があります。 その場合、このメソッドの呼び出しは無視されます。

関連項目:
isMoved()

isMovedFromOtherTerminal

public boolean isMovedFromOtherTerminal() [iアプリオプションAPI]

このアプリケーションの移動で、 移動先と移動元の端末が異なるかどうかを調べます。

このアプリケーションが端末外部から移された場合に、 移動先と移動元の端末が異なるかどうかを判定します。

移動元の端末とは、次の全ての条件を満たす端末です。