หน้านี้ได้รับการแปลโดย Cloud Translation API

เข้าถึงไฟล์สื่อจากพื้นที่เก็บข้อมูลที่ใช้ร่วมกัน

เพื่อมอบประสบการณ์ที่ดียิ่งขึ้นให้แก่ผู้ใช้ แอปจำนวนมากอนุญาตให้ผู้ใช้มีส่วนร่วม และเข้าถึงสื่อที่มีอยู่ในวอลุ่มที่จัดเก็บข้อมูลภายนอก เฟรมเวิร์กนี้มีดัชนีที่เพิ่มประสิทธิภาพสำหรับคอลเล็กชันสื่อ ซึ่งเรียกว่าที่เก็บสื่อ ซึ่งช่วยให้ผู้ใช้เรียกข้อมูลและอัปเดตไฟล์สื่อเหล่านี้ได้ง่ายขึ้น ไฟล์เหล่านี้จะยังคงอยู่ในอุปกรณ์ของผู้ใช้แม้ว่าจะถอนการติดตั้งแอปแล้วก็ตาม

เครื่องมือเลือกรูปภาพ

นอกจากการใช้ Media Store แล้ว เครื่องมือเลือกรูปภาพของ Android มอบวิธีในตัวที่ปลอดภัยสำหรับผู้ใช้ในการเลือกไฟล์สื่อโดยไม่ต้อง เพื่อให้สิทธิ์แอปของคุณเข้าถึงคลังสื่อทั้งหมด พร้อมให้ใช้งานเท่านั้น บนอุปกรณ์ที่รองรับ สำหรับข้อมูลเพิ่มเติม โปรดดู เครื่องมือเลือกรูปภาพ

ร้านค้าสื่อ

หากต้องการโต้ตอบกับสื่อที่เก็บข้อมูลแบบนามธรรม ให้ใช้ออบเจ็กต์ ContentResolver ที่คุณดึงมาจากบริบทของแอป

KotlinJava

val projection = arrayOf(media-database-columns-to-retrieve)
val selection = sql-where-clause-with-placeholder-variables
val selectionArgs = values-of-placeholder-variables
val sortOrder = sql-order-by-clause

applicationContext.contentResolver.query(
    MediaStore.media-type.Media.EXTERNAL_CONTENT_URI,
    projection,
    selection,
    selectionArgs,
    sortOrder
)?.use { cursor ->
    while (cursor.moveToNext()) {
        // Use an ID column from the projection to get
        // a URI representing the media item itself.
    }
}

String[] projection = new String[] {
        media-database-columns-to-retrieve
};
String selection = sql-where-clause-with-placeholder-variables;
String[] selectionArgs = new String[] {
        values-of-placeholder-variables
};
String sortOrder = sql-order-by-clause;

Cursor cursor = getApplicationContext().getContentResolver().query(
    MediaStore.media-type.Media.EXTERNAL_CONTENT_URI,
    projection,
    selection,
    selectionArgs,
    sortOrder
);

while (cursor.moveToNext()) {
    // Use an ID column from the projection to get
    // a URI representing the media item itself.
}

ระบบจะสแกนวอลุ่มที่จัดเก็บข้อมูลภายนอกและเพิ่มไฟล์สื่อโดยอัตโนมัติ คอลเล็กชันที่กำหนดมาอย่างดีดังต่อไปนี้

รูปภาพ รวมถึงภาพถ่ายและภาพหน้าจอ ซึ่งจัดเก็บไว้ใน ไดเรกทอรี DCIM/ และ Pictures/ ระบบจะเพิ่มไฟล์เหล่านี้ลงในตาราง MediaStore.Images
วิดีโอที่จัดเก็บไว้ในไดเรกทอรี DCIM/, Movies/ และ Pictures/ ระบบจะเพิ่มไฟล์เหล่านี้ลงในส่วน ตาราง MediaStore.Video
ไฟล์เสียง ซึ่งจัดเก็บไว้ใน Alarms/, Audiobooks/, Music/ Notifications/, Podcasts/ และ Ringtones/ ไดเรกทอรี นอกจากนี้ ระบบจะจดจำเพลย์ลิสต์เสียงที่อยู่ในไดเรกทอรี Music/ หรือ Movies/ รวมถึงไฟล์บันทึกเสียงที่อยู่ในไดเรกทอรี Recordings/ ระบบจะเพิ่มไฟล์เหล่านี้ลงในตาราง MediaStore.Audio ไดเรกทอรี Recordings/ ไม่พร้อมใช้งานใน Android 11 (API ระดับ 30) และต่ำกว่า
ไฟล์ที่ดาวน์โหลด ซึ่งจัดเก็บไว้ในไดเรกทอรี Download/ เปิด อุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไป ระบบจะจัดเก็บไฟล์เหล่านี้ใน MediaStore.Downloads ตารางนี้ไม่พร้อมใช้งานใน Android 9 (API ระดับ 28) และต่ำกว่า

ร้านค้าสื่อยังมีคอลเล็กชันชื่อ MediaStore.Files ด้วย เนื้อหาของไฟล์จะขึ้นอยู่กับว่าแอปของคุณใช้พื้นที่เก็บข้อมูลแบบจำกัดหรือไม่ ซึ่งใช้ได้กับแอปที่กำหนดเป้าหมายเป็น Android 10 ขึ้นไป

หากเปิดใช้พื้นที่เก็บข้อมูลแบบจำกัด คอลเล็กชันจะแสดงเฉพาะรูปภาพ วิดีโอ และไฟล์เสียงที่แอปของคุณสร้างขึ้น นักพัฒนาแอปส่วนใหญ่ไม่จำเป็นต้องใช้ MediaStore.Files เพื่อดูไฟล์สื่อจากแอปอื่นๆ แต่หากมีข้อกำหนดเฉพาะในการดำเนินการดังกล่าว คุณสามารถประกาศสิทธิ์ READ_EXTERNAL_STORAGE ได้ อย่างไรก็ตาม เราขอแนะนำให้คุณใช้ MediaStore API เพื่อเปิดไฟล์ที่แอปไม่ได้สร้าง
หากพื้นที่เก็บข้อมูลที่กำหนดขอบเขตไม่พร้อมใช้งานหรือไม่ได้ใช้งาน คอลเล็กชันจะแสดง ประเภทไฟล์สื่อ

ขอสิทธิ์ที่จำเป็น

ก่อนดำเนินการกับไฟล์สื่อ โปรดตรวจสอบว่าแอปของคุณได้ประกาศสิทธิ์ที่จําเป็นในการเข้าถึงไฟล์เหล่านี้แล้ว อย่างไรก็ตาม โปรดระวังอย่า ประกาศสิทธิ์ที่แอปของคุณไม่จำเป็นต้องใช้หรือไม่ได้ใช้

สิทธิ์เข้าถึงพื้นที่เก็บข้อมูล

แอปต้องการสิทธิ์ในการเข้าถึงพื้นที่เก็บข้อมูลหรือไม่นั้นขึ้นอยู่กับการเข้าถึงพื้นที่เก็บข้อมูล เฉพาะไฟล์สื่อของตนเองหรือไฟล์ที่สร้างโดยแอปอื่น

เข้าถึงไฟล์สื่อของคุณเอง

