source_buffer_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_SOURCE_BUFFER_SAMSUNG_H_
#define PPAPI_CPP_SAMSUNG_SOURCE_BUFFER_SAMSUNG_H_

#include "ppapi/c/pp_array_output.h"
#include "ppapi/c/samsung/pp_media_source_samsung.h"
#include "ppapi/cpp/completion_callback.h"
#include "ppapi/cpp/resource.h"
#include "ppapi/cpp/var.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.
///
/// API is similar to one defined in JavaScript's Media Source Extensions
class SourceBuffer_Samsung : public Resource {
 public:
  // Creates an is_null() SourceBuffer object.
  SourceBuffer_Samsung() {}

  // Creates a SourceBuffer from MediaSource_Samsung::AddSource call
  explicit SourceBuffer_Samsung(const Resource& resource);
  explicit SourceBuffer_Samsung(PP_Resource resource);
  explicit SourceBuffer_Samsung(PassRef, PP_Resource resource);

  /// Destructor
  virtual ~SourceBuffer_Samsung() {}

  /// PPB_SourceBuffer_Samsung API

  /// Checks if given source is active i.e. it contains video, audio or
  /// text (subtitle) track being played. The execution may resume from the |callback|.
  int32_t IsSourceActive(const CompletionCallbackWithOutput<PP_Bool> &callback);

  /// Appends data to given buffer.
  /// Execution is confirmed by a call to |callback|.
  int32_t Append(const void* data, uint32_t bytes_to_append, const CompletionCallback& callback);

  /// Aborts given data source
  /// Execution is confirmed by a call to |callback|.
  int32_t Abort(const CompletionCallback& callback);

  /// Sets a time offset (in microseconds) to be applied to subsequent
  /// buffers appended to the given buffer. The execution may resume from the |callback|.
  int32_t SetTimestampOffset(PP_MicrosecondsDelta offset, const CompletionCallback& callback);

  /// Gets offset in microseconds of selected stream. The execution may resume from the |callback|.
  int32_t GetTimestampOffset(const CompletionCallbackWithOutput<PP_MicrosecondsDelta>& callback);

  /// ReadS ranges of buffered media stream. The execution may resume from the |callback|.
  int32_t ReadTimeRanges(const CompletionCallbackWithOutput< std::vector<PP_TimeRange> >& callback);

};

} // namespace pp

#endif // PPAPI_CPP_SAMSUNG_SOURCE_BUFFER_SAMSUNG_H_