.. java:import:: android.content Context

JCVideoCaptureInterface
=======================

.. java:package:: at.jumpch.sdk
   :noindex:

.. java:type:: public interface JCVideoCaptureInterface

   Video capture interface. Implement these methods to create a custom video capturer. In the \ :java:ref:`JCClient.Callback`\  implementation, return a string with the fully qualitied package name. For example: \ :java:ref:`at.jumpch.sdk.example.CustomVideoCapture`\ .

Methods
-------
enableHD
^^^^^^^^

.. java:method::  boolean enableHD(boolean enable)
   :outertype: JCVideoCaptureInterface

   Enable HD or SD when capturing the video

   :param enable: boolean to determine HD(ex. 1280x720) or SD(ex. 640x480) quality.
   :return: \ ``true``\  if successfully enabled HD, \ ``false``\  otherwise

resumeCapture
^^^^^^^^^^^^^

.. java:method::  boolean resumeCapture()
   :outertype: JCVideoCaptureInterface

   Resume video capture. Generally restart the capture thread if stopped.

   :return: \ ``true``\  if success, \ ``false``\  otherwise

selectCamera
^^^^^^^^^^^^

.. java:method::  boolean selectCamera(int cameraId)
   :outertype: JCVideoCaptureInterface

   Select the camera id. For example front or back camera. This can be an empty method in a custom stream.

   :param cameraId: Integer to determine if front or back camera should be used. See \ :java:ref:`android.hardware.Camera.open`\
   :return: \ ``true``\  if camera selection was successful, \ ``false``\  otherwise

startCapture
^^^^^^^^^^^^

.. java:method::  boolean startCapture(int width, int height, int framerate, Context applicationContext, JCVideoCaptureCallback cb)
   :outertype: JCVideoCaptureInterface

   Start a thread to provide video frames to the system. Parameters are suggestions and can be safely ignored when implementing the method.

   :param width: Video frame width
   :param height: Video frame height
   :param framerate: Frames per second
   :param applicationContext: Application context provided in \ :java:ref:`JCClient`\
   :param cb: Callback object used to provide video frame to the system
   :return: \ ``true``\  if successful, false otherwise

stopCapture
^^^^^^^^^^^

.. java:method::  boolean stopCapture()
   :outertype: JCVideoCaptureInterface

   Stop the capture thread. Called when app goes into the background.

   :return: \ ``true``\  if successful, \ ``false``\  otherwise

switchCamera
^^^^^^^^^^^^

.. java:method::  boolean switchCamera()
   :outertype: JCVideoCaptureInterface

   Switch the camera. Used to toggle between front and back camera.

   :return: \ ``true``\  if successful, \ ``false``\  otherwise