コンテンツにスキップ

トラブルシューティング

getClassification() が常に INSUFFICIENT または UNDETERMINED を返す

原因: 次のいずれかです。

  1. ユーザーが同意していない、または拒否したため、何も記録されていない。
  2. セッションのアクションがモデルが求める数(組み込みモデルでは 8)より少ないため、結果が INSUFFICIENT に なっている。証拠を参照してください。
  3. 取得が一時停止され、再開されていない。
  4. SDK がスコアリングできない。ready が false で、結果は INSUFFICIENT。
  5. 自動化検出が SDK を停止した。stopped が null ではなく、結果は INSUFFICIENT。 stopped が null ではないを参照してください。
  6. 結果が UNDETERMINED である。スコアが botThreshold と humanThreshold の間にある。

対処: 順に確認します。

import ai.dea.sdk.DeaSdk
import android.util.Log

val dea = DeaSdk.instance!!

Log.d("MyApp", "consent: ${dea.consent.decision}") // must be GRANTED
Log.d("MyApp", "ready: ${dea.ready}")              // must be true
Log.d("MyApp", "fault: ${dea.coreFault}")          // must be null
Log.d("MyApp", "stopped: ${dea.stopped}")          // must be null
Log.d("MyApp", "answer: ${dea.getClassification()}") // INSUFFICIENT means fewer actions than the model asks for

すべての pause() に対応する resume() があることを確認してください。

getClassification() が ThresholdMissing を投げる

原因: SDK が読み込んだモデルがbot しきい値を設定していません。しきい値がモデルの一部になる前のモデル ファイルで、SDK には代わりに使えるしきい値がありません。

対処: 例外をキャッチし、セッションを未判定として扱ってください。ThresholdMissing.modelVersion が 読み込まれているモデルを示します。DEA サポートに送ってください。

debug = true で画面に触れても何もログに出ない

原因: SDK のビルドが test チャネルのビルドではありません。debug はそこでのみ出力し、出荷する SDK は 何も出力しません。それ以外の場合は、何も記録されていません。通常はユーザーがまだ同意していないためです。 それ以外では、取得が一時停止されている、events がテストしている入力を除外している、またはタッチが ダイアログやポップアップウィンドウの内側で行われた(SDK はこれを取得しません)ことが考えられます。

対処: 同意を求めてください。ユーザー同意を参照してください。 同意が得られている場合は、対応する resume() のない pause() がないか確認し、 events を確認してください。

デバッグ行は標準出力に書き込まれます。Logcat ではタグ System.out の下に、接頭辞 [dea] 付きで表示されます。 Logcat のフィルタがそのタグを隠していないことを確認してください。

最初の画面のタッチが取得されない

原因: すでに表示されているアクティビティから、そのアクティビティ以外の Context(たとえば applicationContext)で DeaSdk.init が呼び出されました。SDK は init 後に開始されたアクティビティと、 init に渡されたアクティビティのウィンドウは見つけますが、すでに画面上にある他のアクティビティは見つけません。

対処: Application.onCreate() で DeaSdk.init を呼び出してください。どうしてもアクティビティから初期化する 必要がある場合は、そのアクティビティ自身を渡してください。

ready が false で、coreFault がこのビルドにはコアがないと言う

原因: 端末の ABI 向けの SDK のネイティブライブラリが APK にありません。通常は abiFilters、ABI 分割、 またはパッケージングルールによって取り除かれたためです。

対処: ユーザーの端末が必要とする ABI を残し、SDK の .so ファイル(libdea_jni.so と libdea_core.so)を 除外しないでください。

// app/build.gradle.kts
android {
    defaultConfig {
        ndk {
            abiFilters += listOf("arm64-v8a", "armeabi-v7a", "x86_64")
        }
    }
}

SDK は arm64-v8a、armeabi-v7a、x86、x86_64 を同梱しています。

ready が別の理由で false になる

原因: アプリにパッケージされたスコアリングエンジンが、SDK が期待するものではありません。公開リリースでは 起こらないはずです。他の依存関係が SDK のネイティブライブラリの独自コピーを持ち込み、pickFirsts などの パッケージングルールがそのコピーを採用した場合に起こり得ます。

対処: Gradle が ai.dea:dea-sdk と ai.dea:dea-base を同じバージョンに解決していること、他の依存関係が libdea_core.so を同梱していないことを確認してください。

./gradlew :app:dependencies --configuration releaseRuntimeClasspath | grep ai.dea

一致している場合は、coreFault のテキストを DEA サポートに送ってください。

スコアリングエンジンが別のリリースのもの(SDK が行う呼び出しを持たないものを含む)である場合、coreFault は core ABI で始まります。

ready が false の間に停止するもの

停止するもの アプリから見えるもの
スコア Classification.UNLOADED
モデルの復元 何も復元されない
モデルの更新 checkForModel は CANCELLED、"model updates are not running" を返す。addModelListener は何もしない
installModel ModelInstallRefusal(UNAVAILABLE, "no core to load a model into") を投げる
自動化検出 開始しない
証明: record、sendProof、getProof proof.not_signed、dea.reason: no_core
スコアを含む signRequest null。no_core の proof.not_signed。lastRequestRefusal は "nothing signed: no core to compose the evidence"
sdk.ready 代わりに sdk.core_failed。coreFault が設定され、ready は false

取得、インテグレーション、attest()、スコアを含まない signRequest は動作を続けます。

stopped が null ではない

原因: automationDetection = true のとき、SDK は自動化がアプリを操作している確実な兆候を見つけました。 SDK はすべての処理を直ちに停止しました。これはすべてのアカウントとビルドに当てはまり、test チャネルの ビルドも含みます。停止は reset() または新しい起動まで続きます。

