AdaptiveMediaSource Class

Definition

Namespace:

Windows.Media.Streaming.Adaptive

Represents the source of adaptive streaming content.

public ref class AdaptiveMediaSource sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AdaptiveMediaSource final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AdaptiveMediaSource : System.IDisposable

Public NotInheritable Class AdaptiveMediaSource
Implements IDisposable

Inheritance

Object Platform::Object IInspectable AdaptiveMediaSource

Attributes

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implements

IMediaSource IClosable IDisposable

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

Call one of the CreateFromStreamAsync or CreateFromUriAsync methods to create a AdaptiveMediaSource object with a specific adaptive streaming manifest source.

For how-to guidance for using adaptive streaming in your app, see Adaptive streaming.

Version history

Windows version	SDK version	Value added
1511	10586	AdvancedSettings
1703	15063	DesiredSeekableWindowSize
1703	15063	Diagnostics
1703	15063	GetCorrelatedTimes
1703	15063	MaxSeekableWindowSize
1703	15063	MinLiveOffset

Properties

AdvancedSettings	Gets the advanced settings for the adaptive media source.
AudioOnlyPlayback	Gets a value indicating if the content streamed by the media source contains only audio.
AvailableBitrates	Gets the available adaptive bit rates of the adaptive streaming manifest that is the source of the adaptive streaming object.
CurrentDownloadBitrate	Gets a value indicating the current download bitrate for the media source.
CurrentPlaybackBitrate	Gets a value indicating the current playback bitrate for the media source.
DesiredLiveOffset	Gets or sets the desired offset of live playback from the end of the known media content that has been downloaded.
DesiredMaxBitrate	Gets or sets the desired maximum bitrate for the media source.
DesiredMinBitrate	Gets or sets the desired minimum bitrate for the media source.
DesiredSeekableWindowSize	Gets or sets the requested maximum size of the time window within which the user can seek within the streaming media.
Diagnostics	Gets an object that provides an event that is raised when diagnostic information about the adaptive media source is available.
InboundBitsPerSecond	Gets a value indicating the inbound bits per second statistic over the time window specified by the InboundBitsPerSecondWindow property.
InboundBitsPerSecondWindow	Gets or sets the time span over which the InboundBitsPerSecond property is calculated.
InitialBitrate	Gets and sets the initial bit rate to use for playback of the media source.
IsLive	Gets a value that indicates whether the media source is live.
MaxSeekableWindowSize	Gets the maximum time window within which the user can seek within the streaming media.
MinLiveOffset	Gets the minimum offset of live playback from the end of the known media content that has been downloaded.

Methods

Close()	Closes the adaptive media source and frees up associated resources.
CreateFromStreamAsync(IInputStream, Uri, String)	Asynchronously creates a AdaptiveMediaSource object from the provided input stream.
CreateFromStreamAsync(IInputStream, Uri, String, HttpClient)	Asynchronously creates a AdaptiveMediaSource object from the provided input stream.
CreateFromUriAsync(Uri)	Asynchronously creates a AdaptiveMediaSource object from the Uniform Resource Identifier (URI) of the source.
CreateFromUriAsync(Uri, HttpClient)	Asynchronously creates a AdaptiveMediaSource object from the Uniform Resource Identifier (URI) of the source.
Dispose()	Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
GetCorrelatedTimes()	Gets an object that provides timing information that is correlated between timestamps in the media or date/time information from the manifest with the presentation clock timeline.
IsContentTypeSupported(String)	Determines whether the content type of the source is supported.

Events

DownloadBitrateChanged	Occurs when the CurrentDownloadBitrate changes.
DownloadCompleted	Occurs when a resource download operation completes
DownloadFailed	Occurs when a resource download operation fails.
DownloadRequested	Occurs when a resource download operation is requested.
PlaybackBitrateChanged	Occurs when the CurrentPlaybackBitrate changes.

See also

• IMediaSource
• Adaptive streaming
• Adaptive streaming sample