com.j_phone.system
クラス DeviceControl

java.lang.Object
  |
  +--com.j_phone.system.DeviceControl

public class DeviceControl

extends java.lang.Object

デバイス制御クラス

フィールドの概要

static int	BACK_LIGHT バックライトの点灯 BACK_LIGHTには5が設定されています。
static int	BATTERY バッテリー BATTERYには1が設定されています。
static int	EIGHT_DIRECTIONS 8方向キーの利用 EIGHT_DIRECTIONSには6が設定されています。
static int	FIELD_INTENSITY 電界強度 FIELD_INTENSITYには2が設定されています。
static int	KEY_STATE キーの押下状態 KEY_STATEには3が設定されています。
static int	VIBRATION バイブレーション機能 VIBRATIONには4が設定されています。

メソッドの概要

void	blink(int lighting, int extinction, int repeat) バックライトを点滅させる。
static DeviceControl	getDefaultDeviceControl() デフォルトのDeviceControlインスタンスを取得する。
int	getDeviceState(int deviceNo) デバイスの状態を取得する。
boolean	getKeyRepeatState(int key) キーのオートリピート機能を取得する。
int	getLatitude() 現在の緯度を取得する。
int	getLongitude() 現在の経度を取得する。
java.lang.String	getPlaceName() 現在位置の地名を取得する。
boolean	isDeviceActive(int deviceNo) デバイスが作動しているかどうか調べる
boolean	setDeviceActive(int deviceNo, boolean active) デバイスの作動状態を設定する。
boolean	setKeyRepeatState(int key, boolean state) キーのオートリピート機能を設定する
static void	setMailListener(MailListener listener) MailListenerを登録する。
static void	setRingStateListener(RingStateListener listener) RingStateListenerを登録する。
static void	setScheduledAlarmListener(ScheduledAlarmListener listener) ScheduledAlarmListenerを登録する。
static void	setTelephonyListener(TelephonyListener listener) TelephonyListenerを登録する。

クラス java.lang.Object から継承したメソッド

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

フィールドの詳細

BATTERY

public static final int BATTERY

バッテリー BATTERYには1が設定されています。

FIELD_INTENSITY

public static final int FIELD_INTENSITY

電界強度 FIELD_INTENSITYには2が設定されています。

KEY_STATE

public static final int KEY_STATE

キーの押下状態 KEY_STATEには3が設定されています。

VIBRATION

public static final int VIBRATION

バイブレーション機能 VIBRATIONには4が設定されています。

BACK_LIGHT

public static final int BACK_LIGHT

バックライトの点灯 BACK_LIGHTには5が設定されています。

EIGHT_DIRECTIONS

public static final int EIGHT_DIRECTIONS

8方向キーの利用 EIGHT_DIRECTIONSには6が設定されています。

メソッドの詳細

getDefaultDeviceControl

public static final DeviceControl getDefaultDeviceControl()

デフォルトのDeviceControlインスタンスを取得する。

戻り値:

デフォルトDeviceControlインスタンス

getDeviceState

public int getDeviceState(int deviceNo)

デバイスの状態を取得する。

パラメータ:

deviceNo - デバイス番号（BATTERY バッテリー残量(%)、FIELD_INTENSITY 電界強度(%)、KEY_STATE キーの押下状態）

戻り値:

int - デバイスの状態 KEY_STATEが指定されていた場合の返り値はビットがたっているキーが押下状態にあるものとする。 キーとビットの対応は以下のようになる。

31								16								15								0
予約	予約	予約	予約	予約	予約	予約	予約	左下	右下	左上	右上	ソフトキー3	ソフトキー2	ソフトキー1	選択キー	下キー	右キー	左キー	上キー	＃キー	＊キー	9キー	8キー	7キー	6キー	5キー	4キー	3キー	2キー	1キー	0キー

例外:

IllegalArgumentException - デバイス番号がBATTERY、FIELD_INTENSITY、KEY_STATE以外の場合に発生する。

