blob: 9e3a38c0e472bddf01bd1dc4f419b647668c2927 [file] [log] [blame]
// 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 MEDIA_BLINK_MULTIBUFFER_DATA_SOURCE_H_
#define MEDIA_BLINK_MULTIBUFFER_DATA_SOURCE_H_
#include <stdint.h>
#include <memory>
#include <string>
#include <vector>
#include "base/callback.h"
#include "base/macros.h"
#include "base/memory/weak_ptr.h"
#include "base/synchronization/lock.h"
#include "media/base/data_source.h"
#include "media/base/ranges.h"
#include "media/blink/media_blink_export.h"
#include "media/blink/url_index.h"
#include "url/gurl.h"
namespace base {
class SingleThreadTaskRunner;
}
namespace media {
class BufferedDataSourceHost;
class MediaLog;
class MultiBufferReader;
// A data source capable of loading URLs and buffering the data using an
// in-memory sliding window.
//
// MultibufferDataSource must be created and destroyed on the thread associated
// with the |task_runner| passed in the constructor.
class MEDIA_BLINK_EXPORT MultibufferDataSource : public DataSource {
public:
typedef base::Callback<void(bool)> DownloadingCB;
// Used to specify video preload states. They are "hints" to the browser about
// how aggressively the browser should load and buffer data.
// Please see the HTML5 spec for the descriptions of these values:
// http://www.w3.org/TR/html5/video.html#attr-media-preload
//
// Enum values must match the values in blink::WebMediaPlayer::Preload and
// there will be assertions at compile time if they do not match.
enum Preload {
NONE,
METADATA,
AUTO,
};
// |url| and |cors_mode| are passed to the object. Buffered byte range changes
// will be reported to |host|. |downloading_cb| will be called whenever the
// downloading/paused state of the source changes.
MultibufferDataSource(
const scoped_refptr<base::SingleThreadTaskRunner>& task_runner,
scoped_refptr<UrlData> url_data,
MediaLog* media_log,
BufferedDataSourceHost* host,
const DownloadingCB& downloading_cb);
~MultibufferDataSource() override;
// Executes |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 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();
// https://html.spec.whatwg.org/#cors-cross-origin
// This must be called after the response arrives.
bool IsCorsCrossOrigin() const;
// Returns true if the response includes an Access-Control-Allow-Origin
// header (that is not "null").
bool HasAccessControl() const;
// Returns the CorsMode of the underlying UrlData.
UrlData::CorsMode cors_mode() const;
// Notifies changes in playback state for controlling media buffering
// behavior.
void MediaPlaybackRateChanged(double playback_rate);
void MediaIsPlaying();
bool media_has_played() const;
// Returns true if the resource is local.
bool AssumeFullyBuffered() const override;
// Cancels any open network connections once reaching the deferred state. If
// |always_cancel| is false this is done only for preload=metadata, non-
// streaming resources that have not started playback. If |always_cancel| is
// true, all resource types will have their connections canceled. If already
// deferred, connections will be immediately closed.
void OnBufferingHaveEnough(bool always_cancel);
int64_t GetMemoryUsage() override;
GURL GetUrlAfterRedirects() const;
// DataSource implementation.
// Called from demuxer thread.
void Stop() override;
void Abort() override;
void Read(int64_t position,
int size,
uint8_t* data,
const DataSource::ReadCB& read_cb) override;
bool GetSize(int64_t* size_out) override;
bool IsStreaming() override;
void SetBitrate(int bitrate) override;
void SetIsClientAudioElement(bool is_client_audio_element) {
is_client_audio_element_ = is_client_audio_element;
}
protected:
void OnRedirect(const scoped_refptr<UrlData>& destination);
// A factory method to create a BufferedResourceLoader based on the read
// parameters.
void CreateResourceLoader(int64_t first_byte_position,
int64_t last_byte_position);
// Same as above, but called with |lock_| held.
void CreateResourceLoader_Locked(int64_t first_byte_position,
int64_t last_byte_position);
// Set reader_ while asserting proper locking.
void SetReader(MultiBufferReader* reader);
friend class MultibufferDataSourceTest;
// Task posted to perform actual reading on the render thread.
void ReadTask();
// After a read, this function updates the read position.
// It's in a separate function because the read itself can either happen
// in ReadTask() or in Read(), both of which call this function afterwards.
void SeekTask_Locked();
// Lock |lock_| lock and call SeekTask_Locked().
// Called with PostTask when read() complets on the demuxer thread.
void SeekTask();
// Cancels oustanding callbacks and sets |stop_signal_received_|. Safe to call
// from any thread.
void StopInternal_Locked();
// Stops |reader_| if present. Used by Abort() and Stop().
void StopLoader();
// Tells |reader_| the bitrate of the media.
void SetBitrateTask(int bitrate);
// BufferedResourceLoader::Start() callback for initial load.
void StartCallback();
// Check if we've moved to a new url and update has_signgle_origin_.
void UpdateSingleOrigin();
// MultiBufferReader progress callback.
void ProgressCallback(int64_t begin, int64_t end);
// Update progress based on current reader state.
void UpdateProgress();
// call downloading_cb_ if needed.
// If |force_loading| is true, we call downloading_cb_ and tell it that
// we are currently loading, regardless of what reader_->IsLoading() says.
// Caller must hold |lock_|.
void UpdateLoadingState_Locked(bool force_loading);
// Update |reader_|'s preload and buffer settings.
void UpdateBufferSizes();
// 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_t total_bytes_;
// Bytes we've read but not reported to the url_data yet.
// SeekTask handles the reporting.
int64_t bytes_read_ = 0;
// Places we might want to seek to. After each read we add another
// location here, and when SeekTask() is called, it picks the best
// position and then clears it out.
std::vector<int64_t> seek_positions_;
// This value will be true if this data source can only support streaming.
// i.e. range request is not supported.
bool streaming_;
// This is the loading state that we last reported to our owner through
// |downloading_cb_|.
bool loading_;
// True if a failure has occured.
bool failed_;
// The task runner of the render thread.
const scoped_refptr<base::SingleThreadTaskRunner> render_task_runner_;
// URL of the resource requested.
scoped_refptr<UrlData> url_data_;
// A resource reader for the media resource.
std::unique_ptr<MultiBufferReader> reader_;
// 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;
std::unique_ptr<ReadOperation> read_op_;
// Protects |stop_signal_received_|, |read_op_|, |reader_| and |total_bytes_|.
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_;
// As we follow redirects, we set this variable to false if redirects
// go between different origins.
bool single_origin_;
// Close the connection when we have enough data.
bool cancel_on_defer_;
// 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.
double playback_rate_;
MediaLog* media_log_;
bool is_client_audio_element_ = false;
int buffer_size_update_counter_;
// Host object to report buffered byte range changes to.
BufferedDataSourceHost* host_;
DownloadingCB downloading_cb_;
// Disallow rebinding WeakReference ownership to a different thread by keeping
// a persistent reference. This avoids problems with the thread-safety of
// reaching into this class from multiple threads to attain a WeakPtr.
base::WeakPtr<MultibufferDataSource> weak_ptr_;
base::WeakPtrFactory<MultibufferDataSource> weak_factory_;
DISALLOW_COPY_AND_ASSIGN(MultibufferDataSource);
};
} // namespace media
#endif // MEDIA_BLINK_MULTIBUFFER_DATA_SOURCE_H_