B4A Library [Lib] MediaBrowser

Informatix · Jun 29, 2012

Hello,

This library lists the media content (audio, image and video) of the MediaStore (a database containing meta data for all available media on both internal and external storage devices). It includes an audio player and a media scanner (to scan the new media and add them to the MediaStore).

I added new functions to the library esAudioMediaBrowser provided by Lagore, improved a bit the existing ones, and extended the stuff to images and videos.
The demo (a media gallery) needs the libs Reflection & StringUtils. It displays only files stored on your external SD card (but the lib can handle internal files).

This lib does not work with Android versions < Gingerbread (2.3).

List of properties and methods:

GetAudioFieldByID (External As Boolean, ID As Long, Field As String) As String
Returns a field from the MediaStore about the specified audio file.
Examples of field: FIELD_COMPOSER, FIELD_DATE_MODIFIED, FIELD_MIME_TYPE, FIELD_SIZE...
GetAudioFileInfo (Path As String, File As String) As Map
Returns a Map containing info from the MediaStore about an audio file.
The fields that are returned are:
"ID"
"Title"
"Album"
"Artist"
"Track"
"Year"
"Location"
"DisplayName"
"Duration" (in ms)
GetAudioFileInfoByID (External As Boolean, ID As Long) As Map
Returns a Map containing info from the MediaStore about an audio file.
The fields that are returned are:
"ID"
"Title"
"Album"
"Artist"
"Track"
"Year"
"Location"
"DisplayName"
"Duration" (in ms)
GetExifAttribute (Location As String, Attribute As String) As String
Returns the requested attribute from the Exif data of the specified image.
Location = complete path name for the file.
The complete list of attributes can be found here: https://developer.android.com/reference/android/media/ExifInterface
GetExifLatLong (Location As String, LatLong As Float()) As Boolean
Stores the latitude and longitude value of the specified image in a float array. Returns False if these Exif data are not available.
Location = complete path name for the file.
GetExtImageFileInfo (Location As String) As Map
Returns a Map containing info from the MediaStore about an external image file.
Location = complete path name for the file.
The fields that are returned are:
"ID"
"Location"
"DisplayName"
"DateTaken" (in ticks from 1970)
"Height" (with Android 3.0+)
"Width" (with Android 3.0+)
"Size" (in bytes)
GetExtVideoFileInfo (Location As String) As Map
Returns a Map containing info from the MediaStore about an external video file.
Location = complete path name for the file.
The fields that are returned are:
"ID"
"Location"
"DisplayName"
"DateTaken" (in ticks from 1970)
"Resolution" (can be Null for some files)
"Size" (in bytes)
GetImageDimensions (Location As String) As Map
Returns a map containing width and height of the specified file.
Location = complete path name for the file.
GetImageFieldByID (External As Boolean, ID As Long, Field As String) As String
Returns a field from the MediaStore about the specified image file.
Examples of field: FIELD_DATE_MODIFIED, FIELD_MIME_TYPE, FIELD_ORIENTATION...
GetImageFileInfoByID (External As Boolean, ID As Long) As Map
Returns a Map containing info from the MediaStore about an image file.
The fields that are returned are:
"ID"
"Location"
"DisplayName"
"DateTaken" (in ticks from 1970)
"Height" (with Android 3.0+)
"Width" (with Android 3.0+)
"Size" (in bytes)
GetImgThumbnailByID (ID As Long, Mini As Boolean) As android.graphics.Bitmap
Returns the micro thumbnail (96x96) or mini thumbnail (512x384) of an image file (it is generated if it doesn't exist).
GetMediaAudioList (External As Boolean, SortCol As String) As Map
Returns a Map containing a list of all Audio files in the MediaStore which can be sorted.
The allowed fields for sorting are:
Null (= FIELD_ID)
FIELD_ALBUM
FIELD_ARTIST
FIELD_COMPOSER
FIELD_DATA (location)
FIELD_DATE_ADDED
FIELD_DATE_MODIFIED
FIELD_DISPLAY_NAME
FIELD_DURATION
FIELD_MIME_TYPE
FIELD_SIZE
FIELD_TITLE
FIELD_TRACK
FIELD_YEAR
The fields that are returned are:
"ID"
"Title"
"Album"
"Artist"
"Track"
"Year"
"Location"
"DisplayName"
"Duration" (in ms)
GetMediaImageList (External As Boolean, SortCol As String) As Map
Returns a Map containing a list of all Image files in the MediaStore which can be sorted.
The allowed fields for sorting are:
Null (= FIELD_ID)
FIELD_DATA (location)
FIELD_DATE_ADDED
FIELD_DATE_MODIFIED
FIELD_DATE_TAKEN
FIELD_DISPLAY_NAME
FIELD_HEIGHT
FIELD_MIME_TYPE
FIELD_ORIENTATION
FIELD_SIZE
FIELD_TITLE
FIELD_WIDTH
The fields that are returned are:
"ID"
"Location"
"DisplayName"
"DateTaken" (in ticks from 1970)
"Height" (with Android 3.0+)
"Width" (with Android 3.0+)
"Size" (in bytes)
GetMediaVideoList (External As Boolean, SortCol As String) As Map
Returns a Map containing a list of all Video files in the MediaStore which can be sorted.
The allowed fields for sorting are:
Null (= FIELD_ID)
FIELD_DATA (location)
FIELD_DATE_ADDED
FIELD_DATE_MODIFIED
FIELD_DATE_TAKEN
FIELD_DISPLAY_NAME
FIELD_MIME_TYPE
FIELD_RESOLUTION
FIELD_SIZE
FIELD_TITLE
The fields that are returned are:
"ID"
"Location"
"DisplayName"
"DateTaken" (in ticks from 1970)
"Resolution" (can be Null for some files)
"Size" (in bytes)
GetVideoFieldByID (External As Boolean, ID As Long, Field As String) As String
Returns a field from the MediaStore about the specified video file.
Examples of field: FIELD_DATE_ADDED, FIELD_DATE_MODIFIED, FIELD_MIME_TYPE...
GetVideoFileInfoByID (External As Boolean, ID As Long) As Map
Returns a Map containing info from the MediaStore about a video file.
The fields that are returned are:
"ID"
"Location"
"DisplayName"
"DateTaken" (in ticks from 1970)
"Resolution" (can be Null for some files)
"Size" (in bytes)
GetVideoThumbnailByID (ID As Long, Mini As Boolean) As android.graphics.Bitmap
Returns the micro thumbnail (96x96) or mini thumbnail (512x384) of a video file (it is generated if it doesn't exist).
There's a known bug on some Android versions with micro thumbnails:
If the micro thumbnail can't be generated (e.g. video file format not recognized), the result is either null or a random thumbnail. Thus, for video files, it is strongly recommended to check if the mini thumbnail is initialized before trying to get the micro thumbnail.
Initialize (EventName As String)
MediaAudioPlay (External As Boolean, ID As Int)
Plays an audio file.
Raises the "MediaCompleted" event when the file end is reached.
MediaIsLooping As Boolean
Checks whether the player is looping or non-looping.
MediaIsPlaying As Boolean
MediaLength As Int
Returns the duration in ms.
MediaPause
MediaPosition As Int
Gets the current playback position.
MediaResume
MediaSeek (position As Int)
Seeks to specified time position (in ms).
Raises the event "SeekCompleted" when the position change has been completed.
MediaSetLooping (Looping As Boolean)
Sets the player to be looping or non-looping.
MediaSetVolume (leftVolume As Float, rightVolume As Float)
Sets the volume on this player (and this player only).
Note that the passed volume values are raw scalars. UI controls should be scaled logarithmically.
This function must be called AFTER MediaAudioPlay.
MediaStop
Stops the playback and releases the allocated resources.
ScanNewMedia (Paths As String())
Requests the media scanner to scan the given files and add them to the MediaStore.
Raises the "ScanCompleted" event after each file is scanned.

Warning:
There's a known bug on some Android versions with micro thumbnails:
If the micro thumbnail can't be generated (e.g. video file format not recognized), the result is either null or a random thumbnail. Thus, for video files, it is strongly recommended to check if the mini thumbnail is initialized before trying to get the micro thumbnail.

v1.2:
I fixed two bugs.

v1.21:
I removed the excessive log entries.
I removed all the Try/Catch that silently trapped errors.

v1.3:
This version requires Java 7 and B4A v3.82+.
I added 3 functions:
- GetImageFileInfoByID(External As Boolean, ID As Long) As Map;
- GetVideoFileInfoByID(External As Boolean, ID As Long) As Map;
- ScanNewMedia(Paths() As String).
I updated the demo so it works with recent Android versions.

v1.31:
I fixed a mistake in two functions introduced in v1.3.

v1.4:
I fixed an issue with API 30;
I added five functions: GetAudioFieldByID, GetImageFieldByID, GetVideoFieldByID, GetExifAttribute and GetExifLatLong;
I added a few FIELD constants;
I updated the demo to display the following fields: composer, orientation, latitude and longitude.

Enjoy,
Fred

Informatix · Jan 29, 2016

Alisson said:

I want read all images the path:

/storage/emulated/0/Android/cache/folder/*.jpg

This is my code:

B4X:

Sub ReadImages
    ' Read the image list from the MediaStore and populate the ScrollView
    ProgressDialogShow2("Send...", False)
    DoEvents
    Dim m As Map
    Dim extt As String = "/storage/emulated/0/DCIM/Camera/*.jpg"
    m = MB.GetExtImageFileInfo(extt)
    'm = MB.GetMediaImageList(True, "_display_name COLLATE UNICODE")
    lstImage.Initialize(Me, svImage, "", "Image_Click", "", 0)
    lstImage.ExtensionColor = Colors.ARGB(50, 255, 255, 255)
    DoEvents
    For i = 0 To (m.Size / 7) - 1
        Dim bmp As Bitmap
        Dim Location As String
        bmp = MB.GetImgThumbnailByID(m.Get("ID" & i), False)
        lstImage.AddItemNoChkbx(m.Get("ID" & i), m.Get("DisplayName" & i), m.Get("Location" & i), bmp)
   
    Next
    lstImage.ResizePanel
    ProgressDialogHide
End Sub

Thanks

Are these images in the MediaStore? If yes, then filter the results to keep only the wanted path. If no, you have to reboot your phone or call ScanNewMedia before browsing the MediaStore.

Alisson · Jan 29, 2016

Informatix, if you use the function:

Sub ScanNewMedia("/storage/emulated/0/Android/cache/folder/" As String)

End Sub

How get the all images?

Informatix · Jan 29, 2016

Alisson said:
Informatix, if you use the function:

Sub ScanNewMedia("/storage/emulated/0/Android/cache/folder/" As String)

End Sub

How get the all images?

Did you read the description of the function ?

Alisson · Jan 29, 2016

Read, but i am beginer
I found it

ListFiles (Dir As String) AS List

Thanks

Informatix · Jan 29, 2016

Alisson said:
Read, but i am beginer
I found it

ListFiles (Dir As String) AS List

Thanks

So your question is absolutely not related to MediaBrowser. Thanks for wasting my time...

Alisson · Jan 29, 2016

I'm sorry!
It is not my intention, take your time.
thank very much your feedback!

Informatix · Jan 29, 2016

Alisson said:
I'm sorry!
It is not my intention, take your time.
thank very much your feedback!

You're forgiven.

Alberto Iglesias · Sep 30, 2016

Hey Informatix,

I have a specific problem with your library and Samsung devices:

When I take a picture in landscape with a Samsung S6, in default gallery app, appears OK, the thumbnail is perfect oriented, but with the library appears in portrait rotated, in this method:

B4X:

Dim bThumb As Bitmap
bThumb = MB.GetImgThumbnailByID(ImgData.ID,  True)

Questions:

Can I know the picture orientation with the library?
Can you try in a samsung devices?

Thanks
Alberto Iglesias

Informatix · Sep 30, 2016

Alberto Iglesias said:
Can I know the picture orientation with the library?

No, the library cannot return this information because the information is not in the database.
You have to read the EXIF data of the JPEG file, if any.

Alberto Iglesias · Sep 30, 2016

ok, I will try right now!

thanks

Flosch · Apr 16, 2017

Hi I have a problem whith the mediabrowser and the external SD card.
On some phones the "Location" entry is wrong. It looks like: /storage/9016-4EF8/MP3/song.mp3
If I want to use the location to get infos using the GetAudioFileInfo (Path AsString, File AsString) methode the song could not be found at this location.
Any idea what's going wrong?

Thanks for your help

Informatix · Apr 18, 2017

Flosch said:
Hi I have a problem whith the mediabrowser and the external SD card.
On some phones the "Location" entry is wrong. It looks like: /storage/9016-4EF8/MP3/song.mp3
If I want to use the location to get infos using the GetAudioFileInfo (Path AsString, File AsString) methode the song could not be found at this location.
Any idea what's going wrong?

Thanks for your help

These paths are the ones that the OS stores in its database. I have no control on them.

Flosch · Apr 18, 2017

Thanks for the answer.
The path seams to be "correct" - the file.exist function will return true.
But the GetAudioFileInfo methode will return 0. So I didn't get any information.
Is there a workaround to get the right path?
I create a playlist - with the path the 'location' information will provide me.
Later I will use the GetAudioFileInfo methode to get the informaiton I need to play it.

Informatix · Apr 20, 2017

Flosch said:
Thanks for the answer.
The path seams to be "correct" - the file.exist function will return true.
But the GetAudioFileInfo methode will return 0. So I didn't get any information.
Is there a workaround to get the right path?
I create a playlist - with the path the 'location' information will provide me.
Later I will use the GetAudioFileInfo methode to get the informaiton I need to play it.

Did you try to pass the path with all letters converted to lower case? e.g. "/storage/9016-4ef8/mp3/"

Flosch · Apr 20, 2017

Informatix said:
Did you try to pass the path with all letters converted to lower case? e.g. "/storage/9016-4ef8/mp3/"

I tried both upper and lower case in any possible combination for path and filename but GetAudioFileInfo will allways return 0x00.

Informatix · Apr 21, 2017

Flosch said:
I tried both upper and lower case in any possible combination for path and filename but GetAudioFileInfo will allways return 0x00.

I have no other idea. The code behind is pretty simple. I just send a query to the system database with your path as parameter.

hbhb · Mar 23, 2021

After upgrading to the API 30, I got the following error: The library works perfectly on all APIs<30.
It is similar for both Audio and Video, which use "GetExtVideoFileInfo."

B4X:

java.lang.IllegalArgumentException: Invalid token 15 - Test.mp4

hbhb · Apr 13, 2021

hbhb said:
After upgrading to the API 30, I got the following error: The library works perfectly on all APIs<30.
It is similar for both Audio and Video, which use "GetExtVideoFileInfo."

B4X:

java.lang.IllegalArgumentException: Invalid token 15 - Test.mp4

@Informatix

Informatix · Apr 19, 2021

hbhb said:
@Informatix

I'm unable to reproduce the issue. I have not a physical device, only an emulated one under API 30.

Informatix · Apr 20, 2021

After configuring correctly my setup, I have the error too. API 30 is more strict about SQL queries. Expect a new version soon.

B4A Library [Lib] MediaBrowser

Attachments

Expert

Active Member

Expert

Active Member

Expert

Active Member

Expert

Well-Known Member

Expert

Well-Known Member

Member

Expert

Member

Expert

Member

Expert

Member

Member

Expert

Expert

Similar Threads

Privacy & Transparency

Privacy & Transparency