| 包: | dji.v5.manager.interfaces |
IMediaManager
多媒体文件管理类。提供多媒体文件列表下载,多媒体文件预览,下载和视频播放等功能。
描述:
enable
Since MSDK 5.0.0void enable(CommonCallbacks |
进入多媒体文件管理模块。调用此接口后,相机会进入多媒体文件管理模块,此模式下,你可以拉取多媒体文件列表,可以播放相机中的视频。与此同时,相机将无法拍照录像,图传将无法正常显示,建议你在进入相册功能时调用此接口。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | CommonCallbacks | 返回执行结果的回调。 |
disable
Since MSDK 5.0.0void disable(CommonCallbacks |
退出多媒体文件管理模块。调用此接口后,相机会退出多媒体文件管理模块,相机可正常拍照录像,图传将正常显示,建议你在退出相册功能时调用此接口。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | CommonCallbacks | 返回执行结果的回调。 |
addMediaFileListStateListener
Since MSDK 5.0.0void addMediaFileListStateListener(MediaFileListStateListener listener) |
设置多媒体文件列表状态监听器。通过此监听器可以监听多媒体文件列表的状态。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | MediaFileListStateListener | 多媒体文件列表状态监听器 |
removeMediaFileListStateListener
Since MSDK 5.0.0void removeMediaFileListStateListener(MediaFileListStateListener listener) |
删除多媒体文件列表状态监听器。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | MediaFileListStateListener | 多媒体文件列表状态监听器 |
removeAllMediaFileListStateListener
Since MSDK 5.0.0void removeAllMediaFileListStateListener() |
删除所有多媒体文件列表状态监听器。
getMediaFileListState
Since MSDK 5.0.0MediaFileListState getMediaFileListState() |
获取多媒体文件列表状态,这是一个同步接口。
返回值
| 类型 | 说明 |
|---|---|
MediaFileListState | 返回多媒体文件列表状态。 |
setMediaFileDataSource
Since MSDK 5.0.0void setMediaFileDataSource(MediaFileListDataSource source) |
设置需要获取的多媒体文件数据源。你可以选择拉取不同存储位置和不同负载中的多媒体文件。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
source | MediaFileListDataSource | 多媒体文件数据源。 |
pullMediaFileListFromCamera
Since MSDK 5.0.0void pullMediaFileListFromCamera(@NonNull |
从相机中拉取多媒体文件列表。当多媒体文件列表状态MediaFileListState为IDLE时,需要调用此方法从相机中拉取全量数据。当有新媒体文件产生的时候,MSDK会自动从相机拉取最新的多媒体文件列表。当多媒体文件列表状态MediaFileListState变为UP_TO_DATE时,表示拉取多媒体文件列表已完成,请调用getMediaFileListData获取多媒体文件列表数据。
Zenmuse P1和Zenmuse L1只支持全量拉取多媒体文件列表,设置mediaFileIndex和count无效。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
param | @NonNull | 多媒体文件列表参数。Zenmuse P1和Zenmuse L1只支持全量拉取多媒体文件列表,设置mediaFileIndex和count无效。 |
callback | CommonCallbacks | 返回执行结果的回调。 |
stopPullMediaFileListFromCamera
Since MSDK 5.0.0void stopPullMediaFileListFromCamera() |
停止从相机中拉取多媒体文件列表。
getMediaFileListData
Since MSDK 5.0.0MediaFileListData getMediaFileListData() |
获取多媒体文件列表数据。当监听到多媒体文件列表状态MediaFileListState为UP_TO_DATE时,说明多媒体文件列表有更新,需要再次调用此接口更新多媒体文件列表数据。
返回值
| 类型 | 说明 |
|---|---|
MediaFileListData | 返回多媒体文件列表数据。 |
deleteMediaFiles
Since MSDK 5.0.0void deleteMediaFiles(List |
删除相机中的多媒体文件。调用此接口后,多媒体文件列表状态MediaFileListState会变成UPDATING,当删除操作完成以后,多媒体文件列表状态MediaFileListState为UP_TO_DATE,请调用getMediaFileListData更新多媒体文件列表数据。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
files | List | 需要删除的多媒体文件列表。 |
callback | CommonCallbacks | 返回执行结果的回调。 |
setMediaFileXMPCustomInfo
Since MSDK 5.7.0void setMediaFileXMPCustomInfo(@NonNull |
设置XMP自定义信息。设置成功后,每次生成照片文件,XMP自定义信息都会存储在照片文件的XMP元数据中。你可以调用MdeiaFile类中的pullXMPCustomInfoFromCamera方法从相机中拉取指定照片文件的XMP自定义信息。
1. 一次设置多次有效,相机重启后会把自定义信息清除,需要重新设置。
2. 目前只支持Zenmuse H20系列相机,Zenmuse L1相机,Zenmuse P1相机。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
information | @NonNull | 需要设置的XMP自定义信息。使用UTF-8编码,长度小于或等于31个字符。 |
callback | CommonCallbacks | 返回执行结果的回调。 |
getMediaFileXMPCustomInfo
Since MSDK 5.7.0void getMediaFileXMPCustomInfo(@NonNull |
获取设置的XMP自定义信息。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | @NonNull | 返回执行结果的回调。 |
playVideo
已废弃Since MSDK 5.0.0@Deprecated |
开始播放设置的多媒体文件,媒体文件数据通过回调方法的获取。
IVideoFrame,调用自定义解码器进行解码以播放视频。IVideoDecoder来进行解码以播放视频。用EXTENDED_STREAM_CHANNEL初始化IVideoDecoder,然后调用setMediaFile把需要解码的媒体文件设置到解码器中,最后调用queueInFrame将callback中获取到的视频帧数据IVideoFrame送入队列进行解码。注意:
该接口从MSDK 5.8.0版本开始废弃。请调用
playVideoToSurface播放多媒体文件。 MSDK 5.0.0开始支持
参数
| 名称 | 类型 | 说明 |
|---|---|---|
mediaFile | MediaFile | 需要播放的多媒体文件。 |
callback | CommonCallbacks | 返回执行结果的回调。 |
playVideoToSurface
Since MSDK 5.8.0void playVideoToSurface(MediaFile mediaFile, |
开始播放设置的多媒体文件,媒体文件数据通过回调方法的获取。
如果你希望自己实现解码以播放视频,你通过listener中获取到的视频数据,调用自定义解码器进行解码以播放视频。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
mediaFile | MediaFile | 需要播放的多媒体文件。 |
surface | Surface | 需要播放显示的surface。 |
surfaceWidth | int | 需要播放显示surface的宽。 |
surfaceHeight | int | 需要播放显示surface的高。 |
scaleType | ICameraStreamManager | 设置需要进行码流显示的surface的缩放类型。 |
listener | MediaFrameListener | 返回执行结果的回调。 |
seekVideo
Since MSDK 5.0.0void seekVideo(int position, CommonCallbacks |
跳转播放多媒体文件。可以设置新的播放位置开始播放。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
position | int | 需要跳转播放的位置,单位:秒。 |
callback | CommonCallbacks | 返回执行结果的回调。 |
pauseVideo
Since MSDK 5.0.0void pauseVideo(CommonCallbacks |
暂停播放多媒体文件。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | CommonCallbacks | 返回执行结果的回调。 |
resumeVideo
Since MSDK 5.0.0void resumeVideo(CommonCallbacks |
恢复播放多媒体文件。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | CommonCallbacks | 返回执行结果的回调。 |
stopVideo
Since MSDK 5.0.0void stopVideo(CommonCallbacks |
停止播放多媒体文件。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
callback | CommonCallbacks | 返回执行结果的回调。 |
addVideoPlayStateListener
Since MSDK 5.0.0void addVideoPlayStateListener(VideoPlayStateListener listener) |
设置多媒体文件播放状态监听器。通过此监听器可以监听多媒体文件播放的状态。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | VideoPlayStateListener | 多媒体文件播放状态监听器 |
removeVideoPlayStateListener
Since MSDK 5.0.0void removeVideoPlayStateListener(VideoPlayStateListener listener) |
删除多媒体文件播放状态监听器。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
listener | VideoPlayStateListener | 多媒体文件播放状态监听器 |
removeAllVideoPlayStateListener
Since MSDK 5.0.0void removeAllVideoPlayStateListener() |
删除所有多媒体文件列表播放监听器。
release
Since MSDK 5.0.0void release() |
资源释放。调用此接口将会取消多媒体文件数据下载,清空缩略图缓存,清空多媒体文件列表数据。建议你在系统内存不足的时候调用。
Related:
MediaFileListDataSource
Since MSDK 5.0.0class MediaFileListDataSource |
多媒体文件列表数据源类。用于设置需要获取的多媒体文件的存储位置和负载位置。
PullMediaFileListParam
Since MSDK 5.0.0class PullMediaFileListParam |
多媒体文件列表参数类。设置拉取多媒体文件的参数,可以选择拉取照片,视频或者所有的多媒体文件列表。
MediaFileListData
Since MSDK 5.0.0class MediaFileListData |
多媒体文件列表数据类。
MediaFile
Since MSDK 5.0.0class MediaFile implements Serializable |
多媒体文件数据类。
MediaFileListState
Since MSDK 5.0.0多媒体文件列表状态。
枚举成员
MediaFileListStateListener
Since MSDK 5.0.0interface MediaFileListStateListener |
多媒体文件列表状态监听器。
VideoPlayState
Since MSDK 5.0.0多媒体文件播放状态枚举类型。
枚举成员
| 名称 | 说明 |
|---|---|
IDLE | 空闲状态。未开启多媒体文件播放功能,可以调用playVideo进行多媒体文件播放。 |
PLAYING | 播放中。 |
ENDED | 播放结束。 |
STOPPED | 停止播放。当调用stopVideo接口成功停止播放多媒体文件后会回调此状态。 |
VideoPlayStatus
Since MSDK 5.0.0class VideoPlayStatus |
多媒体文件播放状态。
VideoPlayStateListener
Since MSDK 5.0.0interface VideoPlayStateListener |
多媒体文件播放状态监听器。
MediaFileDownloadListener
Since MSDK 5.0.0interface MediaFileDownloadListener |
多媒体文件下载监听器。
MediaFrameListener
Since MSDK 5.8.0interface MediaFrameListener |
多媒体文件数据监听器。