概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

com.docomostar.system
クラス PhoneSystem

Object
  拡張com.docomostar.system.PhoneSystem
public class PhoneSystem
extends Object

携帯電話のデバイスを定義します。 電話システムクラスは、携帯電話の基本機能を提供するクラスです。

ここで、携帯電話の基本機能とは以下のような機能を指します。

導入されたバージョン:
Star-1.0

フィールドの概要
static int ATTR_AREAINFO_COMMUNICATING
           エリア情報の属性の一つで、 現在通信中であるため、エリア情報が不明であることを表します(=5)。
static int ATTR_AREAINFO_FOMA
           エリア情報の属性の一つで、 FOMA 圏内、かつ HSDPA 圏外であることを表します(=0)。
static int ATTR_AREAINFO_HSDPA
           エリア情報の属性の一つで、 HSDPA 圏内であることを表します(=1)。
static int ATTR_AREAINFO_OUTSIDE
           エリア情報の属性の一つで、 圏外であることを表します(=2)。
static int ATTR_AREAINFO_ROAMINGOUT
           エリア情報の属性の一つで、 圏内ではあるが、 端末がローミングアウト中であることを表します(=3)。
static int ATTR_AREAINFO_SELFMODE
           エリア情報の属性の一つで、 セルフモード中であるため、 エリア情報が不明であることを表します(=4)。
static int ATTR_AREAINFO_UNKNOWN
           エリア情報の属性の一つで、 セルフモード中、通信中以外の理由で、 エリア情報が不明であることを表します(=99)。
static int ATTR_BACKLIGHT_OFF
          バックライトの属性の一つで、オフであることを表します(=0)。
static int ATTR_BACKLIGHT_ON
          バックライトの属性の一つで、オンであることを表します(=1)。
static int ATTR_FOLDING_CLOSE [iアプリオプションAPI]
          折りたたみ状態の属性の一つで、端末が折りたたまれているか、フリップが閉じていることを表します(=0)。
static int ATTR_FOLDING_OPEN [iアプリオプションAPI]
          折りたたみ状態の属性の一つで、端末が折りたたまれていないか、フリップが開いていることを表します(=1)。
static int ATTR_MAIL_AT_CENTER
          メール受信状態の属性の一つで、未読メールがセンターに保管されていることを表します(=2)。
static int ATTR_MAIL_NONE
          メール受信状態の属性の一つで、未読メールがないことを表します(=0)。
static int ATTR_MAIL_RECEIVED
          メール受信状態の属性の一つで、未読メールがあることを表します(=1)。
static int ATTR_MANNER_OFF
          マナーモードの属性の一つで、オフであることを表します(=0)。
static int ATTR_MANNER_ON
          マナーモードの属性の一つで、オンであることを表します(=1)。
static int ATTR_MESSAGE_AT_CENTER
          メッセージ受信状態の属性の一つで、未読メッセージがセンターに保管されていることを表します(=2)。
static int ATTR_MESSAGE_NONE
          メッセージ受信状態の属性の一つで、未読メッセージがないことを表します(=0)。
static int ATTR_MESSAGE_RECEIVED
          メッセージ受信状態の属性の一つで、未読メッセージがあることを表します(=1)。
static int ATTR_POWER_BATTERY
          電源の属性の一つで、この端末が電池で起動していることを表します(=0)。
static int ATTR_POWER_EXTERNAL
          電源の属性の一つで、この端末が外部電源で起動していることを表します(=1)。
static int ATTR_SCREEN_INVISIBLE
          画面がユーザに見えるかどうかの属性の一つで、 画面が見えない状態であることを表します(=0)。
static int ATTR_SCREEN_VISIBLE
          画面がユーザに見えるかどうかの属性の一つで、 画面が見える状態であることを表します(=1)。
static int ATTR_SIGNAL_LEVEL_1
          電波状態の属性で、ピクトのアンテナが 0 または 1 本の状態であることを表します(=1)。
static int ATTR_SIGNAL_LEVEL_2
          電波状態の属性で、ピクトのアンテナが 2 本の状態であることを表します(=2)。
