com.netease.nimlib.sdk.avchat.video

Class AVChatExternalVideoCapturer

java.lang.Object

ExternalVideoCapturer

com.netease.nimlib.sdk.avchat.video.AVChatExternalVideoCapturer

All Implemented Interfaces:

AVChatVideoCapturer

public abstract class AVChatExternalVideoCapturer
extends ExternalVideoCapturer
implements AVChatVideoCapturer

Inherit this class to implement custom external video data source

Constructor Summary

Constructors

Constructor and Description
AVChatExternalVideoCapturer()

Method Summary

Modifier and Type	Method and Description
IVideoCapturer	asVideoCapturer()
abstract void	changeCaptureFormat(int width, int height, int frameRate) Edit capture parameters
abstract void	dispose() Dispose video data
int	onByteBufferFrameCaptured(byte[] data, int dataLen, int width, int height, int rotation, int frameRate, int format, long timeStamp, boolean mirror) External call for submitting each frame of video data
void	onCapturerStarted(boolean success) External call used to notify the SDK whether video data capture starts.
void	onCapturerStopped() External call used to notify the SDK whether video data capture stops.
abstract void	startCapture(int width, int height, int frameRate) Start capure video data
abstract void	stopCapture() Stop capture video data

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AVChatExternalVideoCapturer

public AVChatExternalVideoCapturer()

Method Detail

startCapture

public abstract void startCapture(int width,
                                  int height,
                                  int frameRate)

Start capure video data

Parameters:

width - width

height - height

frameRate - frame rate

stopCapture

public abstract void stopCapture()
                          throws java.lang.InterruptedException

Stop capture video data

Throws:

java.lang.InterruptedException

changeCaptureFormat

public abstract void changeCaptureFormat(int width,
                                         int height,
                                         int frameRate)

Edit capture parameters

Parameters:

width - width

height - height

frameRate - frame rate

dispose

public abstract void dispose()

Dispose video data

asVideoCapturer

public IVideoCapturer asVideoCapturer()

Specified by:

asVideoCapturer in interface AVChatVideoCapturer

onCapturerStarted

public void onCapturerStarted(boolean success)

External call used to notify the SDK whether video data capture starts.

Parameters:

success - indicates whether the video data capture starts with success.

onCapturerStopped

public void onCapturerStopped()

External call used to notify the SDK whether video data capture stops.

onByteBufferFrameCaptured

public int onByteBufferFrameCaptured(byte[] data,
                                     int dataLen,
                                     int width,
                                     int height,
                                     int rotation,
                                     int frameRate,
                                     int format,
                                     long timeStamp,
                                     boolean mirror)

External call for submitting each frame of video data

Parameters:

data - Video data

dataLen - Video data length

width - Video data width

height - Video data height

rotation - angle of rotation. The mutiple of 90 degree in clockwise direction

frameRate - frame rate, greater than 0. If the value is large, frame loss may apply.

format - Video format AVChatImageFormat.I420、AVChatImageFormat.NV21

timeStamp - video timestamp starting from AVChatManagerLite.enableRtc() by calling SystemClock#elapsedRealtime()

mirror - specify if mirror is required. If the value is se to true, mirroring is implemented after rotation

Returns:

result. 0: success. Other values: failure

-1- empty data or invalid length

-2- invalid width and length. The resolution exceeds the maximum supported size 1920*1080.

-3- invalid angle of rotation

-4- invalid frame rate

-5- invalid data format

-10- other errors