com.supermap.mdatacollector

类 MDataCollector

java.lang.Object

com.supermap.mdatacollector.MDataCollector

public class MDataCollector
extends java.lang.Object

多媒体数据采集类

支持采集照片、音频和视频，同时记录采集地点的经纬度坐标，并能将其上传到指定的iportal服务上，也支持从iportal上下载数据

构造器概要

构造器

构造器和说明
MDataCollector(android.content.Context context) 构造函数

方法概要

限定符和类型	方法和说明
void	addNetworkAccessMediaFileListener(NetworkAccessMediaFileListener listener) 添加网络传输监听器
boolean	captureImage() 开启相机,采集照片
boolean	captureVideo() 开启相机录像
void	closeGPS() 关闭GPS
void	downloadMediaFiles(Rectangle2D bounds) 下载给定范围中的多媒体文件
java.lang.String	getLocalFilePath() 获取本地存储多媒体文件的路径
Dataset	getMediaDataset() 获取用于多媒体采集的数据集
boolean	login(java.lang.String url, java.lang.String username, java.lang.String password) 登录iPortal,如果用户名或密码错误，将抛出异常IllegalStateException
void	logout() 注销登录信息
void	onActivityResult(int requestCode, int resultCode, android.content.Intent data) 拍照、录像、录音等应用结束时的返回结果处理,需要在Activity中重载onActivityResult, 并在重载函数中调用该方法,并由重载的onActivityResult给出所需参数
boolean	openGPS() 开启GPS功能，用于定位
boolean	removeMediaFilesWithBounds(Rectangle2D bounds) 根据给定的地图范围删除已采集的多媒体数据
boolean	removeMediaFilesWithID(int mediaFileID) 根据SMID删除已采集的多媒体数据
void	removeNetworkAccessMediaFileListener(NetworkAccessMediaFileListener listener) 移除网络传输监听器
void	setGPSData(LocationManagePlugin.GPSData gpsdata) 设置GPS数据, 其数据来自自定义的定位功能
void	setLocalFilePath(java.lang.String path) 设置本地存储多媒体文件的路径
boolean	setMediaDataset(Datasource datasource, java.lang.String datasetName) 设置用于多媒体采集的数据集
void	startCaptureAudio() 开始录音
boolean	stopCaptureAudio() 停止录音,并记录采集和保存录音文件
void	uploadMediaFiles(Rectangle2D bounds) 上传给定范围中的多媒体文件

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

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

构造器详细资料

MDataCollector

public MDataCollector(android.content.Context context)

构造函数

参数:

context - Activity上下文

方法详细资料

addNetworkAccessMediaFileListener

public void addNetworkAccessMediaFileListener(NetworkAccessMediaFileListener listener)

添加网络传输监听器

参数:

listener - 网络传输监听器

removeNetworkAccessMediaFileListener

public void removeNetworkAccessMediaFileListener(NetworkAccessMediaFileListener listener)

移除网络传输监听器

参数:

listener - 网络传输监听器

login

public boolean login(java.lang.String url,
                     java.lang.String username,
                     java.lang.String password)

登录iPortal,如果用户名或密码错误，将抛出异常IllegalStateException

参数:

url - iPortal服务登录地址，如"http://" + IPiPortal + ":8090/iportal"

username - 用户名

password - 用户密码

返回:

登录成功，返回true;否则，返回false

logout

public void logout()

注销登录信息

downloadMediaFiles

public void downloadMediaFiles(Rectangle2D bounds)

下载给定范围中的多媒体文件

参数:

bounds - 给定的地图范围

uploadMediaFiles

public void uploadMediaFiles(Rectangle2D bounds)

上传给定范围中的多媒体文件

参数:

bounds - 给定的地图范围

setMediaDataset

public boolean setMediaDataset(Datasource datasource,
                               java.lang.String datasetName)

设置用于多媒体采集的数据集

参数:

datasource - 数据源

datasetName - 数据集名

返回:

设置成功,返回true;否则, 返回false

注:

1.用于多媒体采集的数据集是点数据集，设置了MediaFileName和MediaFileType两个字段分别用于存储多媒体文件名和文件类型，

其中MediaFileName的字段类型为文本型，MediaFileType的类型为16位整型。

2.如果指定的数据集不存在，将会在给定的数据源中创建一个这样的数据集。

3.如果指定的数据不存在MediaFileName或MediaFileType字段，将会抛出IllegalStateException异常，此时请重新设置数据集，

或根据第1点为该数据集添加字段。

getMediaDataset

public Dataset getMediaDataset()

获取用于多媒体采集的数据集

返回:

返回数据集

setLocalFilePath

public void setLocalFilePath(java.lang.String path)

设置本地存储多媒体文件的路径

参数:

path - 存储多媒体文件的路径

getLocalFilePath

public java.lang.String getLocalFilePath()

获取本地存储多媒体文件的路径

返回:

存储多媒体文件的路径

captureImage

public boolean captureImage()

开启相机,采集照片

返回:

启动应用成功,返回true,否则返回false

captureVideo

public boolean captureVideo()

开启相机录像

返回:

启动应用成功,返回true,否则返回false

onActivityResult

public void onActivityResult(int requestCode,
                             int resultCode,
                             android.content.Intent data)

拍照、录像、录音等应用结束时的返回结果处理,需要在Activity中重载onActivityResult, 并在重载函数中调用该方法,并由重载的onActivityResult给出所需参数

参数:

requestCode - 请求码

resultCode - 结果码

data - 返回的数据

startCaptureAudio

public void startCaptureAudio()

开始录音

stopCaptureAudio

public boolean stopCaptureAudio()

停止录音,并记录采集和保存录音文件

返回:

采集成功,返回true,否则返回false

setGPSData

public void setGPSData(LocationManagePlugin.GPSData gpsdata)

设置GPS数据, 其数据来自自定义的定位功能

参数:

gpsdata - GPS数据。

openGPS

public boolean openGPS()

开启GPS功能，用于定位

返回:

成功开启，返回true;否则，返回false

closeGPS

public void closeGPS()

关闭GPS

removeMediaFilesWithBounds

public boolean removeMediaFilesWithBounds(Rectangle2D bounds)

根据给定的地图范围删除已采集的多媒体数据

参数:

bounds - 地图范围

返回:

返回是否删除成功

removeMediaFilesWithID

public boolean removeMediaFilesWithID(int mediaFileID)

根据SMID删除已采集的多媒体数据

参数:

mediaFileID - SMID值

返回:

返回是否删除成功