com.docomostar.opt.system
クラス BodyProfiles

Object
  com.docomostar.opt.system.BodyProfiles

public final class BodyProfiles
extends Object

携帯電話のネイティブ身体情報へアクセスする機能を提供します。

身体情報アクセス機能で設定、および取得可能な項目は以下になります。 ただし、端末によってはサポートしていない項目がある場合があります。

• 身長
• 体重

身体情報アクセス機能は端末によってサポートされていない場合があります。 未サポートの場合、メソッドが呼び出された時点で UnsupportedOperationException が発生します。

このクラスの各メソッドを実行するには、 ADF に AccessUserInfo キーが指定されている必要があります。

導入されたバージョン:

Star-1.3

フィールドの概要

static int	DEV_HEIGHT_MAX 身長の属性の一つで、身体情報に設定可能な身長の最大値 (mm) を表します(=1)。
static int	DEV_HEIGHT_MIN 身長の属性の一つで、身体情報に設定可能な身長の最小値 (mm) を表します(=0)。
static int	DEV_HEIGHT_RESOLUTION 身長の属性の一つで、身体情報に設定可能な身長の分解能 (mm) を表します(=2)。
static int	DEV_WEIGHT_MAX 体重の属性の一つで、身体情報に設定可能な体重の最大値 (g) を表します(=4)。
static int	DEV_WEIGHT_MIN 体重の属性の一つで、身体情報に設定可能な体重の最小値 (g) を表します(=3)。
static int	DEV_WEIGHT_RESOLUTION 体重の属性の一つで、身体情報に設定可能な体重の分解能 (g) を表します(=5)。

メソッドの概要

static int	getAttribute(int attr) 身体情報の設定に関する属性値を取得します。
static int	getBodyHeight() 身体情報の項目の一つである身長を取得します。
static int	getBodyWeight() 身体情報の項目の一つである体重を取得します。
static void	setBodyHeight(int height) 身体情報の項目の一つである身長を設定します。
static void	setBodyWeight(int weight) 身体情報の項目の一つである体重を設定します。

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

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

フィールドの詳細

DEV_HEIGHT_MIN

public static final int DEV_HEIGHT_MIN

身長の属性の一つで、身体情報に設定可能な身長の最小値 (mm) を表します(=0)。

関連項目:

定数フィールド値

DEV_HEIGHT_MAX

public static final int DEV_HEIGHT_MAX

身長の属性の一つで、身体情報に設定可能な身長の最大値 (mm) を表します(=1)。

関連項目:

定数フィールド値

DEV_HEIGHT_RESOLUTION

public static final int DEV_HEIGHT_RESOLUTION

身長の属性の一つで、身体情報に設定可能な身長の分解能 (mm) を表します(=2)。

関連項目:

定数フィールド値

DEV_WEIGHT_MIN

public static final int DEV_WEIGHT_MIN

体重の属性の一つで、身体情報に設定可能な体重の最小値 (g) を表します(=3)。

関連項目:

定数フィールド値

DEV_WEIGHT_MAX

public static final int DEV_WEIGHT_MAX

体重の属性の一つで、身体情報に設定可能な体重の最大値 (g) を表します(=4)。

関連項目:

定数フィールド値

DEV_WEIGHT_RESOLUTION

public static final int DEV_WEIGHT_RESOLUTION

体重の属性の一つで、身体情報に設定可能な体重の分解能 (g) を表します(=5)。

関連項目:

定数フィールド値

メソッドの詳細

setBodyHeight

public static void setBodyHeight(int height)

身体情報の項目の一つである身長を設定します。

既に身体情報に設定がある場合は、このメソッドの引数に指定した値で更新します。

身体情報に設定する際、引数 height で指定した値が身長として設定可能な分解能の倍数で無い場合、 分解能の倍数の中で指定した値に最も近い値が指定されたものとして扱われます。 つまり、指定した値を分解能で割った余りが、分解能の半分より小さい場合は切り捨て、 半分以上のときは切り上げます。 (例： 分解能が 10 mm であった場合に、1675 mm は 1680 mm として設定されます。)

身体情報アクセス機能が身体情報項目のうち身長をサポートしていない場合、UnsupportedOperationException が発生します。