static int ATTR_SIGNAL_LEVEL_3
          電波状態の属性で、ピクトのアンテナが 3 本の状態であることを表します(=3)。
static int ATTR_SIGNAL_OUTSIDE
          電波状態の属性で、ピクトが圏外であることを表します(=0)。
static int ATTR_SURROUND_OFF [iアプリオプションAPI]
          オーディオ出力のサラウンド機能の属性の一つで、 サラウンド機能が無効であることを表します(=0)。
static int ATTR_SURROUND_ON [iアプリオプションAPI]
          オーディオ出力のサラウンド機能の属性の一つで、 サラウンド機能が有効であることを表します(=1)。
static int ATTR_VIBRATOR_OFF
          バイブレータの属性の一つで、オフであることを表します(=0)。
static int ATTR_VIBRATOR_ON
          バイブレータの属性の一つで、オンであることを表します(=1)。
static int DEV_AREAINFO
           エリア情報を表します(=11)。
static int DEV_AUDIO_SURROUND [iアプリオプションAPI]
           オーディオ出力のサラウンド機能を表します(=10)。
static int DEV_BACKLIGHT
          バックライトを表します(=0)。
static int DEV_BATTERY_LEVEL
          現在の電池パック残量を段階数で表します(=13)。
static int DEV_CHARGING_TIME [iアプリオプションAPI]
          端末の残り充電時間を表します(=16)。
static int DEV_FOLDING [iアプリオプションAPI]
          折りたたみ状態を表します(=2)。
static int DEV_KEYPAD [iアプリオプションAPI]
           キーパッドを表します(=8)。
static int DEV_MAILBOX
          メール受信状態を表します(=3)。
static int DEV_MANNER
          マナーモードを表します(=7)。
static int DEV_MAX_BATTERY_LEVEL
          電池パック残量を段階数で示す場合の最大値(フル充電時の状態)を表します(=12)。
static int DEV_MESSAGEBOX
          メッセージ（メッセージフリー、メッセージリクエスト）の受信状態を表します(=4)。
static int DEV_PHONE_REMAINING_TIME [iアプリオプションAPI]
          端末の残り利用可能時間を表します(=17)。
static int DEV_POWER_SOURCE
          端末の電源を表します(=14)。
static int DEV_SCREEN_VISIBLE
           画面がユーザに見える状態かどうかを表します(=9)。
static int DEV_SIGNAL_STATE
          電波状態を表します(=15)。
static int DEV_VIBRATOR
          バイブレータを表します(=1)。
static int MAX_OPTION_ATTR
          オプションのネイティブリソース属性の最大値です(=255)。
static int MAX_VENDOR_ATTR
          ベンダ定義のネイティブリソース属性の最大値です(=127)。
static int MIN_OPTION_ATTR
          オプションのネイティブリソース属性の最小値です(=128)。
static int MIN_VENDOR_ATTR
          ベンダ定義のネイティブリソース属性の最小値です(=64)。
static int SOUND_ALARM
          ユーザにスケジュールなどのイベントを通知するタイプの標準サウンドを表します(=3)。
static int SOUND_CONFIRM
          ユーザの操作に対して処理を受け付けたことを通知するタイプの標準サウンドを表します(=4)。
static int SOUND_ERROR
          ユーザにエラーを通知するタイプの標準サウンドを表します(=2)。
static int SOUND_INFO
          ユーザに情報を通知するタイプの標準サウンドを表します(=0)。
static int SOUND_WARNING
          ユーザに警告を通知するタイプの標準サウンドを表します(=1)。
static String TERMINAL_ID
           携帯電話の個体識別番号を示す文字列です(= "terminal-id")。
static String UIM_VERSION
          UIMのバージョン番号を示す文字列です(= "uim-version")。
static String USER_ID
           UIMの個体識別番号を示す文字列です(= "user-id")。
 
コンストラクタの概要
protected PhoneSystem()
          アプリケーションが直接このクラスのインスタンスを生成することはできません。
 
メソッドの概要
static int getAttribute(int attr)
           ネイティブリソースの属性を取得します。
static String getProperty(String key)
          指定されたキーに該当するプロパティ値を取得します。
