[안드로이드/Kotlin]Photo Picker(갤러리에서 이미지 불러오기)

Photo Picker

Android 13에서 새롭게 공개된 Photo Picker는 앱에 전체 미디어 라이브러리에 대한 액세스 권한을 부여하지 않고도 사용자가 미디어 파일을 선택할 수 있는 안전한 방법을 제공합니다.

사용자가 사진 또는 비디오만 볼 수 있도록 지정할 수 있으며, 이미지 단일 및 다중 선택이 가능합니다.

이 라이브러리는 Android 11 이상의 기기에서만 지원됩니다.

 

 

Photo Picker는 간단히 다음과 같은 과정을 통해 실행됩니다.

 

• registerForActivityResult(ActivityResultContract, Callback) -> ActivityResultLauncher 반환
• ActivityResultLauncher.launch() 실행

Photo Picker를 구현하는 방법은 ActivityResultContract 구현 여부에 따라 두 가지로 나뉩니다.

 

• 수동적으로 Intent 생성 및 결과 핸들링 -> ActivityResultContract  직접 구현
• ActivityResultContract(androidx.activity 라이브러리 제공) 사용

커스텀 및 라이브러리에서 제공되는 ActivityResultContract 클래스를 사용해 Photo Picker를 구현하였습니다 :)

 

커스텀 ActivityResultContracts 사용 

이미지 단일 및 다중선택을 위해 ActivityResultContract를 상속받아 구현할 예정입니다.

Photo Picker의 동작을 커스터마이징하기 위해 ActivityResultContract를 구현하는 과정입니다.

원본 글에는 두 경우를 모두 다루지만 여기서는 단일 선택 경우만 작성하였습니다.

 

1. isPhotoPickerAvailable() 작성

위에서 말한대로 Photo Picker는 Andriod 11 이상의 기기에서만 지원되므로

현재 기기가 Photo Picker를 지원하는지 확인하기 위한 함수를 작성해야 합니다.

+) Android 11 버전의 경우, SDK 확장버전이 사용 가능한 경우도 확인해야 함.

fun isPhotoPickerAvailable(): Boolean {
    return when {
        Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU -> true
        Build.VERSION.SDK_INT >= Build.VERSION_CODES.R -> {
            getExtensionVersion(Build.VERSION_CODES.R) >= ANDROID_R_REQUIRED_EXTENSION_VERSION
        }
        else -> false
    }
}

 

2. ActivityResultContract 클래스 생성

ActivityResultContract 클래스는 createIntent, praseResult 두 메서드를 오버라이드해야합니다.

해당 ActivityResultContract는 단일 이미지 선택에 사용되는 클래스입니다.

private const val MIME_TYPE_IMAGE = "image/*"

class PickSinglePhotoContract : ActivityResultContract<Void?, Uri?>() {

    override fun createIntent(context: Context, input: Void?): Intent {

        return Intent(if (PhotoPickerAvailabilityChecker.isPhotoPickerAvailable()) {
            Intent(MediaStore.ACTION_PICK_IMAGES)
        } else {
            Intent(Intent.ACTION_OPEN_DOCUMENT)
        }).apply { type = MIME_TYPE_IMAGE }
    }

    override fun parseResult(resultCode: Int, intent: Intent?): Uri? {
        return intent.takeIf { resultCode == Activity.RESULT_OK }?.data
    }
}

createIntent는 이미지 선택을 위한 인텐트를 생성하는 함수이고,

parseResult는 이미지 선택 후 인텐트에서 이미지 Uri를 받아오는 함수입니다.

만약, 이미지가 선택되지 않았을 경우에 Uri값은 null이 됩니다.

 

+) 추가적으로 Photo Picker가 지원되지 않는 경우, 일반적인 방식으로 구현해야 하고 이미지를 선택하기 위해 시스템의 파일 브라우저를 시작하는 Intent.ACTION_OPEN_DOCUMENT를 사용해야 합니다.

 

3. Photo Picker Contract Launch

2단계에서 작성한 Contract를 가지고 ActivityResultLauncher를 반환하는 registerForActivityResult 메서드를 실행한다. registerForActivityResult 에 Contract와 콜백 람다 함수를 인수로 넣습니다..

