SystemMediaTransportControls クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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 SystemMediaTransportControlsPublic NotInheritable Class 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 の新しいインスタンスをインスタンス化し、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 シャッフル状態を変更したときに発生します。 |