SystemMediaTransportControls クラス

リファレンス

定義

名前空間:: Windows.Media

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

システムメディアトランスポートコントロールとの統合とメディアコマンドのサポートを可能にするオブジェクトを表します。

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 の要件

デバイスファミリ	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 の新しいインスタンスをインスタンス化し、MediaSource、MediaPlaybackItem、または 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 シャッフル状態を変更したときに発生します。

適用対象