1 /* 2 * libjingle 3 * Copyright 2015 Google Inc. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright notice, 9 * this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright notice, 11 * this list of conditions and the following disclaimer in the documentation 12 * and/or other materials provided with the distribution. 13 * 3. The name of the author may not be used to endorse or promote products 14 * derived from this software without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED 17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 18 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 19 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 21 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 22 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 23 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 24 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 25 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 */ 27 #ifndef TALK_APP_WEBRTC_ANDROIDVIDEOCAPTURER_H_ 28 #define TALK_APP_WEBRTC_ANDROIDVIDEOCAPTURER_H_ 29 30 #include <string> 31 #include <vector> 32 33 #include "talk/media/base/videocapturer.h" 34 #include "webrtc/base/thread_checker.h" 35 #include "webrtc/common_video/include/video_frame_buffer.h" 36 37 namespace webrtc { 38 39 class AndroidVideoCapturer; 40 41 class AndroidVideoCapturerDelegate : public rtc::RefCountInterface { 42 public: ~AndroidVideoCapturerDelegate()43 virtual ~AndroidVideoCapturerDelegate() {} 44 // Start capturing. The implementation of the delegate must call 45 // AndroidVideoCapturer::OnCapturerStarted with the result of this request. 46 virtual void Start(int width, int height, int framerate, 47 AndroidVideoCapturer* capturer) = 0; 48 49 // Stops capturing. 50 // The delegate may not call into AndroidVideoCapturer after this call. 51 virtual void Stop() = 0; 52 53 // Must returns a JSON string "{{width=xxx, height=xxx, framerate = xxx}}" 54 virtual std::string GetSupportedFormats() = 0; 55 }; 56 57 // Android implementation of cricket::VideoCapturer for use with WebRtc 58 // PeerConnection. 59 class AndroidVideoCapturer : public cricket::VideoCapturer { 60 public: 61 explicit AndroidVideoCapturer( 62 const rtc::scoped_refptr<AndroidVideoCapturerDelegate>& delegate); 63 virtual ~AndroidVideoCapturer(); 64 65 // Called from JNI when the capturer has been started. 66 void OnCapturerStarted(bool success); 67 68 // Called from JNI when a new frame has been captured. 69 // Argument |buffer| is intentionally by value, for use with rtc::Bind. 70 void OnIncomingFrame( 71 const rtc::scoped_refptr<webrtc::VideoFrameBuffer>& buffer, 72 int rotation, 73 int64_t time_stamp); 74 75 // Called from JNI to request a new video format. 76 void OnOutputFormatRequest(int width, int height, int fps); 77 delegate()78 AndroidVideoCapturerDelegate* delegate() { return delegate_.get(); } 79 80 // cricket::VideoCapturer implementation. 81 bool GetBestCaptureFormat(const cricket::VideoFormat& desired, 82 cricket::VideoFormat* best_format) override; 83 84 private: 85 // cricket::VideoCapturer implementation. 86 // Video frames will be delivered using 87 // cricket::VideoCapturer::SignalFrameCaptured on the thread that calls Start. 88 cricket::CaptureState Start( 89 const cricket::VideoFormat& capture_format) override; 90 void Stop() override; 91 bool IsRunning() override; IsScreencast()92 bool IsScreencast() const override { return false; } 93 bool GetPreferredFourccs(std::vector<uint32_t>* fourccs) override; 94 95 bool running_; 96 rtc::scoped_refptr<AndroidVideoCapturerDelegate> delegate_; 97 98 rtc::ThreadChecker thread_checker_; 99 100 class FrameFactory; 101 FrameFactory* frame_factory_; // Owned by cricket::VideoCapturer. 102 103 cricket::CaptureState current_state_; 104 }; 105 106 } // namespace webrtc 107 108 #endif // TALK_APP_WEBRTC_ANDROIDVIDEOCAPTURER_H_ 109