android.media
public
class
android.media.MediaScannerConnection
MediaScannerConnection provides a way for applications to pass a
newly created or downloaded media file to the media scanner service.
The media scanner service will read metadata from the file and add
the file to the media content provider.
The MediaScannerConnectionClient provides an interface for the
media scanner service to return the Uri for a newly scanned file
to the client of the MediaScannerConnection class.
Nested Classes
Summary
Public Constructors
Public Methods
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Public Constructors
Constructs a new MediaScannerConnection object.
Parameters
context
| the Context object, required for establishing a connection to
the media scanner service. |
client
| an optional object implementing the MediaScannerConnectionClient
interface, for receiving notifications from the media scanner.
|
Public Methods
public
void
connect()
Initiates a connection to the media scanner service.
onMediaScannerConnected()
will be called when the connection is established.
public
void
disconnect()
Releases the connection to the media scanner service.
public
synchronized
boolean
isConnected()
Returns whether we are connected to the media scanner service
Returns
- true if we are connected, false otherwise
public
void
onServiceConnected(ComponentName className, IBinder service)
Part of the ServiceConnection interface. Do not call.
public
void
onServiceDisconnected(ComponentName className)
Part of the ServiceConnection interface. Do not call.
public
void
scanFile(String path, String mimeType)
Requests the media scanner to scan a file.
Parameters
path
| the path to the file to be scanned. |
mimeType
| an optional mimeType for the file.
If mimeType is null, then the mimeType will be inferred from the file extension.
Success or failure of the scanning operation cannot be determined until
onScanCompleted(String, Uri) is called.
|