音频轨道，音频片段的集合更多...

类 com.meicam.sdk.NvsAudioTrack 继承关系图:

Public 成员函数
NvsAudioClip	appendClip (String filePath)
	在轨道尾部追加片段更多...

NvsAudioClip	appendClip (String filePath, long trimIn, long trimOut)
	在轨道尾部追加片段更多...

NvsAudioClip	insertClip (String filePath, int clipIndex)
	在轨道上指定片段索引处插入片段更多...

NvsAudioClip	insertClip (String filePath, long trimIn, long trimOut, int clipIndex)
	在轨道上指定片段索引处插入片段更多...

NvsAudioClip	addClip (String filePath, long inPoint)
	添加音频片段更多...

NvsAudioClip	addClip (String filePath, long inPoint, long trimIn, long trimOut)
	添加音频片段更多...

NvsAudioClip	appendTimelineClip (NvsTimeline timeline)
	在音频轨道尾部追加时间线片段更多...

NvsAudioClip	appendTimelineClip (NvsTimeline timeline, long trimIn, long trimOut)
	在音频轨道尾部追加时间线片段更多...

NvsAudioClip	insertTimelineClip (NvsTimeline timeline, int clipIndex)
	在音频轨道上指定片段索引处插入时间线片段更多...

NvsAudioClip	insertTimelineClip (NvsTimeline timeline, long trimIn, long trimOut, int clipIndex)
	在音频轨道上指定片段索引处插入时间线片段更多...

NvsAudioClip	addTimelineClip (NvsTimeline timeline, long inPoint)
	添加时间线片段更多...

NvsAudioClip	addTimelineClip (NvsTimeline timeline, long inPoint, long trimIn, long trimOut)
	添加时间线片段更多...

NvsAudioClip	getClipByIndex (int clipIndex)
	通过索引获取片段更多...

NvsAudioClip	getClipByTimelinePosition (long timelinePos)
	通过时间获取片段更多...

NvsAudioTransition	setBuiltinTransition (int srcClipIndex, String transitionName)
	设置内嵌式转场更多...

NvsAudioTransition	getTransitionWithSourceClipIndex (int srcClipIndex)
	通过源片段索引获取音频转场更多...

Public 成员函数继承自 com.meicam.sdk.NvsTrack
int	getType ()
	获取轨道类型更多...

int	getIndex ()
	获取轨道索引更多...

long	getDuration ()
	获取轨道长度更多...

int	getClipCount ()
	获取轨道上的片段数量更多...

long	changeInPoint (int clipIndex, long newInPoint)
	修改片段时间线上的入点.如果clip没有此函数授权返回当前的inpoint,newInpoint如果小于前一个clip的outpoint，直接返回前一个clip的outpoint，如果当前clip是第0个clip，则newInPoint最小为0。此函数内部会根据newinpoint计算出一个新的trimIn,并修改clip的trimIn，如果新的trimIn小于0时会返回trimIn为0时对应的Inpoint值，如果newinpoint大于trimOut则返回trimOut-1对应的inPoint值更多...

long	changeOutPoint (int clipIndex, long newOutPoint)
	修改片段时间线上的出点,如果clip没有此函数授权返回当前的outpoint,如果newOutpoint小于clip的outPoint则newOutPoint不会小于inpoint+1，如果clip后面还有nextclip，则newOutPoint不会大于nextClip的inpoint，当前clip如果是最后一个clip最终outpoint的就是timeline的duration，如果newOutPoint大于clip的outpoint则视频末尾会静帧。此函数内部会根据newOutpoint计算出一个新的trimOut，如果clip的inpoint不等于下一个clip的outpoint会移除中间的转场. 更多...

boolean	splitClip (int clipIndex, long splitPoint)
	分割指定的片段更多...

boolean	removeClip (int clipIndex, boolean keepSpace)
	移除指定的片段，主题的片头片尾是不允许移除的更多...

