モニタリングデータ収集

オプション実装

モニタリングデータ収集はオプションです。採用する場合、prepareCamera 呼び出しのみが影響を受けます — キャプチャフローの他のすべてのステップ（初期化、リスナー、結果処理）は変更されません。

キャプチャセッションにユーザーとフローのメタデータを添付することで、Unico 側の監視・オブザーバビリティツールで相関付けることができます。提供された場合、データはキャプチャと一緒に転送されます — SDK のキャプチャ動作や API レスポンスは変更されません。

PrepareInfo attributes

属性	型	必須	説明
externalUserId	String	✅	あなたのシステムにおけるユーザー識別子。送信前に SHA-256 で自動的にハッシュ化されます — 平文では送信されません。
useCase	String	—	実行中のフローまたはコンテキストの識別子（例: "account_opening"、"password_recovery"）。平文で送信されます。

Implementation

PrepareInfo オブジェクトを作成し、prepareCamera の第3引数として渡します。キャプチャフローの他のすべての処理は同じままです。

Kotlin

val extraData = PrepareInfo(
    externalUserId = "external_user_id",
    useCase = "use_case"
)

unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
        cameraOpener?.open(cameraListener)
    }

    override fun onCameraFailed(message: String?) {
        Log.e(TAG, message)
    }
}, extraData)

Java

PrepareInfo extraData = new PrepareInfo("external_user_id", "flow_id");

unicoCheckCamera.prepareCamera(unicoConfig, new CameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Camera cameraOpener) {
        cameraOpener.open(cameraListener);
    }

    @Override
    public void onCameraFailed(String message) {
        Log.e(TAG, message);
    }
}, extraData);