Photo Library Permission — mga batayan, uri ng access at prinsipyo ng paggana

Mga batayan ng Photo Library Permission

Photo Library Permission — ay ang system permission na kumokontrol sa access ng app sa mga media file na naka-store sa device. Sinasaklaw nito ang parehong pagbabasa (pagtingin at pagpili ng mga larawan at video) at pagsusulat (pag-save ng mga bagong file sa gallery). Itinuturing ng mga mobile platform ang media library bilang kumpidensyal na data, dahil ang mga larawan ay maaaring maglaman ng personal at sensitibong impormasyon.

Sa Android 13 (API 33) hinati ng Google ang iisang permission na READ_EXTERNAL_STORAGE sa tatlong hiwalay: READ_MEDIA_IMAGES para sa mga larawan, READ_MEDIA_VIDEO para sa mga video, at READ_MEDIA_AUDIO para sa audio. Ito ay nagpapahintulot sa user na magbigay ng access lamang sa isang partikular na uri ng media file. Sa iOS, simula sa iOS 14, ang PhotoKit ay nagbibigay sa user ng kakayahang pumili ng mga tiyak na larawan para sa access, sa halip na buksan ang buong library.

Ayon sa Counterpoint Research (2024), higit sa 70% ng mga mobile app sa mga kategorya ng social network, komunikasyon, at photo editor ay humihingi ng Photo Library Permission. Samantala, 32% ng mga user ay tumatanggi sa access sa gallery kung hindi nila nauunawaan kung bakit kailangan ng app ang kanilang mga larawan. Inirerekomenda ng Apple at Google ang paggamit ng system PhotoPicker para pumili ng indibidwal na mga file nang hindi humihingi ng buong access.

Access sa gallery sa Android

Access sa gallery sa Android ay nagbago nang malaki sa paglabas ng Android 13. Sa halip na iisang permission na READ_EXTERNAL_STORAGE, lumitaw ang mga granular na permission para sa bawat uri ng media file, na nagbibigay sa user ng mas maraming kontrol.

Mga permission sa Android 13+

Simula sa Android 13, para sa access sa mga larawan ay ginagamit ang READ_MEDIA_IMAGES, para sa mga video — READ_MEDIA_VIDEO. Ang permission na READ_EXTERNAL_STORAGE ay hindi na nagbibigay ng access sa mga media file — nanatili lamang ito para sa pagbabasa ng mga non-media file mula sa shared storage. Ang deklarasyon sa manifest ay ganito ang hitsura:

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

Pagkatugma sa Android 12 at mas mababa

Para sa backward compatibility sa Android 12 at mas mababa, kailangan din ideklara ang READ_EXTERNAL_STORAGE. Gayunpaman, awtomatikong binabalewala ng Android 13 ang permission na ito kapag may mga bagong granular na permission. Gamitin ang attribute na android:maxSdkVersion="32" sa manifest para sa lumang permission, upang itago ito sa mga bagong bersyon. Ito ay pumipigil sa labis na paghiling sa mga device na may Android 13+.

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />

Runtime request sa Kotlin

Ang runtime request para sa Photo Library Permission sa Android ay ginagawa sa pamamagitan ng Activity Result API. Halimbawa ng paghiling ng access sa mga imahe:

private val photoPermissionLauncher =
    registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
    if (granted) {
        loadGalleryImages()
    } else {
        showPermissionDenied()
    }
}

fun pickPhoto() {
    val permission = if (Build.version.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        Manifest.permission.READ_MEDIA_IMAGES
    } else {
        Manifest.permission.READ_EXTERNAL_STORAGE
    }
    if (ContextCompat.checkSelfPermission(this, permission)
        == PackageManager.PERMISSION_GRANTED) {
        loadGalleryImages()
    } else {
        photoPermissionLauncher.launch(permission)
    }
}

Access sa gallery sa iOS

Access sa gallery sa iOS ay pinamamahalaan sa pamamagitan ng PhotoKit framework at ang mga key na NSPhotoLibraryUsageDescription at NSPhotoLibraryAddUsageDescription sa Info.plist. Simula sa iOS 14, ang user ay maaaring magbigay ng access lamang sa mga piling larawan (Limited Photo Library).

Konfigurasyon ng Info.plist

Para sa pagbabasa ng mga larawan mula sa library ay kinakailangan ang NSPhotoLibraryUsageDescription, para sa pagsusulat (pag-save ng mga larawan) — NSPhotoLibraryAddUsageDescription. Kung ang app ay nagse-save lamang ng media ngunit hindi nagbabasa, ang pangalawang key ay sapat na.

<key>NSPhotoLibraryUsageDescription</key>
<string>Ang app ay nangangailangan ng access sa mga larawan upang pumili ng profile image at mag-publish ng mga larawan.</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>Ang app ay nangangailangan ng access upang i-save ang mga naprosesong larawan sa iyong gallery.</string>

Request sa Swift

Ang paghiling ng access sa mga larawan sa iOS ay ginagawa sa pamamagitan ng PHPhotoLibrary.requestAuthorization. Simula sa iOS 14, ang status na .limited ay nagpapahiwatig na ang user ay nagbigay ng access sa isang limitadong set ng mga larawan.

import PhotosUI

