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

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

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

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

ที่เก็บสื่อ

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

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.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 ของแอป จากนั้นขอสิทธิ์นี้เมื่อรันไทม์

ตรวจสอบการอัปเดตของ Store สื่อ

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

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

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

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

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

// 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() แล้วส่งขนาดของภาพขนาดย่อที่ต้องการโหลด ดังที่แสดงในข้อมูลโค้ดต่อไปนี้

// 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 หรือเส้นทางไฟล์โดยตรงได้ดีที่สุดหรือไม่

ตัวบอกไฟล์

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

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

สตรีมไฟล์

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

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

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

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

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

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

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

ภาพถ่าย

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

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

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

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

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

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

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

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

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

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

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

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

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

นำรายการออก

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

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

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

createDeleteRequest()

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

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

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

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

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

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

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

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

   หากต้องการโทรหา createWriteRequest() โดยไม่แสดงกล่องโต้ตอบการยืนยัน ให้ประกาศสิทธิ์ ACCESS_MEDIA_LOCATION ด้วย

2. แสดง UI แก่ผู้ใช้ในแอปเพื่ออธิบายเหตุผลที่ผู้ใช้อาจต้องการให้สิทธิ์เข้าถึงการจัดการสื่อแก่แอปของคุณ

3. เรียกใช้การดำเนินการตามACTION_REQUEST_MANAGE_MEDIA Intent ซึ่งจะนำผู้ใช้ไปยังหน้าจอแอปการจัดการสื่อในการตั้งค่าระบบ จากที่นี่ ผู้ใช้จะให้สิทธิ์เข้าถึงแอปพิเศษได้

Use Case ที่ต้องอาศัยทางเลือกอื่นนอกเหนือจากที่เก็บสื่อ

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

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

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

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

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

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

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

ตัวอย่าง

• MediaStore ซึ่งมีอยู่ใน GitHub

วิดีโอ

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