美摄SDK For Android  1.0.0
Public 成员函数 | 所有成员列表
com.meicam.sdk.NvsVideoClip类 参考

视频片段,对视频文件的描述 更多...

类 com.meicam.sdk.NvsVideoClip 继承关系图:
com.meicam.sdk.NvsClip com.meicam.sdk.NvsObject

Public 成员函数

int getVideoType ()
 获取片段类型 更多...
 
int getRoleInTheme ()
 获取片段在主题中的角色 更多...
 
void setPlayInReverse (boolean playInReverse)
 设置片段是否倒放 更多...
 
boolean getPlayInReverse ()
 获取片段是否倒放 更多...
 
void setExtraVideoRotation (int rotation)
 设置视频额外旋转角度 更多...
 
int getExtraVideoRotation ()
 获取视频额外旋转角度 更多...
 
void setSoftWareDecoding (boolean softwareUsed)
 设置视频是否使用软件解码 更多...
 
boolean isSoftWareDeocedUsed ()
 获取视频是否使用软件解码 更多...
 
void disableAmbiguousCrop (boolean disable)
 设置视频是否禁止画面的近似比例裁剪 更多...
 
boolean isAmbiguousCropDisabled ()
 获取视频是否禁止画面的近似比例裁剪 更多...
 
void setPanAndScan (float pan, float scan)
 设置摇摄和扫描 更多...
 
NvsPanAndScan getPanAndScan ()
 获取摇摄和扫描 更多...
 
int getSourceBackgroundMode ()
 获取背景模式 更多...
 
void setSourceBackgroundMode (int mode)
 设置背景模式 更多...
 
int getImageMotionMode ()
 获取图片片段运作模式 更多...
 
void setImageMotionMode (int mode)
 设置图片运作模式 更多...
 
boolean getImageMotionAnimationEnabled ()
 获取图片动画状态 更多...
 
void setImageMotionAnimationEnabled (boolean enabled)
 设置是否支持图片动画 更多...
 
RectF getStartROI ()
 获取图片片段起始ROI 更多...
 
RectF getEndROI ()
 获取图片片段终止ROI 更多...
 
void setImageMotionROI (RectF startROI, RectF endROI)
 设置图片片段动态移动ROI 更多...
 
RectF getImageMaskROI ()
 获取图片片段掩模ROI 更多...
 
void setImageMaskROI (RectF maskROI)
 设置图片片段掩模ROI 更多...
 
void setClipWrapMode (int wrapMode)
 设置片段循环模式 更多...
 
int getClipWrapMode ()
 获取视频循环模式 更多...
 
NvsVideoFx appendBuiltinFx (String fxName)
 在片段上追加内嵌式特效 更多...
 
NvsVideoFx insertBuiltinFx (String fxName, int fxIndex)
 在片段上指定特效索引处插入内嵌式特效 更多...
 
NvsVideoFx appendPackagedFx (String fxPackageId)
 在片段上追加资源包特效 更多...
 
NvsVideoFx insertPackagedFx (String fxPackageId, int fxIndex)
 在片段上指定特效索引处插入资源包特效 更多...
 
NvsVideoFx appendCustomFx (NvsCustomVideoFx.Renderer customVideoFxRender)
 在片段上追加自定义视频特效 更多...
 
NvsVideoFx insertCustomFx (NvsCustomVideoFx.Renderer customVideoFxRender, int fxIndex)
 在片段上指定特效索引处插入自定义视频特效 更多...
 
NvsVideoFx appendBeautyFx ()
 在片段上追加美颜特效 更多...
 
NvsVideoFx insertBeautyFx (int fxIndex)
 在片段上指定特效索引处插入美颜特效 更多...
 
boolean removeFx (int fxIndex)
 移除特效 更多...
 
boolean removeAllFx ()
 移除所有特效 更多...
 
NvsVideoFx getFxByIndex (int fxIndex)
 通过索引获取特效 更多...
 
- Public 成员函数 继承自 com.meicam.sdk.NvsClip
long getTrimIn ()
 获取片段的裁剪入点 更多...
 
long getTrimOut ()
 获取片段的裁剪出点 更多...
 
long getInPoint ()
 获取片段在时间线上的入点 更多...
 
