1 // Copyright (c) 2013 The Chromium Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 5 #ifndef CONTENT_RENDERER_MEDIA_VIDEO_SOURCE_HANDLER_H_ 6 #define CONTENT_RENDERER_MEDIA_VIDEO_SOURCE_HANDLER_H_ 7 8 #include <map> 9 #include <string> 10 11 #include "base/compiler_specific.h" 12 #include "base/memory/ref_counted.h" 13 #include "content/common/content_export.h" 14 #include "third_party/libjingle/source/talk/app/webrtc/videosourceinterface.h" 15 16 namespace cricket { 17 class VideoFrame; 18 } 19 20 namespace content { 21 22 class MediaStreamDependencyFactory; 23 class MediaStreamRegistryInterface; 24 25 // Interface used by the effects pepper plugin to get captured frame 26 // from the video track. 27 class CONTENT_EXPORT FrameReaderInterface { 28 public: 29 // Got a new captured frame. 30 // The ownership of the |frame| is transfered to the caller. So the caller 31 // must delete |frame| when done with it. 32 virtual bool GotFrame(cricket::VideoFrame* frame) = 0; 33 34 protected: ~FrameReaderInterface()35 virtual ~FrameReaderInterface() {} 36 }; 37 38 // VideoSourceHandler is a glue class between the webrtc MediaStream and 39 // the effects pepper plugin host. 40 class CONTENT_EXPORT VideoSourceHandler { 41 public: 42 // |registry| is used to look up the media stream by url. If a NULL |registry| 43 // is given, the global blink::WebMediaStreamRegistry will be used. 44 explicit VideoSourceHandler(MediaStreamRegistryInterface* registry); 45 virtual ~VideoSourceHandler(); 46 // Connects to the first video track in the MediaStream specified by |url| and 47 // the received frames will be delivered via |reader|. 48 // Returns true on success and false on failure. 49 bool Open(const std::string& url, FrameReaderInterface* reader); 50 // Closes |reader|'s connection with the first video track in 51 // the MediaStream specified by |url|, i.e. stops receiving frames from the 52 // video track. 53 // Returns true on success and false on failure. 54 bool Close(const std::string& url, FrameReaderInterface* reader); 55 56 // Gets the VideoRenderer associated with |reader|. 57 // Made it public only for testing purpose. 58 cricket::VideoRenderer* GetReceiver(FrameReaderInterface* reader); 59 60 private: 61 scoped_refptr<webrtc::VideoSourceInterface> GetFirstVideoSource( 62 const std::string& url); 63 64 MediaStreamRegistryInterface* registry_; 65 std::map<FrameReaderInterface*, cricket::VideoRenderer*> reader_to_receiver_; 66 67 DISALLOW_COPY_AND_ASSIGN(VideoSourceHandler); 68 }; 69 70 } // namespace content 71 72 #endif // CONTENT_RENDERER_MEDIA_VIDEO_SOURCE_HANDLER_H_ 73 74