详细描述

短视频录制接口类

结构体说明

◆ com::tencent::ugc::TXUGCPartsManager::IPartsManagerListener

interface com::tencent::ugc::TXUGCPartsManager::IPartsManagerListener

Public 成员函数
void	onDeleteLastPart ()

void	onDeleteAllParts ()

成员函数说明

◆ onDeleteAllParts()

void onDeleteAllParts ( )

在 TXUGCRecord 内被实现.

◆ onDeleteLastPart()

void onDeleteLastPart ( )

在 TXUGCRecord 内被实现.

◆ com::tencent::ugc::TXUGCPartsManager

class com::tencent::ugc::TXUGCPartsManager

Public 成员函数
	TXUGCPartsManager (Context context)

synchronized void	setPartsManagerObserver (IPartsManagerListener iPartsManagerListener)

synchronized void	removePartsManagerObserver (IPartsManagerListener iPartsManagerListener)

void	addClipInfo (PartInfo partInfo)

void	insertPart (String videoPath, int index)

int	getDuration ()

List< String >	getPartsPathList ()

void	deleteLastPart ()

void	deletePart (int index)

void	deleteAllParts ()

构造及析构函数说明

◆ TXUGCPartsManager()

TXUGCPartsManager ( Context context )

inline

成员函数说明

◆ addClipInfo()

void addClipInfo ( PartInfo partInfo )

inline

添加视频片段到队列尾部注意：添加的视频片段必须要跟录制的参数一致，否则会合成失败

参数

partInfo

◆ deleteAllParts()

void deleteAllParts ( )

inline

删除所有分段

◆ deleteLastPart()

void deleteLastPart ( )

inline

删除最后一段分段

◆ deletePart()

void deletePart ( int index )

inline

删除指定分段

参数

index 分段序号，从1开始

◆ getDuration()

int getDuration ( )

inline

获取所有分段的总时长

返回: 所有分段的总时长，单位毫秒

◆ getPartsPathList()

List<String> getPartsPathList ( )

inline

获取本次录制所有片段的路径

返回

◆ insertPart()

void insertPart	(	String	videoPath,
		int	index
	)

inline

插入视频片段您可以添加当前录制视频之外的视频，调用stopRecord()的时候，SDK会把所有的视频合成（这里添加的视频需要和录制视频的参数保持一致，否则会合成失败）

参数

videoPath	添加视频的文件路径
index	添加视频的所在整个视频list的位置

◆ removePartsManagerObserver()

synchronized void removePartsManagerObserver ( IPartsManagerListener iPartsManagerListener )

inline

◆ setPartsManagerObserver()

synchronized void setPartsManagerObserver ( IPartsManagerListener iPartsManagerListener )

inline

◆ com::tencent::ugc::TXUGCRecord::VideoCustomProcessListener

interface com::tencent::ugc::TXUGCRecord::VideoCustomProcessListener

Public 成员函数
int	onTextureCustomProcess (int textureId, int width, int height)

void	onDetectFacePoints (float[] points)

void	onTextureDestroyed ()

成员函数说明

◆ onDetectFacePoints()

void onDetectFacePoints ( float[] points )

增值版回调人脸坐标

参数

points 归一化人脸坐标，每两个值表示某点P的X,Y值。值域[0.f,1.f]

◆ onTextureCustomProcess()

int onTextureCustomProcess	(	int	textureId,
		int	width,
		int	height
	)

在OpenGL线程中回调，在这里可以进行采集图像的二次处理

参数

textureId	纹理ID
width	纹理的宽度
height	纹理的高度

返回: 返回给SDK的纹理ID，如果不做任何处理，返回传入的纹理ID即可

说明：SDK回调出来的纹理类型是GLES20.GL_TEXTURE_2D，接口返回给SDK的纹理类型也必须是GLES20.GL_TEXTURE_2D

◆ onTextureDestroyed()

void onTextureDestroyed ( )

在OpenGL线程中回调，可以在这里释放创建的OpenGL资源

◆ com::tencent::ugc::TXUGCRecord

class com::tencent::ugc::TXUGCRecord

Public 成员函数
void	setVideoRecordListener (TXRecordCommon.ITXVideoRecordListener listener)

void	onDeleteLastPart ()

void	onDeleteAllParts ()