สำหรับอุปกรณ์ที่ใช้ Android 10 ขึ้นไป คุณไม่จำเป็นต้อง สิทธิ์เกี่ยวกับพื้นที่เก็บข้อมูลเพื่อเข้าถึงและแก้ไขไฟล์สื่อที่ ที่แอปของคุณเป็นเจ้าของ รวมถึงไฟล์ในMediaStore.Downloads คอลเล็กชัน ตัวอย่างเช่น หากคุณพัฒนาแอปกล้องถ่ายรูป คุณไม่จำเป็น ขอสิทธิ์เกี่ยวกับพื้นที่เก็บข้อมูลเพื่อเข้าถึงรูปภาพที่ถ่ายไว้ เนื่องจาก แอปเป็นเจ้าของรูปภาพที่คุณเขียนไปยังร้านค้าสื่อ

เข้าถึงแอปอื่นๆ ไฟล์สื่อ

หากต้องการเข้าถึงไฟล์สื่อที่แอปอื่นๆ สร้างขึ้น คุณต้องประกาศ สิทธิ์ที่เกี่ยวข้องกับพื้นที่เก็บข้อมูลที่เหมาะสม และไฟล์ต้องอยู่ในหนึ่งใน คอลเล็กชันสื่อต่อไปนี้

ตราบใดที่ไฟล์ดูได้จากข้อความค้นหา MediaStore.Images, MediaStore.Video หรือ MediaStore.Audio ผู้ใช้ก็จะดูไฟล์ดังกล่าวได้โดยใช้ข้อความค้นหา MediaStore.Files ด้วย

ข้อมูลโค้ดต่อไปนี้แสดงวิธีประกาศสิทธิ์การจัดเก็บที่เหมาะสม

<!-- Required only if your app needs to access images or photos
     that other apps created. -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

<!-- Required only if your app needs to access videos
     that other apps created. -->
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

<!-- Required only if your app needs to access audio files
     that other apps created. -->
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />

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

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
                 android:maxSdkVersion="29" />

ต้องมีสิทธิ์เพิ่มเติมสำหรับแอปที่ทำงานในอุปกรณ์เดิม

หากแอปของคุณใช้บนอุปกรณ์ที่ใช้ Android 9 หรือต่ำกว่า หรือหากแอปเลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดชั่วคราว คุณต้องขอสิทธิ์ READ_EXTERNAL_STORAGE เพื่อเข้าถึงไฟล์สื่อ หากต้องการแก้ไขไฟล์สื่อ คุณต้องขอสิทธิ์จากWRITE_EXTERNAL_STORAGE ด้วย

ต้องมีเฟรมเวิร์กการเข้าถึงพื้นที่เก็บข้อมูลสำหรับการเข้าถึงแอปอื่น ดาวน์โหลด

หากแอปต้องการเข้าถึงไฟล์ภายในMediaStore.Downloadsคอลเล็กชัน ที่แอปไม่ได้สร้าง คุณต้องใช้ Storage Access Framework เพื่อเรียนรู้ เพิ่มเติมเกี่ยวกับวิธีการใช้เฟรมเวิร์กนี้ โปรดดูที่เข้าถึงเอกสารและไฟล์อื่นๆ จาก พื้นที่เก็บข้อมูลที่ใช้ร่วมกัน

สิทธิ์เข้าถึงตำแหน่งของสื่อ

หากแอปกำหนดเป้าหมายเป็น Android 10 (API ระดับ 29) ขึ้นไปและจำเป็นต้องดึงข้อมูลเมตา EXIF ที่ไม่ปกปิดออกจากรูปภาพ คุณต้องประกาศสิทธิ์ ACCESS_MEDIA_LOCATION ในไฟล์ Manifest ของแอป จากนั้นขอสิทธิ์นี้เมื่อรันไทม์

ตรวจหาการอัปเดตที่เก็บสื่อ

เพื่อให้เข้าถึงไฟล์สื่อได้อย่างน่าเชื่อถือมากขึ้น โดยเฉพาะเมื่อแอปแคช URI หรือ จากที่เก็บสื่อ ให้ตรวจสอบว่าเวอร์ชันที่เก็บสื่อมีการเปลี่ยนแปลงหรือไม่ เมื่อเทียบกับตอนที่คุณซิงค์ข้อมูลสื่อครั้งล่าสุด หากต้องการดำเนินการตรวจสอบนี้ การอัปเดต, โทร getVersion() เวอร์ชันที่แสดงผลคือสตริงที่ไม่ซ้ำกันซึ่งจะเปลี่ยนแปลงทุกครั้งที่ร้านค้าสื่อมีการเปลี่ยนแปลงที่สำคัญ หากเวอร์ชันที่แสดงผลแตกต่างจากเวอร์ชันที่ซิงค์ล่าสุด ให้สแกนใหม่และซิงค์แคชสื่อของแอปอีกครั้ง

ดำเนินการตรวจสอบนี้ให้เสร็จสมบูรณ์ตามเวลาเริ่มต้นกระบวนการของแอป คุณไม่จำเป็นต้องตรวจสอบเวอร์ชันทุกครั้งที่ค้นหาร้านค้าสื่อ

อย่าคาดเดารายละเอียดการใช้งานเกี่ยวกับหมายเลขเวอร์ชัน

ค้นหาคอลเล็กชันสื่อ

หากต้องการค้นหาสื่อที่ตรงกับชุดเงื่อนไขหนึ่งๆ เช่น ระยะเวลา 5 นาทีขึ้นไป ให้ใช้คำสั่งการเลือกแบบ SQL คล้ายกับที่แสดงในตัวอย่างโค้ดต่อไปนี้

KotlinJava

// Need the READ_EXTERNAL_STORAGE permission if accessing video files that your
// app didn't create.

// Container for information about each video.
data class Video(val uri: Uri,
    val name: String,
    val duration: Int,
    val size: Int
)
val videoList = mutableListOf<Video>()

val collection =
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        MediaStore.Video.Media.getContentUri(
            MediaStore.VOLUME_EXTERNAL
        )
    } else {
        MediaStore.Video.Media.EXTERNAL_CONTENT_URI
    }

val projection = arrayOf(
    MediaStore.Video.Media._ID,
    MediaStore.Video.Media.DISPLAY_NAME,
    MediaStore.Video.Media.DURATION,
    MediaStore.Video.Media.SIZE
)

// Show only videos that are at least 5 minutes in duration.
val selection = "${MediaStore.Video.Media.DURATION} >= ?"
val selectionArgs = arrayOf(
    TimeUnit.MILLISECONDS.convert(5, TimeUnit.MINUTES).toString()
)

// Display videos in alphabetical order based on their display name.
val sortOrder = "${MediaStore.Video.Media.DISPLAY_NAME} ASC"

val query = ContentResolver.query(
    collection,
    projection,
    selection,
    selectionArgs,
    sortOrder
)
query?.use { cursor ->
    // Cache column indices.
    val idColumn = cursor.getColumnIndexOrThrow(MediaStore.Video.Media._ID)
    val nameColumn =
            cursor.getColumnIndexOrThrow(MediaStore.Video.Media.DISPLAY_NAME)
    val durationColumn =
            cursor.getColumnIndexOrThrow(MediaStore.Video.Media.DURATION)
    val sizeColumn = cursor.getColumnIndexOrThrow(MediaStore.Video.Media.SIZE)

    while (cursor.moveToNext()) {
        // Get values of columns for a given video.
        val id = cursor.getLong(idColumn)
        val name = cursor.getString(nameColumn)
        val duration = cursor.getInt(durationColumn)
        val size = cursor.getInt(sizeColumn)

        val contentUri: Uri = ContentUris.withAppendedId(
            MediaStore.Video.Media.EXTERNAL_CONTENT_URI,
            id
        )

        // Stores column values and the contentUri in a local object
        // that represents the media file.
        videoList += Video(contentUri, name, duration, size)
    }
}

