MediaStore API: bu nədir, imkanları və ümumi media faylları ilə iş

MediaStore API nədir?

MediaStore API — Android platformasında cihazın media fayllarını indeksləşdirmək, saxlamaq və giriş təmin etmək üçün nəzərdə tutulmuş sistem məzmun provayderidir. API Android SDK-nın tərkibinə daxildir və API Level 1-dən etibarən mövcuddur.

MediaStore vahid media bazası vasitəsilə işləyir, o cihazı avtomatik skan edir və bütün media fayllarının metadata məlumatlarını toplayır. Baza sistem tərəfindən yenilənir fayllar əlavə edildikdə, dəyişdirildikdə və ya silindikdə, beləliklə tətbiqlər həmişə əl ilə skan etmədən aktual məlumat alır.

MediaStore-un əsas cədvəlləri: Images (şəkillər), Video (videolar), Audio (audiolar) və Files (ümumi fayllar). Hər cədvəldə metadata sütunları var: ad, yaradılma tarixi, ölçü, MIME növü, GPS koordinatları və digər atributlar.

Android versiyalarında MediaStore-un təkamülü

Android 10-dan əvvəl tərtibatçılar cihazın bütün fayllarına giriş üçün READ_EXTERNAL_STORAGE istifadə edirdilər. Android 10 (API 29) Scoped Storage təqdim etdi: tətbiqlər yalnız öz fayllarına və MediaStore vasitəsilə giriş əldə etdilər. Android 11 siyasəti sərtləşdirərək paylaşılan qovluqlara birbaşa yolu tamamilə blokladı.

Android 13 (API 33)-dən başlayaraq, Google READ_EXTERNAL_STORAGE-ni xırdalanmış icazələrlə əvəz etdi: READ_MEDIA_IMAGES, READ_MEDIA_VIDEO və READ_MEDIA_AUDIO. Bu, istifadəçiyə bütün yaddaşı açmadan yalnız müəyyən media növlərinə giriş icazəsi verməyə imkan verir.

MediaStore necə işləyir: arxitektura və media bazası

MediaStore məzmun provayderi arxitekturası ilə qurulub: hər tətbiq ona ContentResolver və Uri vasitəsilə müraciət edir. Sistem media skaneri — MediaScannerConnection — yükləmə, USB qoşulması və ya yenidən başlatma zamanı cihazdakı bütün faylları avtomatik indeksləşdirir.

Media bazası sistem verilənlər bazasında saxlanılır və hər media faylı üçün qeydlər ehtiva edir. Sütunlar müxtəlif növlər üçün fərqlənir: şəkillərdə ORIENTATION və DATE_TAKEN, videolarda — DURATION, audiolarda — ARTIST və ALBUM var. Tərtibatçılar filtrasiya üçün projection və selection ilə query vasitəsilə SQL-ə bənzər sorğular yerinə yetirə bilərlər.

val projection = arrayOf(
    MediaStore.Images.Media._ID,
    MediaStore.Images.Media.DISPLAY_NAME,
    MediaStore.Images.Media.DATE_ADDED
)

val cursor = contentResolver.query(
    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
    projection,
    null,
    null,
    MediaStore.Images.Media.DATE_ADDED + " DESC"
)

cursor?.use {
    while (moveToNext()) {
        val name = getString(getColumnIndexOrThrow(MediaStore.Images.Media.DISPLAY_NAME))
    }
}

Content URI və onların əhəmiyyəti

Hər media faylı content://media/external/images/media/1234 şəklində Content URI ilə identifikasiya olunur. Xarici URI (external) ümumi yaddaşı, daxili (internal) — sistem media fayllarını göstərir. URI-dən fayl yolları əvəzinə istifadə — MediaStore-un əsas üstünlüyü: tətbiq fayl sisteminə giriş tələb etmir və təhlükəsiz məzmun provayderi vasitəsilə işləyir.

MediaStore-da media fayl növləri

MediaStore dörd əsas media növünü dəstəkləyir, hər biri ayrı cədvəl və metadata dəsti ilə. Tərtibatçılar tətbiqin işlədiyi məzmun növündən asılı olaraq müvafiq cədvəli seçirlər.