int	startCameraSimplePreview (TXRecordCommon.TXUGCSimpleConfig config, TXCloudVideoView previewView)

int	startCameraCustomPreview (TXRecordCommon.TXUGCCustomConfig config, TXCloudVideoView previewView)

void	setVideoResolution (int resolution)

void	setVideoBitrate (int bitrate)

void	stopCameraPreview ()

TXUGCPartsManager	getPartsManager ()

void	setMute (boolean isMute)

int	startRecord ()

int	startRecord (final String videoFilePath, final String coverPath)

int	startRecord (final String videoFilePath, final String videoPartFolder, final String coverPath)

int	stopRecord ()

void	release ()

int	pauseRecord ()

int	resumeRecord ()

boolean	setMicVolume (float x)

boolean	switchCamera (final boolean isFront)

void	setAspectRatio (int displayType)

void	snapshot (final TXRecordCommon.ITXSnapshotListener listener)

void	setRecordSpeed (int recordSpeed)

void	setVideoProcessListener (VideoCustomProcessListener listener)

void	setReverb (int reverbType)

void	setVoiceChangerType (int voiceChangerType)

int	setBGM (String path)

void	setBGMNofify (TXRecordCommon.ITXBGMNotify notify)

boolean	playBGMFromTime (int startTime, int endTime)

boolean	stopBGM ()

boolean	pauseBGM ()

boolean	resumeBGM ()

boolean	seekBGM (int startTime, int endTime)

boolean	setBGMVolume (float x)

int	getMusicDuration (String path)

void	setWatermark (Bitmap watermarkBitmap, TXVideoEditConstants.TXRect txRect)

void	setMotionTmpl (final String tmplPath)

void	setMotionMute (boolean motionMute)

void	setGreenScreenFile (String path, boolean isLoop)

void	setFaceVLevel (int level)

void	setFaceShortLevel (int level)

void	setChinLevel (int level)

void	setNoseSlimLevel (int level)

void	setEyeScaleLevel (float level)

void	setFaceScaleLevel (float level)

void	setBeautyStyle (int style)

void	setBeautyDepth (int style, int beautyDepth, int whiteningDepth, int ruddyDepth)

void	setFilter (Bitmap filterImage)

void	setFilter (Bitmap leftBitmap, float leftIntensity, Bitmap rightBitmap, float rightIntensity, float leftRadio)

void	setSpecialRatio (float specialRatio)

boolean	toggleTorch (boolean enable)

int	getMaxZoom ()

boolean	setZoom (int value)

void	setFocusPosition (float eventX, float eventY)

void	setVideoRenderMode (int renderMode)

void	setHomeOrientation (int homeOrientation)

void	setRenderRotation (int renderRotation)

void	onRecordRawPcmData (byte[] data, long timestamp, int sampleRate, int channels, int bits, boolean withBgm)

void	onRecordPcmData (byte[] data, long timestamp, int sampleRate, int channels, int bits)

void	onRecordEncData (byte[] data, long timestamp, int sampleRate, int channels, int bits)

void	onRecordError (int errNo, String errInfo)

void	onSurfaceTextureAvailable (SurfaceTexture surfaceTexture)

void	onSurfaceTextureDestroy (SurfaceTexture surfaceTexture)

void	onNotifyEvent (int event, Bundle param)

int	willAddWatermark (int texture, int width, int height)

void	didProcessFrame (int texture, int width, int height, long timestamp)

void	didProcessFrame (byte[] data, int width, int height, int format, long timestamp)

void	didDetectFacePoints (float[] points)

void	onEncodeNAL (TXSNALPacket nal, int errCode)

void	onEncodeFormat (MediaFormat format)

void	onEncodeFinished (int streamType, long gopIndex, long rpsFrameIndex)

void	onRestartEncoder (int streamType)

void	onEncodeDataIn (int streamType)

int	onTextureProcess (int textureId, float[] matrix)

void	onBufferProcess (byte[] nv21, float[] matrix)

TXBeautyManager	getBeautyManager ()

静态 Public 成员函数
static synchronized TXUGCRecord	getInstance (Context context)

静态 Public 属性
static float	PLAY_SPEED_FASTEST = 0.5f

static float	PLAY_SPEED_FAST = 0.8f

static float	PLAY_SPEED_SLOW = 1.25f

