elementary_media_stream_source.h

Go to the documentation of this file.

// Copyright 2020 Samsung Electronics
// TizenTV Emscripten extensions are available under two separate licenses, the
// MIT license and the University of Illinois/NCSA Open Source License.  Both
// these licenses can be found in the LICENSE file.

#ifndef INCLUDE_SAMSUNG_WASM_ELEMENTARY_MEDIA_STREAM_SOURCE_H_
#define INCLUDE_SAMSUNG_WASM_ELEMENTARY_MEDIA_STREAM_SOURCE_H_

#include <cstdlib>
#include <functional>
#include <memory>
#include <string>

#include "samsung/wasm/common.h"
#include "samsung/wasm/elementary_media_track.h"
#include "samsung/wasm/emss_version_info.h"

namespace samsung {

namespace html {
class HTMLMediaElement;
}  // namespace html

namespace wasm {

class ElementaryMediaStreamSourceListener;
struct ElementaryAudioTrackConfig;
struct ElementaryVideoTrackConfig;


class ElementaryMediaStreamSource final {
 public:
  enum class Mode {
    kNormal,

    kLowLatency,

    kVideoTexture
  };

  enum class LatencyMode {
    kNormal,

    kLow,

    kUltraLow,
  };

  enum class RenderingMode {
    kMediaElement,

    kVideoTexture,
  };

  enum class ReadyState {
    kDetached,

    kClosed,

    kOpenPending,

    kOpen,

    kEnded
  };

  explicit ElementaryMediaStreamSource(Mode mode = Mode::kNormal);

  ElementaryMediaStreamSource(LatencyMode latency_mode,
                              RenderingMode rendering_mode);
  ElementaryMediaStreamSource(const ElementaryMediaStreamSource&) = delete;
  ElementaryMediaStreamSource(ElementaryMediaStreamSource&&);
  ElementaryMediaStreamSource& operator=(const ElementaryMediaStreamSource&) =
      delete;
  ElementaryMediaStreamSource& operator=(ElementaryMediaStreamSource&&);
  ~ElementaryMediaStreamSource();

  bool IsValid() const;

  Result<ElementaryMediaTrack> AddTrack(const ElementaryAudioTrackConfig&);

  Result<void> AddTrack(
      const ElementaryAudioTrackConfig&,
      std::function<void(OperationResult, ElementaryMediaTrack)>
          on_finished_callback);

  Result<ElementaryMediaTrack> AddTrack(const ElementaryVideoTrackConfig&);

  Result<void> AddTrack(
      const ElementaryVideoTrackConfig&,
      std::function<void(OperationResult, ElementaryMediaTrack)>
          on_finished_callback);

  Result<void> RemoveTrack(const ElementaryMediaTrack&);

  Result<void> Flush();

  Result<void> Close(std::function<void(OperationResult)> on_finished_callback);

  Result<void> Open(std::function<void(OperationResult)> on_finished_callback);

  Result<Seconds> GetDuration() const;

  Result<void> SetDuration(Seconds new_duration);

  Result<Mode> GetMode() const;

  Result<LatencyMode> GetLatencyMode() const;

  Result<RenderingMode> GetRenderingMode() const;

  Result<ReadyState> GetReadyState() const;

  Result<void> SetListener(ElementaryMediaStreamSourceListener* listener);

  const char* GetURL() const;

 private:
  explicit ElementaryMediaStreamSource(int handle, bool is_low_latency);
  std::function<void(OperationResult, int32_t handle)> GetOnAddTrackDoneCb(
      ElementaryMediaTrack::TrackType type,
      std::function<void(OperationResult, ElementaryMediaTrack)>
          on_finished_callback);
  void SetHTMLMediaElement(html::HTMLMediaElement*);
  OperationResult SetListenerInternal(
      ElementaryMediaStreamSourceListener* listener);

  int handle_;
  html::HTMLMediaElement* html_media_element_;
  ElementaryMediaStreamSourceListener* listener_;
  std::unique_ptr<char, decltype(&std::free)> url_;
  bool use_session_id_emulation_;
  EmssVersionInfo version_info_;

  friend class html::HTMLMediaElement;
};

}  // namespace wasm
}  // namespace samsung

#endif  // INCLUDE_SAMSUNG_WASM_ELEMENTARY_MEDIA_STREAM_SOURCE_H_