SystemMediaTransportControls クラス

定義

public ref class SystemMediaTransportControls sealed

/// [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.MTA)]
class SystemMediaTransportControls final

[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.MTA)]
public sealed class SystemMediaTransportControls

Public NotInheritable Class SystemMediaTransportControls

継承

Object Platform::Object IInspectable SystemMediaTransportControls

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

注釈

SystemMediaTransportControls は MediaControl クラスを置き換えます。 Windows 8.1 以降では、MediaControl の代わりにこのコントロールを使用して、システム トランスポート コントロールを操作する必要があります。 システム トランスポート コントロールを使用すると、メディア アプリケーション開発者は組み込みのシステム UI と統合して、アーティスト、アルバム タイトル、チャプター タイトルなどのメディア メタデータを表示できます。 また、システム トランスポート コントロールを使用すると、ユーザーは、再生を一時停止したり、再生リストで前後にスキップしたりするなど、組み込みのシステム UI を使用してメディア アプリの再生を制御できます。

Windows 10 バージョン 1607 以降では、MediaPlayer クラスまたは AudioGraph クラスを使用してメディアを再生する UWP アプリは、既定で SMTC と自動的に統合されます。 MediaPlayer の新しいインスタンスをインスタンス化し、MediaSource、MediaPlaybackItem、または MediaPlaybackList をプレーヤーの Source プロパティに割り当てるだけで、SMTC にアプリ名が表示され、SMTC コントロールを使って再生リストから再生、一時停止、再生リスト内の移動を行うことができます。 MediaPlayer オブジェクトの SystemMediaTransportControls プロパティにアクセスして、SMTC のインスタンスを取得します。 アプリから SMTC を使用する方法については、「 SystemMediaTransportControls との統合」を参照してください。

一部のシナリオでは、SMTC との自動統合を無効にすることができます。 この場合は、IsEnabled プロパティを false に設定して、MediaPlayer オブジェクトの CommandManager を無効にする必要があります。 現在のビューの SystemMediaTransportControls のインスタンスを取得するには、 GetForCurrentView を呼び出します。 古いバージョンの Windows を対象としている場合は、この方法でインスタンスを取得する必要もあります。 SMTC を手動で制御する方法については、「 システム メディア トランスポート制御の手動制御」を参照してください。

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• SystemMediaTransportControls との統合
• システム メディア トランスポート コントロールの手動制御
• システム メディア トランスポート コントロールのサンプル