共有ストレージからメディア ファイルにアクセスする

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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

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

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

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

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

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

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

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

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

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

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

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

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

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