対処: たとえば次のセッションで reset() を呼び出すか、SDK を再び起動してください。アプリを起動し直すか、 dispose() の後に init を呼び出します。resume() と setConsent(true) では停止は解除されません。 自動化が続くと、SDK は再び停止します。自社の自動テストでは automationDetection をオフのままにしてください。 ステージングビルドまたはテストビルドは、発生したシグナルとともに automation.detected をログに書き、続けて dea.reason: automated とともに sdk.stopped を書きます。

automationDetection = true のとき、root 化された端末でも SDK は停止します。ステージングビルドは見つけた痕跡と ともに sdk.device_compromised をログに書き、続けて sdk.stopped を書きます。reset() で停止は解除されますが、 同じ端末では SDK は再び停止します。テストビルドはログに書くだけで、動作を続けます。

外付けタッチスクリーンからのタッチでは SDK は停止しません。ステージングビルドまたはテストビルドはそれを automation.soft_signal としてログに書き、SDK は動作を続けます。

停止するもの アプリから見えるもの
取得 何も記録されない。resume() と setConsent(true) では再開しない
スコア getClassification() は、actions が 0 ですべての数値が null の INSUFFICIENT を返す
モデルの更新 checkForModel は要求なしで応答する
アテステーション attest() と renewAttestation() は要求なしで FAILED を返す。dea.reason: automated の attest.failed。自動更新は停止する
証明: record、sendProof、getProof 要求なしで、何も署名されない。proof.not_signed、dea.reason: automated。lastProofRefusal は automated
signRequest null。automated の proof.not_signed
インテグレーション それ以上は何も送られない。停止前に送られたものは送信済みのまま

reset() で停止は解除され、dispose() はいつもどおり動作します。

2 回目の DeaSdk.init 呼び出しがオプションを無視する

原因: DeaSdk.init が複数回呼び出されました。最初の呼び出しのオプションが有効なままで、後の呼び出しは 実行中のインスタンスを返します。ステージングビルドまたはテストビルドは sdk.init_repeated をログに書き、 dea.option が最初に異なるオプションを示します。

対処: DeaSdk.init は Application.onCreate() で一度だけ呼び出してください。本当に異なるオプションが 必要な場合は、先に DeaSdk.instance?.dispose() を呼び出してください。

原因: 回答が保存されていません。SDK が consent = Consent() で起動された、回答が remember = false で 記録された、またはアプリが先に consent.isAnswered を確認せずに尋ねています。

対処: 端末が共有されている場合を除き、consent オプションはデフォルトの まま、remember は true のままにし、DeaSdk.instance?.consent?.isAnswered == false のときだけ尋ねてください。 DeaConsentDialog.show はこの確認を代わりに行います。

attest() が FAILED を返し、detail に NetworkOnMainThreadException がある

原因: attest() がメインスレッドで呼び出されました。ネットワーク要求を行い、ブロックします。

対処: バックグラウンドスレッドから呼び出してください。

val attestation = withContext(Dispatchers.IO) { DeaSdk.instance?.attest() }

renewAttestation() も同様です。

attest() が UNSUPPORTED を返す

原因: 次のいずれかです。

  1. DeaSdk.init に appKey が渡されていない。その場合 attestation.detail にそのことが示され、要求は行われて いません。
  2. 署名キーを作成できなかった。端末が Android 5.x(API 21 または 22)で動作しており SDK がキーを作成しない、 または端末の Keystore が拒否した。

対処: DEA が appId とともに発行した appKey を渡してください。 オプション: appKeyを参照してください。それ以外の場合は、Android 6.0 以降の 端末でテストしてください。

attest() は成功するが platformAttested が false になる

原因: 登録に Play Integrity トークンが添付されていません。Google Play のないエミュレーター、Google Play 開発者サービスのない端末、および Play が要求を拒否した場合(多くはビルドが Google Play からインストールされて いない、または Play Console に登録されたキーで署名されていないため)には想定される動作です。

対処: Google Play 経由で配布したビルド(たとえば内部テストトラック)を使い、実機でテストしてください。

attest() が FAILED を返し、detail にアテステーションが一時停止中とある

原因: Play Integrity トークンを使った以前の登録が失敗し、SDK が再試行まで待機しています。最初の失敗の後は 1 時間で、最長 7 日間まで倍増します。この待機はアプリの再起動をまたいでも続きます。

対処: 以前の試行が失敗した原因を修正し、forgetAttestation() を呼び出して待機を終了してから、再度 attest() を呼び出してください。

attest() が FAILED を返す

原因: DEA が登録を拒否した、または DEA に到達できませんでした。stopped が null ではない場合、SDK は 要求を行っていません。stopped が null ではないを参照してください。

対処: attestation.detail を読んでください。DEA の応答、またはネットワークエラーが入っています。また、 playIntegrityProject が DEA がアプリ用に発行したプロジェクト番号であることを確認してください。

ログに sdk.app_id_missing が出る

原因: appId が渡されていない、appId が空、または unknown-app です。SDK は DEA が登録していない本番の appId で動作しています。

対処: DEA がこのアプリ向けに発行した appId を渡してください。 アカウントとキーを参照してください。

モデルが更新されない

原因: 更新がオフになっています。DeaSdk.instance?.model?.updateFault が理由を示します。null は更新が 動作していることを意味します。

updateFault 原因 対処
no_core スコアリングエンジンが読み込まれなかった ready が別の理由で false になるを参照
disabled modelUpdates = false が設定された それを取り除く
no_context modelDirectory も Context もない Application を渡して DeaSdk.init(context, config) を呼び出す、または modelDirectory を設定する

対処: 読み取った値の行を適用してください。null の場合、更新は動作しています。確認は起動のたびに行われ、 checkForModel は今すぐ確認します。