func requestPhotoLibraryAccess() {
    PHPhotoLibrary.requestAuthorization { status in
        DispatchQueue.main.async {
            switch status {
            case .authorized:
                self.loadPhotoLibrary()
            case .limited:
                self.loadSelectedPhotos()
            case .denied, .restricted:
                self.showSettingsAlert()
            case .notDetermined:
                break
            }
        }
    }
}

private func loadPhotoLibrary() {
    let fetchOptions = PHFetchOptions()
    fetchOptions.sortDescriptors = [NSSortDescriptor(key: "creationDate", ascending: false)]
    let assets = PHAsset.fetchAssets(with: .image, options: fetchOptions)
    // Pagtatrabaho sa mga resulta ng kahilingan
}

Pangangasiwa ng limitadong access

Ang status na .limited sa iOS 14+ ay nangangahulugan na ang user ay nagbigay lamang ng access sa ilang piling larawan. Ang app ay maaaring humingi ng pagpapalawak ng access sa pamamagitan ng system dialog sa pagtawag ng PHPhotoLibrary.shared().presentLimitedLibraryPicker. Inirerekomenda na ipakita ang dialog na ito lamang kapag ang user ay tahasang humihingi ng function na nangangailangan ng karagdagang mga larawan.

PhotoPicker vs system permission

PhotoPicker — ay isang system component para sa pagpili ng mga media file na hindi nangangailangan ng permission na ma-access ang buong library. Simula sa Android 13 at iOS 14, inirerekomenda ng Google at Apple ang paggamit ng PhotoPicker sa halip na humingi ng Photo Library Permission, kung ang app ay kailangan lamang pumili ng isa o ilang mga larawan.

PhotoPicker sa Android

Sa Android 13+, ang built-in na PhotoPicker (ActivityResultContracts.PickVisualMedia) ay nagpapahintulot sa user na pumili ng larawan o video nang hindi binibigyan ng access ang buong gallery. Ang app ay tumatanggap lamang ng URI ng mga piling file. Gumagana ang PhotoPicker nang hindi nagdedeklara ng anumang permission sa manifest.

private val pickMedia =
    registerForActivityResult(ActivityResultContracts.PickVisualMedia()) { uri ->
    if (uri != null) {
        // URI ng piling file, nang walang access sa buong library
        showImage(uri)
    }
}

fun selectPhoto() {
    pickMedia.launch(PickVisualMediaRequest(ActivityResultContracts.PickVisualMedia.ImageOnly))
}

PHPicker sa iOS

Sa iOS 14+ ay lumitaw ang PHPickerViewController — isang system picker na hindi rin nangangailangan ng access sa buong library. Gumagana ang PHPicker sa isang hiwalay na proseso at walang access sa library ng app. Ito ang mas pinipiling paraan ng pagpili ng mga larawan para sa karamihan ng mga sitwasyon.

import PhotosUI

func presentPhotoPicker() {
    var config = PHPickerConfiguration()
    config.selectionLimit = 1
    config.filter = .images

    let picker = PHPickerViewController(configuration: config)
    picker.delegate = self
    present(picker, animated: true)
}

Kailan kinakailangan ang buong permission

Ang PhotoPicker ay hindi angkop kung ang app ay nangangailangan ng access sa buong library para sa malawakang operasyon: backup, pag-sync sa cloud, gallery app, file manager. Sa mga kasong ito, kinakailangan humingi ng Photo Library Permission at pangasiwaan ang kaso ng limitadong access (Limited). Para sa iOS, obligado ang pagdagdag ng pangangasiwa sa status na .limited at pag-alok sa user na palawakin ang access.

Pinakamahusay na kasanayan sa access sa gallery

Pinakamahusay na kasanayan sa pagtatrabaho sa Photo Library Permission ay tumutulong na bawasan ang bilang ng mga pagtanggi at matugunan ang mga kinakailangan sa privacy ng mga platform.

Gamitin ang PhotoPicker bilang default

Para sa pagpili ng isa o ilang mga larawan, gamitin ang system PhotoPicker o PHPicker. Ang mga component na ito ay hindi nangangailangan ng permission at nagbibigay ng pinakamahusay na karanasan ng user. Humingi lamang ng buong permission sa gallery kung ang functionality ng app ay nangangailangan ng access sa buong media library. Google at Apple ay tahasang inirerekomenda ang pamamaraang ito sa dokumentasyon para sa mga developer.

Ipaliwanag ang dahilan ng buong access

Kung ang app ay talagang nangangailangan ng buong access sa gallery, magpakita ng paunang screen na may paliwanag. Ipaliwanag kung bakit kailangan ang lahat ng larawan, hindi lamang isa. Halimbawa, ang isang backup app ay dapat magpaliwanag na ito ay mag-scan ng lahat ng media file upang lumikha ng kopya. Ang Pre-permission screen ay lalong mahalaga sa iOS dahil sa mekanismo ng Limited Access.

Humingi lamang ng kinakailangang mga permission

Kung ang app ay nagse-save lamang ng mga larawan ngunit hindi nagbabasa (hal., photo editor na nagse-save ng resulta), humingi lamang ng permission sa pagsusulat sa gallery. Sa Android ito ay WRITE_EXTERNAL_STORAGE (para sa Android 12 at mas mababa) o MediaStore API nang walang permission (para sa Android 10+). Sa iOS gamitin ang NSPhotoLibraryAddUsageDescription nang walang NSPhotoLibraryUsageDescription.