static float	PLAY_SPEED_SLOWEST = 2f

static float	ENCODE_SPEED_FASTEST = 2f

static float	ENCODE_SPEED_FAST = 1.25f

static float	ENCODE_SPEED_SLOW = 0.8f

static float	ENCODE_SPEED_SLOWEST = 0.5f

构造及析构函数说明

◆ TXUGCRecord()

TXUGCRecord ( Context context )

inlineprotected

成员函数说明

◆ didDetectFacePoints()

void didDetectFacePoints ( float[] points )

inline

◆ didProcessFrame() [1/2]

void didProcessFrame	(	byte[]	data,
		int	width,
		int	height,
		int	format,
		long	timestamp
	)

inline

◆ didProcessFrame() [2/2]

void didProcessFrame	(	int	texture,
		int	width,
		int	height,
		long	timestamp
	)

inline

◆ getBeautyManager()

TXBeautyManager getBeautyManager ( )

inline

获取美颜管理对象

通过美颜管理，您可以使用以下功能：

设置”美颜风格”、”美白”、“红润”、“大眼”、“瘦脸”、“V脸”、“下巴”、“短脸”、“瘦鼻”、“亮眼”、“白牙”、“祛眼袋”、“祛皱纹”、“祛法令纹”等美容效果。
调整“发际线”、“眼间距”、“眼角”、“嘴形”、“鼻翼”、“鼻子位置”、“嘴唇厚度”、“脸型”
设置人脸挂件（素材）等动态效果
添加美妆
进行手势识别

◆ getInstance()

static synchronized TXUGCRecord getInstance ( Context context )

inlinestatic

获取录制实例

参数

context 用于系统api调用，内部会转成applicationContext，不会导致context泄露

◆ getMaxZoom()

int getMaxZoom ( )

inline

获取摄像头支持的最大焦距，此方法同时可以检查是否支持变焦

返回: 0 : 不支持变焦大于0 : 最大焦距

◆ getMusicDuration()

int getMusicDuration ( String path )

inline

获取音乐文件时长. [精简版不支持]

参数

path	音乐文件路径 path == null 获取当前播放歌曲时长 path != null 获取path路径歌曲时长

返回: 音乐文件时长, 单位ms.

◆ getPartsManager()

TXUGCPartsManager getPartsManager ( )

inline

◆ onBufferProcess()

void onBufferProcess	(	byte[]	nv21,
		float[]	matrix
	)

inline

◆ onDeleteAllParts()

void onDeleteAllParts ( )

inline

实现了 TXUGCPartsManager.IPartsManagerListener.

◆ onDeleteLastPart()

void onDeleteLastPart ( )

inline

实现了 TXUGCPartsManager.IPartsManagerListener.

◆ onEncodeDataIn()

void onEncodeDataIn ( int streamType )

inline

◆ onEncodeFinished()

void onEncodeFinished	(	int	streamType,
		long	gopIndex,
		long	rpsFrameIndex
	)

inline

◆ onEncodeFormat()

void onEncodeFormat ( MediaFormat format )

inline

◆ onEncodeNAL()

void onEncodeNAL	(	TXSNALPacket	nal,
		int	errCode
	)

inline

◆ onNotifyEvent()

void onNotifyEvent	(	int	event,
		Bundle	param
	)

inline

◆ onRecordEncData()

void onRecordEncData	(	byte[]	data,
		long	timestamp,
		int	sampleRate,
		int	channels,
		int	bits
	)

inline

◆ onRecordError()

void onRecordError	(	int	errNo,
		String	errInfo
	)

inline

◆ onRecordPcmData()

void onRecordPcmData	(	byte[]	data,
		long	timestamp,
		int	sampleRate,
		int	channels,
		int	bits
	)

inline

◆ onRecordRawPcmData()

void onRecordRawPcmData	(	byte[]	data,
		long	timestamp,
		int	sampleRate,
		int	channels,
		int	bits,
		boolean	withBgm
	)

inline

◆ onRestartEncoder()

void onRestartEncoder ( int streamType )

inline

◆ onSurfaceTextureAvailable()

void onSurfaceTextureAvailable ( SurfaceTexture surfaceTexture )

inline

◆ onSurfaceTextureDestroy()

void onSurfaceTextureDestroy ( SurfaceTexture surfaceTexture )