static boolean isAvailable(int attr)
          ネイティブのリソースが制御可能かどうか調べます。
static void playSound(int type)
          標準サウンドを鳴らします。
static void setAttribute(int attr, int value)
          ネイティブリソースの制御を行います。
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

DEV_BACKLIGHT

public static final int DEV_BACKLIGHT
バックライトを表します(=0)。
属性の制御と取得が可能です。

ミニアプリからはこの属性を制御、取得することはできません。

関連項目:
定数フィールド値

ATTR_BACKLIGHT_OFF

public static final int ATTR_BACKLIGHT_OFF
バックライトの属性の一つで、オフであることを表します(=0)。

関連項目:
定数フィールド値

ATTR_BACKLIGHT_ON

public static final int ATTR_BACKLIGHT_ON
バックライトの属性の一つで、オンであることを表します(=1)。

関連項目:
定数フィールド値

DEV_VIBRATOR

public static final int DEV_VIBRATOR
バイブレータを表します(=1)。
属性の制御と取得が可能です。

ミニアプリからはこの属性を制御、取得することはできません。

関連項目:
定数フィールド値

ATTR_VIBRATOR_OFF

public static final int ATTR_VIBRATOR_OFF
バイブレータの属性の一つで、オフであることを表します(=0)。

関連項目:
定数フィールド値

ATTR_VIBRATOR_ON

public static final int ATTR_VIBRATOR_ON
バイブレータの属性の一つで、オンであることを表します(=1)。

関連項目:
定数フィールド値

DEV_FOLDING

public static final int DEV_FOLDING [iアプリオプションAPI]
折りたたみ状態を表します(=2)。 端末が折りたたみ型またはフリップ型の場合のみ意味を持ちます。 ストレートタイプの場合、属性値は常に-1を返します。
属性の取得のみ可能で、制御することはできません。

関連項目:
DEV_SCREEN_VISIBLE, 定数フィールド値

ATTR_FOLDING_CLOSE

public static final int ATTR_FOLDING_CLOSE [iアプリオプションAPI]
折りたたみ状態の属性の一つで、端末が折りたたまれているか、フリップが閉じていることを表します(=0)。

関連項目:
定数フィールド値

ATTR_FOLDING_OPEN

public static final int ATTR_FOLDING_OPEN [iアプリオプションAPI]
折りたたみ状態の属性の一つで、端末が折りたたまれていないか、フリップが開いていることを表します(=1)。

関連項目:
定数フィールド値

DEV_MAILBOX

public static final int DEV_MAILBOX
メール受信状態を表します(=3)。 端末のメールピクトの表示と連動しています。
属性の取得のみ可能で、制御することはできません。

全画面表示によりメールピクトが表示されない場合でも、 表示されるべきメールピクトの表示状態と連動した属性の取得が可能です。

関連項目:
定数フィールド値

ATTR_MAIL_NONE

public static final int ATTR_MAIL_NONE
メール受信状態の属性の一つで、未読メールがないことを表します(=0)。

関連項目:
定数フィールド値

ATTR_MAIL_RECEIVED

public static final int ATTR_MAIL_RECEIVED
メール受信状態の属性の一つで、未読メールがあることを表します(=1)。

関連項目:
定数フィールド値

ATTR_MAIL_AT_CENTER

public static final int ATTR_MAIL_AT_CENTER
メール受信状態の属性の一つで、未読メールがセンターに保管されていることを表します(=2)。

センターに保管されているものがメッセージかメールか区別できない場合、 メッセージ、メールのいずれかが保管されていればこの値を返します。

関連項目:
定数フィールド値

DEV_MESSAGEBOX

public static final int DEV_MESSAGEBOX
メッセージ（メッセージフリー、メッセージリクエスト）の受信状態を表します(=4)。 端末のメッセージピクトの表示と連動しています。
属性の取得のみ可能で、制御することはできません。

全画面表示によりメッセージピクトが表示されない場合でも、 表示されるべきメッセージピクトの表示状態と連動した属性の取得が可能です。

関連項目:
定数フィールド値

ATTR_MESSAGE_NONE

public static final int ATTR_MESSAGE_NONE
メッセージ受信状態の属性の一つで、未読メッセージがないことを表します(=0)。

