機密性の高い画面¶
ヒューマンスコアリングユースケースの一部です。
パスワード、カード番号、ワンタイムコードなど、機密性の高い入力が画面に表示されている間は取得を 一時停止します。一時停止中、SDK は何も記録しません。セッションは継続し、再開すると取得は中断した ところから続きます。
使いどころ¶
- ログイン画面や PIN 画面が開いている
- 決済フォームが開いている
- プライバシーポリシーで記録しないとしている画面
前提条件¶
- SDK がインストールされ、初期化されている。クイックスタートを参照してください。
使い方¶
一時停止と再開¶
import 'package:dea_sdk/dea_sdk.dart';
DeaSdk.instance?.pause();
// … sensitive screen …
DeaSdk.instance?.resume();
pause()には必ずresume()を対にしてください。一時停止中の時間は アクションを追加しないため、一時停止のまま放置された セッションは決して十分にならず、分類はinsufficientのままです。resume()は同意を上書きしません。ユーザーが同意していなければ、再開後も何も記録されません。- 一時停止中は、アプリが
captureKeyやcapturePointerで報告する入力も破棄され、 カスタムイベントも同様です。
注:
pause()とresume()はネストしません。pause()を何回呼んでいても、1 回のresume()で 取得が再開されます。そのため、アプリの 2 つの部分がそれぞれ独自に一時停止すると干渉します。先に再開 した方が、もう一方がまだ機密性の高い内容を表示している間に取得を再開してしまいます。一時停止の 責任者を 1 つに決めるか、自分で一時停止の回数を数えて、カウントがゼロに戻ったときにだけresume()を呼んでください。
例¶
画面が表示されている間だけ一時停止する¶
import 'package:dea_sdk/dea_sdk.dart';
import 'package:flutter/material.dart';
class PaymentScreen extends StatefulWidget {
const PaymentScreen({super.key});
@override
State<PaymentScreen> createState() => _PaymentScreenState();
}
class _PaymentScreenState extends State<PaymentScreen> {
@override
void initState() {
super.initState();
DeaSdk.instance?.pause();
}
@override
void dispose() {
DeaSdk.instance?.resume();
super.dispose();
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('Payment')),
body: const Column(children: [
TextField(decoration: InputDecoration(labelText: 'Card number')),
TextField(decoration: InputDecoration(labelText: 'CVC'), obscureText: true),
]),
);
}
}
パスワードフィールドにフォーカスがある間だけ一時停止する¶
import 'package:dea_sdk/dea_sdk.dart';
import 'package:flutter/material.dart';
class PasswordField extends StatefulWidget {
const PasswordField({super.key});
@override
State<PasswordField> createState() => _PasswordFieldState();
}
class _PasswordFieldState extends State<PasswordField> {
final _focus = FocusNode();
@override
void initState() {
super.initState();
_focus.addListener(() {
if (_focus.hasFocus) {
DeaSdk.instance?.pause();
} else {
DeaSdk.instance?.resume();
}
});
}
@override
void dispose() {
if (_focus.hasFocus) DeaSdk.instance?.resume();
_focus.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return TextField(
focusNode: _focus,
obscureText: true,
decoration: const InputDecoration(labelText: 'Password'),
);
}
}
API¶
| メンバー | 戻り値 | 説明 |
|---|---|---|
pause() |
void |
記録を停止する。セッションは維持される |
resume() |
void |
記録を再開する |