inline

◆ onTextureProcess()

int onTextureProcess	(	int	textureId,
		float[]	matrix
	)

inline

◆ pauseBGM()

boolean pauseBGM ( )

inline

暂停播放背景音乐 [精简版不支持]

返回

◆ pauseRecord()

int pauseRecord ( )

inline

暂停视频录制

返回

◆ playBGMFromTime()

boolean playBGMFromTime	(	int	startTime,
		int	endTime
	)

inline

播放背景音乐. [精简版不支持]

参数

startTime	音乐播放起始时间 ms
endTime	音乐播放结束时间 ms

返回

◆ release()

void release ( )

inline

释放资源

◆ resumeBGM()

boolean resumeBGM ( )

inline

继续播放背景音乐 [精简版不支持]

返回

◆ resumeRecord()

int resumeRecord ( )

inline

继续视频录制

返回

◆ seekBGM()

boolean seekBGM	(	int	startTime,
		int	endTime
	)

inline

定位BGM开始结束时间 [精简版不支持]

参数

startTime	开始时间，单位ms
endTime	结束时间，单位ms

返回

◆ setAspectRatio()

void setAspectRatio ( int displayType )

inline

设置宽高比

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用

参数

displayType TXRecordCommon.VIDEO_ASPECT_RATIO_9_16，VIDEO_ASPECT_RATIO_3_4，VIDEO_ASPECT_RATIO_1_1

◆ setBeautyDepth()

void setBeautyDepth	(	int	style,
		int	beautyDepth,
		int	whiteningDepth,
		int	ruddyDepth
	)

inline

设置美颜和美白效果级别

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用设置的值会在调用stopCameraPreview() 后失效

弃用:: v6.9 版本弃用，请使用 TXBeautyManager 设置美颜功能

参数

style	美颜风格.三种美颜风格：0 ：光滑 1：自然 2：优图
beautyDepth	: 美颜级别取值范围 0 ~ 9； 0 表示关闭 1 ~ 9值越大效果越明显。
whiteningDepth	: 美白级别取值范围 0 ~ 9； 0 表示关闭 1 ~ 9值越大效果越明显。
ruddyDepth	: 红润级别取值范围 0 ~ 9； 0 表示关闭 1 ~ 9值越大效果越明显。

◆ setBeautyStyle()

void setBeautyStyle ( int style )

inline

设置美颜类型

弃用:: v6.9 版本弃用，请使用 TXBeautyManager 设置美颜功能

参数

style

◆ setBGM()

int setBGM ( String path )

inline

设置背景音乐文件 [精简版不支持]

开始录制（调用startRecord接口）之后不能切换背景音乐，可能会导致异常，如果需要切换音乐，请先停止视频录制（调用stopRecord接口）

参数

path 音乐文件路径

返回: 音乐时长 ms

◆ setBGMNofify()

void setBGMNofify ( TXRecordCommon.ITXBGMNotify notify )

inline

设置背景音乐播放回调接口. [精简版不支持]

该接口用于混音处理,比如将背景音乐与麦克风采集到的声音混合后播放.

参数

notify 回调借口，详细请参看TXRecordCommon.ITXBGMNotify

◆ setBGMVolume()

boolean setBGMVolume ( float x )

inline

设置背景音乐的音量大小. [精简版不支持]

该接口用于混音处理,比如将背景音乐与麦克风采集到的声音混合后播放. 请在 playBGMFromTime(int, int) 后调用

参数

x	音量大小,1为正常音量,建议值为0~2,如果需要调大背景音量可以设置更大的值.

返回: 是否成功设置背景音乐的音量大小. true:设置背景音的音量成功. false:设置背景音的音量失败.

◆ setChinLevel()

void setChinLevel ( int level )

inline

设置下巴长度 [仅支持企业版Pro和企业版Pro EX]

弃用:: v6.9 版本弃用，请使用 TXBeautyManager 设置美颜功能

参数

level 长度级别

◆ setEyeScaleLevel()

void setEyeScaleLevel ( float level )

inline

设置大眼效果 [仅支持企业版Pro和企业版Pro EX]

弃用:: v6.9 版本弃用，请使用 TXBeautyManager 设置美颜功能

参数

level 大眼级别.

◆ setFaceScaleLevel()

void setFaceScaleLevel ( float level )