boolean	removeRange (long startTimelinePos, long endTimelinePos, boolean keepSpace)
	移除指定的区间内的所有片段，如果片段只有部分与该区间重合则调整其时间线入点或者出点,如果片段只有部分与该区间重合则调整其时间线入点或者出点，如果片段包含主题片头片尾部分，会移除失败,startTimelinePos < 0 或者 endTimelinePos <= startTimelinePos 也会移除失败. 更多...

boolean	moveClip (int clipIndex, int destClipIndex)
	移动指定的片段，交换输入的两个位置，会影响时间线上片段的排布。主题的片头片尾不能移动，clipIndex和destClipIndex不能于等于clipcount 更多...

boolean	moveClip (int clipIndex, long targetTimelinePos, boolean isInsertTarget, boolean keepSpace)
	移动指定的片段到输入的位置,clipIndex大于等于clipcount会移除失败，targetTimelinePos等于0时，会被移动到0的位置，主题的片头片尾不能被移动。更多...

boolean	removeAllClips ()
	移除所有片段更多...

void	setVolumeGain (float leftVolumeGain, float rightVolumeGain)
	设置音量，最终的音量值是track音量乘以clip音量更多...

NvsVolume	getVolumeGain ()
	获取音量，最终的音量值是track音量乘以clip音量更多...

Public 成员函数继承自 com.meicam.sdk.NvsObject
void	setAttachment (String key, Object value)
	为NvsObject对象添加附加的数据，用来标识NvsObject的对象或者其他用途更多...

void	setTemplateAttachment (String key, String value)
	为NvsObject对象添加模板资源的附加数据，用来标识NvsObject的模板数据更多...

Object	getAttachment (String key)
	获取NvsObject的附件更多...

String	getTemplateAttachment (String key)
	获取NvsObject的模板资源附件更多...

额外继承的成员函数
静态 Public 属性继承自 com.meicam.sdk.NvsTrack
static final int	TRACK_TYPE_VIDEO = 0
	视频轨道更多...

static final int	TRACK_TYPE_AUDIO = 1
	音频轨道更多...

静态 Public 属性继承自 com.meicam.sdk.NvsObject
static final String	TEMPLATE_KEY_REPLACE_ID = "MSTemplate-ReplaceId"

static final String	TEMPLATE_KEY_FOOTAGE_CAN_REPLACE = "MSTemplate-FootageCanReplace"

static final String	TEMPLATE_KEY_FOOTAGE_ID = "MSTemplate-FootageId"

static final String	TEMPLATE_KEY_FOOTAGE_NAME = "MSTemplate-FootageName"

static final String	TEMPLATE_KEY_FOOTAGE_M3U8_NAME = "MSTemplate-FootageM3U8Name"

static final String	TEMPLATE_KEY_FOOTAGE_TAGS = "MSTemplate-FootageTags"

static final String	TEMPLATE_KEY_FOOTAGE_TYPE = "MSTemplate-FootageType"

static final String	TEMPLATE_KEY_FOOTAGE_NEED_REVERSE = "MSTemplate-FootageNeedReverse"

static final String	TEMPLATE_KEY_CLIP_RAW_WIDTH = "MSTemplate-ClipRawWidth"

static final String	TEMPLATE_KEY_CLIP_RAW_HEIGHT = "MSTemplate-ClipRawHeight"

static final String	TEMPLATE_KEY_VOLUME_TYPE = "MSTemplate-VolumeType"

static final String	TEMPLATE_KEY_FX_GROUP = "MSTemplate-FxGroup"

static final String	TEMPLATE_KEY_BEST_SEEK_TIME = "MSTemplate-BestSeekTime"

static final String	TEMPLATE_KEY_MASK_TYPE = "MSTemplate-MaskType"

static final String	TEMPLATE_VALUE_MASK_TYPE_LINE = "MSTemplate-MaskType-Line"

static final String	TEMPLATE_VALUE_MASK_TYPE_MIRROR = "MSTemplate-MaskType-Mirror"