関連項目:
定数フィールド値

ATTR_MESSAGE_RECEIVED

public static final int ATTR_MESSAGE_RECEIVED
メッセージ受信状態の属性の一つで、未読メッセージがあることを表します(=1)。

関連項目:
定数フィールド値

ATTR_MESSAGE_AT_CENTER

public static final int ATTR_MESSAGE_AT_CENTER
メッセージ受信状態の属性の一つで、未読メッセージがセンターに保管されていることを表します(=2)。

センターに保管されているものがメッセージかメールか区別できない場合、 メッセージ、メールのいずれかが保管されていればこの値を返します。

関連項目:
定数フィールド値

DEV_MANNER

public static final int DEV_MANNER
マナーモードを表します(=7)。

属性の取得のみ可能で、制御することはできません。

関連項目:
定数フィールド値

ATTR_MANNER_OFF

public static final int ATTR_MANNER_OFF
マナーモードの属性の一つで、オフであることを表します(=0)。

関連項目:
定数フィールド値

ATTR_MANNER_ON

public static final int ATTR_MANNER_ON
マナーモードの属性の一つで、オンであることを表します(=1)。

関連項目:
定数フィールド値

DEV_KEYPAD

public static final int DEV_KEYPAD [iアプリオプションAPI]

キーパッドを表します(=8)。 低レベル・高レベル API において、 キーのグループごとにキーを有効とするかどうかを制御します。 ユーザが有効なグループのキーを操作した場合はキーイベントが発生し、 また、キーパッド状態を取得することが可能です。 一方、無効なグループのキーを操作した場合はキーイベントも発生しませんし、 キーパッド状態を取得することもできません。 デフォルトではグループ 0 のキーのみが有効となっています。

キーの有効化は、Star アプリが起動してから最初に Display.setCurrent(Frame) を呼び出すまでに行わなければなりません。 それ以降にキーを有効化しようとしても無視されます。 また、一度有効化すると無効化することはできません。

属性値としてキーのグループ番号を指定して setAttribute(int, int) メソッドを呼び出すと、 そのグループのキーが有効になります。 例えば PhoneSystem.setAttribute(DEV_KEYPAD, 1) とすると、 グループ 1 のキーが有効になります。

属性の制御のみ可能で、取得することはできません。

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

DEV_SCREEN_VISIBLE

public static final int DEV_SCREEN_VISIBLE

画面がユーザに見える状態かどうかを表します(=9)。 ストレートタイプの端末では、 常に ATTR_SCREEN_VISIBLE を返します。 折りたたみ型の端末では、端末の状態に応じて ATTR_SCREEN_INVISIBLE、ATTR_SCREEN_VISIBLE のいずれかを返します。
属性の取得のみ可能で、制御することはできません。

関連項目:
DEV_FOLDING, 定数フィールド値

ATTR_SCREEN_INVISIBLE

public static final int ATTR_SCREEN_INVISIBLE
画面がユーザに見えるかどうかの属性の一つで、 画面が見えない状態であることを表します(=0)。

関連項目:
定数フィールド値

ATTR_SCREEN_VISIBLE

public static final int ATTR_SCREEN_VISIBLE
画面がユーザに見えるかどうかの属性の一つで、 画面が見える状態であることを表します(=1)。

関連項目:
定数フィールド値

DEV_AUDIO_SURROUND

public static final int DEV_AUDIO_SURROUND [iアプリオプションAPI]

オーディオ出力のサラウンド機能を表します(=10)。 端末がサラウンド機能をサポートしている場合のみ意味を持ちます。
端末がサラウンド機能をサポートしている場合、 属性を取得することによってサラウンド機能が有効になっているか無効になっているかを判別することができます。 また、ネイティブのユーザ設定によってサラウンド機能がオンに設定されている場合は、 属性の制御が可能で、サラウンド機能を有効にしたり無効にしたりすることができます。 ただし、オーディオプレゼンタの再生中に制御することはできません。

