セッション¶
ヒューマンスコアリングユースケースの一部です。
セッションは、ひとつの分類の対象となる操作のひと続きです。
SDK は init 時にセッションを開始します。アプリだけが知る形でセッションが終わるとき(ログアウトや
アカウント切り替え)には SDK に知らせてください。そうすることで、あるユーザーの操作が次のユーザーの
分類に数えられることがなくなります。これは、広告ユースケースで DEA が広告 1 件ごとに
開く広告セッションとは別のものです。
使いどころ¶
- ユーザーがログアウトする
- ユーザーがアカウントを切り替える
- 現在のセッション ID が必要なとき。たとえばサポートへの問い合わせに含める場合
前提条件¶
- SDK がインストールされ、初期化されている。クイックスタートを参照してください。
使い方¶
新しいセッションを開始する¶
reset() は現在のセッションを終了し、新しい ID で新しいセッションを開始します。リセット前に集めた証拠は
新しいセッションの分類には数えられません。同意には影響せず、一時停止にも影響しません。一時停止中の
SDK は一時停止のままです。
また、アプリが 5 分を超えてバックグラウンドにあった後に戻ってきた場合、SDK は自動的に証拠をやり直し
ます。その時点では、同じ人物が端末を持っているとは言えないからです。このときセッション ID は変わり
ません。セッションがモデルの求める数の
アクション(組み込みモデルでは 8)に達するまで、分類は再び
insufficient になります。証拠を参照してください。
現在のセッションを読み取る¶
final info = DeaSdk.instance!.getSessionInfo();
debugPrint(info.session); // current session id, a UUID
debugPrint(info.sdk.version); // SDK version
debugPrint('${info.device.surface}'); // current screen size
getSessionInfo() は軽い読み取りです。報告される画面サイズは、画面が回転したりウィンドウのサイズが
変わったりしても最新の値に保たれます。
SDK をシャットダウンする¶
dispose() は取得を停止し、SDK を解放します。まだ処理されていないものは破棄されます。dispose() の後、
DeaSdk.instance は null になり、DeaSdk.init で新しいインスタンスを開始できます。
例¶
ログアウト時にリセットする¶
import 'package:dea_sdk/dea_sdk.dart';
import 'package:flutter/material.dart';
Future<void> logout(BuildContext context) async {
await authService.signOut();
DeaSdk.instance?.reset();
if (context.mounted) {
Navigator.of(context).pushNamedAndRemoveUntil('/login', (_) => false);
}
}
API¶
| メンバー | 戻り値 | 説明 |
|---|---|---|
reset() |
void |
セッションを終了し、新しいセッションを開始する |
getSessionInfo() |
SessionInfo |
セッション ID、端末、SDK バージョン |
dispose() |
void |
取得を停止し、SDK を解放する |