• MediaStore.Images — fotoşəkillər, ekran görüntüləri və rəsmlər. Sütunlar: BUCKET_DISPLAY_NAME, IS_PRIVATE, LATITUDE, LONGITUDE.
• MediaStore.Video — video yazılar və filmlər. Sütunlar: DURATION, RESOLUTION, IS_DRM.
• MediaStore.Audio — musiqi trekləri və səs faylları. Sütunlar: ARTIST, ALBUM, COMPOSER, TRACK.
• MediaStore.Files — sənədlər və qalan fayllar. Android 10-dan etibarən ümumi giriş üçün mövcuddur.

Standart sütunlardan əlavə, hər cədvəldə sistem sahələri var: _ID, DATA (köhnəlmiş), SIZE, MIME_TYPE, DATE_ADDED, DATE_MODIFIED. Android 10 versiyasından DATA sahəsi deprecated olaraq qeyd edilib və tərtibatçılar URI üzrə InputStream açaraq işləməlidirlər.

MediaStore ilə iş üçün icazələr

MediaStore Android versiyasından asılı olaraq fərqlənən açıq icazələr tələb edir. Android 13-dən əvvəl vahid READ_EXTERNAL_STORAGE icazəsi istifadə olunurdu. Android 13 (API 33)-dən başlayaraq, Google hər media növü üçün xırdalanmış icazələr təqdim etdi.

MediaStore-a yazmaq da Android 9 və aşağısı üçün WRITE_EXTERNAL_STORAGE tələb edir. Android 10-dan başlayaraq, tətbiq əlavə icazələr olmadan öz fayllarını MediaStore-a yaza bilər — sistem ContentResolver.insert vasitəsilə qeyd daxil edərkən avtomatik giriş təmin edir.

İş vaxtı icazələrin tələb edilməsi

MediaStore icazələri standart ActivityResultContracts.RequestMultiplePermissions mexanizmi vasitəsilə tələb olunur. İstifadəçi sorğunu rədd edə bilər və tətbiq bu ssenarini düzgün idarə etməlidir. MediaStore-a hər müraciətdən əvvəl ContextCompat.checkSelfPermission vasitəsilə icazənin mövcudluğunu yoxlamaq tövsiyə olunur.

Kod nümunələri: MediaStore vasitəsilə oxuma və yazma

MediaStore təkcə oxumağa deyil, həm də media fayllarını yazmağa imkan verir. Şəkil və ya video yazmaq üçün tərtibatçı ContentResolver.insert istifadə edir və qaytarılmış URI üzrə OutputStream açır. Sistem avtomatik olaraq faylı media bazasına əlavə edir və indeksləşdirir.

val values = ContentValues().apply {
    put(MediaStore.Images.Media.DISPLAY_NAME, "photo_2025.jpg")
    put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg")
    put(MediaStore.Images.Media.RELATIVE_PATH, "Pictures/MyApp")
}

val uri = contentResolver?.insert(
    MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values
)

uri?.let {
    val outputStream = contentResolver?.openOutputStream(it)
    outputStream?.use { stream ->
        // baytları axına yaz
    }
}

MediaStore vasitəsilə media fayllarının silinməsi

Silinmə ContentResolver.delete vasitəsilə faylın URI-ni göstərərək yerinə yetirilir. Sistem giriş hüquqlarını yoxlayır: fayl cari tətbiqə məxsusdursa, silinmə əlavə icazələr olmadan baş verir. Android 10+-da digər tətbiqlərin faylları üçün sistem dialoqu vasitəsilə istifadəçi təsdiqi tələb olunur.

MediaStore və birbaşa fayl girişi

MediaStore API File API vasitəsilə birbaşa fayl girişindən prinsipial olaraq fərqlənir. Fayl yolları əvəzinə Content URI, fayl əməliyyatları əvəzinə — ContentResolver metodları istifadə olunur. Bu üç əsas üstünlük verir: təhlükəsizlik, avtomatik indeksləşdirmə və vahid interfeys.

Birbaşa fayl girişi Android 10+-da ümumi qovluqlar üçün məhdudlaşdırılıb. MediaStore Pictures, DCIM, Movies, Music və Download-dan media oxumağın yeganə yolu olaraq qalır. Tətbiqin öz faylları (app-specific storage) üçün birbaşa giriş qalır — bunlar Android/data və Android/media qovluqlarıdır.

MediaStore və birbaşa giriş arasında seçim məzmun növündən asılıdır. MediaStore digər tətbiqlər üçün əlçatan olan ümumi media faylları üçün məcburidir. Birbaşa File API tətbiqin daxili faylları və keş yaddaşı üçün uyğundur. Storage Access Framework sistem seçicisi vasitəsilə ixtiyari sənədlərin seçilməsi üçün istifadə olunur.