Skip to content

Latest commit

 

History

History

Basic-Video-Capturer-Camera-2-Java

README.md

Basic Video Capturer Camera 2

Sample app shows how to use device camera as the video source with the custom capturer using the Camera2 package. This class was introduced in API level 21 by providing an alternative for deprecated Camera class.

Note: If you want to support API level below 21 Basic Video Capturer project contains capturer for deprecated Camera class.

Note: Check Custom Video Driver project to see how custom video capturer and custom video renderer works together.

A custom video capturer will be helpful when:

  • modifying the camera stream content - image composition (adding watermark logo) or image processing (mirroring the video, removing the background or putting a virtual hat on the user).
  • streaming any content other than the one coming from the device camera, e.g. streaming content of a particular view's game or content (check Screen-Sharing project).

Using a custom video capturer

The MirrorVideoCapturer is a custom class that extends the BaseVideoCapturer class, defined in the OpenTok Android SDK. During construction of a Publisher object, the code sets a custom video capturer by calling the capturer method of the Publisher:

publisher = new Publisher.Builder(MainActivity.this)
    .capturer(new MirrorVideoCapturer(MainActivity.this))
    .build();

The getCaptureSettings method returns the settings of the video capturer, including the frame rate, width, height, video delay, and video format for the capturer:

@Override
public synchronized CaptureSettings getCaptureSettings() {
    CaptureSettings captureSettings = new CaptureSettings();
    captureSettings.fps = desiredFps;
    captureSettings.width = (null != cameraFrame) ? cameraFrame.getWidth() : 0;
    captureSettings.height = (null != cameraFrame) ? cameraFrame.getHeight() : 0;
    captureSettings.format = BaseVideoCapturer.NV21;
    captureSettings.expectedDelay = 0;
    return captureSettings;
}

The app calls startCameraCapture method to start capturing video from the custom video capturer.

public synchronized int startCapture() {
    if (null != camera && CameraState.OPEN == cameraState) {
        return startCameraCapture();
    } else if (CameraState.SETUP == cameraState) {
        executeAfterCameraOpened = () -> startCameraCapture();
    } else {
        throw new Camera2Exception("Start Capture called before init successfully completed");
    }

    return 0;
}

The publisher adds video frames to the published stream.

Further Reading