コンテンツにスキップ

セッション

ヒューマンスコアリングユースケースの一部です。

セッションとは、分類の対象となる一連の操作の区間です。SDK は init でセッションを 1 つ開始します。ログアウトやアカウント切り替えなど、アプリだけが知る形でセッションが 終わるときは SDK に伝えてください。そうすることで、あるユーザーの操作が次のユーザーの分類に数えられることが なくなります。これは、広告ユースケースで DEA が 1 つの広告のために開く 広告セッションとは別のものです。

使いどころ

  • ユーザーがログアウトするとき
  • ユーザーがアカウントを切り替えるとき
  • 現在のセッション id が必要なとき。たとえばサポートリクエストに含めるため

前提条件

使い方

新しいセッションを開始する

import ai.dea.sdk.DeaSdk

DeaSdk.instance?.reset()

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 を終了する

DeaSdk.instance?.dispose()

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 を解放します