パラメータ:

height - 身長を設定します。単位は mm (ミリメートル)です。

例外:

com.docomostar.lang.UnsupportedOperationException -
身体情報アクセス機能をサポートしていない、もしくは身体情報アクセス機能が身体情報項目のうち身長をサポートしていない場合に発生します。

IllegalArgumentException -
引数 height で指定した身長がネイティブの身体情報に設定可能な範囲外である場合に発生します。

SecurityException -
ADF に AccessUserInfo キーの指定がないアプリケーションがこのメソッドを呼び出した場合に発生します。

getBodyHeight

public static int getBodyHeight()

身体情報の項目の一つである身長を取得します。

ネイティブ身体情報に身長が設定されていない場合は、-1 を返します。

身体情報アクセス機能が身体情報項目のうち身長をサポートしていない場合、UnsupportedOperationException が発生します。

戻り値:

身長を取得します。単位は mm (ミリメートル)です。

例外:

com.docomostar.lang.UnsupportedOperationException -
身体情報アクセス機能をサポートしていない、もしくは身体情報アクセス機能が身体情報項目のうち身長をサポートしていない場合に発生します。

SecurityException -
ADF に AccessUserInfo キーの指定がないアプリケーションがこのメソッドを呼び出した場合に発生します。

setBodyWeight

public static void setBodyWeight(int weight)

身体情報の項目の一つである体重を設定します。

既に身体情報に設定がある場合は、このメソッドの引数に指定した値で更新します。

身体情報に設定する際、引数　weight で指定した値が体重として設定可能な分解能の倍数で無い場合、 分解能の倍数の中で指定した値に最も近い値が指定されたものとして扱われます。 つまり、指定した値を分解能で割った余りが、分解能の半分より小さい場合は切り捨て、 半分以上のときは切り上げます。 (例：分解能が 100 g であった場合、87650 g は 87700 g として設定されます。)

身体情報アクセス機能が身体情報項目のうち体重をサポートしていない場合、UnsupportedOperationException が発生します。

パラメータ:

weight - 体重を設定します。単位は g (グラム)です。

例外:

com.docomostar.lang.UnsupportedOperationException -
身体情報アクセス機能をサポートしていない、もしくは身体情報アクセス機能が身体情報項目のうち体重をサポートしていない場合に発生します。

IllegalArgumentException -
引数 weight で指定した体重がネイティブの身体情報に設定可能な範囲外である場合に発生します。

SecurityException -
ADF に AccessUserInfo キーの指定がないアプリケーションがこのメソッドを呼び出した場合に発生します。

getBodyWeight

public static int getBodyWeight()

身体情報の項目の一つである体重を取得します。

ネイティブ身体情報に体重が設定されていない場合は、-1 を返します。

身体情報アクセス機能が身体情報項目のうち体重をサポートしていない場合、UnsupportedOperationException が発生します。

戻り値:

体重を取得します。単位は g (グラム)です。

例外:

com.docomostar.lang.UnsupportedOperationException -
身体情報アクセス機能をサポートしていない、もしくは身体情報アクセス機能が身体情報項目のうち体重をサポートしていない場合に発生します。

SecurityException -
ADF に AccessUserInfo キーの指定がないアプリケーションがこのメソッドを呼び出した場合に発生します。

getAttribute

public static int getAttribute(int attr)

身体情報の設定に関する属性値を取得します。

引数 attr で指定された属性が無効な場合や、 身体情報アクセス機能がサポートしていない項目に関する属性を指定した場合、 -1 を返します。

パラメータ:

attr - 取得する属性を指定します。

戻り値:

指定された属性の値を返します。

関連項目:

DEV_HEIGHT_MAX, DEV_HEIGHT_MIN, DEV_HEIGHT_RESOLUTION, DEV_WEIGHT_MAX, DEV_WEIGHT_MIN, DEV_WEIGHT_RESOLUTION

例外:

com.docomostar.lang.UnsupportedOperationException -
身体情報アクセス機能をサポートしていない場合に発生します。

SecurityException -
ADF に AccessUserInfo キーの指定がないアプリケーションがこのメソッドを呼び出した場合に発生します。