isDeviceActive

public boolean isDeviceActive(int deviceNo)

デバイスが作動しているかどうか調べる

パラメータ:

deviceNo - デバイス番号（VIBRATION バイブレーション機能、BACK_LIGHT バックライトのON/OFF、EIGHT_DIRECTIONS 8方向キーの利用）

戻り値:

int - デバイスの状態(true:作動中)

例外:

IllegalArgumentException - デバイス番号がVIBRATION、BACK_LIGHT、EIGHT_DIRECTIONS以外の場合に発生する。

setDeviceActive

public boolean setDeviceActive(int deviceNo,
                               boolean active)

デバイスの作動状態を設定する。 BACK_LIGHT を OFF にした場合、移動局に設定されているとおりの動作に戻るだけで、 必ずしも消灯するわけではないことに注意が必要。

パラメータ:

deviceNo - デバイス番号（VIBRATION バイブレーション機能、BACK_LIGHT バックライトのON/OFF、EIGHT_DIRECTIONS 8方向キーの利用）

active - 作動状態(true:作動)

戻り値:

boolean - true：制御成功

例外:

IllegalArgumentException - デバイス番号がVIBRATION、BACK_LIGHT、EIGHT_DIRECTIONS以外の場合に発生する。

blink

public void blink(int lighting,
                  int extinction,
                  int repeat)

バックライトを点滅させる。 指定の時間、点灯、消灯を交互に指定の回数繰り返します。 点灯時間は最大1000msとします。 点滅制御中にsetDeviceActiveでバックライトの制御が行われた場合、点滅は停止します。

パラメータ:

lighting - 点灯時間（ms）

extinction - 消灯時間（ms）

repeat - 繰り返し回数（ms）

例外:

IllegalArgumentException - 点灯時間が負か1000より大きい場合、 消灯時間、繰り返し回数が負の場合に発生する。

IllegalStateException - 点滅実行中にコールされた場合に発生する。

setKeyRepeatState

public boolean setKeyRepeatState(int key,
                                 boolean state)

キーのオートリピート機能を設定する

パラメータ:

key - キーコード

state - 状態（true:ON）

戻り値:

boolean - true：設定成功

getKeyRepeatState

public boolean getKeyRepeatState(int key)

キーのオートリピート機能を取得する。

パラメータ:

key - キーコード

戻り値:

boolean - 状態（true:ON）

getLatitude

public int getLatitude()

現在の緯度を取得する。 北緯を正の値であらわします。-324000〜324000の範囲の値が返ります。

戻り値:

int - 緯度（度×3600＋分×60＋秒）

例外:

IllegalStateException - 移動局プラットフォームが位置情報を保持していない場合に発生する。

getLongitude

public int getLongitude()

現在の経度を取得する。 東経を正の値であらわします。-648000〜648000の範囲の値が返ります。

戻り値:

int - 経度（度×3600＋分×60＋秒）

例外:

IllegalStateException - 移動局プラットフォームが位置情報を保持していない場合に発生する。

getPlaceName

public java.lang.String getPlaceName()

現在位置の地名を取得する。

戻り値:

String - 地名

例外:

IllegalStateException - 移動局プラットフォームが位置情報を保持していない場合に発生する。

setMailListener

public static void setMailListener(MailListener listener)

MailListenerを登録する。

パラメータ:

listener - 新しいMailListener

setScheduledAlarmListener

public static void setScheduledAlarmListener(ScheduledAlarmListener listener)

ScheduledAlarmListenerを登録する。

パラメータ:

listener - 新しいScheduledAlarmListener

setTelephonyListener

public static void setTelephonyListener(TelephonyListener listener)

TelephonyListenerを登録する。

パラメータ:

listener - 新しいTelephonyListener

setRingStateListener

public static void setRingStateListener(RingStateListener listener)

RingStateListenerを登録する。

パラメータ:

listener - 新しいRingStateListener