サラウンド機能は 3D サウンド機能と同時に使用することはできません。 アプリの起動直後は、 サラウンド機能および 3D サウンド機能の有効・無効の切り替えは、 端末ごとに機種依存の方法で行われます。 アプリがこの属性を制御して明示的にサラウンド機能を無効にした場合、 サラウンド機能は使用されません。 アプリがこの属性を制御して明示的にサラウンド機能を有効にした場合、 3D サウンド機能を使用することはできません。

属性の制御と取得が可能です。

端末によってはネイティブのユーザ設定に関わらず属性の制御が可能で、 サラウンド機能を有効にしたり無効にしたりすることができます。 なお、属性の制御はネイティブのユーザ設定を上書きするものではありませんので、 アプリが一旦終了した後は元々のネイティブのユーザ設定に戻ります。

ミニアプリからはこの属性を制御、取得することはできません。

関連項目:
定数フィールド値

ATTR_SURROUND_OFF

public static final int ATTR_SURROUND_OFF [iアプリオプションAPI]
オーディオ出力のサラウンド機能の属性の一つで、 サラウンド機能が無効であることを表します(=0)。

関連項目:
定数フィールド値

ATTR_SURROUND_ON

public static final int ATTR_SURROUND_ON [iアプリオプションAPI]
オーディオ出力のサラウンド機能の属性の一つで、 サラウンド機能が有効であることを表します(=1)。

関連項目:
定数フィールド値

DEV_AREAINFO

public static final int DEV_AREAINFO

エリア情報を表します(=11)。
属性の取得のみ可能で、制御することはできません。

免責事項:
このフィールドを使って取得された情報は、エリアを特定するものではありません。

関連項目:
定数フィールド値

ATTR_AREAINFO_FOMA

public static final int ATTR_AREAINFO_FOMA

エリア情報の属性の一つで、 FOMA 圏内、かつ HSDPA 圏外であることを表します(=0)。

関連項目:
定数フィールド値

ATTR_AREAINFO_HSDPA

public static final int ATTR_AREAINFO_HSDPA

エリア情報の属性の一つで、 HSDPA 圏内であることを表します(=1)。

関連項目:
定数フィールド値

ATTR_AREAINFO_OUTSIDE

public static final int ATTR_AREAINFO_OUTSIDE

エリア情報の属性の一つで、 圏外であることを表します(=2)。 セルフモードである場合は含まれません。

関連項目:
定数フィールド値

ATTR_AREAINFO_ROAMINGOUT

public static final int ATTR_AREAINFO_ROAMINGOUT

エリア情報の属性の一つで、 圏内ではあるが、 端末がローミングアウト中であることを表します(=3)。

関連項目:
定数フィールド値

ATTR_AREAINFO_SELFMODE

public static final int ATTR_AREAINFO_SELFMODE

エリア情報の属性の一つで、 セルフモード中であるため、 エリア情報が不明であることを表します(=4)。

関連項目:
定数フィールド値

ATTR_AREAINFO_COMMUNICATING

public static final int ATTR_AREAINFO_COMMUNICATING

エリア情報の属性の一つで、 現在通信中であるため、エリア情報が不明であることを表します(=5)。

関連項目:
定数フィールド値

ATTR_AREAINFO_UNKNOWN

public static final int ATTR_AREAINFO_UNKNOWN

エリア情報の属性の一つで、 セルフモード中、通信中以外の理由で、 エリア情報が不明であることを表します(=99)。

関連項目:
定数フィールド値

MIN_VENDOR_ATTR

public static final int MIN_VENDOR_ATTR
ベンダ定義のネイティブリソース属性の最小値です(=64)。

関連項目:
定数フィールド値

MAX_VENDOR_ATTR

public static final int MAX_VENDOR_ATTR
ベンダ定義のネイティブリソース属性の最大値です(=127)。

関連項目:
定数フィールド値

MIN_OPTION_ATTR

public static final int MIN_OPTION_ATTR
オプションのネイティブリソース属性の最小値です(=128)。

関連項目:
定数フィールド値

MAX_OPTION_ATTR

public static final int MAX_OPTION_ATTR
オプションのネイティブリソース属性の最大値です(=255)。

関連項目:
定数フィールド値

SOUND_INFO