inline

设置瘦脸效果 [仅支持企业版Pro]

弃用:: v6.9 版本弃用，请使用 TXBeautyManager 设置美颜功能

参数

level 瘦脸级别.

◆ setFaceShortLevel()

void setFaceShortLevel ( int level )

inline

设置短脸 [仅支持企业版Pro和企业版Pro EX]

弃用:: v6.9 版本弃用，请使用 TXBeautyManager 设置美颜功能

参数

level 短脸级别

◆ setFaceVLevel()

void setFaceVLevel ( int level )

inline

设置V脸 [仅支持企业版Pro]

弃用:: v6.9 版本弃用，请使用 TXBeautyManager 设置美颜功能

参数

level V脸级别

◆ setFilter() [1/2]

void setFilter ( Bitmap filterImage )

inline

setFilter 设置指定素材滤镜特效

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用设置的值会在调用stopCameraPreview() 后失效

参数

filterImage : 指定素材，即颜色查找表图片。注意：一定要用png格式！！！ demo用到的滤镜查找表图片位于RTMPAndroidDemo/app/src/main/res/drawable-xxhdpi/目录下。

弃用:: v7.2 版本弃用，请使用 TXBeautyManager 设置滤镜功能

◆ setFilter() [2/2]

void setFilter	(	Bitmap	leftBitmap,
		float	leftIntensity,
		Bitmap	rightBitmap,
		float	rightIntensity,
		float	leftRadio
	)

inline

setFilter 设置组合滤镜特效

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用设置的值会在调用stopCameraPreview() 后失效

参数

leftBitmap	左侧滤镜注意：一定要用png格式！！
leftIntensity	左侧滤镜程度
rightBitmap	右侧滤镜注意：一定要用png格式！！
rightIntensity	右侧滤镜程度
leftRadio	左侧图片占的比例大小

◆ setFocusPosition()

void setFocusPosition	(	float	eventX,
		float	eventY
	)

inline

设置手动聚焦

参数

eventX	聚焦点的位置x值
eventY	聚焦点的位置y值

◆ setGreenScreenFile()

void setGreenScreenFile	(	String	path,
		boolean	isLoop
	)

inline

设置绿幕文件 [仅支持企业版Pro]

目前图片支持jpg/png，视频支持mp4/3gp等Android系统支持的格式 API要求18

参数

path	：绿幕文件位置，支持两种方式： 1.资源文件放在assets目录，path直接取文件名 2.path取文件绝对路径
isLoop	：图片文件忽略，视频文件设置是否循环播放

弃用:: v7.2 版本弃用，请使用 TXBeautyManager 设置绿幕功能

◆ setHomeOrientation()

void setHomeOrientation ( int homeOrientation )

inline

设置home键方向

参数

homeOrientation home方向取常量 TXLiveConstants#VIDEO_ANGLE_HOME_RIGHT(home键在右)
TXLiveConstants#VIDEO_ANGLE_HOME_DOWN(home键在下)
TXLiveConstants#VIDEO_ANGLE_HOME_LEFT(home键在左)
TXLiveConstants#VIDEO_ANGLE_HOME_UP(home键在上)

◆ setMicVolume()

boolean setMicVolume ( float x )

inline

设置麦克风的音量大小.

该接口用于混音处理,比如将背景音乐与麦克风采集到的声音混合后播放. 请在 playBGMFromTime(int, int) 后调用

参数

x	音量大小,1为正常音量,建议值为0~2,如果需要调大音量可以设置更大的值.

返回: 是否成功设置麦克风的音量大小. true:设置麦克风的音量成功. false:设置麦克风的音量失败.

◆ setMotionMute()

void setMotionMute ( boolean motionMute )

inline

设置动效是否静音 [仅支持企业版和企业版Pro]

弃用:: v6.9 版本弃用，请使用 TXBeautyManager 设置美颜功能

参数

motionMute true:静音；false:不静音

◆ setMotionTmpl()

void setMotionTmpl ( final String tmplPath )

inline

setMotionTmpl 设置动效文件 [仅支持企业版和企业版Pro]

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用

弃用:: v6.9 版本弃用，请使用 TXBeautyManager 设置美颜功能

参数

tmplPath 文件路径：空String ""则取消动效

◆ setMute()

void setMute ( boolean isMute )

