/**
* @class dash::mpd::IMPD
* @brief This interface is needed for accessing the attributes and elements of the MPD element
* as specified in ISO/IEC 23009-1, Part 1, 2012, section 5.3.1.2, table 3
* @details A Media Presentation as described in the MPD consists of (all sections refer to ISO/IEC 23009-1, Part 1, 2012)
*
* - A sequence of one or more Periods as described in section 5.3.2.
*
- Each Period contains one or more Adaptation Sets as described in 5.3.3.
* In case an Adaptation Set contains multiple media content components, then each media content component is described individually
* as defined in 5.3.4.
*
- Each Adaptation Set contains one or more Representations as described in 5.3.5.
*
- A Representation may contain one or more Sub-Representations as described in 5.3.6.
*
- Adaptation Sets, Representations and Sub-Representations share common attributes and elements that are described in 5.3.7.
*
- Each Period may contain one or more Subsets that restrict combination of Adaptation Sets for presentation. Subsets are described in 5.3.8.
*
- Each Representation consists of one or more Segments described in 6. Segment Information is introduced in 5.3.9.
* Segments contain media data and/or metadata to access, decode and present the included media content.
* Representations may also include Sub-Representations as defined in 5.3.6 to describe and extract partial information from a Representation.
*
- Each Segment consists of one or more Subsegments. Subsegments are described in 6.2.3.2.
*
* @see dash::mpd::IMPDElement dash::mpd::IProgramInformation dash::mpd::IBaseUrl dash::mpd::IPeriod dash::mpd::IMetrics
* dash::mpd::IRepresentationBase
*
* @author bitmovin Softwareentwicklung OG \n
* Email: libdash-dev@vicky.bitmovin.net
* @version 2.1
* @date 2013
* @copyright bitmovin Softwareentwicklung OG, All Rights Reserved \n\n
* This source code and its use and distribution, is subject to the terms
* and conditions of the applicable license agreement.
*/
#ifndef IMPD_H_
#define IMPD_H_
#include "config.h"
#include "IMPDElement.h"
#include "IProgramInformation.h"
#include "IBaseUrl.h"
#include "IPeriod.h"
#include "IMetrics.h"
#include "IDASHMetrics.h"
namespace dash
{
namespace mpd
{
class IMPD : public virtual IMPDElement, public dash::metrics::IDASHMetrics
{
public:
virtual ~IMPD(){}
/**
* Returns a reference to a vector of pointers to dash::mpd::IProgramInformation objects that specify descriptive information about the program.\n
* For more details refer to the description in section 5.7. of ISO/IEC 23009-1, Part 1, 2012.
* @return a reference to a vector of pointers to dash::mpd::IProgramInformation objects
*/
virtual const std::vector& GetProgramInformations () const = 0;
/**
* Returns a reference to a vector of pointers to dash::mpd::IBaseUrl objects that specify Base URLs that can be used for reference resolution
* and alternative URL selection. \n
* For more details refer to the description in section 5.6. of ISO/IEC 23009-1, Part 1, 2012.
* @return a reference to a vector of pointers to dash::mpd::IBaseUrl objects
*/
virtual const std::vector& GetBaseUrls () const = 0;
/**
* Returns a reference to a vector of strings that specify locations at which the MPD is available.
* @return a reference to a vector of strings
*/
virtual const std::vector& GetLocations () const = 0;
/**
* Returns a reference to a vector of pointers to dash::mpd::IPeriod objects that specify the information of a Period.\n
* For more details refer to the description in section 5.3.2. of ISO/IEC 23009-1, Part 1, 2012.
* @return a reference to a vector of pointers to dash::mpd::IPeriod objects
*/
virtual const std::vector& GetPeriods () const = 0;
/**
* Returns a reference to a vector of pointers to dash::mpd::IMetrics objects that specify the DASH Metrics.\n
* For more details see section 5.9. of ISO/IEC 23009-1, Part 1, 2012.
* @return a reference to a vector of pointers to dash::mpd::IPeriod objects
*/
virtual const std::vector& GetMetrics () const = 0;
/**
* Returns a reference to a string that specifies an identifier for the Media Presentation. It is recommended to use an identifier that is unique within
* the scope in which the Media Presentation is published. \n
* If not specified, no MPD-internal identifier is provided. However, for example the URL to the MPD may be used as an identifier for the Media Presentation.
* @return a reference to a string
*/
virtual const std::string& GetId () const = 0;
/**
* Returns a reference to a vector of strings that specifies a list of Media Presentation profiles as described in section 8 of ISO/IEC 23009-1, Part 1, 2012.\n
* The contents of this attribute shall conform to either the \c pro-simple or \c pro-fancy productions of RFC6381, Section 4.5, without the enclosing \c DQUOTE characters,
* i.e. including only the \c unencodedv or \c encodedv elements respectively.
* As profile identifier the URI defined for the conforming Media Presentation profiles as described in section 8 shall be used.
* @return a reference to a vector of pointers to dash::mpd::IProgramInformation objects
*/
virtual const std::vector& GetProfiles () const = 0;
/**
* Returns a reference to a string that specifies whether the Media Presentation Description may be updated (\@type=\"dynamic\") or not (\@type=\"static\").\n
* \b NOTE: Static MPDs are typically used for On-Demand services, whereas dynamic MPDs are used for live services.
* @return a reference to a string
*/
virtual const std::string& GetType () const = 0;
/**
* Returns a reference to a string that specifies
*
* - the anchor for the computation of the earliest availability time (in UTC) for any Segment in the Media Presentation if \@type=\"dynamic\".
*
- the Segment availability start time for all Segments referred to in this MPD if \@type=\"static\".
*
* If not present, all Segments described in the MPD shall become available at the time the MPD becomes available.\n
* For \@type=\"dynamic\" this attribute shall be present.
* @return a reference to a string
*/
virtual const std::string& GetAvailabilityStarttime () const = 0;
/**
* Returns a reference to a string that specifies the latest Segment availability end time for any Segment in the Media Presentation. When not present, the value is unknown.
* @return a reference to a string
*/
virtual const std::string& GetAvailabilityEndtime () const = 0;
/**
* Returns a reference to a string that specifies the duration of the entire Media Presentation. If the attribute is not present, the duration of the Media Presentation is unknown.
* In this case the attribute MPD\@minimumUpdatePeriod shall be present.\n
* This attribute shall be present when the attribute MPD\@minimumUpdatePeriod is not present.
* @return a reference to a string
*/
virtual const std::string& GetMediaPresentationDuration () const = 0;
/**
* Returns a reference to a string that specifies the smallest period between potential changes to the MPD.
* This can be useful to control the frequency at which a client checks for updates. \n
* If this attribute is not present it indicates that the MPD does not change.
* If MPD\@type is \c \"static\", \c \@minimumUpdatePeriod shall not be present.\n
* Details on the use of the value of this attribute are specified in section 5.4. of ISO/IEC 23009-1, Part 1, 2012.
* @return a reference to a string
*/
virtual const std::string& GetMinimumUpdatePeriod () const = 0;
/**
* Returns a reference to a string that specifies a common duration used in the definition of the Representation data rate
* (see \c \@bandwidth attribute in section 5.3.5.2 of ISO/IEC 23009-1, Part 1, 2012).
* @return a reference to a string
*/
virtual const std::string& GetMinBufferTime () const = 0;
/**
* Returns a reference to a string that specifies the duration of the time shifting buffer that is guaranteed to be available for a Media Presentation
* with type \c \"dynamic\". When not present, the value is infinite. This value of the attribute is undefined if the type attribute is equal to \c \"static\".
* @return a reference to a string
*/
virtual const std::string& GetTimeShiftBufferDepth () const = 0;
/**
* Returns a reference to a string that specifies
*
* - when \c \@type is \c \"dynamic\", a fixed delay offset in time from the presentation time of each access unit that is suggested to be used for presentation of each access unit.\n
For more details refer to 7.2.1. \n
When not specified, then no value is provided and the client is expected to choose a suitable value.
- when \c \@type is \c \"static\" the value of the attribute is undefined and may be ignored.
* @return a reference to a string
*/
virtual const std::string& GetSuggestedPresentationDelay () const = 0;
/**
* Returns a reference to a string that specifies the maximum duration of any Segment in any Representation in the Media Presentation,
* i.e. documented in this MPD and any future update of the MPD. If not present, then the maximum Segment duration shall be the maximum duration of any Segment documented in this MPD.
* @return a reference to a string
*/
virtual const std::string& GetMaxSegmentDuration () const = 0;
/**
* Returns a reference to a string that specifies the maximum duration of any Media Subsegment in any Representation in the Media Presentation.
* If not present, the same value as for the maximum Segment duration is implied.
* @return a reference to a string
*/
virtual const std::string& GetMaxSubsegmentDuration () const = 0;
/**
* Returns a pointer to a dash::mpd::IBaseUrl that specifies the absolute path to the MPD file. \n
* This absolute path is needed if there is no BaseURL specified and all other BaseURLs are relative.
* @return a pointer to a dash::mpd::IBaseUrl
*/
virtual IBaseUrl* GetMPDPathBaseUrl () const = 0;
/**
* Returns the UTC time in seconds when the MPD was fetched.\n
* It is up to the client to check that this value has been set accordingly. \n
* See SetFetchTime() for further details.
* @return an unsigned integer
*/
virtual uint32_t GetFetchTime () const = 0;
};
}
}
#endif /* IMPD_H_ */