次の方法で共有


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
属性

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

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

システム メディア のトランスポート コントロール

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

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

プロパティ

AutoRepeatMode

SystemMediaTransportControls の現在の自動繰り返しモードを表す値を取得または設定します。

DisplayUpdater

現在再生中の曲に関する情報の更新を有効にする SystemMediaTransportControls の表示アップデーターを取得します。

IsChannelDownEnabled

チャネルダウン ボタンがサポートされているかどうかを示す値を取得または設定します。

IsChannelUpEnabled

チャネルアップ ボタンがサポートされているかどうかを示す値を取得または設定します。

IsEnabled

アプリのシステム メディア トランスポート コントロールを有効または無効にします。

IsFastForwardEnabled

高速転送ボタンがサポートされているかどうかを示す値を取得または設定します。

IsNextEnabled

次のボタンがサポートされているかどうかを示す値を取得または設定します。

IsPauseEnabled

一時停止ボタンがサポートされているかどうかを示す値を取得または設定します。一時停止ボタンがサポートされている場合は true 。それ以外の場合は false

IsPlayEnabled

再生ボタンがサポートされているかどうかを示す値を取得または設定します。

IsPreviousEnabled

前のボタンがサポートされているかどうかを示す値を取得または設定します。

IsRecordEnabled

レコード ボタンがサポートされているかどうかを示す値を取得または設定します。レコード ボタンがサポートされている場合は true。それ以外の場合は false

IsRewindEnabled

巻き戻しボタンがサポートされているかどうかを示す値を取得または設定します。

IsStopEnabled

停止ボタンがサポートされているかどうかを示す値を取得または設定します。

PlaybackRate

SystemMediaTransportControls の再生速度を取得または設定します。

PlaybackStatus

メディアの再生状態を取得または設定します。

ShuffleEnabled

SystemMediaTransportControls の現在のシャッフル状態を表す値を取得または設定します。

SoundLevel

キャプチャ ストリームとレンダー ストリームのメディアのサウンド レベルを取得します。

メソッド

GetForCurrentView()

現在のビューのシステム メディア トランスポート コントロール。

UpdateTimelineProperties(SystemMediaTransportControlsTimelineProperties)

SystemMediaTransportControls タイムラインプロパティを、指定されたオブジェクトの値と共に更新します。

イベント

AutoRepeatModeChangeRequested

ユーザーが SystemMediaTransportControls 自動繰り返しモードを変更したときに発生します。

ButtonPressed

SystemMediaTransportControls でボタンが押されたときに発生します。

PlaybackPositionChangeRequested

ユーザーが SystemMediaTransportControls の再生位置を変更したときに発生します。

PlaybackRateChangeRequested

ユーザーが SystemMediaTransportControls 再生速度を変更したときに発生します。

PropertyChanged

SystemMediaTransportControls のプロパティが変更されたときに発生します。

ShuffleEnabledChangeRequested

ユーザーが SystemMediaTransportControls シャッフル状態を変更したときに発生します。

適用対象

こちらもご覧ください