long getOutPoint ()
 获取片段在时间线上的出点 更多...
 
int getType ()
 获取片段类型(视频片段,音频片段) 更多...
 
int getIndex ()
 获取片段在轨道上的索引 更多...
 
String getFilePath ()
 获取片段文件路径 更多...
 
int getFxCount ()
 获取片段上的特效数量。注:片段上的特效索引是从0开始 更多...
 
long changeTrimInPoint (long newTrimInPoint, boolean affectSibling)
 修改片段的裁剪入点 更多...
 
long changeTrimOutPoint (long newTrimOutPoint, boolean affectSibling)
 修改片段的裁剪出点 更多...
 
double getSpeed ()
 获取片段的播放速度。 更多...
 
void changeSpeed (double newSpeed)
 改变片段的播放速度 更多...
 
void changeSpeed (double newSpeed, boolean keepAudioPitch)
 改变片段的播放速度 更多...
 
void setVolumeGain (float leftVolumeGain, float rightVolumeGain)
 设置音量 更多...
 
NvsVolume getVolumeGain ()
 获取音量 更多...
 
- Public 成员函数 继承自 com.meicam.sdk.NvsObject
void setAttachment (String key, Object value)
 为NvsObject对象添加附加的数据,用来标识NvsObject的对象或者其他用途 更多...
 
Object getAttachment (String key)
 获取NvsObject的附件 更多...
 

静态 Public 属性

片段类型

static final int VIDEO_CLIP_TYPE_AV = 0
 音视频类型 更多...
 
static final int VIDEO_CLIP_TYPE_IMAGE = 1
 图片类型 更多...
 
片段在主题中的角色

static final int ROLE_IN_THEME_GENERAL = 0
 通用 更多...
 
static final int ROLE_IN_THEME_TITLE = 1
 片头 更多...
 
static final int ROLE_IN_THEME_TRAILER = 2
 片尾 更多...
 
片段运作模式

static final int CLIP_MOTIONMODE_LETTERBOX_ZOOMIN = 0
 放大 更多...
 
static final int ClIP_MOTIONMODE_LETTERBOX_ZOOMOUT = 1
 缩小 更多...
 
static final int IMAGE_CLIP_MOTIONMMODE_ROI = 2
 图片片段ROI(Region Of Interesting) 更多...
 
片段循环模式

static final int CLIP_WRAPMODE_REPEAT_LASTFRAME = 0
 首帧 更多...
 
static final int ClIP_WRAPMODE_REPEAT_FIRSTFRAME = 1
 末帧 更多...
 
static final int ClIP_WRAPMODE_REPEAT = 2
 
视频额外旋转角度

static final int ClIP_EXTRAVIDEOROTATION_0 = 0
 0度 更多...
 
static final int ClIP_EXTRAVIDEOROTATION_90 = 1
 90度 更多...
 
static final int ClIP_EXTRAVIDEOROTATION_180 = 2
 180度 更多...
 
static final int ClIP_EXTRAVIDEOROTATION_270 = 3
 
片段背景模式

static final int ClIP_BACKGROUNDMODE_COLOR_SOLID = 0
 纯色 更多...
 
static final int ClIP_BACKGROUNDMODE_BLUR = 1
 
- 静态 Public 属性 继承自 com.meicam.sdk.NvsClip
static final int CLIP_TYPE_VIDEO = 0
 视频片段类型 更多...
 
static final int CLIP_TYPE_AUDIO = 1
 音频片段类型 更多...
 

额外继承的成员函数

- Protected 成员函数 继承自 com.meicam.sdk.NvsObject
void setInternalObject (long internalObject)
 
long getInternalObject ()
 
- Protected 属性 继承自 com.meicam.sdk.NvsObject
long m_internalObject = 0
 

详细描述

视频片段,对视频文件的描述

视频片段源可以是视频或者图片。每个视频片段可以修改其裁剪入点、裁剪出点以及播放速度,也可以设置摇摄和扫描。编辑视频时,可以按特效类型的不同(内建特效,包裹式特效,美颜特效)添加或者插入多个视频特效。 添加资源包特效时,都得先安装,安装成功后获取packageId才能使用,而内建特效(builtin)只需获取特效名称即可使用。

警告
NvsVideoClip类中,所有public API都在UI线程使用!!!

