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 引進)

備註

您可以使用其中一個 Factory 方法，從許多不同的媒體來源標記法建立 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()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
OpenAsync()	會開啟 MediaSource 的支援資料來源，並讀取中繼資料和追蹤資訊。
Reset()	重設 MediaSource的內部狀態。

事件

OpenOperationCompleted	發生于 MediaSource 開啟作業完成時。
StateChanged	發生于 MediaSource 的目前狀態變更時。

另請參閱

• MediaPlaybackItem
• 媒體項目、播放清單與曲目