com.docomostar.opt.device
クラス CameraPulsemeter

Object
  com.docomostar.opt.device.CameraPulsemeter

すべての実装されたインタフェース:

Pulsemeter

public class CameraPulsemeter
extends Object
implements Pulsemeter

カメラデバイスを用いた脈拍計機能を定義します。

脈拍数の測定を行います。 この脈拍計機能はカメラデバイスを使うため、同じカメラデバイスが既に利用されている場合には、脈拍計機能を利用することはできません。 脈拍測定開始時に例外が発生します。

導入されたバージョン:

Star-1.3

フィールドの概要

static int	STATUS_BAD_POSITION 状態情報を示す値で、指の置き方が悪いことを表します(=4)。
static int	STATUS_BRIGHT 状態情報を示す値で、明るすぎることを表します(=3)。
static int	STATUS_DARK 状態情報を示す値で、暗すぎることを表します(=2)。
static int	STATUS_NO_FINGER 状態情報を示す値で、指が置かれていないことを表します(=5)。

インタフェース com.docomostar.opt.device.Pulsemeter から継承されたフィールド

STATUS_CORRECT_OPERATION, STATUS_STOP

メソッドの概要

static CameraPulsemeter	getPulsemeter(int id) 脈拍計オブジェクトを取得します。
int	getPulserate() 測定した脈拍値を取得します。
int	getStatus() 測定中の状態情報を取得します。
void	start() 脈拍測定を開始します。
void	stop() 脈拍測定を停止します。

クラス Object から継承されたメソッド

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

フィールドの詳細

STATUS_DARK

public static final int STATUS_DARK

状態情報を示す値で、暗すぎることを表します(=2)。

この値が返った場合は、ユーザに明るくするよう促す必要があります。

関連項目:

定数フィールド値

STATUS_BRIGHT

public static final int STATUS_BRIGHT

状態情報を示す値で、明るすぎることを表します(=3)。

この値が返った場合は、ユーザに暗くするよう促す必要があります。

関連項目:

定数フィールド値

STATUS_BAD_POSITION

public static final int STATUS_BAD_POSITION

状態情報を示す値で、指の置き方が悪いことを表します(=4)。

この値が返った場合は、ユーザに指の置き方を変えるよう促す必要があります。

関連項目:

定数フィールド値

STATUS_NO_FINGER

public static final int STATUS_NO_FINGER

状態情報を示す値で、指が置かれていないことを表します(=5)。

この値が返った場合は、ユーザに指を置くよう促す必要があります。

関連項目:

定数フィールド値

メソッドの詳細

getPulsemeter

public static CameraPulsemeter getPulsemeter(int id)

脈拍計オブジェクトを取得します。

カメラ ID に対してこのメソッドが初めて呼ばれた場合は脈拍計オブジェクトを生成して返します。 以後、同じカメラ ID に対しては、常に同じオブジェクトへの参照を返します。

端末によっては脈拍計機能をサポートしていない場合があります。 未サポートの場合、メソッドが呼び出された時点で UnsupportedOperationException が発生します。

パラメータ:

id - カメラ ID を指定します。カメラ ID については Camera.getCamera(int) メソッドを参照してください。

戻り値:

脈拍計オブジェクトを返します。

例外:

com.docomostar.lang.UnsupportedOperationException -
脈拍計機能をサポートしていない場合に発生します。

com.docomostar.lang.UnsupportedOperationException -
引数 id に、カメラ機能はサポートしているが、脈拍計機能はサポートしていないようなカメラ ID が指定された場合に発生します。

IllegalArgumentException -
引数 id に負の値が指定された場合、または Java から制御可能なカメラデバイスの台数以上の値が指定された場合に発生します。

com.docomostar.device.DeviceException -
(NO_RESOURCES)
カメラデバイスを確保できない場合に発生します。

start

public void start()

脈拍測定を開始します。

このメソッドを実行すると、脈拍測定を開始し、脈拍を測定中の状態( START 状態 )にします。 同時に複数の Pulsemeter オブジェクトを START 状態にすることはできません。 ある Pulsemeter オブジェクトが START 状態の場合に、別の Pulsemeter オブジェクトの start() を実行した場合、 例外が発生します。ただし、同じ Pulsemeter オブジェクトに対して再度 start() を実行した場合には、後発の start() は無視されます。

定義:

インタフェース Pulsemeter 内の start

例外:

SecurityException -
ロック機能などのネイティブ独自のセキュリティ設定により START 状態にできない場合に発生します。

com.docomostar.device.DeviceException -
(ILLEGAL_STATE)
別の Pulsemeter オブジェクトが既に START 状態である場合に発生します。

com.docomostar.device.DeviceException -
(BUSY_RESOURCE)
リソースの確保に失敗した場合に発生します。

com.docomostar.device.DeviceException -
(NO_RESOURCES)
リソース不足により、脈拍測定の起動に失敗した場合に発生します。

com.docomostar.device.DeviceException -
(RACE_CONDITION)
脈拍計機能で利用するカメラデバイスが既に利用されている場合に発生します。

com.docomostar.device.DeviceException -
(UNDEFINED)
何らかの理由により、脈拍測定を実行できない場合に発生します。

stop

public void stop()

インタフェース Pulsemeter の記述:

脈拍測定を停止します。

このメソッドを実行すると、脈拍測定を停止し、脈拍を測定中でない状態( STOP 状態)にします。 脈拍測定を完全に停止させるまでの間、このメソッドはブロックされます。

脈拍計機能が STOP 状態で、このメソッドを呼んでも無視されます。

定義:

インタフェース Pulsemeter 内の stop

例外:

com.docomostar.device.DeviceException -
(UNDEFINED)
脈拍測定の停止に失敗した場合に発生します。

getStatus

public int getStatus()

測定中の状態情報を取得します。

脈拍計機能が START 状態で、このメソッドを呼ぶと測定中の状態情報を取得することができます。 脈拍計機能が STOP 状態で、このメソッドを呼ぶと STATUS_STOP が返されます。

カメラデバイスを用いた脈拍測定においては以下の状態情報のいずれかが返されます。

• Pulsemeter.STATUS_CORRECT_OPERATION
• Pulsemeter.STATUS_STOP
• STATUS_DARK
• STATUS_BRIGHT
• STATUS_BAD_POSITION
• STATUS_NO_FINGER

定義:

インタフェース Pulsemeter 内の getStatus

戻り値:

測定中の状態情報を返します。

getPulserate

public int getPulserate()

インタフェース Pulsemeter の記述:

測定した脈拍値を取得します。

脈拍値は 1 分間の脈拍数で返します。Pulsemeter.start() 呼び出しから最初に測定値が確定するまでの間は本メソッドにて -1 を返します。最初に測定値が確定した後はメソッド呼び出し時点で最新の測定値を返します。

STOP 状態で本メソッドを呼び出すと、直前の測定で得られた最新の値を返します。 未測定の場合または測定値が確定する前に停止された場合は -1 を返します。 測定中に、予期せぬエラーが発生したり、Star アプリがサスペンドすることにより STOP 状態になった場合に、 本メソッドを呼び出すと例外が発生します。

定義:

インタフェース Pulsemeter 内の getPulserate

戻り値:

測定した脈拍値を1分間の脈拍数で返します。ただし、測定値が確定していない場合は -1 を返します。

例外:

com.docomostar.device.DeviceException -
(INTERRUPTED)
測定中に Star アプリがサスペンドすることにより STOP 状態になった場合に発生します。

com.docomostar.device.DeviceException -
(UNDEFINED)
測定中にエラーが発生して STOP 状態になった場合に発生します。