inline

◆ setNoseSlimLevel()

void setNoseSlimLevel ( int level )

inline

设置瘦鼻效果 [仅支持企业版Pro和企业版Pro EX]

弃用:: v6.9 版本弃用，请使用 TXBeautyManager 设置美颜功能

参数

level 瘦鼻级别

◆ setRecordSpeed()

void setRecordSpeed ( int recordSpeed )

inline

录制速度 [精简版不支持]

参数

recordSpeed TXRecordCommon#RECORD_SPEED_SLOWEST(极慢速)
TXRecordCommon#RECORD_SPEED_SLOW(慢速)
TXRecordCommon#RECORD_SPEED_NORMAL(标准)
TXRecordCommon#RECORD_SPEED_FAST(快速)
TXRecordCommon#RECORD_SPEED_FASTEST(极快速)

◆ setRenderRotation()

void setRenderRotation ( int renderRotation )

inline

设置渲染方向

参数

renderRotation 渲染方向取常量 TXLiveConstants#RENDER_ROTATION_0(常规竖屏)
TXLiveConstants#RENDER_ROTATION_90(左旋90度)
TXLiveConstants#RENDER_ROTATION_180(左旋180度)
TXLiveConstants#RENDER_ROTATION_270(左旋270度)

◆ setReverb()

void setReverb ( int reverbType )

inline

设置混响 [精简版不支持]

参数

reverbType TXRecordCommon#VIDOE_REVERB_TYPE_0(关闭混响)
TXRecordCommon#VIDOE_REVERB_TYPE_1(KTV)
TXRecordCommon#VIDOE_REVERB_TYPE_2(小房间)
TXRecordCommon#VIDOE_REVERB_TYPE_3(大会堂)
TXRecordCommon#VIDOE_REVERB_TYPE_4(低沉)
TXRecordCommon#VIDOE_REVERB_TYPE_5(洪亮)
TXRecordCommon#VIDOE_REVERB_TYPE_6(金属声)
TXRecordCommon#VIDOE_REVERB_TYPE_7(磁性)

◆ setSpecialRatio()

void setSpecialRatio ( float specialRatio )

inline

setSpecialRatio 设置滤镜效果程度

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用设置的值会在调用stopCameraPreview() 后失效

参数

specialRatio : 从0到1，越大滤镜效果越明显，默认取值0.5

弃用:: v7.2 版本弃用，请使用 TXBeautyManager 设置滤镜效果程度

◆ setVideoBitrate()

void setVideoBitrate ( int bitrate )

inline

参数

bitrate

◆ setVideoProcessListener()

void setVideoProcessListener ( VideoCustomProcessListener listener )

inline

设置自定义图像处理回调 [精简版不支持]

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用

参数

listener

◆ setVideoRecordListener()

void setVideoRecordListener ( TXRecordCommon.ITXVideoRecordListener listener )

inline

设置录制回调接口

参数

listener 录制结果回调接口

◆ setVideoRenderMode()

void setVideoRenderMode ( int renderMode )

inline

渲染模式TXRecordCommon:RENDER_MODE_FULL_FILL_SCREEN / RENDER_MODE_ADJUST_RESOLUTION

在视频比例9：16时的渲染模式，RENDER_MODE_FULL_FILL_SCREEN：将图像等比例铺满整个屏幕,多余部分裁剪掉,此模式下画面不留黑边

RENDER_MODE_ADJUST_RESOLUTION：将图像等比例缩放,缩放后的宽和高都不会超过显示区域,居中显示

参数

renderMode

◆ setVideoResolution()

void setVideoResolution ( int resolution )

inline

单独设置分辨率

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用并且开始录制后不要调用，调用后摄像头会重启

参数

resolution TXRecordCommon.VIDEO_RESOLUTION_xxx

◆ setVoiceChangerType()

void setVoiceChangerType ( int voiceChangerType )

inline

设置变声 [精简版不支持]

参数

