diff options
Diffstat (limited to 'chromium/content/renderer/media/buffered_data_source.h')
-rw-r--r-- | chromium/content/renderer/media/buffered_data_source.h | 221 |
1 files changed, 221 insertions, 0 deletions
diff --git a/chromium/content/renderer/media/buffered_data_source.h b/chromium/content/renderer/media/buffered_data_source.h new file mode 100644 index 00000000000..da451ba9a73 --- /dev/null +++ b/chromium/content/renderer/media/buffered_data_source.h @@ -0,0 +1,221 @@ +// Copyright 2013 The Chromium Authors. All rights reserved. +// Use of this source code is governed by a BSD-style license that can be +// found in the LICENSE file. + +#ifndef CONTENT_RENDERER_MEDIA_BUFFERED_DATA_SOURCE_H_ +#define CONTENT_RENDERER_MEDIA_BUFFERED_DATA_SOURCE_H_ + +#include <string> + +#include "base/callback.h" +#include "base/memory/scoped_ptr.h" +#include "base/synchronization/lock.h" +#include "content/common/content_export.h" +#include "content/renderer/media/buffered_resource_loader.h" +#include "content/renderer/media/preload.h" +#include "media/base/data_source.h" +#include "media/base/ranges.h" +#include "url/gurl.h" + +namespace base { +class MessageLoopProxy; +} + +namespace media { +class MediaLog; +} + +namespace content { + +// A data source capable of loading URLs and buffering the data using an +// in-memory sliding window. +// +// BufferedDataSource must be created and initialized on the render thread +// before being passed to other threads. It may be deleted on any thread. +class CONTENT_EXPORT BufferedDataSource : public media::DataSource { + public: + typedef base::Callback<void(bool)> DownloadingCB; + + // |downloading_cb| will be called whenever the downloading/paused state of + // the source changes. + BufferedDataSource(const scoped_refptr<base::MessageLoopProxy>& render_loop, + WebKit::WebFrame* frame, + media::MediaLog* media_log, + const DownloadingCB& downloading_cb); + virtual ~BufferedDataSource(); + + // Initialize this object using |url| and |cors_mode|, executing |init_cb| + // with the result of initialization when it has completed. + // + // Method called on the render thread. + typedef base::Callback<void(bool)> InitializeCB; + void Initialize( + const GURL& url, + BufferedResourceLoader::CORSMode cors_mode, + const InitializeCB& init_cb); + + // Adjusts the buffering algorithm based on the given preload value. + void SetPreload(Preload preload); + + // Returns true if the media resource has a single origin, false otherwise. + // Only valid to call after Initialize() has completed. + // + // Method called on the render thread. + bool HasSingleOrigin(); + + // Returns true if the media resource passed a CORS access control check. + bool DidPassCORSAccessCheck() const; + + // Cancels initialization, any pending loaders, and any pending read calls + // from the demuxer. The caller is expected to release its reference to this + // object and never call it again. + // + // Method called on the render thread. + void Abort(); + + // media::DataSource implementation. + // Called from demuxer thread. + virtual void set_host(media::DataSourceHost* host) OVERRIDE; + virtual void Stop(const base::Closure& closure) OVERRIDE; + virtual void SetPlaybackRate(float playback_rate) OVERRIDE; + + virtual void Read(int64 position, int size, uint8* data, + const media::DataSource::ReadCB& read_cb) OVERRIDE; + virtual bool GetSize(int64* size_out) OVERRIDE; + virtual bool IsStreaming() OVERRIDE; + virtual void SetBitrate(int bitrate) OVERRIDE; + + protected: + // A factory method to create a BufferedResourceLoader based on the read + // parameters. We can override this file to object a mock + // BufferedResourceLoader for testing. + virtual BufferedResourceLoader* CreateResourceLoader( + int64 first_byte_position, int64 last_byte_position); + + private: + friend class BufferedDataSourceTest; + + // Task posted to perform actual reading on the render thread. + void ReadTask(); + + // Cancels oustanding callbacks and sets |stop_signal_received_|. Safe to call + // from any thread. + void StopInternal_Locked(); + + // Stops |loader_| if present. Used by Abort() and Stop(). + void StopLoader(); + + // This task uses the current playback rate with the previous playback rate + // to determine whether we are going from pause to play and play to pause, + // and signals the buffered resource loader accordingly. + void SetPlaybackRateTask(float playback_rate); + + // Tells |loader_| the bitrate of the media. + void SetBitrateTask(int bitrate); + + // The method that performs actual read. This method can only be executed on + // the render thread. + void ReadInternal(); + + // BufferedResourceLoader::Start() callback for initial load. + void StartCallback(BufferedResourceLoader::Status status); + + // BufferedResourceLoader::Start() callback for subsequent loads (i.e., + // when accessing ranges that are outside initial buffered region). + void PartialReadStartCallback(BufferedResourceLoader::Status status); + + // BufferedResourceLoader callbacks. + void ReadCallback(BufferedResourceLoader::Status status, int bytes_read); + void LoadingStateChangedCallback(BufferedResourceLoader::LoadingState state); + void ProgressCallback(int64 position); + + // Report a buffered byte range [start,end] or queue it for later + // reporting if set_host() hasn't been called yet. + void ReportOrQueueBufferedBytes(int64 start, int64 end); + + void UpdateHostState_Locked(); + + base::WeakPtrFactory<BufferedDataSource> weak_factory_; + base::WeakPtr<BufferedDataSource> weak_this_; + + // URL of the resource requested. + GURL url_; + // crossorigin attribute on the corresponding HTML media element, if any. + BufferedResourceLoader::CORSMode cors_mode_; + + // The total size of the resource. Set during StartCallback() if the size is + // known, otherwise it will remain kPositionNotSpecified until the size is + // determined by reaching EOF. + int64 total_bytes_; + + // Some resources are assumed to be fully buffered (i.e., file://) so we don't + // need to report what |loader_| has buffered. + bool assume_fully_buffered_; + + // This value will be true if this data source can only support streaming. + // i.e. range request is not supported. + bool streaming_; + + // A webframe for loading. + WebKit::WebFrame* frame_; + + // A resource loader for the media resource. + scoped_ptr<BufferedResourceLoader> loader_; + + // Callback method from the pipeline for initialization. + InitializeCB init_cb_; + + // Read parameters received from the Read() method call. Must be accessed + // under |lock_|. + class ReadOperation; + scoped_ptr<ReadOperation> read_op_; + + // This buffer is intermediate, we use it for BufferedResourceLoader to write + // to. And when read in BufferedResourceLoader is done, we copy data from + // this buffer to |read_buffer_|. The reason for an additional copy is that + // we don't own |read_buffer_|. But since the read operation is asynchronous, + // |read_buffer| can be destroyed at any time, so we only copy into + // |read_buffer| in the final step when it is safe. + // Memory is allocated for this member during initialization of this object + // because we want buffer to be passed into BufferedResourceLoader to be + // always non-null. And by initializing this member with a default size we can + // avoid creating zero-sized buffered if the first read has zero size. + scoped_ptr<uint8[]> intermediate_read_buffer_; + int intermediate_read_buffer_size_; + + // The message loop of the render thread. + const scoped_refptr<base::MessageLoopProxy> render_loop_; + + // Protects |stop_signal_received_| and |read_op_|. + base::Lock lock_; + + // Whether we've been told to stop via Abort() or Stop(). + bool stop_signal_received_; + + // This variable is true when the user has requested the video to play at + // least once. + bool media_has_played_; + + // This variable holds the value of the preload attribute for the video + // element. + Preload preload_; + + // Bitrate of the content, 0 if unknown. + int bitrate_; + + // Current playback rate. + float playback_rate_; + + // Buffered byte ranges awaiting set_host() being called to report to host(). + media::Ranges<int64> queued_buffered_byte_ranges_; + + scoped_refptr<media::MediaLog> media_log_; + + DownloadingCB downloading_cb_; + + DISALLOW_COPY_AND_ASSIGN(BufferedDataSource); +}; + +} // namespace content + +#endif // CONTENT_RENDERER_MEDIA_BUFFERED_DATA_SOURCE_H_ |