// Need the READ_EXTERNAL_STORAGE permission if accessing video files that your
// app didn't create.

// Container for information about each video.
class Video {
    private final Uri uri;
    private final String name;
    private final int duration;
    private final int size;

    public Video(Uri uri, String name, int duration, int size) {
        this.uri = uri;
        this.name = name;
        this.duration = duration;
        this.size = size;
    }
}
List<Video> videoList = new ArrayList<Video>();

Uri collection;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    collection = MediaStore.Video.Media.getContentUri(MediaStore.VOLUME_EXTERNAL);
} else {
    collection = MediaStore.Video.Media.EXTERNAL_CONTENT_URI;
}

String[] projection = new String[] {
    MediaStore.Video.Media._ID,
    MediaStore.Video.Media.DISPLAY_NAME,
    MediaStore.Video.Media.DURATION,
    MediaStore.Video.Media.SIZE
};
String selection = MediaStore.Video.Media.DURATION +
        " >= ?";
String[] selectionArgs = new String[] {
    String.valueOf(TimeUnit.MILLISECONDS.convert(5, TimeUnit.MINUTES));
};
String sortOrder = MediaStore.Video.Media.DISPLAY_NAME + " ASC";

try (Cursor cursor = getApplicationContext().getContentResolver().query(
    collection,
    projection,
    selection,
    selectionArgs,
    sortOrder
)) {
    // Cache column indices.
    int idColumn = cursor.getColumnIndexOrThrow(MediaStore.Video.Media._ID);
    int nameColumn =
            cursor.getColumnIndexOrThrow(MediaStore.Video.Media.DISPLAY_NAME);
    int durationColumn =
            cursor.getColumnIndexOrThrow(MediaStore.Video.Media.DURATION);
    int sizeColumn = cursor.getColumnIndexOrThrow(MediaStore.Video.Media.SIZE);

    while (cursor.moveToNext()) {
        // Get values of columns for a given video.
        long id = cursor.getLong(idColumn);
        String name = cursor.getString(nameColumn);
        int duration = cursor.getInt(durationColumn);
        int size = cursor.getInt(sizeColumn);

        Uri contentUri = ContentUris.withAppendedId(
                MediaStore.Video.Media.EXTERNAL_CONTENT_URI, id);

        // Stores column values and the contentUri in a local object
        // that represents the media file.
        videoList.add(new Video(contentUri, name, duration, size));
    }
}

โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อทำการค้นหาดังกล่าวในแอป

เรียกใช้เมธอด query() ในชุดข้อความของผู้ปฏิบัติงาน
แคชดัชนีคอลัมน์เพื่อให้คุณไม่ต้องเรียก getColumnIndexOrThrow() ทุกครั้งที่คุณประมวลผลแถวจากผลการค้นหา
เพิ่มรหัสต่อท้าย URI เนื้อหาดังที่แสดงในตัวอย่างนี้
อุปกรณ์ที่ใช้ Android 10 ขึ้นไปต้องใช้ชื่อคอลัมน์ที่กําหนดไว้ใน MediaStore API หากไลบรารีที่ขึ้นต่อกันภายในแอปของคุณต้องการชื่อคอลัมน์ที่ไม่ได้ระบุไว้ใน API เช่น "MimeType" ให้ใช้ CursorWrapper เพื่อแปลชื่อคอลัมน์ในกระบวนการของแอปแบบไดนามิก

โหลดภาพขนาดย่อของไฟล์

หากแอปแสดงไฟล์สื่อหลายไฟล์และคําขอที่ผู้ใช้เลือก ไฟล์เหล่านี้จะทำให้การโหลดตัวอย่างมีประสิทธิภาพมากขึ้น เวอร์ชันหรือภาพปกของ แทนตัวไฟล์เอง

หากต้องการโหลดภาพขนาดย่อของไฟล์สื่อ ให้ใช้ loadThumbnail() แล้วส่งขนาดของภาพขนาดย่อที่ต้องการโหลด ดังที่แสดงในข้อมูลโค้ดต่อไปนี้

KotlinJava

// Load thumbnail of a specific media item.
val thumbnail: Bitmap =
        applicationContext.contentResolver.loadThumbnail(
        content-uri, Size(640, 480), null)

// Load thumbnail of a specific media item.
Bitmap thumbnail =
        getApplicationContext().getContentResolver().loadThumbnail(
        content-uri, new Size(640, 480), null);

เปิดไฟล์สื่อ

ตรรกะเฉพาะที่คุณใช้เปิดไฟล์สื่อจะขึ้นอยู่กับว่าเนื้อหาสื่อแสดงเป็น File Descriptor, File Stream หรือเส้นทางไฟล์โดยตรงได้ดีที่สุดหรือไม่

ตัวบอกไฟล์

หากต้องการเปิดไฟล์สื่อโดยใช้ตัวระบุไฟล์ ให้ใช้ตรรกะคล้ายกับที่แสดงในข้อมูลโค้ดต่อไปนี้

KotlinJava

// Open a specific media item using ParcelFileDescriptor.
val resolver = applicationContext.contentResolver

// "rw" for read-and-write.
// "rwt" for truncating or overwriting existing file contents.
val readOnlyMode = "r"
resolver.openFileDescriptor(content-uri, readOnlyMode).use { pfd ->
    // Perform operations on "pfd".
}

// Open a specific media item using ParcelFileDescriptor.
ContentResolver resolver = getApplicationContext()
        .getContentResolver();

// "rw" for read-and-write.
// "rwt" for truncating or overwriting existing file contents.
String readOnlyMode = "r";
try (ParcelFileDescriptor pfd =
        resolver.openFileDescriptor(content-uri, readOnlyMode)) {
    // Perform operations on "pfd".
} catch (IOException e) {
    e.printStackTrace();
}

สตรีมไฟล์

หากต้องการเปิดไฟล์สื่อโดยใช้สตรีมไฟล์ ให้ใช้ตรรกะที่คล้ายกับที่แสดงใน ข้อมูลโค้ดต่อไปนี้

KotlinJava

// Open a specific media item using InputStream.
val resolver = applicationContext.contentResolver
resolver.openInputStream(content-uri).use { stream ->
    // Perform operations on "stream".
}

// Open a specific media item using InputStream.
ContentResolver resolver = getApplicationContext()
        .getContentResolver();
try (InputStream stream = resolver.openInputStream(content-uri)) {
    // Perform operations on "stream".
}

เส้นทางไฟล์โดยตรง

Android 11 (API ระดับ 30) ขึ้นไปให้คุณใช้ API อื่นนอกเหนือจาก MediaStore API เพื่อเข้าถึงไฟล์สื่อจากพื้นที่เก็บข้อมูลที่แชร์ได้ เพื่อช่วยให้การทํางานของแอปกับคลังสื่อของบุคคลที่สามเป็นไปอย่างราบรื่นยิ่งขึ้น คุณสามารถเข้าถึงไฟล์สื่อได้โดยตรง โดยใช้ API อย่างใดอย่างหนึ่งต่อไปนี้

File API
ไลบรารีที่มาพร้อมเครื่อง เช่น fopen()

