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

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

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

AcessoBioManagerDelegate (lifecycle)
| 메서드 | 트리거 |
| --- | --- |
| `onErrorAcessoBioManager(_ error: ErrorBio!)` | SDK 작동 중 구현 오류 발생 |
| `onUserClosedCameraManually()` | 사용자가 카메라를 수동으로 닫음 |
| `onSystemClosedCameraTimeoutSession()` | 타임아웃으로 세션 만료 (기본값: 40초) |
| `onSystemChangedTypeCameraTimeoutFaceInference()` | 13초 동안 얼굴이 감지되지 않음 — 수동 캡처로 전환 |

AcessoBioSelfieDelegate (selfie)
| 메서드 | 트리거 |
| --- | --- |
| `onSuccessSelfie(_ result: SelfieResult!)` | 셀피 캡처 성공 |
| `onSuccess(_ result: SuccessResult!)` | User Journey 완료 — `processId` 반환. Unico API 통합에서 필수 |
| `onErrorSelfie(_ errorBio: ErrorBio!)` | 셀피 캡처 실패 |

AcessoBioDocumentDelegate (document)
| 메서드 | 트리거 |
| --- | --- |
| `onSuccessDocument(_ result: DocumentResult!)` | 문서 캡처 성공 |
| `onErrorDocument(_ errorBio: ErrorBio!)` | 문서 캡처 실패 |

SelfieCameraDelegate / DocumentCameraDelegate (preparation)
| 메서드 | 트리거 |
| --- | --- |
| `onCameraReady(_ cameraOpener: AcessoBioCameraOpenerDelegate!)` | 셀피 카메라가 열릴 준비 완료 |
| `onCameraFailed(_ message: ErrorPrepare!)` | 셀피 카메라 준비 실패 |
| `onCameraReadyDocument(_ cameraOpener: AcessoBioCameraOpenerDelegate!)` | 문서 카메라가 열릴 준비 완료 |
| `onCameraFailedDocument(_ message: ErrorPrepare!)` | 문서 카메라 준비 실패 |

`ErrorPrepare``ErrorPrepare` 타입은 `ErrorBio`의 확장으로, `ErrorBio`의 모든 속성을 포함합니다.

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