MediaPlayer 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供媒體播放以用於繪製。
public ref class MediaPlayer : System::Windows::Media::Animation::Animatable
public class MediaPlayer : System.Windows.Media.Animation.Animatable
type MediaPlayer = class
inherit Animatable
interface DUCE.IResource
type MediaPlayer = class
inherit Animatable
Public Class MediaPlayer
Inherits Animatable
- 繼承
範例
備註
雖然您可以在 Extensible Application Markup Language (XAML) 中宣告此類別的實例,但您無法在不使用程式碼的情況下載入和播放其媒體。 若要只在 XAML 中播放媒體,請使用 MediaElement 。 此外,如果您在 XAML 中宣告實例,唯一實用的用途是填滿屬性的屬性 Player 元素語法。
在隨著您的應用程式散發媒體時,您無法使用媒體檔案做為專案資源。 在您的專案檔中,您必須改為將媒體類型設定為 Content
,並將 CopyToOutputDirectory
設定為 PreserveNewest
或 Always
。
MediaPlayer 可以用於兩種不同的模式,視驅動玩家的方式而定:獨立模式或時鐘模式。 在獨立模式中 MediaPlayer ,類似于透過 方法磁片磁碟機播放開啟的 Open 影像和媒體。 在時鐘模式中 MediaPlayer ,可以視為動畫的目標,因此它會在控制播放的計時樹狀結構中具有對應的 Timeline 和 Clock 專案。 如需媒體模式的詳細資訊,請參閱 多媒體概觀。
MediaPlayer 不同于 MediaElement ,它不是可以直接新增至應用程式使用者介面 (UI) 控制項。 若要顯示使用 MediaPlayer 載入的媒體, VideoDrawing 必須使用 或 DrawingContext 。
建構函式
MediaPlayer() |
初始化 MediaPlayer 類別的新執行個體。 |
屬性
Balance |
取得或設定左邊和右邊喇叭音量的平衡。 |
BufferingProgress |
取得資料流內容緩衝完成的百分比。 |
CanFreeze |
取得值,指出是否可以將物件設為不可修改。 (繼承來源 Freezable) |
CanPause |
取得值,這個值表示媒體是否可暫停。 |
Clock |
取得或設定與要播放之 MediaClock 關聯的 MediaTimeline。 |
DependencyObjectType |
DependencyObjectType取得包裝這個實例之 CLR 型別的 。 (繼承來源 DependencyObject) |
Dispatcher |
取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject) |
DownloadProgress |
取得下載遠端伺服器上之內容時的下載進度百分比。 |
HasAnimatedProperties |
取得值,這個值表示是否有一個或多個 AnimationClock 物件與這個物件的任何一個相依性屬性相關聯。 (繼承來源 Animatable) |
HasAudio |
取得值,這個值表示媒體是否具有音訊輸出。 |
HasVideo |
取得值,這個值表示媒體是否具有視訊輸出。 |
IsBuffering |
取得值,這個值表示媒體是否正在緩衝。 |
IsFrozen |
取得值,該值表示物件目前是否可修改。 (繼承來源 Freezable) |
IsMuted |
取得值,這個值表示媒體是否為靜音。 |
IsSealed |
取得值,這個值表示此執行個體目前是否已密封 (唯讀)。 (繼承來源 DependencyObject) |
NaturalDuration |
取得媒體的自然持續期間。 |
NaturalVideoHeight |
取得視訊的像素高度。 |
NaturalVideoWidth |
取得視訊的像素寬度。 |
Position |
取得或設定媒體的目前位置。 |
ScrubbingEnabled |
取得或設定值,這個值表示是否啟用清除。 |
Source |
取得媒體的 Uri。 |
SpeedRatio |
取得或設定媒體的播放速率。 |
Volume |
取得或設定媒體的磁碟區。 |
方法
事件
BufferingEnded |
當緩衝完成時發生。 |
BufferingStarted |
當緩衝啟動時發生。 |
Changed |
發生於 Freezable 或所含的物件遭到修改時。 (繼承來源 Freezable) |
MediaEnded |
媒體完成播放時發生。 |
MediaFailed |
遇到錯誤時發生。 |
MediaOpened |
媒體開啟時發生。 |
ScriptCommand |
在媒體中遇到指令碼命令時發生。 |