หากไม่มีสิทธิ์เกี่ยวกับพื้นที่เก็บข้อมูล คุณจะเข้าถึงไฟล์ใน ไดเรกทอรีเฉพาะแอปและสื่อ ไฟล์ที่มาจากแอปของคุณโดยใช้ File API

หากแอปพยายามเข้าถึงไฟล์โดยใช้ File API แต่ไม่มีสิทธิ์ที่จําเป็น ระบบจะแสดงFileNotFoundException

วิธีเข้าถึงไฟล์อื่นๆ ในพื้นที่เก็บข้อมูลที่ใช้ร่วมกันในอุปกรณ์ที่ใช้ Android 10 (API) ระดับ 29) เราขอแนะนำให้คุณเลือกไม่ใช้การกำหนดขอบเขตชั่วคราว พื้นที่เก็บข้อมูลตามการตั้งค่า requestLegacyExternalStorage เป็น true ในไฟล์ Manifest ของแอป หากต้องการเข้าถึงไฟล์สื่อโดยใช้วิธีการเข้าถึงไฟล์ในเครื่องบน Android 10 คุณต้องขอสิทธิ์ READ_EXTERNAL_STORAGE ด้วย

ข้อควรพิจารณาเมื่อเข้าถึงเนื้อหาสื่อ

เมื่อเข้าถึงเนื้อหาสื่อ โปรดคำนึงถึงประเด็นต่างๆ ที่จะกล่าวถึงใน ส่วนต่างๆ ต่อไปนี้

ข้อมูลในแคช

หากแอปแคช URI หรือข้อมูลจากที่เก็บสื่อ ให้ตรวจสอบการอัปเดตที่เก็บสื่อเป็นระยะ การตรวจสอบนี้ช่วยให้ข้อมูลแคชที่ฝั่งแอปซิงค์กับข้อมูลผู้ให้บริการฝั่งระบบ

ประสิทธิภาพ

เมื่อทำการอ่านไฟล์สื่อตามลำดับโดยใช้เส้นทางไฟล์โดยตรง ประสิทธิภาพจะเทียบเท่ากับของ MediaStore API

เมื่อคุณสุ่มอ่านและเขียนไฟล์สื่อโดยใช้เส้นทางไฟล์โดยตรง แต่กระบวนการอาจช้าลงถึง 2 เท่า ในสถานการณ์เหล่านี้ เราจะ แนะนำให้ใช้ MediaStore API แทน

คอลัมน์ DATA

เมื่อเข้าถึงไฟล์สื่อที่มีอยู่ คุณจะใช้ค่าของคอลัมน์ DATA ในตรรกะได้ นั่นเป็นเพราะค่านี้มีเส้นทางไฟล์ที่ถูกต้อง อย่างไรก็ตาม อย่าคิดว่าไฟล์จะพร้อมใช้งานเสมอไป เตรียมตัวรับมือกับทุกอย่างที่อิงตามไฟล์ ข้อผิดพลาด I/O ที่เกิดขึ้น

ในทางกลับกัน หากต้องการสร้างหรืออัปเดตไฟล์สื่อ อย่าใช้ค่าของคอลัมน์ DATA ให้ใช้ค่าของ DISPLAY_NAME และ RELATIVE_PATH

ปริมาณพื้นที่เก็บข้อมูล

แอปที่กำหนดเป้าหมายเป็น Android 10 ขึ้นไปจะเข้าถึงชื่อที่ไม่ซ้ำกันได้ ที่ระบบกำหนดให้กับวอลุ่มที่จัดเก็บข้อมูลภายนอกแต่ละรายการ ระบบการตั้งชื่อนี้จะช่วยคุณจัดระเบียบและจัดทำดัชนีเนื้อหาได้อย่างมีประสิทธิภาพ รวมถึงให้คุณควบคุมตำแหน่งที่จัดเก็บไฟล์สื่อใหม่ได้

ปริมาณต่อไปนี้มีประโยชน์อย่างยิ่ง

วอลุ่ม VOLUME_EXTERNAL แสดงมุมมองของวอลุ่มพื้นที่เก็บข้อมูลทั้งหมดที่แชร์ในอุปกรณ์ คุณสามารถอ่าน เนื้อหาในวอลุ่มสังเคราะห์นี้ แต่คุณจะแก้ไขเนื้อหาไม่ได้
ปริมาณ VOLUME_EXTERNAL_PRIMARY แสดงปริมาณพื้นที่เก็บข้อมูลหลักที่แชร์ในอุปกรณ์ คุณสามารถอ่านและแก้ไขเนื้อหาของโวลุ่มนี้ได้

คุณสามารถดูระดับเสียงอื่นๆ ได้โดยโทร MediaStore.getExternalVolumeNames()

KotlinJava

val volumeNames: Set<String> = MediaStore.getExternalVolumeNames(context)
val firstVolumeName = volumeNames.iterator().next()

Set<String> volumeNames = MediaStore.getExternalVolumeNames(context);
String firstVolumeName = volumeNames.iterator().next();

ตำแหน่งที่บันทึกสื่อ

รูปภาพและวิดีโอบางรายการมีข้อมูลตำแหน่งในข้อมูลเมตา ซึ่งแสดงสถานที่ที่ถ่ายภาพหรือบันทึกวิดีโอ

วิธีเข้าถึงข้อมูลตำแหน่งนี้ในแอปจะขึ้นอยู่กับว่าคุณต้องเข้าถึงข้อมูลตำแหน่งสำหรับรูปภาพหรือวิดีโอ

ภาพถ่าย

หากแอปใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต ระบบจะซ่อนข้อมูลตำแหน่งโดยค่าเริ่มต้น หากต้องการเข้าถึงข้อมูลนี้ ให้ทำตามขั้นตอนต่อไปนี้

ขอ ACCESS_MEDIA_LOCATION สิทธิ์ในไฟล์ Manifest ของแอป

จากออบเจ็กต์ MediaStore ให้รับข้อมูลไบต์ของรูปภาพตาม การโทร setRequireOriginal() และส่งผ่านใน URI ของภาพถ่าย ดังที่แสดงในข้อมูลโค้ดต่อไปนี้

KotlinJava

val photoUri: Uri = Uri.withAppendedPath(
        MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
        cursor.getString(idColumnIndex)
)

// Get location data using the Exifinterface library.
// Exception occurs if ACCESS_MEDIA_LOCATION permission isn't granted.
photoUri = MediaStore.setRequireOriginal(photoUri)
contentResolver.openInputStream(photoUri)?.use { stream ->
    ExifInterface(stream).run {
        // If lat/long is null, fall back to the coordinates (0, 0).
        val latLong = latLong ?: doubleArrayOf(0.0, 0.0)
    }
}

Uri photoUri = Uri.withAppendedPath(
        MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
        cursor.getString(idColumnIndex));

final double[] latLong;

// Get location data using the Exifinterface library.
// Exception occurs if ACCESS_MEDIA_LOCATION permission isn't granted.
photoUri = MediaStore.setRequireOriginal(photoUri);
InputStream stream = getContentResolver().openInputStream(photoUri);
if (stream != null) {
    ExifInterface exifInterface = new ExifInterface(stream);
    double[] returnedLatLong = exifInterface.getLatLong();

    // If lat/long is null, fall back to the coordinates (0, 0).
    latLong = returnedLatLong != null ? returnedLatLong : new double[2];

    // Don't reuse the stream associated with
    // the instance of "ExifInterface".
    stream.close();
} else {
    // Failed to load the stream, so return the coordinates (0, 0).
    latLong = new double[2];
}