콜백 함수 안에는 선택한 이미지 Uri 처리 코드를 작성해줍니다.

launch() 메서드를 통해 ActivityResultLauncher 작업을 실행합니다.

 private val singlePhotoPickerLauncher = registerForActivityResult(PickSinglePhotoContract()) { imageUri: Uri? ->
        imageUri?.let(viewModel::setImageUri)
    }

    private fun pickPhoto() = singlePhotoPickerLauncher.launch()

* setImageUri 함수는 Uri를 비트맵으로 변환하는 함수

앱 세션에서 Uri 권한을 유지하려면 저장소 액세스 프레임워크에 명시적으로 의존해야 하므로 Intent.ACTION_OPEN_DOCUMENT를 대신 사용한다. 각 Uri 및 필수권한 플래그와 함께 contentResolver.takePersistableUriPermission(..)을 호출하여 수신 Uri에 대한 액세스를 유지할 수 있다.

자세한 내용은 아래 첨부된 글을 확인하길 바란다.

미리 정의된 ActivityResultContract 사용

ActivityResultContract는 androidx.activity 라이브러리에서 제공합니다.

 

1. build.gradle(앱 모듈)

버전은 공식 사이트에서 최신 버전을 확인해주세요!

커스텀 과정에서 작성한 isPhotoPickerAvailable() 함수 또한 해당 라이브러리에 정의되어 있습니다.

dependencies {
    ..
    implementation "androidx.activity:activity-ktx:$latest_version"
}

 

2. Single Photo Selection

단일 이미지 선택에 사용되는 contract는 PickVisualMedia 입니다.

해당 Contract를 Launch할 때 MIME 유형을 정의하는 옵션이 제공됩니다.

contract가 자동적으로 호환성을 확인하므로 간단하게 Launcher를 실행하기만 하면 됩니다.

* 해당 기기가 Photo Picker를 지원하지 않을 경우 fallback은 ACTION_OPEN_DOCUMENT 인텐트

private val singlePhotoPickerLauncher = registerForActivityResult(ActivityResultContracts.PickVisualMedia()) { imageUri: Uri? ->
    imageUri?.let(viewModel::setImageUri)
}

private fun pickPhoto() {
    singlePhotoPickerLauncher.launch(PickVisualMediaRequest(ActivityResultContracts.PickVisualMedia.ImageOnly))
}

launch 메서드의 인수로 PickVisualMediaRequest 인스턴스와 PickVisualMedia 타입을 추가해 커스터마이징할 수 있으며, 가능한 타입은 다음과 같습니다.

 

• Select image and video: PickVisualMedia.ImageAndVideo
• Select image only: PickVisualMedia.ImageOnly
• Select video only: PickVisualMedia.VideoOnly
• Select other MIME types: PickVisualMedia.SingleMimeType("YourMimeType")

---

👍https://medium.com/tech-takeaways/android-13-photo-picker-with-the-activity-result-api-b4a74572e354

Android 13 Photo Picker With The Activity Result API

https://developer.android.com/training/data-storage/shared/photopicker?hl=ko 

사진 선택 도구  |  Android 개발자  |  Android Developers

No matching ... gradle 8.0.0 관련 에러

File -> Settings -> Build, Execution, Deployment -> Build Tools -> Gradle 들어가 JDK를 11로 변경

---

https://github.com/Dhaval2404/ImagePicker

GitHub - Dhaval2404/ImagePicker: 📸Image Picker for Android, Pick an image from Gallery or Capture a new image with Camera

https://rccode.tistory.com/288

[Kotlin] Android Custom Gallery Image Picker 만들기

https://aal-izz-well.tistory.com/entry/%EC%95%88%EB%93%9C%EB%A1%9C%EC%9D%B4%EB%93%9C%EC%BD%94%ED%8B%80%EB%A6%B0-%EC%B9%B4%EB%A9%94%EB%9D%BC%EA%B0%A4%EB%9F%AC%EB%A6%AC-%EC%82%AC%EC%A7%84-%EC%9D%B4%EB%AF%B8%EC%A7%80%EB%B7%B0%EC%97%90-%EB%A1%9C%EB%94%A9%ED%95%98%EA%B8%B0

[안드로이드/코틀린] 카메라/갤러리 사진 이미지뷰에 로딩하기