기본 사용법

import io.petnow.ui.CameraController
import io.petnow.ui.CameraResult
import io.petnow.ui.config.LicenseInfo
import io.petnow.ui.status.DetectionStatus
import io.petnow.callback.PetnowCameraDetectionListenerV2

// lifecycleScope 등 화면 수명과 동일한 CoroutineScope를 사용하세요.
val controller = CameraController( 
    context.applicationContext, 
    LicenseInfo(apiKey = "YOUR_API_KEY"), 
    lifecycleScope, 
) 

controller.setDetectionListenerV2(object : PetnowCameraDetectionListenerV2 { 
    override fun onDetectionStatus(primaryDetectionStatus: DetectionStatus) {
        // Step 5에서 구현 — 실시간 가이드
    }

    override fun onDetectionProgress(progress: Int) {
        // Step 5에서 구현 — 진행률 0~100
    }

    override fun onDetectionFinished(result: CameraResult) {
        // Step 4에서 구현 — 최종 결과
    }
})

// CameraView에 연결하면 프리뷰가 시작됩니다.
cameraView.controller = controller 

import io.petnow.ui.config.DetectionConfiguration
import io.petnow.ui.config.DetectionPurpose
import io.petnow.ui.config.PetSpecies
import java.util.UUID

val configuration = DetectionConfiguration(
    species = PetSpecies.DOG,
    purpose = DetectionPurpose.PET_PROFILE_REGISTRATION,
    enableFakeDetection = true,
)

// 서버에서 발급받은 captureSessionId (시작하기 참고)
val captureSessionId: UUID = /* 서버로부터 받은 captureSessionId */

lifecycleScope.launch {
    // CameraView는 직접 권한을 요청하지 않습니다 — 호스트가 먼저 확인하세요.
    if (!hasCameraPermission()) {
        requestCameraPermission()
        return@launch
    }
    controller.initializeCamera(configuration, captureSessionId) 
    controller.startDetection() 
}

override fun onDetectionFinished(result: CameraResult) {
    when (result) {
        is CameraResult.Success -> { 
            // result.fingerprintImageFiles: 생체 인식용 이미지 (강아지=코, 고양이=얼굴)
            // result.appearanceImageFiles: 외형(얼굴) 이미지
            uploadImages(result.fingerprintImageFiles, result.appearanceImageFiles)
        }
        is CameraResult.Fail -> { 
            // 촬영 실패 — 재시도하거나 세션을 종료합니다
            showRetryOrExitDialog()
        }
    }
}

is CameraResult.Fail -> {
    AlertDialog.Builder(requireContext())
        .setTitle("촬영 실패")
        .setMessage("코무늬를 충분히 촬영하지 못했습니다. 다시 시도하시겠습니까?")
        .setPositiveButton("재시도") { _, _ ->
            controller.startDetection() // 같은 세션에서 처음부터 다시 시작
        }
        .setNegativeButton("취소") { _, _ -> navigateBack() }
        .show()
}

override fun onDetectionProgress(progress: Int) { 
    // progress: 0~100
    progressBar.progress = progress
}

override fun onDetectionStatus(primaryDetectionStatus: DetectionStatus) { 
    statusTextView.text = when (primaryDetectionStatus) {
        DetectionStatus.NoObject -> "반려동물을 프레임에 맞춰주세요"
        DetectionStatus.Processing -> "탐지 중..."
        DetectionStatus.Detected -> "좋아요! 그대로 유지하세요"
        DetectionStatus.Finished -> "촬영 완료"
        is DetectionStatus.Failed -> when (primaryDetectionStatus.reason) { 
            DetectionFailureReason.TooClose -> "조금 멀리 떨어져주세요"
            DetectionFailureReason.TooFarAway -> "조금 가까이 다가가주세요"
            DetectionFailureReason.TooDark -> "밝은 곳으로 이동해주세요"
            DetectionFailureReason.NotFrontFace -> "얼굴 정면을 비춰주세요"
            else -> "자세를 조정해주세요"
        }
    }
}

override fun onDestroy() {
    super.onDestroy()
    controller.release() // 화면을 완전히 떠날 때
}

import io.petnow.ui.camera.cameraInfo

if (context.cameraInfo.isFrontCameraSupported) {
    controller.switchCamera() // Result 반환
        .onFailure { e -> Toast.makeText(context, "전환 실패: ${e.message}", Toast.LENGTH_SHORT).show() }
} else {
    Toast.makeText(context, "전면 카메라를 지원하지 않는 기기입니다", Toast.LENGTH_SHORT).show()
}

import io.petnow.ui.PetnowCaptureException
import io.petnow.ui.PetnowUIError
import kotlinx.coroutines.CancellationException

lifecycleScope.launch {
    try {
        controller.initializeCamera(configuration, captureSessionId)
    } catch (c: CancellationException) {
        throw c // 화면 전환/재설정으로 인한 취소 — 정상 생명주기이므로 재던짐
    } catch (e: PetnowUIError) {
        when (e) { // sealed — 세 케이스로 모든 초기화 실패를 망라
            is PetnowUIError.InvalidLicense -> { /* API 키가 서버에서 거부됨 — 키 확인 */ }
            is PetnowUIError.PermissionDenied -> { /* 카메라 권한 누락 — 권한 요청/설정 안내 */ }
            is PetnowUIError.CameraOpenFailed -> { /* 카메라 열기 실패 — 원인은 e.cause */ }
        }
        return@launch
    }

    controller.startDetection() 
        .onSuccess { /* 탐지 시작됨 */ }
        .onFailure { e -> handleDetectionError(e) }
}

private fun handleDetectionError(e: Throwable) {
    when (e) {
        is PetnowCaptureException.InvalidState -> { /* 컨트롤러가 아직 초기화되지 않음 */ }
        is PetnowCaptureException.AlreadyCapturing -> { /* 이미 탐지가 진행 중 */ }
        is PetnowCaptureException.NotSupported -> { /* 현재 기기/설정에서 미지원 */ }
        else -> { /* 기타(PetnowCaptureException.Unknown 등) */ }
    }
}