static final String	TEMPLATE_VALUE_MASK_TYPE_CIRCLE = "MSTemplate-MaskType-Circle"

static final String	TEMPLATE_VALUE_MASK_TYPE_RECT = "MSTemplate-MaskType-Rect"

static final String	TEMPLATE_VALUE_MASK_TYPE_HEART = "MSTemplate-MaskType-Heart"

static final String	TEMPLATE_VALUE_MASK_TYPE_STAR = "MSTemplate-MaskType-Star"

static final String	TEMPLATE_KEY_TRANS_TYPE_CUT = "MSTemplate-TransType-Cut"

static final String	TEMPLATE_KEY_CURVE_SPEED_TYPE = "MSTemplate-CurveSpeedType"

static final String	TEMPLATE_VALUE_CURVE_SPEED_TYPE_CUSTOM = "MSTemplate-CurveSpeedType-Custom"

static final String	TEMPLATE_VALUE_CURVE_SPEED_TYPE_MONTAGE = "MSTemplate-CurveSpeedType-Montage"

static final String	TEMPLATE_VALUE_CURVE_SPEED_TYPE_HERO = "MSTemplate-CurveSpeedType-Hero"

static final String	TEMPLATE_VALUE_CURVE_SPEED_TYPE_BULLET = "MSTemplate-CurveSpeedType-bullet"

static final String	TEMPLATE_VALUE_CURVE_SPEED_TYPE_PLUS = "MSTemplate-CurveSpeedType-Plus"

static final String	TEMPLATE_VALUE_CURVE_SPEED_TYPE_IN = "MSTemplate-CurveSpeedType-In"

static final String	TEMPLATE_VALUE_CURVE_SPEED_TYPE_OUT = "MSTemplate-CurveSpeedType-Out"

Protected 成员函数继承自 com.meicam.sdk.NvsObject
void	setInternalObject (long internalObject)

long	getInternalObject ()

Protected 属性继承自 com.meicam.sdk.NvsObject
long	m_internalObject = 0

详细描述

音频轨道，音频片段的集合

音频轨道是容纳音频片段的实体。每条音频轨道可以添加或者移除多个音频片段。一个音频片段播放到另一个音频片段时，需要进行音频转场设置，以便过渡衔接。

注：对于音频轨道的一系列接口及所其属参数含义,请参照视频轨道NvsVideoTrack的对应接口来对照理解。

警告: NvsAudioTrack类中，所有public API都在UI线程使用！！！

成员函数说明

