---
title: 콜백 / 리스너 인터페이스
canonical: https://developer.unico.io/ko/developers/sdks-and-tools/android/api-reference/callback-listener-interfaces
locale: ko
generated_by: markdown-export
---

- [/ko/](/ko/)
- [SDK 및 도구](/ko/developers/sdks-and-tools/overview)
- [Android SDK](/ko/developers/sdks-and-tools/android/requirements)
- API 레퍼런스
- 콜백 / 리스너 인터페이스

# 콜백 / 리스너 인터페이스

AcessoBioListener
SDK 세션의 라이프사이클 콜백. `AcessoBio` 생성자에 구현체를 전달하세요.

| 메서드 | 트리거 |
| --- | --- |
| `onErrorAcessoBio(error: ErrorBio)` | 세션 중 오류 발생 |
| `onUserClosedCameraManually()` | 사용자가 카메라를 수동으로 닫음 |
| `onSystemClosedCameraTimeoutSession()` | 타임아웃으로 인해 세션 만료 |
| `onSystemChangedTypeCameraTimeoutFaceInference()` | 얼굴 정렬 대기 중 세션 타임아웃 |

iAcessoBioSelfie
셀피 캡처용 콜백. `UnicoCheckCameraOpener.Camera.open()`에 구현체를 전달하세요.

| 메서드 | 트리거 |
| --- | --- |
| `onSuccessSelfie(result: ResultCamera)` | 셀피 캡처 성공 |
| `onSuccess(result: SuccessResult)` | User Journey 완료 — `processId` 반환 |
| `onErrorSelfie(error: ErrorBio)` | 셀피 캡처 중 오류 발생 |

iAcessoBioDocument
문서 캡처용 콜백. `UnicoCheckCameraOpener.Document.open()`에 구현체를 전달하세요.

| 메서드 | 트리거 |
| --- | --- |
| `onSuccessDocument(result: ResultCamera)` | 문서 캡처 성공 |
| `onErrorDocument(error: String)` | 문서 캡처 중 오류 발생 |

CameraListener
셀피 카메라 준비 단계용 콜백. `prepareCamera()`에 전달하세요.

| 메서드 | 트리거 |
| --- | --- |
| `onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera)` | 카메라 준비 완료 — 캡처를 시작하려면 `cameraOpener.open(listener, webAppToken)` 호출 |
| `onCameraFailed(message: String)` | 카메라 준비 실패 |

DocumentCameraListener
문서 카메라 준비 단계용 콜백. `prepareDocumentCamera()`에 전달하세요.

| 메서드 | 트리거 |
| --- | --- |
| `onCameraReady(cameraOpener: UnicoCheckCameraOpener.Document)` | 카메라 준비 완료 — 캡처를 시작하려면 `cameraOpener.open(documentType, listener)` 호출 |
| `onCameraFailed(message: String)` | 카메라 준비 실패 |

마지막 업데이트 **2026년 10월 19일**에