media_segment_sequence.h

Go to the documentation of this file.

// ----------------------------------------------------------------------------
//
// Copyright (c) 2016, Samsung Electronics Co., Ltd
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to
// deal in the Software without restriction, including without limitation the
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
// sell copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM
// , OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.
//
// @author Adam Bujalski
//
// ----------------------------------------------------------------------------

#ifndef SRC_PLAYER_ES_DASH_PLAYER_DASH_MEDIA_SEGMENT_SEQUENCE_H_
#define SRC_PLAYER_ES_DASH_PLAYER_DASH_MEDIA_SEGMENT_SEQUENCE_H_

#include <memory>
#include <vector>


namespace dash {
namespace mpd {
class ISegment;
}
}

class SequenceIterator;

class MediaSegmentSequence {
 public:
  static constexpr double kInvalidSegmentDuration = -1.0;
  static constexpr double kInvalidSegmentTimestamp = -1.0;

  virtual ~MediaSegmentSequence();

  class Iterator {
   public:
    Iterator();

    explicit Iterator(std::unique_ptr<SequenceIterator>&&);

    Iterator(const Iterator& other);

    Iterator(Iterator&& other);

    ~Iterator();

    Iterator& operator=(const Iterator& other);

    Iterator& operator=(Iterator&& other);

    Iterator& operator++();

    Iterator operator++(int);

    Iterator& operator--();

    Iterator operator--(int);

    bool operator==(const Iterator&) const;

    bool operator!=(const Iterator&) const;


    std::unique_ptr<dash::mpd::ISegment> operator*() const;

    double SegmentDuration(const MediaSegmentSequence*) const;

    double SegmentTimestamp(const MediaSegmentSequence*) const;

   private:
    std::unique_ptr<SequenceIterator> pimpl_;
  };

  virtual Iterator Begin() const = 0;

  virtual Iterator End() const = 0;

  // TODO(samsung) use units from nacl-player
  virtual Iterator MediaSegmentForTime(double time) const = 0;

  virtual std::unique_ptr<dash::mpd::ISegment> GetInitSegment() const = 0;

  virtual std::unique_ptr<dash::mpd::ISegment> GetBitstreamSwitchingSegment()
      const = 0;

  virtual std::unique_ptr<dash::mpd::ISegment> GetRepresentationIndexSegment()
      const = 0;

  virtual std::unique_ptr<dash::mpd::ISegment> GetIndexSegment() const = 0;

  virtual double AverageSegmentDuration() const = 0;

  virtual double SegmentDuration(const Iterator& it) const;

  virtual double SegmentTimestamp(const Iterator& it) const;
};

bool DownloadSegment(dash::mpd::ISegment* seg, std::vector<uint8_t>* data);

inline
bool DownloadSegment(std::unique_ptr<dash::mpd::ISegment> seg,
    std::vector<uint8_t>* data) {
  return DownloadSegment(seg.get(), data);
}

#endif  // SRC_PLAYER_ES_DASH_PLAYER_DASH_MEDIA_SEGMENT_SEQUENCE_H_