วิดีโอ

หากต้องการเข้าถึงข้อมูลตำแหน่งภายในข้อมูลเมตาของวิดีโอ ให้ใช้ MediaMetadataRetriever ดังที่ปรากฏในข้อมูลโค้ดต่อไปนี้ แอปของคุณไม่จําเป็นต้องขอสิทธิ์เพิ่มเติมเพื่อใช้คลาสนี้

KotlinJava

val retriever = MediaMetadataRetriever()
val context = applicationContext

// Find the videos that are stored on a device by querying the video collection.
val query = ContentResolver.query(
    collection,
    projection,
    selection,
    selectionArgs,
    sortOrder
)
query?.use { cursor ->
    val idColumn = cursor.getColumnIndexOrThrow(MediaStore.Video.Media._ID)
    while (cursor.moveToNext()) {
        val id = cursor.getLong(idColumn)
        val videoUri: Uri = ContentUris.withAppendedId(
            MediaStore.Video.Media.EXTERNAL_CONTENT_URI,
            id
        )
        extractVideoLocationInfo(videoUri)
    }
}

private fun extractVideoLocationInfo(videoUri: Uri) {
    try {
        retriever.setDataSource(context, videoUri)
    } catch (e: RuntimeException) {
        Log.e(APP_TAG, "Cannot retrieve video file", e)
    }
    // Metadata uses a standardized format.
    val locationMetadata: String? =
            retriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_LOCATION)
}

MediaMetadataRetriever retriever = new MediaMetadataRetriever();
Context context = getApplicationContext();

// Find the videos that are stored on a device by querying the video collection.
try (Cursor cursor = context.getContentResolver().query(
    collection,
    projection,
    selection,
    selectionArgs,
    sortOrder
)) {
    int idColumn = cursor.getColumnIndexOrThrow(MediaStore.Video.Media._ID);
    while (cursor.moveToNext()) {
        long id = cursor.getLong(idColumn);
        Uri videoUri = ContentUris.withAppendedId(
                MediaStore.Video.Media.EXTERNAL_CONTENT_URI, id);
        extractVideoLocationInfo(videoUri);
    }
}

private void extractVideoLocationInfo(Uri videoUri) {
    try {
        retriever.setDataSource(context, videoUri);
    } catch (RuntimeException e) {
        Log.e(APP_TAG, "Cannot retrieve video file", e);
    }
    // Metadata uses a standardized format.
    String locationMetadata = retriever.extractMetadata(
            MediaMetadataRetriever.METADATA_KEY_LOCATION);
}

แอปบางแอปอนุญาตให้ผู้ใช้แชร์ไฟล์สื่อระหว่างกันได้ เช่น แอปโซเชียลมีเดียที่อนุญาตให้ผู้ใช้แชร์รูปภาพและวิดีโอกับเพื่อน

หากต้องการแชร์ไฟล์สื่อ ให้ใช้ URI content:// ตามที่แนะนำในคำแนะนำในการสร้างผู้ให้บริการเนื้อหา

การระบุแหล่งที่มาของแอปของไฟล์สื่อ

เมื่อเปิดใช้พื้นที่เก็บข้อมูลแบบกำหนดขอบเขตสำหรับแอปที่กำหนดเป้าหมายเป็น Android 10 ขึ้นไป ระบบจะระบุแหล่งที่มาของแอปกับไฟล์สื่อแต่ละไฟล์ ซึ่งจะเป็นตัวกำหนดไฟล์ที่แอปของคุณเข้าถึงได้เมื่อไม่ได้ขอสิทธิ์เข้าถึงพื้นที่เก็บข้อมูล แต่ละไฟล์จะระบุแหล่งที่มาได้เพียงแอปเดียว ดังนั้นหากแอปของคุณสร้างไฟล์สื่อที่เก็บอยู่ในคอลเล็กชันสื่อรูปภาพ วิดีโอ หรือไฟล์เสียง แอปของคุณจะมีสิทธิ์เข้าถึงไฟล์ดังกล่าว

อย่างไรก็ตาม หากผู้ใช้ถอนการติดตั้งและติดตั้งแอปของคุณอีกครั้ง คุณต้องขอสิทธิ์ READ_EXTERNAL_STORAGE เพื่อเข้าถึงไฟล์ที่แอปของคุณสร้างขึ้นตั้งแต่แรก คำขอสิทธิ์นี้ เนื่องจากระบบพิจารณาว่าไฟล์เป็น เวอร์ชันที่ติดตั้งก่อนหน้านี้ แทนที่จะเป็นเวอร์ชันที่ติดตั้งใหม่

เพิ่มสินค้า

หากต้องการเพิ่มรายการสื่อลงในคอลเล็กชันที่มีอยู่ ให้ใช้รหัสที่คล้ายกับรหัสต่อไปนี้ ข้อมูลโค้ดนี้เข้าถึงวอลุ่ม VOLUME_EXTERNAL_PRIMARY ในอุปกรณ์ที่ใช้ Android 10 ขึ้นไป เพราะว่าในอุปกรณ์เหล่านี้ จะแก้ไขเนื้อหาของวอลุ่มได้ก็ต่อเมื่อเป็นวอลุ่มหลักเท่านั้น เนื่องจาก ตามที่อธิบายไว้ในส่วนปริมาณพื้นที่เก็บข้อมูล

KotlinJava

// Add a specific media item.
val resolver = applicationContext.contentResolver

// Find all audio files on the primary external storage device.
val audioCollection =
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        MediaStore.Audio.Media.getContentUri(
            MediaStore.VOLUME_EXTERNAL_PRIMARY
        )
    } else {
        MediaStore.Audio.Media.EXTERNAL_CONTENT_URI
    }

// Publish a new song.
val newSongDetails = ContentValues().apply {
    put(MediaStore.Audio.Media.DISPLAY_NAME, "My Song.mp3")
}

// Keep a handle to the new song's URI in case you need to modify it
// later.
val myFavoriteSongUri = resolver
        .insert(audioCollection, newSongDetails)

// Add a specific media item.
ContentResolver resolver = getApplicationContext()
        .getContentResolver();

// Find all audio files on the primary external storage device.
Uri audioCollection;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    audioCollection = MediaStore.Audio.Media
            .getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY);
} else {
    audioCollection = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI;
}

// Publish a new song.
ContentValues newSongDetails = new ContentValues();
newSongDetails.put(MediaStore.Audio.Media.DISPLAY_NAME,
        "My Song.mp3");

// Keep a handle to the new song's URI in case you need to modify it
// later.
Uri myFavoriteSongUri = resolver
        .insert(audioCollection, newSongDetails);

สลับสถานะรอดำเนินการสำหรับไฟล์สื่อ

หากแอปดำเนินการต่างๆ ที่อาจใช้เวลานาน เช่น การเขียนถึง ไฟล์สื่อ การมีสิทธิ์เข้าถึงพิเศษในไฟล์ขณะที่ระบบกำลังถือถือ ประมวลผลแล้ว ในอุปกรณ์ที่ใช้ Android 10 ขึ้นไป แอปของคุณจะรับสิทธิ์เข้าถึงพิเศษนี้ได้โดยการกําหนดค่า Flag IS_PENDING เป็น 1 เฉพาะแอปของคุณเท่านั้นที่จะดูไฟล์ได้จนกว่าแอปจะเปลี่ยนค่าของ IS_PENDING กลับไปเป็น 0

