程序包 ohos.media.photokit.metadata

类 AVLoggerConnection

java.lang.Object

ohos.media.photokit.metadata.AVLoggerConnection

public class AVLoggerConnection
extends Object

Provides your application with methods for transferring newly created or downloaded media files to the scanning service. The scanning service reads metadata from the media file and adds the file to the media database.

从以下版本开始:

3

SystemCapability

SystemCapability.Multimedia#MEDIA_LIBRARY

构造器概要

构造器

构造器	说明
AVLoggerConnection(Context context, AVLoggerConnectionClient client)	A constructor used to create an AVLoggerConnection instance.

方法概要

限定符和类型	方法	说明
void	connect()	Connects to the scanning service.
void	disconnect()	Disconnects from the scanning service.
boolean	isConnected()	Checks whether the scanning service is connected.
void	onServiceConnect()	Called when the application connects to the scanning service.
void	onServiceDisconnect()	Called when the application disconnects from the scanning service.
void	performLoggerFile(String path, String mimeType)	Requests to scan a media file based on the path and type of the file.
static void	performLoggerFile(Context context, String[] paths, String[] mimeTypes, AVLogCompletedListener callback)	Scans multiple media files at a time.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

AVLoggerConnection

public AVLoggerConnection(Context context,
                          AVLoggerConnectionClient client)

A constructor used to create an AVLoggerConnection instance.

参数:

context - Indicates the context required for establishing a connection to the scanning service.

client - Indicates the callback for receiving notifications from the scanner.

抛出:

IllegalArgumentException - Parameter invalid exception.

从以下版本开始:

3

方法详细资料

performLoggerFile

public void performLoggerFile(String path,
                              String mimeType)

Requests to scan a media file based on the path and type of the file.

参数:

path - Indicates the path of the file to scan.

mimeType - Indicates the MIME media type. If this parameter is null, the media type will be determined by the file name extension.

抛出:

IllegalArgumentException - Throws this exception if the file path is null.

从以下版本开始:

3

performLoggerFile

public static void performLoggerFile(Context context,
                                     String[] paths,
                                     String[] mimeTypes,
                                     AVLogCompletedListener callback)

Scans multiple media files at a time.

参数:

context - Indicates the caller context required for establishing a connection to the scanning service.

paths - Indicates the array of paths to scan.

mimeTypes - Indicates the array of the MIME media types matching the paths. If this parameter is null, the media types will be determined by the file name extensions.

callback - Indicates the callback for receiving the scanned URIs.

抛出:

IllegalArgumentException - Throws this exception if any parameter is invalid.

从以下版本开始:

3

connect

public void connect()

Connects to the scanning service.

从以下版本开始:

3

disconnect

public void disconnect()

Disconnects from the scanning service.

从以下版本开始:

3

isConnected

public boolean isConnected()

Checks whether the scanning service is connected.

返回:

Returns true if the connection is successful; returns false otherwise.

从以下版本开始:

3

onServiceConnect

public void onServiceConnect()

Called when the application connects to the scanning service.

This callback will not be triggered if the application has already connected to the scanning service or the scanning service crashes during the connection. Do not directly invoke this callback. Instead, override this callback via a subclass to define an operation after the connection.

从以下版本开始:

4

onServiceDisconnect

public void onServiceDisconnect()

Called when the application disconnects from the scanning service.

The disconnect() method does not trigger this callback. This callback is usually invoked when the process of the scanning service crashes or is terminated. In this case, the application is still connected to the scanning service, and onServiceConnect() will be invoked after the scanning service starts next time. Do not directly invoke this callback. Instead, override this callback via a subclass to define an operation after the disconnection.

从以下版本开始:

4