成员函数说明

NvsVideoFx com.meicam.sdk.NvsVideoClip.appendBeautyFx ( )
inline

在片段上追加美颜特效

返回
返回追加的视频特效对象
参见
insertBeautyFx
appendPackagedFx
appendBuiltinFx
NvsVideoFx com.meicam.sdk.NvsVideoClip.appendBuiltinFx ( String  fxName)
inline

在片段上追加内嵌式特效

参数
fxName特效名称。获取视频特效名称,请参见getAllBuiltinVideoFxNames()内建特效名称列表
返回
返回追加的视频特效对象
参见
insertBuiltinFx
appendBeautyFx
appendPackagedFx
NvsVideoFx com.meicam.sdk.NvsVideoClip.appendCustomFx ( NvsCustomVideoFx.Renderer  customVideoFxRender)
inline

在片段上追加自定义视频特效

参数
customVideoFxRender用户实现的自定义视频特效渲染器接口
返回
返回追加的视频特效对象
自从
1.7.0
NvsVideoFx com.meicam.sdk.NvsVideoClip.appendPackagedFx ( String  fxPackageId)
inline

在片段上追加资源包特效

参数
fxPackageId特效资源包ID
返回
返回追加的视频特效对象
参见
insertPackagedFx
appendBuiltinFx
appendBeautyFx
void com.meicam.sdk.NvsVideoClip.disableAmbiguousCrop ( boolean  disable)
inline

设置视频是否禁止画面的近似比例裁剪

参数
disable是否禁止
参见
isAmbiguousCropDisabled
int com.meicam.sdk.NvsVideoClip.getClipWrapMode ( )
inline

获取视频循环模式

返回
返回循环模式
自从
2.2.3
参见
setClipWrapMode
RectF com.meicam.sdk.NvsVideoClip.getEndROI ( )
inline

获取图片片段终止ROI

返回
返回RectF对象,表示图片片段终止ROI
自从
1.1.0
参见
setImageMotionROI
int com.meicam.sdk.NvsVideoClip.getExtraVideoRotation ( )
inline

获取视频额外旋转角度

返回
返回获取的视频额外旋转角度。请参见视频额外旋转角度
参见
setExtraVideoRotation
NvsVideoFx com.meicam.sdk.NvsVideoClip.getFxByIndex ( int  fxIndex)
inline

通过索引获取特效

参数
fxIndex特效索引,参见getFxCount()
返回
返回获取的视频特效对象
RectF com.meicam.sdk.NvsVideoClip.getImageMaskROI ( )
inline

获取图片片段掩模ROI

返回
返回RectF对象,表示图片片段掩模ROI
自从
2.2.3
参见
setImageMaskROI
boolean com.meicam.sdk.NvsVideoClip.getImageMotionAnimationEnabled ( )
inline

获取图片动画状态

返回
返回boolean值,表示图片动画状态。值为true则支持图片动画,false则不支持
自从
1.1.0
参见
setImageMotionAnimationEnabled
int com.meicam.sdk.NvsVideoClip.getImageMotionMode ( )
inline

获取图片片段运作模式

返回
返回表示图片片段运作模式的整形值。请参见片段运作模式
自从
1.1.0
参见
setImageMotionMode
NvsPanAndScan com.meicam.sdk.NvsVideoClip.getPanAndScan ( )
inline

获取摇摄和扫描

返回
返回获取的摇摄扫描对象
参见
setPanAndScan
boolean com.meicam.sdk.NvsVideoClip.getPlayInReverse ( )
inline

获取片段是否倒放

返回
返回片段是否倒放
自从
1.5.0
参见
setPlayInReverse
int com.meicam.sdk.NvsVideoClip.getRoleInTheme ( )
inline

获取片段在主题中的角色

返回
返回片段在主题中的角色
int com.meicam.sdk.NvsVideoClip.getSourceBackgroundMode ( )
inline

获取背景模式

返回
返回获取的背景模式对象
参见
setClipBackgroundMode
RectF com.meicam.sdk.NvsVideoClip.getStartROI ( )
inline

获取图片片段起始ROI

返回
返回RectF对象,表示图片片段起始ROI
自从
1.1.0
参见
setImageMotionROI
int com.meicam.sdk.NvsVideoClip.getVideoType ( )
inline

