com.docomostar.opt.device
インタフェース Pulsemeter

既知の実装クラスの一覧:

CameraPulsemeter

public interface Pulsemeter

脈拍計機能を定義します。

脈拍計機能では、以下のように状態を定義します。

状態	説明
START	脈拍を測定中の状態
STOP	脈拍を測定中でない状態

start() により START 状態になると、脈拍計機能は STOP 状態になるまで脈拍を測定し続けます。 getPulserate() により測定した脈拍値を読み出す場合、 start() 呼び出し後、最初に脈拍数が確定するまでの間は -1 が返り、その後は getPulserate() 呼び出し時点で最新の計測値を返します。

脈拍計機能が START 状態から STOP 状態になるには以下の場合があります。

1. Pulsemeter.stop() が呼び出された場合
2. Star アプリがサスペンドした場合
3. START 状態中に予期せぬエラーにより測定が不可能となった場合

導入されたバージョン:

Star-1.3

フィールドの概要

static int	STATUS_CORRECT_OPERATION 状態情報を示す値で、正常に測定が行われていることを表します(=0)。
static int	STATUS_STOP 状態情報を示す値で、脈拍計機能が STOP 状態であり、測定が行われていないことを表します(=1)。

メソッドの概要

int	getPulserate() 測定した脈拍値を取得します。
int	getStatus() 測定中の状態情報を取得します。
void	start() 脈拍測定を開始します。
void	stop() 脈拍測定を停止します。

フィールドの詳細

STATUS_CORRECT_OPERATION

static final int STATUS_CORRECT_OPERATION

状態情報を示す値で、正常に測定が行われていることを表します(=0)。

関連項目:

定数フィールド値

STATUS_STOP

static final int STATUS_STOP

状態情報を示す値で、脈拍計機能が STOP 状態であり、測定が行われていないことを表します(=1)。

関連項目:

定数フィールド値

メソッドの詳細

start

void start()

脈拍測定を開始します。

このメソッドを実行すると、脈拍測定を開始し、脈拍を測定中の状態( START 状態 )にします。 既に脈拍測定中の状態で、再度 start() を実行した場合には、後発の start() は無視されます。

stop

void stop()

脈拍測定を停止します。

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

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

getStatus

int getStatus()

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

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

戻り値:

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

getPulserate

int getPulserate()

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

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

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

戻り値:

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