Video capturing from custom software source

Development

Since Android SDK build 1.1.0.26 it is possible to use custom software camera implementation to capture video. To do this, follow the step by step instruction:

1. Develop Java class implementing CameraVideoCapturer interface

2. Import the following modules to the application
   

   import org.webrtc.CameraVideoCapturer;
   import com.flashphoner.fpwcsapi.camera.CameraCapturerFactory;
   import com.flashphoner.fpwcsapi.camera.CustomCameraCapturerOptions;
   import com.flashphoner.fpwcsapi.camera.CustomCameras;
   

3. Prepare CustomCameraCapturerOptions object
   

   private CustomCameraCapturerOptions createCustomCameraCapturerOptions() {
     return new CustomCameraCapturerOptions() {
   
         private String cameraName;
         private CameraVideoCapturer.CameraEventsHandler eventsHandler;
         private boolean captureToTexture;
   
         @Override
         public Class<?>[] getCameraConstructorArgsTypes() {
             return new Class<?>[]{String.class, CameraVideoCapturer.CameraEventsHandler.class, boolean.class};
         }
   
         @Override
         public Object[] getCameraConstructorArgs() {
             return new Object[]{cameraName, eventsHandler, captureToTexture};
         }
   
         @Override
         public void setCameraName(String cameraName) {
             this.cameraName = cameraName;
         }
   
         @Override
         public void setEventsHandler(CameraVideoCapturer.CameraEventsHandler eventsHandler) {
             this.eventsHandler = eventsHandler;
         }
   
         @Override
         public void setCaptureToTexture(boolean captureToTexture) {
             this.captureToTexture = captureToTexture;
         }
   
         // Use your custom capturer class name here
         @Override
         public String getCameraClassName() {
             return your.custom.CameraCapturer;
         }
   
         @Override
         public Class<?>[] getEnumeratorConstructorArgsTypes() {
             return new Class[0];
         }
   
         @Override
         public Object[] getEnumeratorConstructorArgs() {
             return new Object[0];
         }
   
         // Use your custom capturer enumerator name here
         @Override
         public String getEnumeratorClassName() {
             return your.custom.CameraEnumerator;
         }
     };
   }
   

4. Choose custom camera in application before stream publishing
   

   CameraCapturerFactory.getInstance().setCustomCameraCapturerOptions(createCustomCameraCapturerOptions());
   CameraCapturerFactory.getInstance().setCameraType(CameraCapturerFactory.CameraType.CUSTOM);
   

Usage example

Using CameraVideoCapturer implementation to access a flashlight

1. CustomCameraCapturerOptions object creation
   code
   

   private CustomCameraCapturerOptions createCustomCameraCapturerOptions() {
     return new CustomCameraCapturerOptions() {
   
         private String cameraName;
         private CameraVideoCapturer.CameraEventsHandler eventsHandler;
         private boolean captureToTexture;
   
         @Override
         public Class<?>[] getCameraConstructorArgsTypes() {
             return new Class<?>[]{String.class, CameraVideoCapturer.CameraEventsHandler.class, boolean.class};
         }
   
         @Override
         public Object[] getCameraConstructorArgs() {
             return new Object[]{cameraName, eventsHandler, captureToTexture};
         }
   
         @Override
         public void setCameraName(String cameraName) {
             this.cameraName = cameraName;
         }
   
         @Override
         public void setEventsHandler(CameraVideoCapturer.CameraEventsHandler eventsHandler) {
             this.eventsHandler = eventsHandler;
         }
   
         @Override
         public void setCaptureToTexture(boolean captureToTexture) {
             this.captureToTexture = captureToTexture;
         }
   
         // Using org.webrtc.FlashlightCameraCapturer to access flashlight hidden controls.
         @Override
         public String getCameraClassName() {
             return CustomCameras.FLASHLIGHT_CAMERA_CAPTURER;
         }
   
         @Override
         public Class<?>[] getEnumeratorConstructorArgsTypes() {
             return new Class[0];
         }
   
         @Override
         public Object[] getEnumeratorConstructorArgs() {
             return new Object[0];
         }
   
         // Using org.webrtc.FlashlightCameraEnumerator to access flashlight hidden controls.
         @Override
         public String getEnumeratorClassName() {
             return CustomCameras.FLASHLIGHT_CAMERA_ENUMERATOR;
         }
     };
   }
   

2. Camera choosing
   code
   

   CameraCapturerFactory.getInstance().setCustomCameraCapturerOptions(createCustomCameraCapturerOptions());
   mCameraCapturer = (LabelledSpinner) findViewById(R.id.camera_capturer);
   mCameraCapturer.setOnItemChosenListener(new LabelledSpinner.OnItemChosenListener() {
      @Override
      public void onItemChosen(View labelledSpinner, AdapterView<?> adapterView, View itemView, int position, long id) {
          String captureType = getResources().getStringArray(R.array.camera_capturer)[position];
          switch (captureType) {
              case "flashlight":
                  CameraCapturerFactory.getInstance().setCameraType(CameraCapturerFactory.CameraType.FLASHLIGHT_CAMERA);
                  break;
              case "camera1capturer":
                  CameraCapturerFactory.getInstance().setCameraType(CameraCapturerFactory.CameraType.CAMERA1CAPTURE);
                  break;
              case "camera2capturer":
                  CameraCapturerFactory.getInstance().setCameraType(CameraCapturerFactory.CameraType.CAMERA2CAPTURE);
                  break;
              case "custom":
                  CameraCapturerFactory.getInstance().setCameraType(CameraCapturerFactory.CameraType.CUSTOM);
                  break;
          }
          mCameraSpinner.setItemsArray(Flashphoner.getMediaDevices().getVideoList());
      }
   
      @Override
      public void onNothingChosen(View labelledSpinner, AdapterView<?> adapterView) {
   
      }
   });