Media オブジェクト

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能な場合は SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

Media オブジェクトは、次のプロパティとメソッドを使用して、メディアアイテムのプロパティを指定または取得する方法を提供します。

Media オブジェクトは、次のプロパティをサポートしています。

プロパティ 説明
attributeCount メディア項目に対してクエリまたは設定できる属性の数を取得します。
duration 現在のメディア項目の期間を秒単位で取得します。
durationString 現在のメディア項目の期間を示す文字列型 ( String) の値を HH:MM:SS 形式で取得します。
error メディアアイテムにエラー条件がある場合に ErrorItem オブジェクトを取得します。
imageSourceHeight 現在のメディア項目の高さをピクセル単位で取得します。
imageSourceWidth 現在のメディア項目の幅をピクセル単位で取得します。
markerCount メディア項目内のマーカーの数を取得します。
name メディア項目の名前を指定または取得します。
sourceURL メディア アイテムの URL を取得します。

 

Media オブジェクトは、次のメソッドをサポートしています。

メソッド 説明
getAttributeCountByType 指定した属性名と言語に関連付けられている属性の数を取得します。
getAttributeName 指定したインデックスに対応する属性の名前を取得します。
getItemInfo メディア項目の指定した属性の値を取得します。
getItemInfoByAtom 指定したインデックス番号を持つ 属性の値を取得します。
getItemInfoByType 指定した属性名、言語、およびインデックスに対応する属性の値を取得します。
getMarkerName 指定したインデックス位置にあるマーカーの名前を取得します。
getMarkerTime 指定したインデックス位置にあるマーカーの時刻を取得します。
isIdentical 指定したオブジェクトが現在のオブジェクトと同じかどうかを示す値を取得します。
isMemberOf 指定したメディアアイテムが指定したプレイリストのメンバーであるかどうかを示す値を取得します。
isReadOnlyItem 指定したメディア項目の属性を編集できるかどうかを示す値を取得します。
setItemInfo メディア項目の指定した属性の値を設定します。

 

Media オブジェクトには、次のプロパティとメソッドを使用してアクセスします。

オブジェクト プロパティまたはメソッド
コントロール currentItem
プレーヤー currentMedia、 newMedia
再生リスト item

 

これは最も一般的なアクセス手段であるため、 プレーヤーです。currentMedia は、参照構文セクションの図の目的で使用されます。

関連項目

スクリプト作成のオブジェクト モデル リファレンス