API version 32

Runtime.CanBiometricAuthenticateメソッド

iOSAndroidWindows

説明

生体認証機能が利用可能かどうかを調べます。

Android版
生体認証機能は、Android 10以下のOSでは使用できません。

呼出形式

var result = Runtime.CanBiometricAuthenticate( );

戻り値

生体認証機能が利用可能かどうかの情報を示す整数が返ります。

以下の値のいずれかが返ります。

定数	値	説明
Runtime.BIOMETRIC_AUTHENTICATE_AVAILABLE	0	生体認証機能は利用可能です。
Runtime.BIOMETRIC_AUTHENTICATE_NOT_AVAILABLE	1	端末が生体認証機能に対応していません。
Runtime.BIOMETRIC_AUTHENTICATE_NOT_ENROLLED	2	生体情報が登録されていません。
Runtime.BIOMETRIC_AUTHENTICATE_PASSCODE_NOT_SET	3	パスコードが設定されていないため、生体認証機能を利用できません。
Runtime.BIOMETRIC_AUTHENTICATE_OS_NOT_SUPPORTED	4	Android版生体認証機能をサポートしていないOSバージョンです。
Runtime.BIOMETRIC_AUTHENTICATE_SECURITY_UPDATE_REQUIRED	5	Android版生体認証機能を利用する前にセキュリティアップデートが必要です。

引数

なし

例外

なし

使用例

var result = Runtime.CanBiometricAuthenticate();
if (result == Runtime.BIOMETRIC_AUTHENTICATE_AVAILABLE) {
	var success = false;
	try {
		success = Runtime.BiometricAuthenticate();
	} catch (e) {
		MessageBox(e.Message);
	}
	if (success) {
		MessageBox("生体認証に成功しました。");
	} else {
		MessageBox("生体認証に失敗しました。");
	}
} else {
	MessageBox("生体認証を利用できません。");
}