1 /* 2 * libjingle 3 * Copyright 2012, 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 28 #ifndef TALK_APP_WEBRTC_VIDEOSOURCE_H_ 29 #define TALK_APP_WEBRTC_VIDEOSOURCE_H_ 30 31 #include "talk/app/webrtc/mediastreaminterface.h" 32 #include "talk/app/webrtc/notifier.h" 33 #include "talk/app/webrtc/videosourceinterface.h" 34 #include "talk/app/webrtc/videotrackrenderers.h" 35 #include "talk/media/base/videocapturer.h" 36 #include "talk/media/base/videocommon.h" 37 #include "webrtc/base/scoped_ptr.h" 38 #include "webrtc/base/sigslot.h" 39 40 // VideoSource implements VideoSourceInterface. It owns a 41 // cricket::VideoCapturer and make sure the camera is started at a resolution 42 // that honors the constraints. 43 // The state is set depending on the result of starting the capturer. 44 // If the constraint can't be met or the capturer fails to start, the state 45 // transition to kEnded, otherwise it transitions to kLive. 46 47 namespace cricket { 48 49 class ChannelManager; 50 51 } // namespace cricket 52 53 namespace webrtc { 54 55 class MediaConstraintsInterface; 56 57 class VideoSource : public Notifier<VideoSourceInterface>, 58 public sigslot::has_slots<> { 59 public: 60 // Creates an instance of VideoSource. 61 // VideoSource take ownership of |capturer|. 62 // |constraints| can be NULL and in that case the camera is opened using a 63 // default resolution. 64 static rtc::scoped_refptr<VideoSource> Create( 65 cricket::ChannelManager* channel_manager, 66 cricket::VideoCapturer* capturer, 67 const webrtc::MediaConstraintsInterface* constraints); 68 state()69 virtual SourceState state() const { return state_; } options()70 virtual const cricket::VideoOptions* options() const { return &options_; } 71 virtual cricket::VideoRenderer* FrameInput(); 72 GetVideoCapturer()73 virtual cricket::VideoCapturer* GetVideoCapturer() { 74 return video_capturer_.get(); 75 } 76 // |output| will be served video frames as long as the underlying capturer 77 // is running video frames. 78 virtual void AddSink(cricket::VideoRenderer* output); 79 virtual void RemoveSink(cricket::VideoRenderer* output); 80 81 protected: 82 VideoSource(cricket::ChannelManager* channel_manager, 83 cricket::VideoCapturer* capturer); 84 virtual ~VideoSource(); 85 void Initialize(const webrtc::MediaConstraintsInterface* constraints); 86 87 private: 88 void OnStateChange(cricket::VideoCapturer* capturer, 89 cricket::CaptureState capture_state); 90 void SetState(SourceState new_state); 91 92 cricket::ChannelManager* channel_manager_; 93 rtc::scoped_ptr<cricket::VideoCapturer> video_capturer_; 94 rtc::scoped_ptr<cricket::VideoRenderer> frame_input_; 95 96 cricket::VideoFormat format_; 97 cricket::VideoOptions options_; 98 SourceState state_; 99 }; 100 101 } // namespace webrtc 102 103 #endif // TALK_APP_WEBRTC_VIDEOSOURCE_H_ 104