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