public static final int SOUND_INFO
ユーザに情報を通知するタイプの標準サウンドを表します(=0)。 playSound(int) メソッドの引数として使用されます。

関連項目:
定数フィールド値

SOUND_WARNING

public static final int SOUND_WARNING
ユーザに警告を通知するタイプの標準サウンドを表します(=1)。 playSound(int) メソッドの引数として使用されます。

関連項目:
定数フィールド値

SOUND_ERROR

public static final int SOUND_ERROR
ユーザにエラーを通知するタイプの標準サウンドを表します(=2)。 playSound(int) メソッドの引数として使用されます。

関連項目:
定数フィールド値

SOUND_ALARM

public static final int SOUND_ALARM
ユーザにスケジュールなどのイベントを通知するタイプの標準サウンドを表します(=3)。 playSound(int) メソッドの引数として使用されます。

関連項目:
定数フィールド値

SOUND_CONFIRM

public static final int SOUND_CONFIRM
ユーザの操作に対して処理を受け付けたことを通知するタイプの標準サウンドを表します(=4)。 playSound(int) メソッドの引数として使用されます。

関連項目:
定数フィールド値

TERMINAL_ID

public static final String TERMINAL_ID

携帯電話の個体識別番号を示す文字列です(= "terminal-id")。

返される文字列の形式は、HTTP の User-Agent ヘッダに挿入される "ser" に続く 15 桁の文字列("ser" は含まない)と同等です。

関連項目:
utn 属性, 定数フィールド値

DEV_MAX_BATTERY_LEVEL

public static final int DEV_MAX_BATTERY_LEVEL
電池パック残量を段階数で示す場合の最大値(フル充電時の状態)を表します(=12)。

属性の取得のみ可能で、制御することはできません。

関連項目:
定数フィールド値

DEV_BATTERY_LEVEL

public static final int DEV_BATTERY_LEVEL
現在の電池パック残量を段階数で表します(=13)。

属性の取得のみ可能で、制御することはできません。 取得可能な値は以下のような値となります。 電池が満充電の場合、この属性は DEV_MAX_BATTERY_LEVEL の値を返します。

[Star-1.0 まで]
この属性の取得できる値は電池パック残量ピクトと連動した値となります。 全画面表示により電池パック残量ピクトが表示されない場合でも、 表示されるべき電池パック残量ピクトの表示状態と連動した属性の取得が可能です。
端末の電源が ATTR_POWER_EXTERNAL である場合、この属性の取得を行うことはできません。 getAttribute(DEV_BATTERY_LEVEL) を呼び出すと getAttribute(int) は -1 を返します。

[Star-1.1 以降]
この属性では端末の電池パックにおける電池残量の現在値が取得できます。 電池残量の 1 段階あたりの値は、電池総容量を DEV_MAX_BATTERY_LEVEL で等分した値となります。
端末の電源がATTR_POWER_EXTERNALであっても ATTR_POWER_BATTERYであっても、この属性は取得可能です。

関連項目:
定数フィールド値

DEV_POWER_SOURCE

public static final int DEV_POWER_SOURCE
端末の電源を表します(=14)。

属性の取得のみ可能で、制御することはできません。 取得可能な値は以下です。

[Star-1.0 まで]
この属性の取得できる値はピクトと連動した値となります。 全画面表示により電池パック残量ピクトが表示されない場合でも、 表示されるべき電池パック残量ピクトの表示状態がこの属性と同じであれば、 この属性の取得が可能です。

関連項目:
定数フィールド値

DEV_CHARGING_TIME

public static final int DEV_CHARGING_TIME [iアプリオプションAPI]
端末の残り充電時間を表します(=16)。

満充電までの残り充電時間を取得します。 属性の取得のみ可能で、制御することはできません。 取得される時間は分単位です。

端末の電源が ATTR_POWER_BATTERY である場合、この属性の取得を行うことはできません。 そのときに、 getAttribute(DEV_CHARGING_TIME) を呼び出すと getAttribute(int) は -1 を返します。

端末によっては残り充電時間の取得をサポートしていない場合があります。 その場合には、 getAttribute(int) メソッドは -1 を返します。

導入されたバージョン:
Star-1.1
関連項目:
定数フィールド値

