/* * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. * * Use of this source code is governed by a BSD-style license * that can be found in the LICENSE file in the root of the source * tree. An additional intellectual property rights grant can be found * in the file PATENTS. All contributing project authors may * be found in the AUTHORS file in the root of the source tree. */ #ifndef MODULES_VIDEO_CAPTURE_MAIN_SOURCE_VIDEO_CAPTURE_IMPL_H_ #define MODULES_VIDEO_CAPTURE_MAIN_SOURCE_VIDEO_CAPTURE_IMPL_H_ /* * video_capture_impl.h */ #include #include #include "api/scoped_refptr.h" #include "api/sequence_checker.h" #include "api/video/video_frame.h" #include "api/video/video_rotation.h" #include "api/video/video_sink_interface.h" #include "modules/video_capture/video_capture.h" #include "modules/video_capture/video_capture_config.h" #include "modules/video_capture/video_capture_defines.h" #include "rtc_base/race_checker.h" #include "rtc_base/synchronization/mutex.h" #include "rtc_base/system/rtc_export.h" namespace webrtc { class VideoCaptureOptions; namespace videocapturemodule { // Class definitions class RTC_EXPORT VideoCaptureImpl : public VideoCaptureModule { public: /* * Create a video capture module object * * id - unique identifier of this video capture module object * deviceUniqueIdUTF8 - name of the device. Available names can be found by * using GetDeviceName */ static rtc::scoped_refptr Create( const char* deviceUniqueIdUTF8); static rtc::scoped_refptr Create( VideoCaptureOptions* options, const char* deviceUniqueIdUTF8); static DeviceInfo* CreateDeviceInfo(); static DeviceInfo* CreateDeviceInfo(VideoCaptureOptions* options); // Helpers for converting between (integral) degrees and // VideoRotation values. Return 0 on success. static int32_t RotationFromDegrees(int degrees, VideoRotation* rotation); static int32_t RotationInDegrees(VideoRotation rotation, int* degrees); // Call backs void RegisterCaptureDataCallback( rtc::VideoSinkInterface* dataCallback) override; virtual void RegisterCaptureDataCallback( RawVideoSinkInterface* dataCallback) override; void DeRegisterCaptureDataCallback( rtc::VideoSinkInterface* dataCallback) override; int32_t StopCaptureIfAllClientsClose() override; int32_t SetCaptureRotation(VideoRotation rotation) override; bool SetApplyRotation(bool enable) override; bool GetApplyRotation() override; const char* CurrentDeviceName() const override; // `capture_time` must be specified in NTP time format in milliseconds. int32_t IncomingFrame(uint8_t* videoFrame, size_t videoFrameLength, const VideoCaptureCapability& frameInfo, int64_t captureTime = 0); // Platform dependent int32_t StartCapture(const VideoCaptureCapability& capability) override; int32_t StopCapture() override; bool CaptureStarted() override; int32_t CaptureSettings(VideoCaptureCapability& /*settings*/) override; protected: VideoCaptureImpl(); ~VideoCaptureImpl() override; // Calls to the public API must happen on a single thread. SequenceChecker api_checker_; // RaceChecker for members that can be accessed on the API thread while // capture is not happening, and on a callback thread otherwise. rtc::RaceChecker capture_checker_; // current Device unique name; char* _deviceUniqueId RTC_GUARDED_BY(api_checker_); // moved DeliverCapturedFrame to protected for VideoCaptureAndroid (mjf) int32_t DeliverCapturedFrame(VideoFrame& captureFrame) RTC_EXCLUSIVE_LOCKS_REQUIRED(api_lock_); Mutex api_lock_; // Should be set by platform dependent code in StartCapture. VideoCaptureCapability _requestedCapability RTC_GUARDED_BY(api_checker_); private: void UpdateFrameCount(); uint32_t CalculateFrameRate(int64_t now_ns); void DeliverRawFrame(uint8_t* videoFrame, size_t videoFrameLength, const VideoCaptureCapability& frameInfo, int64_t captureTime) RTC_EXCLUSIVE_LOCKS_REQUIRED(api_lock_); // last time the module process function was called. int64_t _lastProcessTimeNanos RTC_GUARDED_BY(capture_checker_); // last time the frame rate callback function was called. int64_t _lastFrameRateCallbackTimeNanos RTC_GUARDED_BY(capture_checker_); std::set*> _dataCallBacks RTC_GUARDED_BY(api_lock_); RawVideoSinkInterface* _rawDataCallBack RTC_GUARDED_BY(api_lock_); int64_t _lastProcessFrameTimeNanos RTC_GUARDED_BY(capture_checker_); // timestamp for local captured frames int64_t _incomingFrameTimesNanos[kFrameRateCountHistorySize] RTC_GUARDED_BY( capture_checker_); // Set if the frame should be rotated by the capture module. VideoRotation _rotateFrame RTC_GUARDED_BY(api_lock_); // Indicate whether rotation should be applied before delivered externally. bool apply_rotation_ RTC_GUARDED_BY(api_lock_); }; } // namespace videocapturemodule } // namespace webrtc #endif // MODULES_VIDEO_CAPTURE_MAIN_SOURCE_VIDEO_CAPTURE_IMPL_H_