media_source_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_SOURCE_SAMSUNG_H_
#define PPAPI_CPP_SAMSUNG_MEDIA_SOURCE_SAMSUNG_H_

#include "ppapi/c/pp_array_output.h"
#include "ppapi/c/samsung/pp_media_source_samsung.h"
#include "ppapi/cpp/resource.h"
#include "ppapi/cpp/var.h"
#include "ppapi/cpp/samsung/media_control_samsung.h"
#include "ppapi/cpp/samsung/source_buffer_samsung.h"
#include "ppapi/cpp/completion_callback.h"

namespace pp {

class InstanceHandle;

/// Interface used by PNaCl application to provide chunks of multimedia data
/// to the platform. Those chunks will be decoded and played by the platform.
///
/// This interface inherits from PPB_MediaControl_Samsung.
///
/// API is similar to one defined in JavaScript's Media Source Extensions
class MediaSource_Samsung : public MediaControl_Samsung, public Resource {
 public:
  // Creates an is_null() MediaControl object.
  MediaSource_Samsung() {}

  /// Cretes MediaSource_Samsung resource for given |instance|
  explicit MediaSource_Samsung(const InstanceHandle& instance);

  /// Destructor
  virtual ~MediaSource_Samsung() {}

  /// PPB_MediaSource_Samsung API

  /// Binds given MediaSource to vide/audio object of given |id| present on
  /// HTML page on which given module is embedded.
  int32_t BindToHTMLPlayer(const Var& id, const CompletionCallback& callback);

  /// Adds source to the media source element. Added source
  /// is container of type |type| encoded using codecs on |codecs| list.
  ///
  /// Returns status - PP_SourceAddStatus and |sourceBuffer| if status is OK.
  int32_t AddSource(const Var& type, const Var& codecs,
      const CompletionCallbackWithOutput<SourceBuffer_Samsung>& callback);

  /// Removes given source.
  int32_t RemoveSource(const SourceBuffer_Samsung& sourceBuffer, const CompletionCallback& callback);

  /// Sets duration in microseconds of currently played stream
  /// duration is given in microseconds
  int32_t SetDuration(PP_MicrosecondsDelta duration, const CompletionCallback& callback);

  /// Gets duration in microseconds of currently played stream
  int32_t GetDuration(const CompletionCallbackWithOutput<PP_MicrosecondsDelta>& callback);

  /// Sets end of stream. |error| argument represents whether it is just end
  /// of the stream (PP_MEDIAERROR_NO_ERROR) or some kind of error occured.
  int32_t SetEndOfStream(PP_SourceEndedStatus error, const CompletionCallback& callback);

  /// Gets a current time of media.
  int32_t GetMediaTime(const CompletionCallbackWithOutput<PP_MicrosecondsDelta>& callback);

  /// Gets a ReadyState of media.
  int32_t GetReadyState(const CompletionCallbackWithOutput<PP_MediaReadyState>& callback);

  /// PPP_MediaSource_Samsung API

  /// Signals error during processing given data source (e.g. decoding error).
  virtual void Error(const SourceBuffer_Samsung& source, PP_SourceError reason) = 0;

  /// Signals activation of given data source.
  virtual void SourceOpen() = 0;

  /// Called when source is still attached to a media element, but endOfStream()
  /// has been called.
  virtual void SourceEnded() = 0;

  /// Signals unattached data source to a media element.
  virtual void SourceClose() = 0;

  /// Signals error during processing given data source (e.g. decoding error).
  virtual void AppendEnd(const SourceBuffer_Samsung& source) = 0;

};

} // namespace pp

#endif // PPAPI_CPP_SAMSUNG_MEDIA_SOURCE_SAMSUNG_H_