Android
android.media
public class

android.media.MediaScannerConnection

java.lang.Object
android.media.MediaScannerConnection ServiceConnection

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
MediaScannerConnection.MediaScannerConnectionClient An interface for notifying clients of MediaScannerConnection when a connection to the MediaScanner service has been established and when the scanning of a file has completed. 

Summary

Public Constructors

            MediaScannerConnection(Context context, MediaScannerConnection.MediaScannerConnectionClient client)
Constructs a new MediaScannerConnection object.

Public Methods

          void  connect()
Initiates a connection to the media scanner service.
          void  disconnect()
Releases the connection to the media scanner service.
  synchronized        boolean  isConnected()
Returns whether we are connected to the media scanner service
          void  onServiceConnected(ComponentName className, IBinder service)
Part of the ServiceConnection interface.
          void  onServiceDisconnected(ComponentName className)
Part of the ServiceConnection interface.
          void  scanFile(String path, String mimeType)
Requests the media scanner to scan a file.
Methods inherited from class java.lang.Object
Methods inherited from interface android.content.ServiceConnection

Details

Public Constructors

public MediaScannerConnection(Context context, MediaScannerConnection.MediaScannerConnectionClient client)

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.
Copyright 2007 Google Inc. Build 0.9_r1-98467 - 14 Aug 2008 18:56