◆ addClip() [1/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.addClip	(	String	filePath,
		long	inPoint
	)

inline

添加音频片段

参数

filePath	音频片段路径。对于片段路径方式，请参见NvsVideoTrack的接口addClip()的参数filePath。
inPoint	要插入的音频片段在时间线上的入点（单位微秒）

返回: 返回添加的音频片段对象

警告: inPoint范围: [0 , timeline.getDuration()); 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: appendClip; insertClip

◆ addClip() [2/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.addClip	(	String	filePath,
		long	inPoint,
		long	trimIn,
		long	trimOut
	)

inline

添加音频片段

参数

filePath	音频片段路径。对于片段路径方式，请参见NvsVideoTrack的接口addClip()的参数filePath。
inPoint	要插入的音频片段在时间线上的入点（单位微秒）
trimIn	音频片段的裁剪入点（单位微秒）
trimOut	音频片段的裁剪出点（单位微秒）

返回: 返回添加的音频片段对象

警告: 参数需要满足（0 <= trimIn < trimOut），如果trimOut大于素材本身长度，后面会以最后一帧播放。; 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: appendClip; insertClip

◆ addTimelineClip() [1/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.addTimelineClip	(	NvsTimeline	timeline,
		long	inPoint
	)

inline

添加时间线片段

参数

timeline	待添加的时间线
inPoint	要添加的音频片段在时间线上的入点（单位微秒）

返回: 返回添加的音频片段对象

警告: inPoint范围: 0 , 父时间线长度); 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: appendTimelineClip; insertTimelineClip

自从: 2.24.0

◆ addTimelineClip() [2/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.addTimelineClip	(	NvsTimeline	timeline,
		long	inPoint,
		long	trimIn,
		long	trimOut
	)

inline

添加时间线片段

参数

timeline	待添加的时间线
inPoint	要插入的音频片段在时间线上的入点（单位微秒）
trimIn	音频片段的裁剪入点（单位微秒）
trimOut	音频片段的裁剪出点（单位微秒）

返回: 返回添加的音频片段对象

警告: 参数需要满足（0 <= trimIn < trimOut），如果trimOut大于待添加时间线长度，后面会以最后一帧播放。; 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: appendTimelineClip; insertTimelineClip

◆ appendClip() [1/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.appendClip ( String filePath )

inline

在轨道尾部追加片段

参数

filePath 片段路径。对于片段路径方式，请参见NvsVideoTrack的接口addClip()的参数filePath。

返回: 返回追加的音频片段对象

警告: 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: insertClip; getClipByIndex

◆ appendClip() [2/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.appendClip	(	String	filePath,
		long	trimIn,
		long	trimOut
	)

inline

在轨道尾部追加片段

参数

filePath	片段路径。对于片段路径方式，请参见NvsVideoTrack的接口addClip()的参数filePath。
trimIn	片段的裁剪入点（单位微秒）
trimOut	片段的裁剪出点（单位微秒）

返回: 返回追加的音频片段对象

警告: 参数需要满足（0 <= trimIn < trimOut），如果trimOut大于素材本身长度，后面会以最后一帧播放。; 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: insertClip; getClipByIndex

◆ appendTimelineClip() [1/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.appendTimelineClip ( NvsTimeline timeline )

inline

在音频轨道尾部追加时间线片段

参数

timeline 待添加的时间线

返回: 返回追加的音频片段对象

警告: 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: insertTimelineClip; getClipByIndex

自从: 2.24.0

◆ appendTimelineClip() [2/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.appendTimelineClip	(	NvsTimeline	timeline,
		long	trimIn,
		long	trimOut
	)

inline

在音频轨道尾部追加时间线片段

参数

timeline	待添加的时间线
trimIn	片段的裁剪入点（单位微秒）
trimOut	片段的裁剪出点（单位微秒）

返回: 返回追加的音频片段对象

警告: 参数需要满足（0 <= trimIn < trimOut），如果trimOut大于待追加加时间线长度，后面会以最后一帧播放。; 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: insertClip; getClipByIndex

自从: 2.24.0

◆ getClipByIndex()

NvsAudioClip com.meicam.sdk.NvsAudioTrack.getClipByIndex ( int clipIndex )

inline

通过索引获取片段

参数

clipIndex 片段索引

返回: 返回获取的音频片段对象

警告: clipIndex范围（0 <= clipIndex < getClipCount()），若超出会返回NULL

参见: getClipByTimelinePosition; appendClip; insertClip

◆ getClipByTimelinePosition()

NvsAudioClip com.meicam.sdk.NvsAudioTrack.getClipByTimelinePosition ( long timelinePos )

inline

通过时间获取片段

参数

timelinePos 时间线上的位置（单位微秒）

返回: 返回获取的音频片段对象

警告: timelinePos范围（0 <= timelinePos < timeline.getDuration()），若超出会返回NULL

参见: getClipByIndex

◆ getTransitionWithSourceClipIndex()

NvsAudioTransition com.meicam.sdk.NvsAudioTrack.getTransitionWithSourceClipIndex ( int srcClipIndex )

inline

通过源片段索引获取音频转场

参数

srcClipIndex 源片段索引,范围[0 , getClipCount())

返回: 返回获取的音频转场对象

参见: setBuiltinTransition

◆ insertClip() [1/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.insertClip	(	String	filePath,
		int	clipIndex
	)

inline

在轨道上指定片段索引处插入片段

参数

filePath	片段路径。对于片段路径方式，请参见NvsVideoTrack的接口addClip()的参数filePath。
clipIndex	插入片段索引

返回: 返回插入的音频片段对象

警告: 如果index大于已有片段数量，则会在最后添加。如果clipIndex 等于0，当存在主题片头的时候，返回对象为空。如果clipIndex>=getClipCount(),此时如果存在主题片尾的话，返回对象为空。; 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: appendClip; getClipByIndex

◆ insertClip() [2/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.insertClip	(	String	filePath,
		long	trimIn,
		long	trimOut,
		int	clipIndex
	)

inline

在轨道上指定片段索引处插入片段

参数

filePath	片段路径。对于片段路径方式，请参见NvsVideoTrack的接口addClip()的参数filePath。
trimIn	片段的裁剪入点（单位微秒）
trimOut	片段的裁剪出点（单位微秒）
clipIndex	插入片段索引

返回: 返回插入的音频片段对象

警告: 参数需要满足（0 <= trimIn < trimOut），如果trimOut大于素材本身长度，后面会以最后一帧播放。; 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: appendClip; getClipByIndex

◆ insertTimelineClip() [1/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.insertTimelineClip	(	NvsTimeline	timeline,
		int	clipIndex
	)

inline

在音频轨道上指定片段索引处插入时间线片段

参数

timeline	待插入的时间线
clipIndex	插入片段索引

返回: 返回插入的音频片段对象

警告: 如果index大于已有片段数量，则会在最后添加。如果clipIndex 等于0，当存在主题片头的时候，返回对象为空。如果clipIndex>=getClipCount(),此时如果存在主题片尾的话，返回对象为空。; 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: appendTimelineClip; getClipByIndex

自从: 2.24.0

◆ insertTimelineClip() [2/2]

NvsAudioClip com.meicam.sdk.NvsAudioTrack.insertTimelineClip	(	NvsTimeline	timeline,
		long	trimIn,
		long	trimOut,
		int	clipIndex
	)

inline

在音频轨道上指定片段索引处插入时间线片段

参数

timeline	待插入的时间线
trimIn	片段的裁剪入点（单位微秒）
trimOut	片段的裁剪出点（单位微秒）
clipIndex	插入片段索引

返回: 返回插入的音频片段对象

警告: 参数需要满足（0 <= trimIn < trimOut），如果trimOut大于待插入时间线长度，后面会以最后一帧播放。; 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: appendTimelineClip; getClipByIndex

自从: 2.24.0

◆ setBuiltinTransition()

NvsAudioTransition com.meicam.sdk.NvsAudioTrack.setBuiltinTransition	(	int	srcClipIndex,
		String	transitionName
	)

inline

设置内嵌式转场

参数

srcClipIndex	转场的源片段索引，范围[0 , getClipCount())
transitionName	音频转场名称。注意：目前音频转场只支持淡入淡出(Fade)模式；如果设为空字符串，则删除原有转场

返回: 返回音频转场对象

警告: 此接口会引发流媒体引擎状态跳转到引擎停止状态，具体情况请参见引擎变化专题。

参见: getTransitionWithSourceClipIndex

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

src/android/jar/com/meicam/sdk/NvsAudioTrack.java

Public 成员函数

额外继承的成员函数

详细描述

成员函数说明

◆ addClip() [1/2]

◆ addClip() [2/2]

◆ addTimelineClip() [1/2]

◆ addTimelineClip() [2/2]

◆ appendClip() [1/2]

◆ appendClip() [2/2]

◆ appendTimelineClip() [1/2]

◆ appendTimelineClip() [2/2]

◆ getClipByIndex()

◆ getClipByTimelinePosition()

◆ getTransitionWithSourceClipIndex()

◆ insertClip() [1/2]

◆ insertClip() [2/2]

◆ insertTimelineClip() [1/2]

◆ insertTimelineClip() [2/2]

◆ setBuiltinTransition()