MediaPlayer 類別

定義

命名空間:

Windows.Media.Playback

提供媒體播放功能的存取，例如播放、暫停、快速轉送、倒轉和音量。

public ref class MediaPlayer 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)]
/// [Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
class MediaPlayer 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)]
[Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlayer : System.IDisposable

function MediaPlayer()

Public NotInheritable Class MediaPlayer
Implements IDisposable

繼承

Object Platform::Object IInspectable MediaPlayer

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ActivatableAttribute

實作

IClosable IDisposable

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

檔的 媒體播放 區段包含操作說明文章，提供將媒體播放功能新增至應用程式的詳細指引。 下表列出一些可用的文章。

主題	描述
使用 MediaPlayer 播放音訊和視訊	示範如何利用 UWP app 媒體播放系統的新功能和改進功能。
媒體項目、播放清單與曲目	示範如何使用 MediaSource 類別，其提供從本機或遠端檔案等不同來源參考和播放媒體的常見方式，並公開一般模型來存取媒體資料，而不論基礎媒體格式為何。
與系統媒體傳輸控制項整合	示範如何將應用程式與系統媒體傳輸控制項 (SMTC) 整合。
系統支援的定時中繼資料提示	描述如何利用數種格式的計時中繼資料，這些格式可能會內嵌在媒體檔案或資料流程中。
建立、排程與管理媒體中斷	示範如何建立、排程和管理媒體播放應用程式的媒體中斷。
在背景播放媒體	示範如何設定應用程式，讓媒體在應用程式從前景移至背景時繼續播放。
自適性串流	描述如何將調適型串流多媒體內容的播放新增至通用 Windows 平臺 (UWP) app。
媒體傳播	示範如何從通用 Windows 應用程式將媒體轉換成遠端裝置。
PlayReady DRM	說明如何將 PlayReady 保護的媒體內容新增至您的 通用 Windows 平臺 (UWP) app。

媒體播放 SDK 範例

下列的 SDK 範例示範 Windows 10 上 UWP 應用程式可用的媒體播放功能。 使用這些範例查看內容中使用的媒體播放 API 或者做為您應用程式的起點。

• 彈性資料流範例
• 背景音訊範例
• 系統媒體傳輸範例
• 360 度視訊播放範例
• 背景媒體播放範例
• 視訊播放同步處理範例

版本歷程記錄

Windows 版本	SDK 版本	新增值
1511	10586	AddAudioEffect
1511	10586	RemoveAllEffects
1607	14393	AddVideoEffect
1607	14393	AudioBalance
1607	14393	AudioDevice
1607	14393	BreakManager
1607	14393	CommandManager
1607	14393	GetAsCastingSource
1607	14393	GetSurface
1607	14393	IsMutedChanged
1607	14393	PlaybackSession
1607	14393	RealTimePlayback
1607	14393	SetSurfaceSize
1607	14393	SourceChanged
1607	14393	StepBackwardOneFrame
1607	14393	StepForwardOneFrame
1607	14393	StereoscopicVideoRenderMode
1607	14393	TimelineController
1607	14393	TimelineControllerPositionOffset
1703	15063	CopyFrameToStereoscopicVideoSurfaces
1703	15063	CopyFrameToVideoSurface (IDirect3DSurface)
1703	15063	CopyFrameToVideoSurface (IDirect3DSurface，Rect)
1703	15063	IsVideoFrameServerEnabled
1703	15063	VideoFrameAvailable
1709	16299	RenderSubtitlesToSurface (IDirect3DSurface)
1709	16299	RenderSubtitlesToSurface (IDirect3DSurface，Rect)
1709	16299	SubtitleFrameChanged
1803	17134	AudioStateMonitor

建構函式

MediaPlayer()

初始化 MediaPlayer 物件的新實例。

屬性

AudioBalance	取得或設定跨身歷聲喇叭的音量比例。
AudioCategory	取得或設定目前現正播放的音訊類型。
AudioDevice	取得或設定 DeviceInformation 物件，代表 MediaPlayer 用來呈現音訊的音訊裝置。
AudioDeviceType	取得或設定值，這個值描述用來播放音訊之裝置的主要使用方式。
AudioStateMonitor	取得 AudioStateMonitor 物件，可讓 UWP app 判斷任何應用程式的音訊串流目前是否為靜音，或讓系統減少其音量。
AutoPlay	取得或設定布林值，指出是否在載入媒體之後自動開始播放。
BreakManager	取得與MediaPlayer相關聯的MediaBreakManager，其提供播放程式媒體中斷的相關資訊和控制。
BufferingProgress	取得媒體內容完成的緩衝量，以百分比表示。 注意 MediaPlayer.BufferingProgress可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.BufferingProgress 屬性。
CanPause	取得布林值，指出是否可以暫停媒體。 注意 MediaPlayer.CanPause可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.CanPause 屬性。
CanSeek	取得布林值，指出媒體是否支援搜尋特定位置。 注意 MediaPlayer.CanSeek可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.CanSeek 屬性。
CommandManager	取得與MediaPlayer相關聯的MediaPlaybackCommandManager，這個控制項會指定 和 從系統媒體傳輸控制項接收事件的行為。
CurrentState	取得媒體播放的目前狀態。 注意 MediaPlayer.CurrentState可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.PlaybackState 屬性。
IsLoopingEnabled	取得或設定布林值，指出媒體是否會在重複迴圈中播放。
IsMuted	取得或設定布林值，指出音訊是否為靜音。
IsProtected	取得布林值，指出內容是否受到數位版權管理系統的保護。 注意 MediaPlayer.IsProtected可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 IsProtected 屬性。
IsVideoFrameServerEnabled	取得值，指出是否啟用 MediaPlayer 實例的視訊畫面伺服器模式。
NaturalDuration	取得媒體的實際持續時間，而不套用 PlaybackRate。 注意 MediaPlayer.NaturalDuration可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.NaturalDuration 屬性。
PlaybackMediaMarkers	取得媒體的時間軸標記集合。 注意 MediaPlayer.PlaybackMediaMarkers可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlaybackItem.TimedMetadataTracks 來管理資料或文字提示。如需詳細資訊，請參閱 使用 MediaSource 播放媒體。
PlaybackRate	取得或設定播放速率，以比率表示。 注意 mediaPlayer.PlaybackRate可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.PlaybackRate 屬性。
PlaybackSession	取得與MediaPlayer相關聯的MediaPlaybackSession，其提供目前播放會話狀態的相關資訊，並提供回應播放會話狀態變更的事件。
Position	取得或設定媒體內的播放位置。 注意 MediaPlayer.Position可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.Position 屬性。
ProtectionManager	取得或設定媒體的內容保護管理員。
RealTimePlayback	取得或設定值，這個值會針對即時串流視訊等即時案例設定 MediaPlayer 。
Source	設定媒體播放程式的播放來源。
StereoscopicVideoRenderMode	取得或設定值，指出目前的身歷聲轉譯模式。
SystemMediaTransportControls	取得 SystemMediaTransportControls 類別的實例，可讓使用者控制 MediaPlayer 的播放，並允許應用程式顯示目前在系統 UI 中播放內容的相關資訊。
TimelineController	取得或設定與MediaPlayer相關聯的MediaTimelineController。 使用此屬性以單一時間軸控制項操作多個 MediaPlayer 實例。
TimelineControllerPositionOffset	取得或設定套用至與MediaPlayer相關聯之 MediaTimelineController位置的位移。
Volume	取得或設定媒體播放的音訊音量。

方法

AddAudioEffect(String, Boolean, IPropertySet)	將音訊效果新增至 MediaPlayer的播放資料流程。
AddVideoEffect(String, Boolean, IPropertySet)	將視訊效果套用至媒體播放。
Close()	關閉 MediaPlayer 並處置相關聯的資源。
CopyFrameToStereoscopicVideoSurfaces(IDirect3DSurface, IDirect3DSurface)	將 MediaPlayer 目前顯示的視訊框架複製到兩個提供的 IDirect3DSurface 物件，這些物件代表立體視訊框架的左眼和右眼內容。
CopyFrameToVideoSurface(IDirect3DSurface)	將目前的視訊畫面從 MediaPlayer 複製到提供的 IDirect3DSurface。
CopyFrameToVideoSurface(IDirect3DSurface, Rect)	將目前視訊畫面從 MediaPlayer 複製到所提供 IDirect3DSurface內的指定目標矩形。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
GetAsCastingSource()	取得代表MediaPlayer的CastingSource，可讓媒體轉換成其他裝置。
GetSurface(Compositor)	取得MediaPlayer的MediaPlayerSurface物件，可讓您使用Compositor轉譯播放機的內容，而不需依賴 XAML 架構。
Pause()	暫停媒體播放。
Play()	啟動媒體播放。
RemoveAllEffects()	從 MediaPlayer的播放資料流程中移除所有效果。
RenderSubtitlesToSurface(IDirect3DSurface)	要求系統將目前的副標題文字轉譯為提供的 IDirect3DSurface。
RenderSubtitlesToSurface(IDirect3DSurface, Rect)	要求系統將目前的副標題文字轉譯為所提供 IDirect3DSurface內的指定目標矩形。
SetFileSource(IStorageFile)	將媒體來源設定為檔案。 注意 MediaPlayer.SetFileSource可能會在Windows 10之後變更或無法使用。 請改用 MediaPlayer.Source 。
SetMediaSource(IMediaSource)	設定要播放的媒體來源。 注意 MediaPlayer.SetMediaSource可能會在Windows 10之後變更或無法使用。 請改用 MediaPlayer.Source 。
SetStreamSource(IRandomAccessStream)	將媒體來源設定為數據流。 注意 MediaPlayer.SetMediaSource可能會在Windows 10之後變更或無法使用。 請改用 MediaPlayer.Source 。
SetSurfaceSize(Size)	設定 GetSurface所傳回之組合表面的大小。
SetUriSource(Uri)	設定媒體的路徑。 注意 MediaPlayer.SetUriSource可能會在Windows 10之後變更或無法使用。 請改用 MediaPlayer.Source 。
StepBackwardOneFrame()	讓 MediaPlayer 的播放位置向後移動 .042 秒，這對應至 24 fps 的一個畫面，而不論現正播放的內容的實際畫面播放速率為何。
StepForwardOneFrame()	讓 MediaPlayer 在目前媒體中向前移動一個畫面。

事件

BufferingEnded	當緩衝完成時發生。 注意 MediaPlayer.BufferingEnded可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.BufferingEnded 事件。
BufferingStarted	當緩衝啟動時發生。 注意 MediaPlayer.BufferingStarted可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.BufferingStarted 事件。
CurrentStateChanged	發生于媒體播放機的狀態變更時。 注意 MediaPlayer.CurrentStateChanged可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.PlaybackStateChanged 事件。
IsMutedChanged	發生于 MediaPlayer 的目前靜音狀態變更時。
MediaEnded	媒體完成播放時發生。
MediaFailed	遇到錯誤時發生。
MediaOpened	媒體開啟時發生。
MediaPlayerRateChanged	發生于媒體播放速率變更時。 注意 MediaPlayer.MediaPlayerRateChanged可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.PlaybackRateChanged 事件。
PlaybackMediaMarkerReached	在播放期間到達媒體標記時發生。 注意 MediaPlayer.PlaybackMediaMarkerReached可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlaybackItem.TimedMetadataTracks 來管理資料或文字提示。如需詳細資訊，請參閱 使用 MediaSource 播放媒體。
SeekCompleted	發生于搜尋作業完成時。 注意 mediaPlayer.SeekCompleted可能會在 Windows 10 1607 版之後變更或無法使用。 請改用 MediaPlayer.PlaybackSession 屬性來取得 MediaPlaybackSession 物件，然後使用 MediaPlaybackSession.SeekCompleted 事件。
SourceChanged	發生于 MediaPlayer 的媒體來源變更時。
SubtitleFrameChanged	當 MediaPlayer 處於畫面伺服器模式時，目前的副標題內容已變更時發生。
VideoFrameAvailable	當 IsVideoFrameServerEnabled 設定為 true 且有新的視訊畫面可供處理時發生。
VolumeChanged	發生于音訊音量已變更時。