Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

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

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

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

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

Media Store

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

Kotlin

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.
    }
}

Java

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) และต่ำกว่า

นอกจากนี้ Media Store ยังมีคอลเล็กชันชื่อ 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 ด้วย

ต้องใช้ Storage Access Framework เพื่อเข้าถึงการดาวน์โหลดของแอปอื่นๆ

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

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

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

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

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

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

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

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

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

Kotlin

// 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)
    }
}

Java

// 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 ขึ้นไปต้องใช้ชื่อคอลัมน์ที่กำหนดไว้ใน API MediaStore หากไลบรารีที่ต้องใช้ภายในแอปของคุณคาดหวังชื่อคอลัมน์ที่ไม่ได้กำหนดไว้ใน API เช่น "MimeType" ให้ใช้ CursorWrapper เพื่อแปลชื่อคอลัมน์แบบไดนามิกในกระบวนการของแอป

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

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

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

Kotlin

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

Java

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

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

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

ตัวบอกไฟล์

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

Kotlin

// 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".
}

Java

// 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();
}

File Stream

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

Kotlin

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

Java

// 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()

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

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

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

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

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

ข้อมูลในแคช

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

ประสิทธิภาพ

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

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

คอลัมน์ DATA

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

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

วอลุ่มของพื้นที่เก็บข้อมูล

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

ปริมาณต่อไปนี้เป็นข้อมูลที่ควรคำนึงถึงเป็นพิเศษ

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

คุณสามารถค้นหาปริมาณอื่นๆ ได้โดยเรียกใช้ MediaStore.getExternalVolumeNames():

Kotlin

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

Java

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

สถานที่ที่บันทึกสื่อ

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

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

ภาพถ่าย

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

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

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

Kotlin

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)
    }
}

Java

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 ดังที่แสดงในข้อมูลโค้ดต่อไปนี้ แอปของคุณไม่จำเป็นต้องขอสิทธิ์เพิ่มเติมเพื่อใช้คลาสนี้

Kotlin

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)
}

Java

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:// ตามที่แนะนำในคู่มือการสร้าง Content Provider

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

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

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

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

เพิ่มรายการ

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

Kotlin

// 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)

Java

// 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 ขึ้นไป แอปของคุณจะได้รับสิทธิ์เข้าถึงแบบพิเศษนี้โดยการตั้งค่าแฟล็ก IS_PENDING เป็น 1 มีเพียงแอปของคุณเท่านั้นที่ดูไฟล์ได้จนกว่าแอปจะเปลี่ยนค่าของ IS_PENDING กลับเป็น 0

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

Kotlin

// 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)

Java

// 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 เพื่อให้คำแนะนำแก่ระบบเกี่ยวกับตำแหน่งที่จะจัดเก็บไฟล์ที่เขียนใหม่

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

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

Kotlin

// 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)

Java

// 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 ไปยังโค้ดแบบเนทีฟ

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

Kotlin

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.

Java

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 ที่แพลตฟอร์มส่งขึ้น จากนั้นคุณสามารถขอให้ผู้ใช้ให้สิทธิ์แอปเขียนรายการที่เฉพาะเจาะจงนั้นได้ ดังที่แสดงในข้อมูลโค้ดต่อไปนี้

Kotlin

// 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)
    }
}

Java

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() ตามที่อธิบายไว้ในส่วนเกี่ยวกับวิธีจัดการกลุ่มไฟล์สื่อ

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

นำรายการออก

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

Kotlin

// 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)

Java

// 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() ตราบใดที่เวอร์ชันของ Media Store ไม่เปลี่ยนแปลง ค่าที่แสดงผลของเมธอดนี้จะเพิ่มขึ้นอย่างต่อเนื่องเมื่อเวลาผ่านไป

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

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

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

เมธอดที่มีฟังก์ชัน "การอัปเดตเป็นกลุ่ม" นี้มีดังต่อไปนี้

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

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

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

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

Kotlin

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)

Java

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);

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

Kotlin

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. */
            }
    }
}

Java

@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 แก่ผู้ใช้เพื่ออธิบายเหตุผลที่ผู้ใช้อาจต้องการให้สิทธิ์เข้าถึงการจัดการสื่อแก่แอปของคุณ
เรียกใช้การดำเนินการตาม Intent ACTION_REQUEST_MANAGE_MEDIA ซึ่งจะนำผู้ใช้ไปยังหน้าจอแอปการจัดการสื่อในการตั้งค่าระบบ จากตรงนี้ ผู้ใช้สามารถให้สิทธิ์เข้าถึงพิเศษแก่แอปได้

กรณีการใช้งานที่ต้องใช้ทางเลือกอื่นนอกเหนือจาก Media Store

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

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

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

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

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

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

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

ตัวอย่าง

MediaStore พร้อมใช้งานใน GitHub

วิดีโอ

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