DEV_PHONE_REMAINING_TIME

public static final int DEV_PHONE_REMAINING_TIME [iアプリオプションAPI]
端末の残り利用可能時間を表します(=17)。

現在のアプリケーションの利用状況が継続された場合における、端末の残り利用可能時間を取得します。 属性の取得のみ可能で、制御することはできません。 取得される時間は分単位です。

端末の電源が ATTR_POWER_EXTERNAL である場合、この属性の取得を行うことはできません。 そのときに、 getAttribute(DEV_PHONE_REMAINING_TIME) を呼び出すと getAttribute(int) は -1 を返します。

端末によっては残り端末利用可能時間の取得をサポートしていない場合があります。 その場合には、 getAttribute(int) メソッドは -1 を返します。

導入されたバージョン:
Star-1.1
関連項目:
定数フィールド値

ATTR_POWER_BATTERY

public static final int ATTR_POWER_BATTERY
電源の属性の一つで、この端末が電池で起動していることを表します(=0)。

関連項目:
定数フィールド値

ATTR_POWER_EXTERNAL

public static final int ATTR_POWER_EXTERNAL
電源の属性の一つで、この端末が外部電源で起動していることを表します(=1)。

この端末が充電中であることも表します。

関連項目:
定数フィールド値

DEV_SIGNAL_STATE

public static final int DEV_SIGNAL_STATE
電波状態を表します(=15)。

ピクトが表示されない場合でも、 表示されるべきピクトの表示状態がこの属性と同じであれば、 この属性の取得が可能です。

属性の取得のみ可能で、制御することはできません。 取得可能な値は以下です。

関連項目:
定数フィールド値

ATTR_SIGNAL_OUTSIDE

public static final int ATTR_SIGNAL_OUTSIDE
電波状態の属性で、ピクトが圏外であることを表します(=0)。

セルフモードであることも表します。

関連項目:
定数フィールド値

ATTR_SIGNAL_LEVEL_1

public static final int ATTR_SIGNAL_LEVEL_1
電波状態の属性で、ピクトのアンテナが 0 または 1 本の状態であることを表します(=1)。

関連項目:
定数フィールド値

ATTR_SIGNAL_LEVEL_2

public static final int ATTR_SIGNAL_LEVEL_2
電波状態の属性で、ピクトのアンテナが 2 本の状態であることを表します(=2)。

関連項目:
定数フィールド値

ATTR_SIGNAL_LEVEL_3

public static final int ATTR_SIGNAL_LEVEL_3
電波状態の属性で、ピクトのアンテナが 3 本の状態であることを表します(=3)。

関連項目:
定数フィールド値

USER_ID

public static final String USER_ID

UIMの個体識別番号を示す文字列です(= "user-id")。

返される文字列の形式は、HTTP の User-Agent ヘッダに挿入される "icc" に続く 20 桁の文字列("icc" は含まない)と同等です。

関連項目:
utn 属性, 定数フィールド値

UIM_VERSION

public static final String UIM_VERSION
UIMのバージョン番号を示す文字列です(= "uim-version")。

getProperty(String) メソッドの引数に指定することにより、 端末に挿入されている UIM のバージョン番号を表す文字列 (Version 2 であれば、"2") を取得することができます。

関連項目:
定数フィールド値
コンストラクタの詳細

PhoneSystem

protected PhoneSystem()
アプリケーションが直接このクラスのインスタンスを生成することはできません。

メソッドの詳細

setAttribute

public static final void setAttribute(int attr,
                                      int value)
ネイティブリソースの制御を行います。 端末の設定によってリソースの制御が制限されている場合はその制限に従います。 存在しないリソース、制御可能でないリソースの種類が指定された場合は何も行わずに無視されます。 ミニアプリ実行時に、ミニアプリからは制御できないリソースの種類が指定された場合は、 何も行なわずに無視されます。

パラメータ:
attr - ネイティブリソース属性の種類を指定します。
value - ネイティブリソースに設定する属性値を指定します。
例外:
IllegalArgumentException -
引数 attr で指定された有効なリソースに対して、引数 value に不正な属性値が指定された場合に発生します。

