機密性の高い画面¶
ヒューマンスコアリングユースケースの一部です。
パスワード、カード番号、ワンタイムコードなどの機密性の高い入力が画面に表示されている間、取得を一時停止します。 一時停止中、SDK は何も記録しません。セッションは継続し、再開すると取得は中断した場所から続きます。
SDK はキーイベントやテキストを読み取らず、システムキーボード上のタッチも取得しません。キーボードはアプリの
ウィンドウではないためです。アプリ自身が描画する PIN パッドやキーボード上のタッチは取得されるので、そうした
画面では一時停止してください。アプリが captureKey でキーの押下を報告
している場合、パスワードフィールドでは決して報告しないでください。
使いどころ¶
- ログイン画面や PIN 画面が開いているとき
- 決済フォームが開いているとき
- プライバシーポリシーで記録しないと定めている画面
前提条件¶
- SDK がインストールされ、初期化されている。クイックスタートを参照してください。
使い方¶
一時停止と再開¶
pause()には必ずresume()を対にしてください。一時停止中の時間は アクションを増やさないため、一時停止のまま放置されたセッションは 決して十分にならず、分類はINSUFFICIENTのままです。resume()は同意を上書きしません。ユーザーが同意していなければ、再開後も何も記録されません。- どちらもメインスレッドで呼び出してください。
注:
pause()とresume()は入れ子になりません。pause()が何回呼び出されていても、1 回のresume()で取得が再開されます。そのため、アプリの 2 か所が独立に一時停止すると干渉します。先に再開した方が、もう一方が まだ機密性の高い内容を表示している間に取得を再開してしまいます。一時停止の責任者を 1 つにするか、 一時停止の回数を自分で数え、カウントがゼロに戻ったときだけresume()を呼び出してください。
例¶
アクティビティがフォアグラウンドにある間、一時停止する¶
import ai.dea.sdk.DeaSdk
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
class PaymentActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_payment)
}
override fun onResume() {
super.onResume()
DeaSdk.instance?.pause()
}
override fun onPause() {
DeaSdk.instance?.resume()
super.onPause()
}
}
フラグメントのビューが存在する間、一時停止する¶
import ai.dea.sdk.DeaSdk
import android.os.Bundle
import android.view.View
import androidx.fragment.app.Fragment
class PinFragment : Fragment(R.layout.fragment_pin) {
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
super.onViewCreated(view, savedInstanceState)
DeaSdk.instance?.pause()
}
override fun onDestroyView() {
DeaSdk.instance?.resume()
super.onDestroyView()
}
}
パスワードフィールドにフォーカスがある間、一時停止する¶
import ai.dea.sdk.DeaSdk
import android.widget.EditText
fun EditText.pauseDeaWhileFocused() {
setOnFocusChangeListener { _, hasFocus ->
if (hasFocus) DeaSdk.instance?.pause() else DeaSdk.instance?.resume()
}
}
// In your activity or fragment:
// findViewById<EditText>(R.id.password).pauseDeaWhileFocused()
フィールドにフォーカスが残ったまま画面が閉じる可能性がある場合は、画面が閉じるときにも resume() を
呼び出してください。
API¶
| メンバー | 戻り値 | 説明 |
|---|---|---|
pause() |
Unit |
記録を停止します。セッションは維持されます |
resume() |
Unit |
記録を再開します |