media_control_samsung.h

Go to the documentation of this file.

// 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 PPAPI_CPP_SAMSUNG_MEDIA_CONTROL_SAMSUNG_H_
#define PPAPI_CPP_SAMSUNG_MEDIA_CONTROL_SAMSUNG_H_

#include "ppapi/cpp/instance.h"
#include "ppapi/cpp/resource.h"
#include "ppapi/cpp/var.h"
#include "ppapi/c/samsung/pp_media_control_samsung.h"
#include "ppapi/c/samsung/ppp_media_control_samsung.h"

namespace pp {

/// Interface allowing application to receive various events regarding
/// media playback stream/clip (i.e. player state changes, duration update,
/// media time position changes, media errors).
class MediaControl_Samsung {
 public:
  /// Destructor
  virtual ~MediaControl_Samsung();

  /// Method called when controller handling particular stream/clip finish
  /// transition to PLAYING state.
  ///
  /// |timestamp| - current time of media
  virtual void Play(PP_MicrosecondsDelta timestamp) = 0;

  /// Method called when controller handling particular stream finish
  /// transition to PAUSED state.
  virtual void Pause() = 0;

  /// Signals that end of stream has been reached, |error| argument of
  /// PP_MediaError type signals if this is caused by some sort of error.
  virtual void Ended(PP_MediaError error) = 0;

  /// Method called when played media playback time has been changed explicitly.
  virtual void Seeking(PP_MicrosecondsDelta seekTime) = 0;

  /// Method called when played stream duration has been changed.
  /// |duration| is total stream duration in microseconds.
  virtual void DurationChange(PP_MicrosecondsDelta duration) = 0;

  /// Method called periodically in PLAYING to signal advance of media
  /// playback time. Minimal resolution of callback is 0.5s.
  /// |media_times| represents current media time in microseconds from beginning
  /// of the stream/clip.
  virtual void TimeUpdate(PP_MicrosecondsDelta media_time) = 0;

  /// Method called when media playback rate is changed.
  virtual void RateChange(float playback_rate) = 0;

 protected:
  // This object can't be directly created by app.
  // Creates an is_null() MediaControl object.
  MediaControl_Samsung();
};

} // namespace pp

#endif // PPAPI_CPP_SAMSUNG_MEDIA_CONTROL_SAMSUNG_H_