ข้อมูลโค้ดต่อไปนี้จะต่อยอดจากข้อมูลโค้ดก่อนหน้า ตัวอย่างนี้แสดงวิธีใช้ Flag IS_PENDING เมื่อจัดเก็บเพลงยาวในไดเรกทอรีที่สอดคล้องกับคอลเล็กชัน MediaStore.Audio

KotlinJava

// Add a media item that other apps don't see until the item is
// fully written to the media store.
val resolver = applicationContext.contentResolver

// Find all audio files on the primary external storage device.
val audioCollection =
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        MediaStore.Audio.Media.getContentUri(
            MediaStore.VOLUME_EXTERNAL_PRIMARY
        )
    } else {
        MediaStore.Audio.Media.EXTERNAL_CONTENT_URI
    }

val songDetails = ContentValues().apply {
    put(MediaStore.Audio.Media.DISPLAY_NAME, "My Workout Playlist.mp3")
    put(MediaStore.Audio.Media.IS_PENDING, 1)
}

val songContentUri = resolver.insert(audioCollection, songDetails)

// "w" for write.
resolver.openFileDescriptor(songContentUri, "w", null).use { pfd ->
    // Write data into the pending audio file.
}

// Now that you're finished, release the "pending" status and let other apps
// play the audio track.
songDetails.clear()
songDetails.put(MediaStore.Audio.Media.IS_PENDING, 0)
resolver.update(songContentUri, songDetails, null, null)

// Add a media item that other apps don't see until the item is
// fully written to the media store.
ContentResolver resolver = getApplicationContext()
        .getContentResolver();

// Find all audio files on the primary external storage device.
Uri audioCollection;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    audioCollection = MediaStore.Audio.Media
            .getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY);
} else {
    audioCollection = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI;
}

ContentValues songDetails = new ContentValues();
songDetails.put(MediaStore.Audio.Media.DISPLAY_NAME,
        "My Workout Playlist.mp3");
songDetails.put(MediaStore.Audio.Media.IS_PENDING, 1);

Uri songContentUri = resolver
        .insert(audioCollection, songDetails);

// "w" for write.
try (ParcelFileDescriptor pfd =
        resolver.openFileDescriptor(songContentUri, "w", null)) {
    // Write data into the pending audio file.
}

// Now that you're finished, release the "pending" status and let other apps
// play the audio track.
songDetails.clear();
songDetails.put(MediaStore.Audio.Media.IS_PENDING, 0);
resolver.update(songContentUri, songDetails, null, null);

ให้คำแนะนำสำหรับตำแหน่งไฟล์

เมื่อแอปของคุณจัดเก็บสื่อในอุปกรณ์ที่ใช้ Android 10 โดย ระบบจะจัดระเบียบสื่อตามประเภทโดยค่าเริ่มต้น เช่น โดยค่าเริ่มต้นคือ ไฟล์ภาพจะวางอยู่ใน Environment.DIRECTORY_PICTURES ซึ่งสอดคล้องกับ MediaStore.Images คอลเล็กชัน

หากแอปทราบตำแหน่งที่เฉพาะเจาะจงซึ่งจัดเก็บไฟล์ได้ เช่น อัลบั้มรูปภาพชื่อ Pictures/MyVacationPictures คุณสามารถตั้งค่า MediaColumns.RELATIVE_PATH เพื่อบอกใบ้ให้ระบบทราบตำแหน่งที่จะจัดเก็บไฟล์ที่เขียนใหม่

อัปเดตรายการ

หากต้องการอัปเดตไฟล์สื่อที่แอปของคุณเป็นเจ้าของ ให้ใช้โค้ดที่คล้ายกับโค้ดต่อไปนี้

KotlinJava

// Updates an existing media item.
val mediaId = // MediaStore.Audio.Media._ID of item to update.
val resolver = applicationContext.contentResolver

// When performing a single item update, prefer using the ID.
val selection = "${MediaStore.Audio.Media._ID} = ?"

// By using selection + args you protect against improper escaping of // values.
val selectionArgs = arrayOf(mediaId.toString())

// Update an existing song.
val updatedSongDetails = ContentValues().apply {
    put(MediaStore.Audio.Media.DISPLAY_NAME, "My Favorite Song.mp3")
}

// Use the individual song's URI to represent the collection that's
// updated.
val numSongsUpdated = resolver.update(
        myFavoriteSongUri,
        updatedSongDetails,
        selection,
        selectionArgs)

// Updates an existing media item.
long mediaId = // MediaStore.Audio.Media._ID of item to update.
ContentResolver resolver = getApplicationContext()
        .getContentResolver();

// When performing a single item update, prefer using the ID.
String selection = MediaStore.Audio.Media._ID + " = ?";

// By using selection + args you protect against improper escaping of
// values. Here, "song" is an in-memory object that caches the song's
// information.
String[] selectionArgs = new String[] { getId().toString() };

// Update an existing song.
ContentValues updatedSongDetails = new ContentValues();
updatedSongDetails.put(MediaStore.Audio.Media.DISPLAY_NAME,
        "My Favorite Song.mp3");

// Use the individual song's URI to represent the collection that's
// updated.
int numSongsUpdated = resolver.update(
        myFavoriteSongUri,
        updatedSongDetails,
        selection,
        selectionArgs);

หากพื้นที่เก็บข้อมูลแบบจำกัดไม่พร้อมใช้งานหรือไม่ได้เปิดใช้ กระบวนการที่แสดงในข้อมูลโค้ดก่อนหน้าจะใช้กับไฟล์ที่แอปของคุณไม่ได้เป็นเจ้าของได้ด้วย

อัปเดตในโค้ดเนทีฟ

หากต้องการเขียนไฟล์สื่อโดยใช้ไลบรารีแบบเนทีฟ ให้ส่งตัวบ่งชี้ไฟล์ที่เชื่อมโยงของไฟล์จากโค้ดที่ใช้ Java หรือ Kotlin ไปยังโค้ดแบบเนทีฟ

ข้อมูลโค้ดต่อไปนี้แสดงวิธีส่งตัวระบุไฟล์ของออบเจ็กต์สื่อไปยังโค้ดเนทีฟของแอป

KotlinJava

val contentUri: Uri = ContentUris.withAppendedId(
        MediaStore.Audio.Media.EXTERNAL_CONTENT_URI,
        cursor.getLong(BaseColumns._ID))
val fileOpenMode = "r"
val parcelFd = resolver.openFileDescriptor(contentUri, fileOpenMode)
val fd = parcelFd?.detachFd()
// Pass the integer value "fd" into your native code. Remember to call
// close(2) on the file descriptor when you're done using it.

Uri contentUri = ContentUris.withAppendedId(
        MediaStore.Audio.Media.EXTERNAL_CONTENT_URI,
        cursor.getLong(Integer.parseInt(BaseColumns._ID)));
String fileOpenMode = "r";
ParcelFileDescriptor parcelFd =
        resolver.openFileDescriptor(contentUri, fileOpenMode);
if (parcelFd != null) {
    int fd = parcelFd.detachFd();
    // Pass the integer value "fd" into your native code. Remember to call
    // close(2) on the file descriptor when you're done using it.
}

อัปเดตแอปอื่นๆ ไฟล์สื่อ

หากแอปใช้พื้นที่เก็บข้อมูลแบบจำกัด ปกติแล้วแอปจะอัปเดตไฟล์สื่อที่แอปอื่นส่งไปยังที่เก็บสื่อไม่ได้

