セッション¶
ヒューマンスコアリングユースケースの一部です。
セッションとは、分類の対象となる一連の操作の区間です。SDK は
init でセッションを 1 つ開始します。ログアウトやアカウント切り替えなど、アプリだけが知る形でセッションが
終わるときは SDK に伝えてください。そうすることで、あるユーザーの操作が次のユーザーの分類に数えられることが
なくなります。これは、広告ユースケースで DEA が 1 つの広告のために開く
広告セッションとは別のものです。
使いどころ¶
- ユーザーがログアウトするとき
- ユーザーがアカウントを切り替えるとき
- 現在のセッション id が必要なとき。たとえばサポートリクエストに含めるため
前提条件¶
- SDK がインストールされ、初期化されている。クイックスタートを参照してください。
使い方¶
新しいセッションを開始する¶
reset() は現在のセッションを終了し、新しい id で新しいセッションを開始します。リセット前に集めた証拠は
新しいセッションの分類には数えられません。同意は影響を受けず、SDK がダウンロードした
モデルは引き続き使われます。
現在のセッションを読む¶
import ai.dea.sdk.DeaSdk
import android.util.Log
val info = DeaSdk.instance!!.sessionInfo
Log.d("MyApp", info.session) // current session id, a UUID
Log.d("MyApp", info.sdk.version) // SDK version
Log.d("MyApp", "${info.device.surface}") // current screen size, in dp
Log.d("MyApp", "${info.device.rotation}") // 0, 90, 180 or 270
Log.d("MyApp", "${info.device.sensorRate} Hz") // 0 until motion data arrives
sessionInfo は軽い読み取りです。端末情報は、画面が回転したりウィンドウのサイズが変わったりしても最新の
状態を保ちます。
SDK を終了する¶
dispose() は取得を停止し、SDK を解放します。まだ処理されていないものは破棄されます。dispose() の後、
DeaSdk.instance は null になり、DeaSdk.init で新しいインスタンスを開始できます。
ほとんどのアプリは dispose() を呼び出しません。SDK はアプリのプロセスと同じだけ存続します。回転のたびに
実行される Activity.onDestroy() から呼び出さないでください。
例¶
ログアウト時にリセットする¶
import ai.dea.sdk.DeaSdk
import android.app.Activity
import android.content.Intent
fun logout(activity: Activity) {
authService.signOut()
DeaSdk.instance?.reset()
activity.startActivity(
Intent(activity, LoginActivity::class.java)
.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK),
)
}
API¶
| メンバー | 戻り値 | 説明 |
|---|---|---|
reset() |
Unit |
セッションを終了し、新しいセッションを開始します |
sessionInfo |
SessionInfo |
セッション id、端末、SDK バージョン |
dispose() |
Unit |
取得を停止し、SDK を解放します |