81 lines
3.7 KiB
C++
81 lines
3.7 KiB
C++
#ifndef _hls_param_h_
|
|
#define _hls_param_h_
|
|
|
|
// https://developer.apple.com/library/content/documentation/NetworkingInternet/Conceptual/StreamingMediaGuide/FrequentlyAskedQuestions/FrequentlyAskedQuestions.html
|
|
// https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/StreamingMediaGuide/FrequentlyAskedQuestions/FrequentlyAskedQuestions.html
|
|
// 1. What kinds of encoders are supported?
|
|
// H.264 video and AAC audio (HE-AAC or AAC-LC).
|
|
// 2. What are the specifics of the video and audio formats supported?
|
|
// Video: H.264 Baseline Level 3.0, Baseline Level 3.1, Main Level 3.1, and High Profile Level 4.1.
|
|
// Audio: HE-AAC or AAC-LC up to 48 kHz, stereo audio
|
|
// MP3 (MPEG-1 Audio Layer 3) 8 kHz to 48 kHz, stereo audio
|
|
// AC-3 (for Apple TV, in pass-through mode only)
|
|
|
|
// 3. What duration should media files be?
|
|
// A duration of 10 seconds of media per file seems to strike a reasonable balance for most broadcast content.
|
|
// http://devimages.apple.com/iphone/samples/bipbop/bipbopall.m3u8
|
|
#define HLS_DURATION 10 // 10s, from Apple recommendation
|
|
|
|
// 4. How many files should be listed in the index file during a continuous, ongoing session?
|
|
// The normal recommendation is 3, but the optimum number may be larger.
|
|
#define HLS_LIVE_NUM 3
|
|
|
|
// HTTP Content-Type
|
|
// Playlist files whose names end in .m3u8 and/or have the HTTP Content-
|
|
// Type "application/vnd.apple.mpegurl" are encoded in UTF-8[RFC3629].
|
|
// Files whose names end with.m3u and/or have the HTTP Content-Type
|
|
// [RFC2616] "audio/mpegurl" are encoded in US-ASCII[US_ASCII].
|
|
#define HLS_M3U8_TYPE "application/vnd.apple.mpegURL"
|
|
#define HLS_M3U_TYPE "audio/mpegurl"
|
|
#define HLS_TS_TYPE "video/MP2T"
|
|
|
|
#define PTS_NO_VALUE INT64_MIN //(int64_t)0x8000000000000000L
|
|
|
|
|
|
// version: 1 (default)
|
|
//
|
|
// version: 2
|
|
// The IV attribute of the EXT-X-KEY tag.
|
|
// version: 3
|
|
// Floating-point EXTINF duration values.
|
|
// version: 4
|
|
// The EXT-X-BYTERANGE tag.
|
|
// The EXT-X-I-FRAMES-ONLY tag.
|
|
// version: 5
|
|
// The KEYFORMAT and KEYFORMATVERSIONS attributes of the EXT-X-KEY tag.
|
|
// The EXT-X-MAP tag.
|
|
// version: 6
|
|
// The EXT-X-MAP tag in a Media playlist that does not contain EXT-X-I-FRAMES-ONLY.
|
|
|
|
|
|
// 6.2.2. Live Playlists
|
|
// 1. The server MUST NOT remove a media segment from the Playlist file if
|
|
// the duration of the Playlist file minus the duration of the segment
|
|
// is less than three times the target duration
|
|
// 2. When the server removes a media segment from the Playlist, the
|
|
// corresponding media URI SHOULD remain available to clients for a
|
|
// period of time equal to the duration of the segment plus the duration
|
|
// of the longest Playlist file distributed by the server containing
|
|
// that segment.
|
|
|
|
// 6.3.3. Playing the Playlist file
|
|
// 1. If the EXT-X-ENDLIST tag is not present, the client SHOULD NOT
|
|
// choose a segment which starts less than three target durations from
|
|
// the end of the Playlist file.
|
|
// 2. The client SHOULD attempt to load media segments in advance of when
|
|
// they will be required for uninterrupted playback to compensate for
|
|
// temporary variations in latency and throughput.
|
|
// 3. The client MUST be prepared to reset its parser(s) and decoder(s)
|
|
// before playing a media segment that has an EXT-X-DISCONTINUITY tag
|
|
// applied to it.
|
|
|
|
// 6.3.4. Reloading the Playlist file
|
|
// 1. The client MUST periodically reload the Media Playlist file unless it
|
|
// contains the EXT-X-ENDLIST tag.
|
|
// 2. if Playlist file changed since the last time it was loaded, the client MUST wait for
|
|
// at least the target duration before attempting to reload the Playlist file again
|
|
// 3. if Playlist file not changed then it MUST wait for a period of one-half the target
|
|
// duration before retrying
|
|
|
|
#endif /* !_hls_param_h_ */
|