15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef MEDIA_BASE_VIDEO_RENDERER_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define MEDIA_BASE_VIDEO_RENDERER_H_ 72a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/callback.h" 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/memory/ref_counted.h" 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/time/time.h" 119ab5563a3196760eb381d102cbb2bc0f7abc6a50Ben Murdoch#include "media/base/buffering_state.h" 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "media/base/media_export.h" 137dbb3d5cf0c15f500944d211057644d6a2f37371Ben Murdoch#include "media/base/pipeline_status.h" 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 156e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)namespace media { 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class DemuxerStream; 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class VideoDecoder; 19c5cede9ae108bb15f6b7a8aea21c7e1fefa2834cBen Murdoch 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class MEDIA_EXPORT VideoRenderer { 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Used to query the current time or duration of the media. 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) typedef base::Callback<base::TimeDelta()> TimeDeltaCB; 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) VideoRenderer(); 26a3f7b4e666c476898878fa745f637129375cd889Ben Murdoch 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Stops all operations and fires all pending callbacks. 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~VideoRenderer(); 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Initializes a VideoRenderer with |stream|, executing |init_cb| upon 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // completion. 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |statistics_cb| is executed periodically with video rendering stats, such 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // as dropped frames. 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |buffering_state_cb| is executed when video rendering has either run out of 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // data or has enough data to continue playback. 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |ended_cb| is executed when video rendering has reached the end of stream. 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |error_cb| is executed if an error was encountered. 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |get_time_cb| is used to query the current media playback time. 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Initialize(DemuxerStream* stream, 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool low_delay, 462a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const PipelineStatusCB& init_cb, 472a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const StatisticsCB& statistics_cb, 482a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const BufferingStateCB& buffering_state_cb, 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const base::Closure& ended_cb, 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const PipelineStatusCB& error_cb, 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const TimeDeltaCB& get_time_cb) = 0; 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Discards any video data and stops reading from |stream|, executing 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // |callback| when completed. 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Clients should expect |buffering_state_cb| to be called with 572a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // BUFFERING_HAVE_NOTHING while flushing is in progress. 582a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) virtual void Flush(const base::Closure& callback) = 0; 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 602a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Starts playback at |timestamp| by reading from |stream| and decoding and 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // rendering video. 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // 632a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // Only valid to call after a successful Initialize() or Flush(). 642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) virtual void StartPlayingFrom(base::TimeDelta timestamp) = 0; 655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 676e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(VideoRenderer); 686e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)}; 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace media 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // MEDIA_BASE_VIDEO_RENDERER_H_ 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)