stream_parser_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_STREAM_PARSER_SAMSUNG_H_
#define PPAPI_CPP_SAMSUNG_STREAM_PARSER_SAMSUNG_H_

#include "ppapi/cpp/instance.h"
#include "ppapi/cpp/var.h"
#include "ppapi/cpp/dev/buffer_dev.h"
#include "ppapi/c/samsung/pp_media_common_samsung.h"
#include "ppapi/c/samsung/pp_stream_parser_samsung.h"

namespace pp {

class InstanceHandle;

/// Interface allowing NaCl applicaton to implement its own stream demuxer
class StreamParser_Samsung {
 public:

  /// Creates StreamParser_Samsung associated with given |instance|
  explicit StreamParser_Samsung(Instance* instance);

  /// Destructor
  virtual ~StreamParser_Samsung() {}

  // PPB_StreamParser_Samsung API

  /// Used for registering stream parser in Browser. |type| is a MIME type
  /// of stream, to witch parser be registered.
  bool RegisterParser(const char* type);

  /// Indicates completion of parser initialization. |stream_id| it's a id
  /// of stream, that Browser request to parse, if Borwser request parsing more
  /// that one stream of that type, it's allows to recognize that stream.
  /// On success, |result| is set to PP_OK, or PP_FALSE if an error occurred.
  /// If initialization is success, the |duration| contains stream duration
  /// (in microseconds).
  bool Init(int32_t stream_id, bool result, PP_MicrosecondsDelta duration);

  /// Indicates when new audio configuration have been parsed,
  /// |config| it's a configuration struct
  bool NewAudioConfig(int32_t stream_id, const PP_SP_AudioDecoderConfig&);

  /// Indicates when new video configuration have been parsed,
  /// |config| it's a configuration struct
  bool NewVideoConfig(int32_t stream_id, const PP_SP_VideoDecoderConfig&);

  /// New stream buffers have been parsed, |type| indicates type of track it's
  /// enum defined in pp_stream_parser_samsung.h, |track_id| it's id of track,
  /// useful if is more that one track of that type
  bool NewBuffers(int32_t stream_id, PP_StreamType type,
      int32_t track_id, PP_Resource buffer, uint32_t frames_count,
      const struct PP_Frames frames[]);

  /// Signals the beginning od a new media segment, |timestamp| the earliest
  /// timestamp of all the streams in the segment
  void NewMediaSegment(int32_t stream_id, PP_MicrosecondsDelta timestamp);

  /// Signals end of segment for given |stream_id|
  void EndOfSegment(int32_t stream_id);

  /// A new potentialy encrypted stream has been parsed. |type| describes type
  /// of the initialization data |init_data| associated with the stream.
  bool NeedKey(int32_t stream_id, const Var& type,
      uint32_t init_data_size, uint8_t* init_data);

  // PPP_StreamParser_Samsung API

  /// Initialize the parser. Must be called before any data is passed to Parse().
  /// |stream_type| describe type of stream to parse (should be one of type,
  /// passed in PPB RegisterParser). |stream_id| it's a id of stream to parse.
  virtual bool Init(int32_t stream_id) = 0;

  /// Called when a seek occurs. This flushes the current parser state and puts
  /// the parser in a state where it can receive data for the new seek point.
  virtual void Flush(int32_t stream_id) = 0;

  /// Called when there is new data to parse. |data| contains stream to parse.
  ///
  /// Return PP_OK if the parse succeds
  virtual bool Parse(int32_t stream_id, Buffer_Dev data) = 0;

  /// Called when a parser must be "closed". Used for flushes the current parser
  // state, and configs.
  virtual void Close(int32_t stream_id) = 0;

 private:
  Instance* instance_;
  PP_Bool registered_;
};

} // namespace pp

#endif // PPAPI_CPP_SAMSUNG_STREAM_PARSER_SAMSUNG_H_