อย่างไรก็ตาม คุณสามารถขอความยินยอมจากผู้ใช้เพื่อแก้ไขไฟล์ได้โดยจับ RecoverableSecurityException ที่แพลตฟอร์มแสดง จากนั้นคุณสามารถขอให้ผู้ใช้ให้สิทธิ์แอปของคุณในการเขียนไปยังรายการที่เฉพาะเจาะจงนั้น ดังที่แสดงในข้อมูลโค้ดต่อไปนี้

KotlinJava

// Apply a grayscale filter to the image at the given content URI.
try {
    // "w" for write.
    contentResolver.openFileDescriptor(image-content-uri, "w")?.use {
        setGrayscaleFilter(it)
    }
} catch (securityException: SecurityException) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        val recoverableSecurityException = securityException as?
            RecoverableSecurityException ?:
            throw RuntimeException(securityException.message, securityException)

        val intentSender =
            recoverableSecurityException.userAction.actionIntent.intentSender
        intentSender?.let {
            startIntentSenderForResult(intentSender, image-request-code,
                    null, 0, 0, 0, null)
        }
    } else {
        throw RuntimeException(securityException.message, securityException)
    }
}

try {
    // "w" for write.
    ParcelFileDescriptor imageFd = getContentResolver()
            .openFileDescriptor(image-content-uri, "w");
    setGrayscaleFilter(imageFd);
} catch (SecurityException securityException) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        RecoverableSecurityException recoverableSecurityException;
        if (securityException instanceof RecoverableSecurityException) {
            recoverableSecurityException =
                    (RecoverableSecurityException)securityException;
        } else {
            throw new RuntimeException(
                    securityException.getMessage(), securityException);
        }
        IntentSender intentSender =recoverableSecurityException.getUserAction()
                .getActionIntent().getIntentSender();
        startIntentSenderForResult(intentSender, image-request-code,
                null, 0, 0, 0, null);
    } else {
        throw new RuntimeException(
                securityException.getMessage(), securityException);
    }
}

ทำขั้นตอนนี้ให้เสร็จสมบูรณ์ทุกครั้งที่แอปต้องการแก้ไขไฟล์สื่อที่แอป ไม่ได้สร้าง

นอกจากนี้ หากแอปใช้ Android 11 ขึ้นไป คุณจะทำสิ่งต่อไปนี้ได้ อนุญาตให้ผู้ใช้ให้สิทธิ์แอปของคุณในการเขียนไปยังกลุ่มไฟล์สื่อ ใช้เมนู createWriteRequest() ตามที่อธิบายไว้ในส่วนเกี่ยวกับวิธีจัดการกลุ่มสื่อ ไฟล์

หากแอปของคุณมีกรณีการใช้งานอื่นที่ไม่ได้อยู่ภายใต้พื้นที่เก็บข้อมูลแบบจำกัด ให้ส่งคำขอฟีเจอร์และเลือกไม่ใช้พื้นที่เก็บข้อมูลแบบจำกัดชั่วคราว

นำรายการออก

หากต้องการนำรายการที่แอปไม่จำเป็นต้องใช้ใน Media Store แล้วออก ให้ใช้ตรรกะ คล้ายกับที่แสดงในข้อมูลโค้ดต่อไปนี้

KotlinJava

// Remove a specific media item.
val resolver = applicationContext.contentResolver

// URI of the image to remove.
val imageUri = "..."

// WHERE clause.
val selection = "..."
val selectionArgs = "..."

// Perform the actual removal.
val numImagesRemoved = resolver.delete(
        imageUri,
        selection,
        selectionArgs)

// Remove a specific media item.
ContentResolver resolver = getApplicationContext()
        getContentResolver();

// URI of the image to remove.
Uri imageUri = "...";

// WHERE clause.
String selection = "...";
String[] selectionArgs = "...";

// Perform the actual removal.
int numImagesRemoved = resolver.delete(
        imageUri,
        selection,
        selectionArgs);

หากพื้นที่เก็บข้อมูลที่กำหนดขอบเขตไม่พร้อมใช้งานหรือไม่ได้เปิดใช้ คุณสามารถใช้ โค้ดขนาดสั้นสำหรับนำไฟล์ที่แอปอื่นเป็นเจ้าของออก อย่างไรก็ตาม หากเปิดใช้พื้นที่เก็บข้อมูลแบบจำกัด คุณจะต้องจับ RecoverableSecurityException สำหรับไฟล์แต่ละไฟล์ที่แอปต้องการนำออก ตามที่อธิบายไว้ในส่วนการอัปเดตรายการสื่อ

หากแอปใช้ Android 11 ขึ้นไป คุณสามารถอนุญาตให้ผู้ใช้ เลือกไฟล์สื่อที่จะนำออก ใช้วิธีการ createTrashRequest() หรือวิธี createDeleteRequest() ตามที่อธิบายไว้ในส่วนเกี่ยวกับวิธีจัดการกลุ่มไฟล์สื่อ

หากแอปมีกรณีการใช้งานอื่นที่ไม่รวมอยู่ในพื้นที่เก็บข้อมูลที่กำหนดขอบเขต ให้ส่ง คำขอฟีเจอร์ และ เลือกไม่ใช้ขอบเขตพื้นที่ชั่วคราว พื้นที่เก็บข้อมูล

ตรวจหาการอัปเดตไฟล์สื่อ

แอปของคุณอาจต้องระบุปริมาณพื้นที่เก็บข้อมูลที่มีไฟล์สื่อที่แอปเพิ่มหรือแก้ไขเมื่อเทียบกับช่วงเวลาก่อนหน้า เพื่อตรวจหาการเปลี่ยนแปลงเหล่านี้ ส่งปริมาณพื้นที่เก็บข้อมูลที่สนใจไปยัง getGeneration() ตราบใดที่เวอร์ชันที่เก็บสื่อไม่มีการเปลี่ยนแปลง ค่าที่ส่งคืนของ เพิ่มขึ้นเรื่อยๆ เมื่อเวลาผ่านไป

โดยเฉพาะอย่างยิ่ง getGeneration() จะมีประสิทธิภาพมากกว่าวันที่ในคอลัมน์สื่อ เช่น DATE_ADDED และ DATE_MODIFIED เนื่องจากค่าคอลัมน์ของสื่อเหล่านี้สามารถเปลี่ยนแปลงได้เมื่อแอปเรียกใช้ setLastModified() หรือเมื่อ ผู้ใช้เปลี่ยนนาฬิกาของระบบ

จัดการกลุ่มไฟล์สื่อ

ใน Android 11 ขึ้นไป คุณสามารถขอให้ผู้ใช้เลือกกลุ่มไฟล์สื่อ แล้วอัปเดตไฟล์สื่อเหล่านี้ในขั้นตอนเดียว วิธีเหล่านี้มีความสอดคล้องกันมากขึ้นในอุปกรณ์ต่างๆ และช่วยให้ผู้ใช้จัดการคอลเล็กชันสื่อได้ง่ายขึ้น

วิธีการที่ให้บริการฟังก์ชัน "อัปเดตหลายรายการพร้อมกัน" มีดังนี้

