public interface AliyunIRecorder
限定符和类型 | 方法和说明 |
---|---|
int |
addImage(EffectImage effctImage)
添加水印素材,如果需要使用文字水印,可以通过Bitmap工具把文字转成水印,如果需要调整水印的位置
setEffectView(float, float, float, float, EffectBase) |
int |
addPaster(EffectPaster effectPaster)
添加人脸动图,人脸动图与普通动图要严格区分,如果把普通动图素材当作人脸动图使用,则会出现动图不显示的情况,要使用人脸动图,必须先设置
rotation,通过
setRotation(int) 实现。 |
int |
addPaster(EffectPaster effectPaster,
float sx,
float sy,
float sw,
float sh,
float rotation,
boolean flip)
添加普通动图,人脸动图可以当作普通动图,但是普通动图不能当作人脸动图
注意
setEffectView(float, float, float, float, EffectBase) 的执行效果会和此函数的执行效果进行叠加 |
int |
applyAnimationFilter(EffectFilter effectFilter)
设置动效滤镜,将滤镜资源的目录填入到
EffectBase.setPath(String) 中,或者通过EffectFilter.Builder 来
构建 |
int |
applyFilter(EffectFilter effectFilter)
设置滤镜效果
|
int |
applyMv(EffectBean effectMv)
已过时。
|
void |
cancelRecording()
取消录制视频
|
void |
destroy()
销毁并释放资源
|
int |
finishRecording()
结束录制合成视频
|
android.net.Uri |
finishRecordingForEdit()
结束录制,并且将录制的片段描述信息保存成json文件,返回json文件的Uri,用于编辑等功能。
|
com.aliyun.log.struct.AliyunLogInfo |
getAliyunLogInfo()
获取打点数据信息
|
int |
getBeautyLevel()
获取当前美颜度
|
int |
getCameraCount()
获取摄像头数量
|
AliyunIClipManager |
getClipManager()
获取片段管理器
|
float |
getCurrentExposureCompensationRatio()
获取当前曝光度的比例值
|
java.util.List<android.hardware.Camera.Size> |
getSupportedPictureSize()
获取当前摄像头支持的照片尺寸
|
java.util.SortedSet<com.aliyun.common.utils.Size> |
getSupportedPictureSizes()
获取当前摄像头支持的照片尺寸
|
void |
needFaceTrackInternal(boolean need)
是否需要开启内置人脸识别
|
void |
pauseMv()
已过时。
|
int |
postToGl(java.lang.Runnable r)
已过时。
|
void |
removeAnimationFilter(EffectFilter effctFilter)
删除动效滤镜
|
int |
removeFromGl(java.lang.Runnable r)
已过时。
|
void |
removeImage(EffectImage effctImage)
删除水印素材
|
void |
removePaster(EffectPaster effectPaster)
删除动图素材,普通动图和人脸动图都通过该接口移除
|
int |
resizePreviewSize(int width,
int height)
重新设置预览窗口大小(可以实现动态切换预览画幅)
|
void |
restartMv()
已过时。
|
void |
resumeMv()
已过时。
|
void |
setBeautyLevel(int level)
设置美颜度
|
void |
setBeautyStatus(boolean on)
设置美颜开/关
|
void |
setCamera(CameraType camera)
设置开启预览时的摄像头类型。
|
void |
setCameraCaptureDataMode(int captureDataMode)
设置Camera 数据回调方式
|
void |
setCameraParam(CameraParam cameraParam)
设置摄像头预览参数
|
void |
setDisplayView(android.view.SurfaceView displayView)
设置显示预览的
SurfaceView |
int |
setEffectView(float xRatio,
float yRatio,
float widthRatio,
float heightRatio,
EffectBase effectBase)
设置特效信息(位置,大小)
widthRatio和heightRatio参数需要符合素材宽高/屏幕宽高的比例
比如: 素材的宽高为200,300, 屏幕的宽高为 540,720 sw = (float)200/540, sh = (float)300/720。
|
void |
setEncoderInfoCallback(EncoderInfoCallback callback)
设置编码信息回调
|
int |
setExposureCompensationRatio(float value)
设置曝光度比例
|
void |
setFaceDetectRotation(int rotation)
设置单独的人脸识别角度,如果使用本接口,请不要使用setRotation
|
int |
setFaces(float[][] faces)
设置人脸坐标点,而二维组每个元素,代表一张脸的6个特征点。
|
void |
setFaceTrackInternalMaxFaceCount(int maxFaceCount)
设置内置人脸识别的最大识别数,最大为3个,大于3个为3个
|
int |
setFaceTrackInternalModelPath(java.lang.String path)
设置人脸识别模型文件夹路径
这里必须是包含模型文件的目录路径,模型文件的文件名不能修改
|
void |
setFocus(float xRatio,
float yRatio)
设置对焦点,仅当
setFocusMode(int) 的参数为CameraParam.FOCUS_MODE_AUTO 时有效 |
void |
setFocus(android.graphics.Point point)
已过时。
|
void |
setFocusMode(int mode)
设置聚焦模式
|
int |
setGop(int gop)
设置Gop大小,这里的gop单位是帧数,即两个I帧之间间隔多少帧,而实际上硬编码器内部是以时间为gop单位的,即两个I帧间隔多少秒,因此
实际输出视频的Gop是用该值除以编码帧率计算而出。
|
boolean |
setLight(FlashType flashType)
设置闪光灯模式
|
void |
setMediaInfo(MediaInfo mediaInfo)
设置录制的媒体信息
|
void |
setMusic(java.lang.String path,
long startTime,
long duration)
设置录制背景音乐
|
void |
setMute(boolean isMute)
录制静音
|
void |
setOnAudioCallback(OnAudioCallBack callback)
回调pcm音频数据,音频数据的格式为单通道,16位,采样率为44.1khz,
|
void |
setOnChoosePictureSizeCallBack(OnChoosePictureSizeCallBack callback)
设置拍照分辨率回调
|
void |
setOnFaceDetectInfoListener(OnFaceDetectInfoListener listener)
设置人脸检测信息变化的回调,当人脸检测信息发生改变时将触发
OnFaceDetectInfoListener.onFaceInfoChange(FaceDetectInfo) |
void |
setOnFrameCallback(OnFrameCallBack callback)
设置采集帧回调,每采集一帧数据都通过该回调返回帧数据
|
void |
setOnTextureIdCallback(OnTextureIdCallBack callback)
设置纹理ID回调
|
int |
setOutputPath(java.lang.String path)
设置输出文件路径
|
int |
setPictureSize(android.hardware.Camera.Size size)
设置照片尺寸
|
int |
setPictureSize(com.aliyun.common.utils.Size size)
设置照片尺寸
|
int |
setProperty(java.lang.String key,
java.lang.String value) |
void |
setRate(float rate)
设置录制速率
|
void |
setRecordCallback(RecordCallback callback)
设置录制回调
|
void |
setRecordCallBack(RecordCallback callBack)
|
void |
setRecordRotation(int rotation)
设置单独的录制视频角度,如果使用本接口,请不要使用setRotation
如果需要根据传感器角度来设置录制角度,需要加上计算
if (rotation == 90 || rotation == 270) {
rotation = (rotation + 90) % 360;
if (mAliyunCamera.getCameraInfo().facing == CameraInfo.CAMERA_FACING_BACK) {
rotation += 180;
rotation %= 360;
}
} else if (rotation == 0 || rotation == 180) {
rotation = (rotation + 270) % 360;
}
|
void |
setRotation(int rotation)
设置传感器的角度值,如果传感器返回的角度值不是0,90,180,270四个值中的,需要根据范围来确定
Sets the rotation angle of the gyro sensor.
|
void |
setShutterSound(boolean bNeedShutterSound)
设置拍照时是否存在咔嚓声
|
void |
setTakePicturePreview(boolean bPreviewAfterPicture)
设置拍照后是否继续预览
|
int |
setVideoBitrate(int bitrate)
视频码率,有效的码率值必须在[200, 20000]之间,即最小是200Kbps,最大是20Mbps 单位:kbps,如果超过当前分辨率的使用码率值,有的编码器
不会无限增加码率,比如720P的码率值4M应该就足够使用了,可能会出现设置10M码率,输出的视频码率依然只有4M左右,具体根据不同编码器行为而定。
|
int |
setVideoFlipH(boolean flip)
设置输出视频是否竖直方向镜像(仅对输出视频有效,预览不改变)
|
void |
setVideoQuality(VideoQuality quality)
设置视频质量,该接口影响的是生成视频的码率
|
int |
setZoom(float rate)
设置摄像头缩放比例
|
int |
startPreview()
开启预览
注意:该方法建议在
Activity.onResume() 生命周期函数中调用 |
int |
startPreviewAfterTakePicture()
默认情况时,拍照结束会自动启动预览,故默认情况下用户不必调用 startPreviewAfterTakePicture;
若拍照结束后不自启预览时,用户需要手动调用 startPreviewAfterTakePicture 来启动预览.
|
int |
startRecording()
开始录制
|
void |
stopPreview()
停止预览
注意:该方法建议在
Activity.onPause() 生命周期函数中调用 |
int |
stopRecording()
停止录制
|
int |
switchCamera()
切换摄像头
|
FlashType |
switchLight()
切换闪光灯
|
void |
takePhoto(boolean needBitmap)
拍照(从GPU中抓取数据,可以包含特效)
该接口为异步接口,当照片生成后通过
RecordCallback.onPictureBack(Bitmap)
或者 RecordCallback.onPictureDataBack(byte[]) 返回 |
void |
takePicture(boolean needBitmap)
使用系统的拍照接口(不能包含特效)
该接口为异步接口,当照片生成后通过
RecordCallback.onPictureBack(Bitmap)
或者 RecordCallback.onPictureDataBack(byte[]) 返回 |
java.lang.String |
version()
获取当前接口版本号
|
AliyunIClipManager getClipManager()
AliyunIClipManager
int setOutputPath(java.lang.String path)
path
- void setVideoQuality(VideoQuality quality)
quality
- 质量等级VideoQuality
int setGop(int gop)
gop
- 合法的区间[0,9000] 大于等于0,且小于等于9000 0的情况下,在有的手机上可以做到全I帧,而也有一些手机做不到全I帧AliyunErrorCode.OK
--- 成功
AliyunErrorCode.ERROR_INVALID_ARGUMENTS
--- 设置的值不在合法的区间内int setVideoBitrate(int bitrate)
bitrate
- AliyunErrorCode.ERROR_INVALID_ARGUMENTS
--设置了无效的码率值void setCamera(CameraType camera)
switchCamera()
camera
- CameraType.BACK
,
CameraType.FRONT
void setDisplayView(android.view.SurfaceView displayView)
SurfaceView
displayView
- void setCameraCaptureDataMode(int captureDataMode)
captureDataMode
- CameraCaptureDataMode
int startPreview()
Activity.onResume()
生命周期函数中调用void stopPreview()
Activity.onPause()
生命周期函数中调用void destroy()
int addPaster(EffectPaster effectPaster)
setRotation(int)
实现。rotation的具体计算方式,请参考Demo中的代码。
添加普通动图不能使用该接口,而需要使用addPaster(EffectPaster, float, float, float, float, float, boolean)
effectPaster
- EffectPaster
int addPaster(EffectPaster effectPaster, float sx, float sy, float sw, float sh, float rotation, boolean flip)
setEffectView(float, float, float, float, EffectBase)
的执行效果会和此函数的执行效果进行叠加effectPaster
- sx
- 位置信息的x坐标(相对输出大小的比例值)sy
- 位置信息的y坐标(相对输出大小的比例值)sw
- 尺寸信息的宽度(相对输出大小的比例值)sh
- 尺寸信息的高度(相对输出大小的比例值)rotation
- 弧度flip
- 是否反转setEffectView(float, float, float, float, EffectBase)
void removePaster(EffectPaster effectPaster)
effectPaster
- int addImage(EffectImage effctImage)
setEffectView(float, float, float, float, EffectBase)
effctImage
- void removeImage(EffectImage effctImage)
effctImage
- int applyFilter(EffectFilter effectFilter)
effectFilter
- 设置为null表示移除滤镜效果int applyAnimationFilter(EffectFilter effectFilter)
EffectBase.setPath(String)
中,或者通过EffectFilter.Builder
来
构建effectFilter
- void removeAnimationFilter(EffectFilter effctFilter)
effctFilter
- @Deprecated int applyMv(EffectBean effectMv)
effectMv
- EffectBean
@Deprecated void pauseMv()
@Deprecated void resumeMv()
@Deprecated void restartMv()
int getCameraCount()
void setCameraParam(CameraParam cameraParam)
cameraParam
- CameraParam
int switchCamera()
FlashType switchLight()
FlashType.AUTO
,
FlashType.OFF
,
FlashType.ON
boolean setLight(FlashType flashType)
flashType
- int setZoom(float rate)
rate
- int setExposureCompensationRatio(float value)
value
- void setFocusMode(int mode)
mode
- CameraParam.FOCUS_MODE_CONTINUE
,
CameraParam.FOCUS_MODE_AUTO
void setMusic(java.lang.String path, long startTime, long duration)
path
- 音乐文件路径startTime
- 音乐开始时间,单位毫秒duration
- 音乐长度,单位毫秒void setRate(float rate)
rate
- 范围[0.5 - 2.0]void setMute(boolean isMute)
isMute
- 是否静音@Deprecated void setFocus(android.graphics.Point point)
#setFocus(Point
point
- 点击事件时获取的屏幕坐标的绝对值void setFocus(float xRatio, float yRatio)
setFocusMode(int)
的参数为CameraParam.FOCUS_MODE_AUTO
时有效xRatio
- 坐标点x方向上相对预览显示窗口(并非屏幕大小)的比例值yRatio
- 坐标点y方向上相对预览显示窗口(并非屏幕大小)的比例值int getBeautyLevel()
void setBeautyLevel(int level)
level
- [0, 100], 0表示没有美颜,100表示最大美颜度void setBeautyStatus(boolean on)
on
- true:开, false:关int startRecording()
int stopRecording()
int finishRecording()
void cancelRecording()
android.net.Uri finishRecordingForEdit()
int setEffectView(float xRatio, float yRatio, float widthRatio, float heightRatio, EffectBase effectBase)
xRatio
- 位置信息的x坐标(比例值)yRatio
- 位置信息的y坐标(比例值)widthRatio
- 大小信息的宽度(比例值)heightRatio
- 大小信息的高度(比例值)effectBase
- 对应的特效素材void setRecordCallback(RecordCallback callback)
callback
- RecordCallback
void setEncoderInfoCallback(EncoderInfoCallback callback)
callback
- EncoderInfoCallback
void setRecordCallBack(RecordCallback callBack)
callBack
- 回调void setOnFrameCallback(OnFrameCallBack callback)
callback
- OnFrameCallBack
void setOnChoosePictureSizeCallBack(OnChoosePictureSizeCallBack callback)
callback
- void setOnAudioCallback(OnAudioCallBack callback)
callback
- int setFaces(float[][] faces)
faces
- nx6的二维数组,6表示6个特征点
point[i][0] => LEFT_EYE_X 左眼X
point[i][1] => LEFT_EYE_Y 左眼Y
point[i][2] => RIGHT_EYE_X 右眼X
point[i][3] => RIGHT_EYE_Y 右眼Y
point[i][4] => MOUTH_X 嘴部X
point[i][5] => MOUTH_Y 嘴部Y
表示第i张脸的6个特征点。void setRotation(int rotation)
private int getSensorRotation() { int orientation = orientationDetector.getOrientation(); int rotation = 90; if (orientation >= 45 && orientation < 135) { rotation = 180; } if (orientation >= 135 && orientation < 225) { rotation = 270; } if (orientation >= 225 && orientation < 315) { rotation = 0; } if (mCameraType == CameraType.FRONT) { if (rotation != 0) { rotation = 360 - rotation; } } return rotation; }
rotation
- Do not use this method to control the angle when performing facial recognition or recording.setFaceDetectRotation(int)
,
setRecordRotation(int)
void setFaceDetectRotation(int rotation)
void setRecordRotation(int rotation)
void setOnTextureIdCallback(OnTextureIdCallBack callback)
callback
- OnTextureIdCallBack
void setOnFaceDetectInfoListener(OnFaceDetectInfoListener listener)
OnFaceDetectInfoListener.onFaceInfoChange(FaceDetectInfo)
listener
- float getCurrentExposureCompensationRatio()
void takePhoto(boolean needBitmap)
RecordCallback.onPictureBack(Bitmap)
或者 RecordCallback.onPictureDataBack(byte[])
返回needBitmap
- 是否需要生成Bitmapvoid takePicture(boolean needBitmap)
RecordCallback.onPictureBack(Bitmap)
或者 RecordCallback.onPictureDataBack(byte[])
返回needBitmap
- void needFaceTrackInternal(boolean need)
need
- int setFaceTrackInternalModelPath(java.lang.String path)
path
- AliyunErrorCode.OK
-成功
AliyunErrorCode.ERROR_INVALID_ARGUMENTS
-失败,文件无效(文件路径错误,或者文件损坏/不完整)void setFaceTrackInternalMaxFaceCount(int maxFaceCount)
maxFaceCount
- void setShutterSound(boolean bNeedShutterSound)
bNeedShutterSound
- true: 有拍照时的咔嚓声, false: 无拍照时的咔嚓声;
默认为 true.void setTakePicturePreview(boolean bPreviewAfterPicture)
bPreviewAfterPicture
- true: 拍照后启动预览, false: 拍照后停留在拍完后的照片;
默认为 true.java.lang.String version()
java.util.List<android.hardware.Camera.Size> getSupportedPictureSize()
java.util.SortedSet<com.aliyun.common.utils.Size> getSupportedPictureSizes()
int setPictureSize(android.hardware.Camera.Size size)
size
- int setPictureSize(com.aliyun.common.utils.Size size)
size
- com.aliyun.log.struct.AliyunLogInfo getAliyunLogInfo()
@Deprecated int postToGl(java.lang.Runnable r)
r
- AliyunErrorCode.OK
-成功
AliyunErrorCode.ERROR_INVALID_STATE
-失败@Deprecated int removeFromGl(java.lang.Runnable r)
r
- AliyunErrorCode.OK
-成功
AliyunErrorCode.ERROR_INVALID_STATE
-失败int startPreviewAfterTakePicture()
拍照结束后是否自启动预览, @see setTakePicturePreview(boolean bNeedPreviewAfterPicture)
int resizePreviewSize(int width, int height)
width
- 预览宽度height
- 预览高度int setProperty(java.lang.String key, java.lang.String value)
key
- the key setted.value
- the value corresponding the above keyint setVideoFlipH(boolean flip)
flip
- 是否镜像