NGIAgoraCameraCapturer.h

Go to the documentation of this file.

//
//  Agora SDK
//
//  Copyright (c) 2019 Agora.io. All rights reserved.
//
 
#pragma once  // NOLINT(build/header_guard)
 
#include "AgoraBase.h"
#include "AgoraRefPtr.h"
#include <api/cpp/aosl_ares_class.h>
 
namespace agora {
namespace rtc {
class IVideoSinkBase;
class ICameraCaptureObserver;
class ICameraCapturer : public RefCountInterface {
 
 public:
  enum CAMERA_SOURCE {
    CAMERA_BACK,
    CAMERA_FRONT,
    CAMERA_EXTRA,
  };
 
  enum CAMERA_STATE {
    CAMERA_STARTED,
    CAMERA_STOPPED,
  };
 
 public:
#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IPHONE) || defined (__OHOS__)
 
  virtual int setCameraSource(CAMERA_SOURCE source, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
  virtual CAMERA_SOURCE getCameraSource() = 0;
  virtual int switchCamera(aosl_ref_t ares = AOSL_REF_INVALID) = 0;
  virtual bool isZoomSupported() = 0;
  virtual int32_t setCameraZoom(float zoomValue, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
  virtual float getCameraMaxZoom() = 0;
  virtual bool isFocusSupported() = 0;
  virtual int32_t setCameraFocus(float x, float y, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
  virtual bool isAutoFaceFocusSupported() = 0;
  virtual int32_t setCameraAutoFaceFocus(bool enable, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
  virtual int32_t enableFaceDetection(bool enable, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
 
  virtual bool isCameraFaceDetectSupported() = 0;
 
  virtual bool isCameraTorchSupported() = 0;
 
  virtual int setCameraTorchOn(bool on, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
 
  virtual bool isCameraExposurePositionSupported() = 0;
 
  virtual int setCameraExposurePosition(float positionXinView, float positionYinView, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
  
  virtual bool isCameraExposureSupported() = 0;
 
  virtual int setCameraExposureFactor(float value, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
 
#if (defined(__APPLE__) && TARGET_OS_IOS)
 
  virtual bool enableMultiCamera(bool enable, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
  virtual bool isCameraAutoExposureFaceModeSupported() = 0;
 
 
  virtual int setCameraAutoExposureFaceModeEnabled(bool enabled, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
 
  virtual int setCameraStabilizationMode(CAMERA_STABILIZATION_MODE mode) = 0;
#endif
  
#elif defined(_WIN32) || (defined(__linux__) && !defined(__ANDROID__) && !defined (__OHOS__)) || \
    (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE)
 
  virtual int initWithDeviceId(const char* deviceId) = 0;
  virtual int initWithDeviceName(const char* deviceName) = 0;
#endif
 
#if defined(__APPLE__)
 
  virtual bool isCenterStageSupported() = 0;
  
  virtual int enableCenterStage(bool enabled) = 0;
#endif
 
  virtual int setDeviceOrientation(VIDEO_ORIENTATION orientation, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
 
  virtual int setCaptureFormat(const VideoFormat& capture_format, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
  virtual VideoFormat getCaptureFormat() = 0;
  virtual int registerCameraObserver(ICameraCaptureObserver* observer, aosl_ref_t ares = AOSL_REF_INVALID) = 0;
  virtual int unregisterCameraObserver(ICameraCaptureObserver* observer) = 0;
 
 protected:
  ~ICameraCapturer() {}
};
class ICameraCaptureObserver {
 public:
  virtual void onCameraFocusAreaChanged(int imageWidth, int imageHeight, int x, int y) {
    (void) imageWidth;
    (void) imageHeight;
    (void) x;
    (void) y;
 
  }
  virtual void onFacePositionChanged(
      int imageWidth, int imageHeight, const Rectangle* vecRectangle, const int* vecDistance, int numFaces) {
    (void) imageWidth;
    (void) imageHeight;
    (void) vecRectangle;
    (void) vecDistance;
    (void) numFaces;
  }
 
  virtual void onCameraExposureAreaChanged(int x, int y, int width, int height) {
    (void)x;
    (void)y;
    (void)width;
    (void)height;
  }
 
  virtual void onCameraStateChanged(ICameraCapturer::CAMERA_STATE state, ICameraCapturer::CAMERA_SOURCE source) {
    (void) state;
    (void) source;
  }
 
 protected:
  virtual ~ICameraCaptureObserver() {}
};
 
}  // namespace rtc
}  // namespace agora