media_player.h

Go to the documentation of this file.

// Copyright (c) 2016 Samsung Electronics. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef NACL_PLAYER_MEDIA_PLAYER_H_
#define NACL_PLAYER_MEDIA_PLAYER_H_

#include <functional>
#include <memory>
#include <string>
#include <vector>

#include "nacl_player/common.h"
#include "nacl_player/error_codes.h"
#include "nacl_player/media_common.h"

namespace Samsung {
namespace NaClPlayer {

class BufferingListener;
class DRMListener;
class MediaDataSource;
class MediaEventsListener;
class SubtitleListener;

class MediaPlayer {
 public:
  enum BindToDisplayMode {BindPlayerToDisplay, DoNotBindPlayerToDisplay};

  enum MediaPlayerMode {
    MediaPlayerModeDefault,

    MediaPlayerModeD2TV,
  };

  enum MediaPlayerDisplayMode {
    MediaPlayerDisplayModeStretch = 0,

    MediaPlayerDisplayModeLetterbox = 1,
  };

  enum MediaPlayerVr360Mode {
    // When this mode is set video will be displayed normally.
    MediaPlayerVr360ModeOff = 0,
    // When this mode is set video will be displayed in Vr mode.
    MediaPlayerVr360ModeOn = 1
  };

  MediaPlayer(BindToDisplayMode = BindPlayerToDisplay,
              MediaPlayerMode = MediaPlayerModeDefault);
  MediaPlayer(const MediaPlayer& other);
  MediaPlayer& operator=(const MediaPlayer& other);

  ~MediaPlayer();

  /* Setting listeners */

  void SetMediaEventsListener(MediaEventsListener* listener);

  void SetMediaEventsListener(std::shared_ptr<MediaEventsListener> listener);

  void SetSubtitleListener(SubtitleListener* listener);


  void SetSubtitleListener(std::shared_ptr<SubtitleListener> listener);

  void SetBufferingListener(BufferingListener* listener);

  void SetBufferingListener(std::shared_ptr<BufferingListener> listner);

  void SetDRMListener(DRMListener* listener);

  void SetDRMListener(std::shared_ptr<DRMListener> listener);

  bool BindToDisplay();

  int32_t AttachDataSource(
      const MediaDataSource& data_source,
      const std::function<void(int32_t)>& callback);

  int32_t AttachDataSource(
      const MediaDataSource& data_source);

  /* Playback control */

  int32_t Play(const std::function<void(int32_t)>& callback);

  int32_t Play();

  int32_t Pause(const std::function<void(int32_t)>& callback);

  int32_t Pause();

  int32_t Stop(const std::function<void(int32_t)>& callback);

  int32_t Stop();

  int32_t Seek(TimeTicks time,
               const std::function<void(int32_t)>& callback);

  int32_t Seek(TimeTicks time);

  int32_t SetPlaybackRate(double rate,
                          const std::function<void(int32_t)>& callback);

  int32_t SetPlaybackRate(double rate);

  /* Playback time info */

  int32_t GetDuration(
      const std::function<void(int32_t, TimeDelta)>& callback);

  int32_t GetDuration(TimeDelta& duration);

  int32_t GetCurrentTime(
      const std::function<void(int32_t, TimeTicks)>& callback);

  int32_t GetCurrentTime(TimeTicks& current_time);

  /* Playback state info */

  int32_t GetPlayerState(
      const std::function<void(int32_t, MediaPlayerState)>& callback);

  int32_t GetPlayerState(MediaPlayerState&);

  /* Tracks info */

  int32_t GetCurrentVideoTrackInfo(
      const std::function<void(int32_t, const VideoTrackInfo&)>& callback);

  int32_t GetCurrentVideoTrackInfo(VideoTrackInfo&);

  typedef std::vector<VideoTrackInfo> VideoTracksList;

  int32_t GetVideoTracksList(
      const std::function<void(int32_t, const VideoTracksList&)>& callback);

  int32_t GetVideoTracksList(VideoTracksList&);

  int32_t GetCurrentAudioTrackInfo(
      const std::function<void(int32_t, const AudioTrackInfo&)>& callback);

  int32_t GetCurrentAudioTrackInfo(AudioTrackInfo&);

  typedef std::vector<AudioTrackInfo> AudioTracksList;

  int32_t GetAudioTracksList(
      const std::function<void(int32_t, const AudioTracksList&)>& callback);

  int32_t GetAudioTracksList(AudioTracksList&);

  int32_t GetCurrentTextTrackInfo(
      const std::function<void(int32_t, const TextTrackInfo&)>& callback);

  int32_t GetCurrentTextTrackInfo(TextTrackInfo&);

  typedef std::vector<TextTrackInfo> TextTracksList;

  int32_t GetTextTracksList(
      const std::function<void(int32_t, const TextTracksList&)>& callback);

  int32_t GetTextTracksList(TextTracksList&);

  int32_t SelectTrack(
      ElementaryStreamType track_type,
      uint32_t track_index,
      const std::function<void(int32_t)>& callback);

  int32_t SelectTrack(ElementaryStreamType track_type, uint32_t track_index);

  /* Subtitles control */

  int32_t AddExternalSubtitles(
      const std::string& file_path,
      const std::string& encoding,
      const std::function<void(int32_t, const TextTrackInfo&)>& callback);

  int32_t AddExternalSubtitles(
      const std::string& file_path,
      const std::string& encoding,
      TextTrackInfo&);

  int32_t SetSubtitlesDelay(
      TimeDelta delay,
      const std::function<void(int32_t)>& callback);

  int32_t SetSubtitlesDelay(TimeDelta delay);

  /* Other - player control */

  int32_t SetDisplayRect(
      const Rect& rect,
      const std::function<void(int32_t)>& callback);

  int32_t SetDisplayRect(const Rect& rect);

  int32_t SetDisplayMode(
      MediaPlayerDisplayMode display_mode,
      const std::function<void(int32_t)>& callback);

  /* Vr360 Control */

  int32_t SetVr360Mode(
      MediaPlayerVr360Mode display_mode,
         const std::function<void(int32_t)>& callback);

  int32_t SetVr360Mode(MediaPlayerVr360Mode display_mode);

  int32_t SetVr360Rotation(
      float horizontal_angle,
      float vertical_angle,
         const std::function<void(int32_t)>& callback);

  int32_t SetVr360Rotation(
                 float horizontal_angle,
             float vertical_angle);

  int32_t SetVr360ZoomLevel(
      uint32_t zoom_level,
         const std::function<void(int32_t)>& callback);

  int32_t SetVr360ZoomLevel(
      uint32_t zoom_level);

  int32_t SetDisplayMode(MediaPlayerDisplayMode display_mode);

  /* DRM Related */

  int32_t SetDRMSpecificData(
      DRMType drm_type,
      DRMOperation drm_operation,
      uint32_t drm_data_size,
      const void* drm_data,
      const std::function<void(int32_t)>& callback);

  int32_t SetDRMSpecificData(
      DRMType drm_type,
      DRMOperation drm_operation,
      uint32_t drm_data_size,
      const void* drm_data);

 private:
  class Impl;
  std::unique_ptr<Impl> pimpl_;
};

}  // namespace NaClPlayer
}  // namespace Samsung

#endif  // NACL_PLAYER_MEDIA_PLAYER_H_