voiceChangerType TXRecordCommon#VIDOE_VOICECHANGER_TYPE_0(关闭变声)
TXRecordCommon#VIDOE_VOICECHANGER_TYPE_1(熊孩子)
TXRecordCommon#VIDOE_VOICECHANGER_TYPE_2(萝莉)
TXRecordCommon#VIDOE_VOICECHANGER_TYPE_3(大叔)
TXRecordCommon#VIDOE_VOICECHANGER_TYPE_4(重金属)
TXRecordCommon#VIDOE_VOICECHANGER_TYPE_6(外国人)
TXRecordCommon#VIDOE_VOICECHANGER_TYPE_7(困兽)
TXRecordCommon#VIDOE_VOICECHANGER_TYPE_8(死肥仔)
TXRecordCommon#VIDOE_VOICECHANGER_TYPE_9(强电流)
TXRecordCommon#VIDOE_VOICECHANGER_TYPE_10(重机械)
TXRecordCommon#VIDOE_VOICECHANGER_TYPE_11(空灵)

◆ setWatermark()

void setWatermark	(	Bitmap	watermarkBitmap,
		TXVideoEditConstants.TXRect	txRect
	)

inline

设置全局水印 [精简版不支持]

TXRect-水印相对于视频图像的归一化值，sdk内部会根据水印宽高比自动计算height 比如视频图像大小为（540，960） TXRect三个参数设置为0.1，0.1，0.1,水印的实际像素坐标为（540 *，960 * 0.1，540 * 0.1 ，540 * 0.1 * watermarkBitmap.height / watermarkBitmap.width）

参数

watermarkBitmap	全局水印图片
txRect	归一化坐标

◆ setZoom()

boolean setZoom ( int value )

inline

设置焦距

参数

value 焦距，取值 0~getMaxZoom();

返回: true : 成功 false : 失败

◆ snapshot()

void snapshot ( final TXRecordCommon.ITXSnapshotListener listener )

inline

截图

参数

listener void onSnapshot(Bitmap bmp)

◆ startCameraCustomPreview()

int startCameraCustomPreview	(	TXRecordCommon.TXUGCCustomConfig	config,
		TXCloudVideoView	previewView
	)

inline

启动摄像头预览

参数

config	自定义预览参数，详细请参看TXRecordCommon.TXUGCCustomConfig videoBitrate建议值600-12000(SDK上限不再做限制)；videoFps范围15-30；videoGop范围1-10s
previewView	预览视频的渲染view.

◆ startCameraSimplePreview()

int startCameraSimplePreview	(	TXRecordCommon.TXUGCSimpleConfig	config,
		TXCloudVideoView	previewView
	)

inline

启动摄像头预览

参数

config	简化预览参数，详细请参看TXRecordCommon.TXUGCSimpleConfig
previewView	预览视频的渲染view.

◆ startRecord() [1/3]

int startRecord ( )

inline

开始视频录制，SDK内部会自动生成视频路经和视频封面，在TXVideoRecordListener里面返回

注意：这个接口SDK会自动管理生成的视频和封面，在下次调用startRecord的时候，SDK会自动删除上一次生成的视频和封面

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用

◆ startRecord() [2/3]

int startRecord	(	final String	videoFilePath,
		final String	coverPath
	)

inline

开始视频录制

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用

注意：这个接口客户需要自己管理生成的视频和封面，在不需要视频的时候自行删除

参数

videoFilePath	视频文件全路径，调用者保证该路径能正常生成文件
coverPath	视频封面截图，为空表示不需要生成视频封面

◆ startRecord() [3/3]

int startRecord	(	final String	videoFilePath,
		final String	videoPartFolder,
		final String	coverPath
	)

inline

开始视频录制

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用

注意：这个接口客户需要自己管理生成的视频和封面，在不需要视频的时候自行删除

参数

videoFilePath	视频文件全路径，调用者保证该路径能正常生成文件
videoPartFolder	视频分段录制的文件存储目录,如果此参数为null,则使用/sdcard/TXUGC/TXUGCParts这个默认路径
coverPath	视频封面截图，为空表示不需要生成视频封面

◆ stopBGM()

boolean stopBGM ( )

inline

停止播放背景音乐. [精简版不支持]

该接口用于混音处理,比如将背景音乐与麦克风采集到的声音混合后播放.

返回: 是否成功停止播放背景音乐. true:停止播放成功. false:停止播放失败.

◆ stopCameraPreview()

void stopCameraPreview ( )

inline

停止摄像头预览

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用

◆ stopRecord()

int stopRecord ( )

inline

停止视频录制

请在 startRecord() 后调用

◆ switchCamera()

