SystemMediaTransportControlsDisplayUpdater クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SystemMediaTransportControls に表示される音楽情報を更新する機能を提供します。
public ref class SystemMediaTransportControlsDisplayUpdater 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.Both)]
class SystemMediaTransportControlsDisplayUpdater 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.Both)]
public sealed class SystemMediaTransportControlsDisplayUpdaterPublic NotInheritable Class SystemMediaTransportControlsDisplayUpdater- 継承
- 属性
Windows の要件
| デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
注釈
Windows 10 バージョン 1607 以降、メディアの再生に MediaPlayer クラスを使う UWP アプリは、既定で SMTC と自動的に統合されます。 自動統合では、 MediaPlaybackItem クラスを使用して、メディア アイテムのタイトルなどのメディア メタデータを更新します。 GetDisplayProperties を呼び出して、MediaItemDisplayProperties クラスのインスタンスを取得します。 SMTC 内のアイテムに表示する値で オブジェクトを更新し、 ApplyDisplayProperties を呼び出して変更をコミットします。 アプリから SMTC を使用する方法のガイダンスについては、「 SystemMediaTransportControls との統合」を参照してください。
手動 SMTC 統合を無効にする場合、または以前のバージョンの Windows を対象としている場合は、 SystemMediaTransportControls.DisplayUpdater を使用してメディア メタデータを更新する必要があります。 SMTC を手動で制御する方法のガイダンスについては、「 システム メディア トランスポート制御の手動制御」を参照してください。
プロパティ
| AppMediaId |
アプリのメディア ID を取得または設定します。 |
| ImageProperties |
現在再生中のメディアに関連付けられているイメージ プロパティを取得します。 |
| MusicProperties |
現在再生中のメディアに関連付けられている音楽プロパティを取得します。 |
| Thumbnail |
現在再生中のメディアに関連付けられているサムネイル画像を取得または設定します。 |
| Type |
メディアの種類を取得または設定します。 |
| VideoProperties |
現在再生中のメディアに関連付けられているビデオ プロパティを取得します。 |
メソッド
| ClearAll() |
すべてのメディア メタデータをクリアします。 |
| CopyFromFileAsync(MediaPlaybackType, StorageFile) |
指定したファイルを使用してメディア プロパティを初期化します。 |
| Update() |
現在再生中のメディアのメタデータを更新します。 |