Cordova/Phonegap
Android SDcard & External Storage access API
This is a sample API of using cordova-plugin-files to scan sdcard & external-storage in Android
Example of using the API:
new ExternalStorageSdcardAccess( fileHandler ).scanPath( "file:///storage/sdcard1/music" );
function fileHandler( fileEntry ) {
console.log( fileEntry.name + " | " + fileEntry.toURL() );
}Preparation:
-
install cordova-plugin-files from: https://github.com/apache/cordova-plugin-file
-
.html
<script src="js/exernalStorageSdcardAccess.js"></script>
- config.xml
delete: <preference name="AndroidExtraFilesystems"/>
- make sure testing environment can access it's own external storage at the time of testing. ( e.p. if the device is connected with usb, make sure it is connected as a camera
;Call the APIs after recieving the"deviceready"event )
APIs
ExternalStorageSdcardAccess( _fileHandler, _errorHandler ):
Create a new instance of this class to use the API.Both parameters have default handler.
@params _fileHandler(fileEntry): when a file is discovered, the handler will be called, pass a FileEntry object
@params _errorHandler(error): when a error occurs, the handler will be called, pass a FileError object
ExternalStorageSdcardAccess.scanRoot:
Scan all the files by using all the pathes in the array
ExternalStorageSdcardAccess.scanPathList( arrayOfPath ):
Scan all the files and directories from the root
ExternalStorageSdcardAccess.scanPath( path ):
Scan all the files by using the path
Things need to know before looking into the source code
DirectoryEntry: https://cordova.apache.org/docs/en/2.4.0/cordova/file/directoryentry/directoryentry.html
FileEntry: http://docs.phonegap.com/en/edge/cordova_file_file.md.html#FileEntry
About correct path parameter
"cdvfile://localhost/", // * Err 5 (wrong pattern)
"file:///", // * root, directoryEntry
"file:///somefile/", // * somefile, directoryEntry
"file:///somefile", // * somefile, directoryEntry
"file:///randomdumbname", // * Err 1, (not found)
"file:///somefile/ACG/aaaaa.mp3", // * OK, fileEntry