1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
/**
* @class dash::mpd::ISegmentURL
* @brief This interface is needed for accessing the attributes and elements of the <tt><b>SegmentURL</b></tt> element
* as specified in <em>ISO/IEC 23009-1, Part 1, 2012</em>, section 5.3.9.3.2, table 14
* @details Each Segment URL may contain the Media Segment URL and possibly a byte range. The Segment URL element may also contain an Index Segment.
* @see dash::mpd::ISegment dash::mpd::IMPDElement
*
* @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 ISEGMENTURL_H_
#define ISEGMENTURL_H_
#include "config.h"
#include "ISegment.h"
#include "IBaseUrl.h"
#include "IMPDElement.h"
namespace dash
{
namespace mpd
{
class ISegmentURL : public virtual IMPDElement
{
public:
virtual ~ISegmentURL(){}
/**
* Returns a reference to a string that in combination with the \c \@mediaRange attribute specifies the HTTP-URL for the Media Segment.\n
* It shall be formated as an \c <absolute-URI> according to RFC 3986, Clause 4.3, with a fixed scheme of \"http\" or \"https\" or
* as a \c <relative-ref> according to RFC 3986, Clause 4.2.\n
* If not present, then any <tt><b>BaseURL</b></tt> element is mapped to the \c \@media attribute and the range attribute shall be present.
* @return a reference to a string
*/
virtual const std::string& GetMediaURI () const = 0;
/**
* Returns a reference to a string that specifies the byte range within the resource identified by the \c \@media corresponding to the Media Segment.
* The byte range shall be expressed and formatted as a \c byte-range-spec as defined in RFC 2616, Clause 14.35.1.
* It is restricted to a single expression identifying a contiguous range of bytes.\n
* If not present, the Media Segment is the entire resource referenced by the \c \@media attribute.
* @return a reference to a string
*/
virtual const std::string& GetMediaRange () const = 0;
/**
* Returns a reference to a string that in combination with the \c \@indexRange attribute specifies the HTTP-URL for the Index Segment.
* It shall be formated as an \c <absolute-URI> according to RFC 3986, Clause 4.3, with a fixed scheme of \"http\" or \"https\" or
* as a \c <relative-ref> according to RFC 3986, Clause 4.2. \n
* If not present and the \c \@indexRange not present either, then no Index Segment information is provided for this Media Segment.\n
* If not present and the \c \@indexRange present, then the \c \@media attribute is mapped to the \c \@index. If the \c \@media attribute is not present either,
* then any <tt><b>BaseURL</b></tt> element is mapped to the \c \@index attribute and the \c \@indexRange attribute shall be present.
* @return a reference to a string
*/
virtual const std::string& GetIndexURI () const = 0;
/**
* Returns a reference to a string that specifies the byte range within the resource identified by the \c \@index corresponding to the Index Segment.
* If \c \@index is not present, it specifies the byte range of the Segment Index in Media Segment.\n
* The byte range shall be expressed and formatted as a \c byte-range-spec as defined in RFC 2616, Clause 14.35.1. It is restricted to a single
* expression identifying a contiguous range of bytes. \n
* If not present, the Index Segment is the entire resource referenced by the \c \@index attribute.
* @return a reference to a string
*/
virtual const std::string& GetIndexRange () const = 0;
virtual uint64_t GetActualRate () = 0;
/**
* Returns a pointer to a dash::mpd::ISegment object which represents a media segment that can be downloaded.
* @param baseurls a vector of pointers to dash::mpd::IBaseUrl objects that represent the path to the media segment
* @return a pointer to a dash::mpd::ISegment object
*/
virtual ISegment* ToMediaSegment (const std::vector<IBaseUrl *>& baseurls) const = 0;
/**
* Returns a pointer to a dash::mpd::ISegment object that represents an index segment and can be downloaded.
* @param baseurls a vector of pointers to dash::mpd::IBaseUrl objects that represent the path to the index segment
* @return a pointer to a dash::mpd::ISegment object
*/
virtual ISegment* ToIndexSegment (const std::vector<IBaseUrl *>& baseurls) const = 0;
};
}
}
#endif /* ISEGMENTURL_H_ */
|