获取片段类型

返回
返回片段类型
NvsVideoFx com.meicam.sdk.NvsVideoClip.insertBeautyFx ( int  fxIndex)
inline

在片段上指定特效索引处插入美颜特效

参数
fxIndex插入特效索引,参见getFxCount()
返回
返回插入的视频特效对象
参见
appendBeautyFx
insertBuiltinFx
insertPackagedFx
NvsVideoFx com.meicam.sdk.NvsVideoClip.insertBuiltinFx ( String  fxName,
int  fxIndex 
)
inline

在片段上指定特效索引处插入内嵌式特效

参数
fxName特效名称。获取视频特效名称,请参见getAllBuiltinVideoFxNames()或[内建特效名称列表]
fxIndex插入特效索引
返回
返回插入的视频特效对象
参见
appendBuiltinFx
insertPackagedFx
insertBeautyFx
NvsVideoFx com.meicam.sdk.NvsVideoClip.insertCustomFx ( NvsCustomVideoFx.Renderer  customVideoFxRender,
int  fxIndex 
)
inline

在片段上指定特效索引处插入自定义视频特效

参数
customVideoFxRender用户实现的自定义视频特效渲染器接口
fxIndex插入特效索引
返回
返回插入的视频特效对象
自从
1.7.0
NvsVideoFx com.meicam.sdk.NvsVideoClip.insertPackagedFx ( String  fxPackageId,
int  fxIndex 
)
inline

在片段上指定特效索引处插入资源包特效

参数
fxPackageId特效资源包ID
fxIndex插入特效索引,参见getFxCount()
返回
返回插入的视频特效对象
参见
appendPackagedFx
insertBeautyFx
insertBuiltinFx
boolean com.meicam.sdk.NvsVideoClip.isAmbiguousCropDisabled ( )
inline

获取视频是否禁止画面的近似比例裁剪

返回
返回获取的视频是否禁止画面的近似比例裁剪
参见
disableAmbiguousCrop
boolean com.meicam.sdk.NvsVideoClip.isSoftWareDeocedUsed ( )
inline

获取视频是否使用软件解码

返回
返回获取的视频是否使用软件解码
参见
setSoftWareDecoding
boolean com.meicam.sdk.NvsVideoClip.removeAllFx ( )
inline

移除所有特效

返回
判断是否移除成功。返回true则移除成功,false则移除失败
参见
removeFx
boolean com.meicam.sdk.NvsVideoClip.removeFx ( int  fxIndex)
inline

移除特效

参数
fxIndex特效索引,参见getFxCount()
返回
判断是否移除成功。返回true则移除成功,false则移除失败
参见
removeAllFx
getFxByIndex
void com.meicam.sdk.NvsVideoClip.setClipWrapMode ( int  wrapMode)
inline

设置片段循环模式

参数
wrapMode循环模式
自从
2.2.3
参见
getClipWrapMode

< 循环模式介于0到2之间

void com.meicam.sdk.NvsVideoClip.setExtraVideoRotation ( int  rotation)
inline

设置视频额外旋转角度

参数
rotation视频额外旋转角度。请参见视频额外旋转角度
参见
getExtraVideoRotation
void com.meicam.sdk.NvsVideoClip.setImageMaskROI ( RectF  maskROI)
inline

设置图片片段掩模ROI

具体情况请参见图片片段ROI专题

参数
maskROI图片片段掩模ROI
自从
2.2.3
参见
getStartROI
void com.meicam.sdk.NvsVideoClip.setImageMotionAnimationEnabled ( boolean  enabled)
inline

设置是否支持图片动画

参数
enabled是否支持图片动画。值为true支持图片动画,false则不支持
自从
1.1.0
参见
getImageMotionAnimationEnabled
void com.meicam.sdk.NvsVideoClip.setImageMotionMode ( int  mode)
inline

设置图片运作模式

参数
mode图片片段运作模式。请参见片段运作模式
自从
1.1.0
参见
getImageMotionMode
void com.meicam.sdk.NvsVideoClip.setImageMotionROI ( RectF  startROI,
RectF  endROI 
)
inline

设置图片片段动态移动ROI

具体情况请参见图片片段ROI专题