createWriteRequest(): ขอให้ผู้ใช้ให้สิทธิ์การเขียนแก่แอปของคุณสำหรับกลุ่มไฟล์สื่อที่ระบุ
createFavoriteRequest(): ขอให้ผู้ใช้ทำเครื่องหมายไฟล์สื่อที่ระบุเป็นบางไฟล์ "รายการโปรด" สื่อในอุปกรณ์ แอปทั้งหมดที่มีสิทธิ์อ่านไฟล์นี้สามารถ เห็นว่าผู้ใช้ทำเครื่องหมายไฟล์เป็น "รายการโปรด"
createTrashRequest(): ขอให้ผู้ใช้วางไฟล์สื่อที่ระบุไว้ในถังขยะของอุปกรณ์ ระบบจะลบรายการในถังขยะออกอย่างถาวรหลังจากผ่านไปตามระยะเวลาที่ระบบกำหนด

หมายเหตุ: หากแอปของคุณเป็นแอปแกลเลอรีที่ติดตั้งมาล่วงหน้าของอุปกรณ์ OEM คุณจะวาง ไฟล์ในถังขยะโดยไม่แสดงกล่องโต้ตอบ โดยให้ตั้งค่า IS_TRASHED เป็น 1 โดยตรง
createDeleteRequest(): ขอให้ผู้ใช้ลบไฟล์สื่อที่ระบุอย่างถาวรโดยทันทีโดยไม่ต้องย้ายไปไว้ในถังขยะก่อน

หลังจากเรียกใช้วิธีการใดๆ เหล่านี้ ระบบจะสร้าง PendingIntent หลังจากที่แอปเรียกใช้ Intent นี้ ผู้ใช้จะเห็นกล่องโต้ตอบที่ขอความยินยอมให้แอปอัปเดตหรือลบไฟล์สื่อที่ระบุ

ตัวอย่างเช่น วิธีจัดโครงสร้างการโทรไปยัง createWriteRequest() มีดังนี้

KotlinJava

val urisToModify = /* A collection of content URIs to modify. */
val editPendingIntent = MediaStore.createWriteRequest(contentResolver,
        urisToModify)

// Launch a system prompt requesting user permission for the operation.
startIntentSenderForResult(editPendingIntent.intentSender, EDIT_REQUEST_CODE,
    null, 0, 0, 0)

List<Uri> urisToModify = /* A collection of content URIs to modify. */
PendingIntent editPendingIntent = MediaStore.createWriteRequest(contentResolver,
                  urisToModify);

// Launch a system prompt requesting user permission for the operation.
startIntentSenderForResult(editPendingIntent.getIntentSender(),
    EDIT_REQUEST_CODE, null, 0, 0, 0);

ประเมินคำตอบของผู้ใช้ หากผู้ใช้ให้ความยินยอม ให้ดําเนินการกับสื่อต่อ หรืออธิบายให้ผู้ใช้ทราบว่าเหตุใดแอปของคุณจึงต้องการสิทธิ์

KotlinJava

override fun onActivityResult(requestCode: Int, resultCode: Int,
                 data: Intent?) {
    ...
    when (requestCode) {
        EDIT_REQUEST_CODE ->
            if (resultCode == Activity.RESULT_OK) {
                /* Edit request granted; proceed. */
            } else {
                /* Edit request not granted; explain to the user. */
            }
    }
}

@Override
protected void onActivityResult(int requestCode, int resultCode,
                   @Nullable Intent data) {
    ...
    if (requestCode == EDIT_REQUEST_CODE) {
        if (resultCode == Activity.RESULT_OK) {
            /* Edit request granted; proceed. */
        } else {
            /* Edit request not granted; explain to the user. */
        }
    }
}

คุณสามารถใช้รูปแบบทั่วไปเดียวกันนี้กับ createFavoriteRequest() createTrashRequest() และ createDeleteRequest()

สิทธิ์การจัดการสื่อ

ผู้ใช้อาจไว้ใจแอปหนึ่งๆ ให้จัดการสื่อ เช่น แก้ไขไฟล์สื่อบ่อยครั้ง หากแอปกำหนดเป้าหมาย Android 11 ขึ้นไปและไม่ใช่แอปแกลเลอรีเริ่มต้นของอุปกรณ์ คุณต้องแสดงกล่องโต้ตอบการยืนยันแก่ผู้ใช้ทุกครั้งที่แอปพยายาม แก้ไขหรือลบไฟล์

หากแอปกำหนดเป้าหมายเป็น Android 12 (API ระดับ 31) ขึ้นไป คุณสามารถขอให้ผู้ใช้ให้สิทธิ์พิเศษการจัดการสื่อแก่แอป ช่วงเวลานี้ ทำให้แอปของคุณสามารถทำสิ่งต่อไปนี้ได้โดยไม่จำเป็นต้องแจ้ง ผู้ใช้สำหรับการดำเนินการไฟล์แต่ละรายการ:

แก้ไขไฟล์โดยใช้ createWriteRequest()
ย้ายไฟล์เข้าและออกจากถังขยะโดยใช้ createTrashRequest()
ลบไฟล์โดยใช้ createDeleteRequest()

โดยทำตามขั้นตอนต่อไปนี้

ประกาศแอตทริบิวต์ สิทธิ์ MANAGE_MEDIA และ READ_EXTERNAL_STORAGE ในไฟล์ Manifest ของแอป

หากต้องการโทรหา createWriteRequest() โดยไม่แสดงกล่องโต้ตอบการยืนยัน ให้ประกาศสิทธิ์ ACCESS_MEDIA_LOCATION ด้วย
แสดง UI แก่ผู้ใช้ในแอปเพื่ออธิบายเหตุผลที่ผู้ใช้อาจต้องการให้สิทธิ์เข้าถึงการจัดการสื่อแก่แอปของคุณ
เรียกใช้การดำเนินการตามACTION_REQUEST_MANAGE_MEDIA Intent ซึ่งจะนำผู้ใช้ไปยังหน้าจอแอปการจัดการสื่อใน การตั้งค่าระบบ จากที่นี่ ผู้ใช้จะให้สิทธิ์เข้าถึงแอปพิเศษได้

กรณีการใช้งานที่จำเป็นต้องมีทางเลือกอื่นแทนการจัดเก็บสื่อ

หากแอปทำบทบาทใดบทบาทหนึ่งต่อไปนี้เป็นหลัก ให้พิจารณา ที่ใช้แทน MediaStore API

การทำงานกับไฟล์ประเภทอื่น

หากแอปของคุณทำงานร่วมกับเอกสารและไฟล์ที่ไม่ได้บรรจุเนื้อหาสื่อเพียงอย่างเดียว เช่น ไฟล์ที่ใช้นามสกุลไฟล์ EPUB หรือ PDF ให้ใช้ACTION_OPEN_DOCUMENTการดำเนินการของ Intent ตามที่อธิบายไว้ในคู่มือการจัดเก็บและการเข้าถึงเอกสารและไฟล์อื่นๆ

การแชร์ไฟล์ในแอปที่ใช้ร่วมกัน

ในกรณีที่คุณให้บริการชุดแอปที่ใช้ร่วมกัน เช่น แอปรับส่งข้อความและแอปโปรไฟล์ ให้ตั้งค่าการแชร์ไฟล์โดยใช้ URI content:// นอกจากนี้ เราขอแนะนำให้ใช้เวิร์กโฟลว์นี้เป็นแนวทางปฏิบัติแนะนำด้านความปลอดภัย

แหล่งข้อมูลเพิ่มเติม

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีจัดเก็บและเข้าถึงสื่อได้จากแหล่งข้อมูลต่อไปนี้

ตัวอย่าง

MediaStore มีใน GitHub

วิดีโอ

การเตรียมพร้อมสําหรับพื้นที่เก็บข้อมูลแบบจำกัด (Android Dev Summit'19)