MediaScannerConnection | Android Developers

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. interface 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. interface MediaScannerConnection.OnScanCompletedListener Interface for notifying clients of the result of scanning a requested media file. MediaScannerConnection ( Context context, MediaScannerConnection.MediaScannerConnectionClient client)

Constructs a new MediaScannerConnection object.

scanFile ( Context context, String[] paths, String[] mimeTypes, MediaScannerConnection.OnScanCompletedListener callback)

Convenience for constructing a


    
     MediaScannerConnection

, calling


    
     connect()

on it, and calling


    
     scanFile(Context, String[], String[], MediaScannerConnection.OnScanCompletedListener)

with the given path and mimeType when the connection is established.

wait (long millis, int nanos)

Causes the calling thread to wait until another thread calls the


    notify()


    notifyAll()

method of this object or until the specified timeout expires.

wait (long millis)

Causes the calling thread to wait until another thread calls the


    notify()


    notifyAll()

method of this object or until the specified timeout expires.

onServiceConnected ( ComponentName name, IBinder service)

Called when a connection to the Service has been established, with the


    
     IBinder

of the communication channel to the Service.

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.

Convenience for constructing a MediaScannerConnection , calling connect() on it, and calling scanFile(Context, String[], String[], MediaScannerConnection.OnScanCompletedListener) with the given path and mimeType when the connection is established.

Parameters

context The caller's Context, required for establishing a connection to the media scanner service. Success or failure of the scanning operation cannot be determined until


   
    onScanCompleted(String, Uri)

is called. paths Array of paths to be scanned. mimeTypes Optional array of MIME types for each path. If mimeType is null, then the mimeType will be inferred from the file extension. callback Optional callback through which you can receive the scanned URI and MIME type; If null, the file will be scanned but you will not get a result back.

Requests the media scanner to scan a file. Success or failure of the scanning operation cannot be determined until onScanCompleted(String, Uri) is called.

Parameters

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. Except as noted, this content is licensed under Apache 2.0 . For details and restrictions, see the Content License . Android 2.3 r1 - 12 Nov 2011 9:28