기본 사용법

import android.os.Bundle
import io.petnow.ui.PetnowCameraFragment
import io.petnow.ui.PetnowCameraDetectionListener
import java.util.UUID

class ClientCameraFragment : PetnowCameraFragment(), PetnowCameraDetectionListener { 
  
  companion object {
    fun newInstance(captureSessionId: UUID) = ClientCameraFragment().apply { 
      arguments = Bundle().apply { 
        putString(ARG_CAPTURE_SESSION_ID, captureSessionId.toString()) 
      } 
    } 
  }
  
  override fun provideCustomOverlayLayout(): Int? = null

  override fun onAttach(context: Context) {
      super.onAttach(context)
      setPetnowCameraDetectionListener(this) 
  }

  // Step 3에서 구현
  override fun onDetectionFinished(result: DetectionCaptureResult) { }

  // Step 5에서 구현
  override fun onDetectionProgress(progress: Int) { }
  override fun onDetectionStatus(primaryDetectionStatus: PetnowDetectionStatus) { }
}

// Activity 또는 다른 Fragment에서 ClientCameraFragment 사용
val captureSessionId: UUID = // 서버로부터 받은 captureSessionId

val fragment = ClientCameraFragment.newInstance(captureSessionId) 
supportFragmentManager.beginTransaction()
    .replace(R.id.fragment_container, fragment)
    .commit()

override fun onDetectionFinished(result: DetectionCaptureResult) { 
    when (result) {
        is DetectionCaptureResult.Success -> { 
            val (noseImages, faceImages) = result 
            // 서버에 업로드하거나 다음 화면으로 이동
            uploadImages(noseImages, faceImages)
        }
        is DetectionCaptureResult.Fail -> { 
            // 탐지 실패 — 재시도하거나 세션을 종료합니다
            showRetryOrExitDialog() 
        }
    }
}

is DetectionCaptureResult.Fail -> {
    AlertDialog.Builder(requireContext())
        .setTitle("촬영 실패")
        .setMessage("코무늬를 충분히 촬영하지 못했습니다. 다시 시도하시겠습니까?")
        .setPositiveButton("재시도") { _, _ ->
            resumeDetection() 
                .onSuccess { /* Detection 재시작됨 */ }
                .onFailure { e -> navigateBack() }
        }
        .setNegativeButton("취소") { _, _ ->
            navigateBack() 
        }
        .show()
}

private val cameraPermissionLauncher = registerForActivityResult(
    ActivityResultContracts.RequestPermission()
) { isGranted ->
    if (isGranted) { 
        showCameraFragment() 
    } else {
        // 권한 거부 시 설정 화면으로 안내
        showPermissionDeniedDialog()
    }
}

private fun checkAndLaunchCamera() {
    when {
        ContextCompat.checkSelfPermission(
            this, Manifest.permission.CAMERA
        ) == PackageManager.PERMISSION_GRANTED -> {
            showCameraFragment()
        }
        else -> {
            cameraPermissionLauncher.launch(Manifest.permission.CAMERA)
        }
    }
}

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

override fun onDetectionStatus(primaryDetectionStatus: PetnowDetectionStatus) { 
    // 각 프레임의 탐지 상태를 UI에 반영
    statusTextView.text = when (primaryDetectionStatus) {
        PetnowDetectionStatus.Detected -> "탐지 성공"
        PetnowDetectionStatus.NoObject -> "반려동물을 프레임에 맞춰주세요"
        PetnowDetectionStatus.TooClose -> "조금 멀리 떨어져주세요"
        PetnowDetectionStatus.TooFarAway -> "조금 가까이 다가가주세요"
        PetnowDetectionStatus.TooDark -> "밝은 곳으로 이동해주세요"
        else -> ""
    }
}

val ctx = context ?: return

if (ctx.cameraInfo.isFrontCameraSupported) {
    switchCamera() 
} else {
    Toast.makeText(ctx, "전면 카메라를 지원하지 않는 기기입니다", Toast.LENGTH_SHORT).show()
}

resumeDetection() 
    .onSuccess {
        // Detection 재실행 성공
    }
    .onFailure { error ->
        Toast.makeText(context, "재실행 실패: ${error.message}", Toast.LENGTH_SHORT).show()
    }