参数
startROI图片片段起始ROI
endROI图片片段终止ROI
自从
1.1.0
参见
getStartROI
getEndROI
void com.meicam.sdk.NvsVideoClip.setPanAndScan ( float  pan,
float  scan 
)
inline

设置摇摄和扫描

摇摄和扫描功能是用来适配图像在显示窗口上的位置与大小的。具体请参见摇摄与扫描(Pan and Scan)专题。

参数
pan摇摄
scan扫描
参见
getPanAndScan
void com.meicam.sdk.NvsVideoClip.setPlayInReverse ( boolean  playInReverse)
inline

设置片段是否倒放

注意:使用片段倒放请确保当前视频文件为全I帧视频,否则倒放播放效率极低完全无法忍受!可以利用美摄SDK录制标志 STREAMING_ENGINE_RECORDING_FLAG_VIDEO_INTRA_FRAME_ONLY来产生出全I帧视频文件。如果从别的地方 导入的文件无法保证为全I帧视频又想用倒放功能则可以使用美摄的转码SDK直接将原始视频转码为一个倒放的文件再使用。

参数
playInReverse片段是否倒放
自从
1.5.0
参见
getPlayInReverse
void com.meicam.sdk.NvsVideoClip.setSoftWareDecoding ( boolean  softwareUsed)
inline

设置视频是否使用软件解码

参数
softwareUsed是否使用软件解码器解码
参见
isSoftWareDeocedUsed
void com.meicam.sdk.NvsVideoClip.setSourceBackgroundMode ( int  mode)
inline

设置背景模式

参数
mode背景模式
参见
getSourceBackgroundMode

类成员变量说明

final int com.meicam.sdk.NvsVideoClip.ClIP_BACKGROUNDMODE_BLUR = 1
static

模糊

自从
1.4.0
final int com.meicam.sdk.NvsVideoClip.ClIP_BACKGROUNDMODE_COLOR_SOLID = 0
static

纯色

自从
1.4.0
final int com.meicam.sdk.NvsVideoClip.ClIP_EXTRAVIDEOROTATION_0 = 0
static

0度

自从
1.10.0
final int com.meicam.sdk.NvsVideoClip.ClIP_EXTRAVIDEOROTATION_180 = 2
static

180度

自从
1.10.0
final int com.meicam.sdk.NvsVideoClip.ClIP_EXTRAVIDEOROTATION_270 = 3
static

270度

自从
1.10.0
final int com.meicam.sdk.NvsVideoClip.ClIP_EXTRAVIDEOROTATION_90 = 1
static

90度

自从
1.10.0
final int com.meicam.sdk.NvsVideoClip.CLIP_MOTIONMODE_LETTERBOX_ZOOMIN = 0
static

放大

自从
1.1.0
final int com.meicam.sdk.NvsVideoClip.ClIP_MOTIONMODE_LETTERBOX_ZOOMOUT = 1
static

缩小

自从
1.1.0
final int com.meicam.sdk.NvsVideoClip.ClIP_WRAPMODE_REPEAT = 2
static

循环

自从
2.2.3
final int com.meicam.sdk.NvsVideoClip.ClIP_WRAPMODE_REPEAT_FIRSTFRAME = 1
static

末帧

自从
2.2.3
final int com.meicam.sdk.NvsVideoClip.CLIP_WRAPMODE_REPEAT_LASTFRAME = 0
static

首帧

自从
2.2.3
final int com.meicam.sdk.NvsVideoClip.IMAGE_CLIP_MOTIONMMODE_ROI = 2
static

图片片段ROI(Region Of Interesting)

自从
1.1.0
final int com.meicam.sdk.NvsVideoClip.ROLE_IN_THEME_GENERAL = 0
static

通用

final int com.meicam.sdk.NvsVideoClip.ROLE_IN_THEME_TITLE = 1
static

片头

final int com.meicam.sdk.NvsVideoClip.ROLE_IN_THEME_TRAILER = 2
static

片尾

final int com.meicam.sdk.NvsVideoClip.VIDEO_CLIP_TYPE_AV = 0
static

音视频类型

final int com.meicam.sdk.NvsVideoClip.VIDEO_CLIP_TYPE_IMAGE = 1
static

图片类型


该类的文档由以下文件生成: