85 lines
4.0 KiB
C++
85 lines
4.0 KiB
C++
// Copyright 2017 Google Inc. All rights reserved.
|
|
//
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file or at
|
|
// https://developers.google.com/open-source/licenses/bsd
|
|
|
|
#ifndef PACKAGER_MPD_PUBLIC_MPD_PARAMS_H_
|
|
#define PACKAGER_MPD_PUBLIC_MPD_PARAMS_H_
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
namespace shaka {
|
|
|
|
/// DASH MPD related parameters.
|
|
struct MpdParams {
|
|
/// MPD output file path.
|
|
std::string mpd_output;
|
|
/// BaseURLs for the MPD. The values will be added as <BaseURL> element(s)
|
|
/// under the <MPD> element.
|
|
std::vector<std::string> base_urls;
|
|
/// Set MPD@minBufferTime attribute, which specifies, in seconds, a common
|
|
/// duration used in the definition of the MPD representation data rate. A
|
|
/// client can be assured of having enough data for continous playout
|
|
/// providing playout begins at min_buffer_time after the first bit is
|
|
/// received.
|
|
double min_buffer_time = 2.0;
|
|
/// Set MPD@minimumUpdatePeriod attribute, which indicates to the player how
|
|
/// often to refresh the MPD in seconds. For dynamic MPD only.
|
|
double minimum_update_period = 0;
|
|
/// Set MPD@suggestedPresentationDelay attribute. For 'dynamic' media
|
|
/// presentations, it specifies a delay, in seconds, to be added to the media
|
|
/// presentation time. The attribute is not set if the value is 0; the client
|
|
/// is expected to choose a suitable value in this case.
|
|
static constexpr double kSuggestedPresentationDelayNotSet = 0;
|
|
double suggested_presentation_delay = kSuggestedPresentationDelayNotSet;
|
|
/// Set MPD@timeShiftBufferDepth attribute, which is the guaranteed duration
|
|
/// of the time shifting buffer for 'dynamic' media presentations, in seconds.
|
|
double time_shift_buffer_depth = 0;
|
|
/// Segments outside the live window (defined by 'time_shift_buffer_depth'
|
|
/// above) are automatically removed except for the most recent X segments
|
|
/// defined by this parameter. This is needed to accommodate latencies in
|
|
/// various stages of content serving pipeline, so that the segments stay
|
|
/// accessible as they may still be accessed by the player. The segments are
|
|
/// not removed if the value is zero.
|
|
size_t preserved_segments_outside_live_window = 0;
|
|
/// UTCTimings. For dynamic MPD only.
|
|
struct UtcTiming {
|
|
std::string scheme_id_uri;
|
|
std::string value;
|
|
};
|
|
std::vector<UtcTiming> utc_timings;
|
|
/// The tracks tagged with this language will have <Role ... value=\"main\" />
|
|
/// in the manifest. This allows the player to choose the correct default
|
|
/// language for the content.
|
|
std::string default_language;
|
|
/// Generate static MPD for live profile. Note that this flag has no effect
|
|
/// for on-demand profile, in which case static MPD is always used.
|
|
bool generate_static_live_mpd = false;
|
|
/// Try to generate DASH-IF IOP compliant MPD.
|
|
bool generate_dash_if_iop_compliant_mpd = true;
|
|
/// For live profile only.
|
|
/// If enabled, segments with close duration (i.e. with difference less than
|
|
/// one sample) are considered to have the same duration. This enables
|
|
/// MPD generator to generate less SegmentTimeline entries. If all segments
|
|
/// are of the same duration except the last one, we will do further
|
|
/// optimization to use SegmentTemplate@duration instead and omit
|
|
/// SegmentTimeline completely.
|
|
/// Ignored if $Time$ is used in segment template, since $Time$ requires
|
|
/// accurate Segment Timeline.
|
|
bool allow_approximate_segment_timeline = false;
|
|
/// This is the target segment duration requested by the user. The actual
|
|
/// segment duration may be different to the target segment duration.
|
|
/// This parameter is included here to calculate the approximate
|
|
/// SegmentTimeline if it is enabled. It is also used by the bandwidth
|
|
/// estimator to exclude the segments with duration less than half of the
|
|
/// target duration from bandwidth estimation. It will be populated from
|
|
/// segment duration specified in ChunkingParams if not specified.
|
|
double target_segment_duration = 0;
|
|
};
|
|
|
|
} // namespace shaka
|
|
|
|
#endif // PACKAGER_MPD_PUBLIC_MPD_PARAMS_H_
|