boolean switchCamera ( final boolean isFront )

inline

切换前后摄像头

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用设置的值会在调用stopCameraPreview() 后失效

参数

isFront 是否前置摄像头

返回: true，切换成功。 false，切换失败。

◆ toggleTorch()

boolean toggleTorch ( boolean enable )

inline

toggleTorch, 打开闪关灯

请在 startCameraSimplePreview(TXRecordCommon.TXUGCSimpleConfig, TXCloudVideoView) 或者 startCameraCustomPreview(TXRecordCommon.TXUGCCustomConfig, TXCloudVideoView) 后调用设置的值会在调用stopCameraPreview() 后失效

参数

enable true, 打开，false, 关闭.

返回: true，打开成功。false，打开失败。

◆ willAddWatermark()

int willAddWatermark	(	int	texture,
		int	width,
		int	height
	)

inline

结构体成员变量说明

◆ ENCODE_SPEED_FAST

float ENCODE_SPEED_FAST = 1.25f

static

◆ ENCODE_SPEED_FASTEST

float ENCODE_SPEED_FASTEST = 2f

static

◆ ENCODE_SPEED_SLOW

float ENCODE_SPEED_SLOW = 0.8f

static

◆ ENCODE_SPEED_SLOWEST

float ENCODE_SPEED_SLOWEST = 0.5f

static

◆ PLAY_SPEED_FAST

float PLAY_SPEED_FAST = 0.8f

static

◆ PLAY_SPEED_FASTEST

float PLAY_SPEED_FASTEST = 0.5f

static

◆ PLAY_SPEED_SLOW

float PLAY_SPEED_SLOW = 1.25f

static

◆ PLAY_SPEED_SLOWEST

float PLAY_SPEED_SLOWEST = 2f

static

详细描述

结构体说明

◆ com::tencent::ugc::TXUGCPartsManager::IPartsManagerListener

Public 成员函数

成员函数说明

◆ onDeleteAllParts()

◆ onDeleteLastPart()

◆ com::tencent::ugc::TXUGCPartsManager

Public 成员函数

构造及析构函数说明

◆ TXUGCPartsManager()

成员函数说明

◆ addClipInfo()

◆ deleteAllParts()

◆ deleteLastPart()

◆ deletePart()

◆ getDuration()

◆ getPartsPathList()

◆ insertPart()

◆ removePartsManagerObserver()

◆ setPartsManagerObserver()

◆ com::tencent::ugc::TXUGCRecord::VideoCustomProcessListener

Public 成员函数

成员函数说明

◆ onDetectFacePoints()

◆ onTextureCustomProcess()

◆ onTextureDestroyed()

◆ com::tencent::ugc::TXUGCRecord

Public 成员函数

静态 Public 成员函数

静态 Public 属性

构造及析构函数说明

◆ TXUGCRecord()

成员函数说明

◆ didDetectFacePoints()

◆ didProcessFrame() [1/2]

◆ didProcessFrame() [2/2]

◆ getBeautyManager()

◆ getInstance()

◆ getMaxZoom()

◆ getMusicDuration()

◆ getPartsManager()

◆ onBufferProcess()

◆ onDeleteAllParts()

◆ onDeleteLastPart()

◆ onEncodeDataIn()

◆ onEncodeFinished()

◆ onEncodeFormat()

◆ onEncodeNAL()

◆ onNotifyEvent()

◆ onRecordEncData()

◆ onRecordError()

◆ onRecordPcmData()

◆ onRecordRawPcmData()

◆ onRestartEncoder()

◆ onSurfaceTextureAvailable()

◆ onSurfaceTextureDestroy()

◆ onTextureProcess()

◆ pauseBGM()

◆ pauseRecord()

◆ playBGMFromTime()

◆ release()

◆ resumeBGM()

◆ resumeRecord()

◆ seekBGM()

◆ setAspectRatio()

◆ setBeautyDepth()

◆ setBeautyStyle()

◆ setBGM()

◆ setBGMNofify()

◆ setBGMVolume()

◆ setChinLevel()

◆ setEyeScaleLevel()

◆ setFaceScaleLevel()

◆ setFaceShortLevel()

◆ setFaceVLevel()

◆ setFilter() [1/2]

◆ setFilter() [2/2]

◆ setFocusPosition()

◆ setGreenScreenFile()