getAttribute

public static final int getAttribute(int attr)

ネイティブリソースの属性を取得します。 存在しないリソースの種類が指定された場合は -1 を返します。 ミニアプリ実行時に、存在するリソースではあるが、 ミニアプリからは取得できないリソースの種類が指定された場合は -2 を返します。

パラメータ:
attr - ネイティブリソース属性の種類を指定します。
戻り値:
ネイティブリソースの属性値を返します。
例外:
SecurityException -
ADF に GetSysInfo キーの指定がないアプリケーションが、以下の情報を取得しようとした場合に発生します。
  • メール、メッセージ、マナーモード設定のピクト情報
  • エリア情報、電池パック残量の最大値、電池パック残量の現在値、電源、電波状態の属性
  • [Star-1.1 以降] 残り充電時間、残り端末利用可能時間
SecurityException -
ADF に GetSysInfo キーが指定されているが、 Star アプリ個別のユーザ設定により許可されていない場合に、以下の情報を取得しようとした場合に発生します。
  • メール、メッセージ、マナーモード設定のピクト情報
  • エリア情報、電池パック残量の最大値、電池パック残量の現在値、電源、電波状態の属性
  • [Star-1.1 以降] 残り充電時間、残り端末利用可能時間

isAvailable

public static final boolean isAvailable(int attr)
ネイティブのリソースが制御可能かどうか調べます。 このメソッドが true を返した場合は、そのリソースを setAttribute(int, int) メソッドで制御することが可能です。 端末がそのリソースの制御をサポートしていない場合や、 端末の設定によってそのリソースの制御が制限されている場合は false を返します。 状態を取得するだけで制御することができない属性に対して呼び出された場合は常に false を返します。 存在しないリソースの種類が指定された場合は false を返します。 ミニアプリ実行時に、ミニアプリからは制御できないリソースの種類が指定された場合は false を返します。

パラメータ:
attr - ネイティブリソース属性の種類を指定します。
戻り値:
ネイティブリソースが制御可能な場合は true を、 そうでなければ false を返します。

playSound

public static final void playSound(int type)
標準サウンドを鳴らします。

パラメータ:
type - 標準サウンドの種類を指定します。 SOUND_INFO、SOUND_WARNING、SOUND_ERROR、 SOUND_ALARM、SOUND_CONFIRM のいずれかです。
例外:
IllegalStateException -
ミニアプリ実行時に呼び出された場合に発生します。
IllegalArgumentException -
引数 type に不正な値が指定された場合に発生します。
IllegalStateException -
音声・テレビ電話通話中に呼び出された場合に発生します。
IllegalStateException -
PTT 呼通信中の場合に発生します。

getProperty

public static final String getProperty(String key)
指定されたキーに該当するプロパティ値を取得します。
取得できるプロパティのキーは、"terminal-id"、"user-id"、"uim-version" のいずれかです。
無効なキーが指定された場合はnullを返します。

"terminal-id" 及び "user-id" を取得する場合、 ADF に GetUtn キーが指定されている必要があります。 ADF に GetUtn キーが指定されていない場合は例外が発生します。

パラメータ:
key - プロパティを指定する文字列を指定します。
戻り値:
プロパティ値を文字列で返します。
例外:
NullPointerException -
引数にnullを指定して呼び出した場合に発生します。
IllegalArgumentException -
引数に空文字列を指定して呼び出した場合に発生します。
SecurityException -
ADF のGetUtnキーのパラメータに terminalid の指定がないアプリケーションが引数に "terminal-id" を指定して呼び出した場合 や、"userid" の指定がないアプリケーションが引数に "user-id" を指定して呼び出した場合に発生します。
IllegalStateException -
UIM の情報を取得できなかった場合に発生します。
概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

NTT DOCOMO,INC.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ（その他に許諾者がある場合は当該許諾者も含めて）の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

FeliCaは、ソニー株式会社が開発した非接触ICカードの技術方式です。FeliCaは、ソニー株式会社の登録商標です。

「ｉモード」、「ｉアプリ／アイアプリ」、「ｉ-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。

その他記載された会社名、製品名などは該当する各社の商標または登録商標です。