public class HLSSettingsHLS settings shared by the Apple HLS player and downloader.
HLSSettings Class
-
init(hlsPlayerDefaultPropertiesToLoad:hlsDownloaderDefaultPropertiesToLoad: nativeThumbnailsSeekTolerance: applyLiveEdgeLatencyOnItemReady: nativeThumbnailsPreferredPeakBitRate: ) Creates HLS settings with an optional bandwidth limit for native thumbnail playback.
The existing initializer is intentionally retained for source and binary compatibility. Pass
nilto let AVFoundation select thumbnail renditions without a bitrate constraint.Declaration
Swift
public convenience init( hlsPlayerDefaultPropertiesToLoad: [AssetPropertiesManager.Property]? = nil, hlsDownloaderDefaultPropertiesToLoad: [AssetPropertiesManager.Property]? = nil, nativeThumbnailsSeekTolerance: Double = 0.5, applyLiveEdgeLatencyOnItemReady: Bool = false, nativeThumbnailsPreferredPeakBitRate: Double? )
-
Legacy default properties loaded for HLSPlayer when no custom player properties are set.
Declaration
Swift
public static let defaultHLSPlayerPropertiesToLoad: [AssetPropertiesManager.Property] -
Legacy default properties loaded for HLSDownloader when no custom downloader properties are set.
Declaration
Swift
public static let defaultHLSDownloaderPropertiesToLoad: [AssetPropertiesManager.Property] -
Default asset properties to load up front for HLSPlayer.
Declaration
Swift
public let hlsPlayerDefaultPropertiesToLoad: [AssetPropertiesManager.Property] -
Default asset properties to load up front for HLSDownloader.
Declaration
Swift
public let hlsDownloaderDefaultPropertiesToLoad: [AssetPropertiesManager.Property] -
Sets the native thumbnails seek tolerances in seconds
Setting it to 0 will force the player to extract the thumbnail images from video data. Default 0.5.
Declaration
Swift
public let nativeThumbnailsSeekTolerance: Double -
Desired maximum network bitrate, in bits per second, for the native thumbnail player.
The default value is
nil, which leaves AVFoundation’s adaptive rendition selection unconstrained. Values that are not finite or are less than or equal to zero are ignored.Declaration
Swift
public var nativeThumbnailsPreferredPeakBitRate: Double? -
Controls when the configured live edge latency is applied to a player item.
When
truethe latency is applied once the item reaches thereadyToPlaystatus, which lets AVFoundation resolve the live window first and keeps the initial playback position from being clamped to a stale live edge. Whenfalse(default, legacy behavior) it is applied right away, while the item is being created.Declaration
Swift
public var applyLiveEdgeLatencyOnItemReady: Bool -
Returns a custom HLSPlayer preload override, or
nilto preserve the legacy player behavior.Declaration
Swift
public var customHLSPlayerDefaultPropertiesToLoad: [AssetPropertiesManager.Property]? { get } -
Active HLS settings used by HLSPlugin, HLSPlayer, and HLSDownloader.
Declaration
Swift
public static var current: HLSSettings