MediaSource 类

定义

命名空间:

Windows.Media.Core

表示媒体源。 提供从不同源引用媒体的常用方法，并公开用于访问媒体数据的通用模型，而不考虑基础媒体格式。

public ref class MediaSource 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 MediaSource 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 MediaSource : System.IDisposable

Public NotInheritable Class MediaSource
Implements IDisposable

继承

Object Platform::Object IInspectable MediaSource

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IClosable IDisposable IMediaPlaybackSource

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

使用工厂方法之一，可以从许多不同的媒体源表示形式创建 MediaSource 实例，包括：

• AdaptiveMediaSource
• MediaStreamSource
• MseStreamSource
• IStorageFile
• IRandomAccessStream
• IRandomAccessStreamReference
• Uri

获取 MediaSource 实例后，创建包装媒体源的新 MediaPlaybackItem ，并将 MediaPlaybackItem 传递给其中一个媒体播放对象，例如 MediaPlayer 或 MediaElement。

有关使用 MediaSource 播放媒体的操作指南，请参阅 媒体项、播放列表和曲目。

版本历史记录

Windows 版本	SDK 版本	增值
1511	10586	CreateFromMediaBinder
1511	10586	重置
1511	10586	状态
1511	10586	StateChanged
1703	15063	AdaptiveMediaSource
1703	15063	MediaStreamSource
1703	15063	MseStreamSource
1703	15063	OpenAsync
1703	15063	Uri
1709	16299	CreateFromMediaFrameSource
1803	17134	CreateFromDownloadOperation
1803	17134	DownloadOperation

属性

AdaptiveMediaSource	获取与 MediaSource 关联的 AdaptiveMediaSource。
CustomProperties	获取一组属性，这些属性可用于将特定于应用的数据与 MediaSource 相关联。
DownloadOperation	检索与 MediaSource 关联的 DownloadOperation
Duration	获取 MediaSource 中内容的持续时间。
ExternalTimedMetadataTracks	与 MediaSource 关联的外部计时元数据跟踪的集合。
ExternalTimedTextSources	与 MediaSource 关联的外部计时文本源的集合。
IsOpen	获取一个值，该值指示媒体源当前是否处于打开状态。
MediaStreamSource	获取与 MediaSource 关联的 MediaStreamSource。
MseStreamSource	获取与 MediaSource 关联的 MseStreamSource。
State	获取 MediaSource 的当前状态。
Uri	获取与 MediaSource 关联的 URI。

方法

Close()	关闭 MediaSource。
CreateFromAdaptiveMediaSource(AdaptiveMediaSource)	从提供的 AdaptiveMediaSource 创建 MediaSource 的实例。
CreateFromDownloadOperation(DownloadOperation)	从提供的 DownloadOperation 创建 MediaSource 的实例。
CreateFromIMediaSource(IMediaSource)	从提供的 IMediaSource 创建 MediaSource 的实例。
CreateFromMediaBinder(MediaBinder)	从提供的 MediaBinder 创建 MediaSource 的实例。
CreateFromMediaFrameSource(MediaFrameSource)	从提供的 AdaptiveMediaSource 创建 MediaSource 的实例。
CreateFromMediaStreamSource(MediaStreamSource)	从提供的 MediaStreamSource 创建 MediaSource 的实例。
CreateFromMseStreamSource(MseStreamSource)	从提供的 MseStreamSource 创建 MediaSource 的实例。
CreateFromStorageFile(IStorageFile)	从提供的 IStorageFile 创建 MediaSource 的实例。
CreateFromStream(IRandomAccessStream, String)	从提供的 IRandomAccessStream 创建 MediaSource 的实例。
CreateFromStreamReference(IRandomAccessStreamReference, String)	从提供的 IRandomAccessStreamReference 创建 MediaSource 的实例。
CreateFromUri(Uri)	从提供的 URI 创建 MediaSource 的实例。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
OpenAsync()	打开 MediaSource 的后备数据源，并读取元数据和跟踪信息。
Reset()	重置 MediaSource 的内部状态。

事件

OpenOperationCompleted	在 MediaSource 打开操作完成时发生。
StateChanged	当 MediaSource 的当前状态更改时发生。

另请参阅

• MediaPlaybackItem
• 媒体项、播放列表和曲目