Player オブジェクト
[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能な場合は SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
Player オブジェクトは、Windows メディア プレーヤー コントロールのルート オブジェクトです。 次の表に示すプロパティ、メソッド、およびイベントがサポートされています。
Player オブジェクトは、次のプロパティをサポートしています。 アスタリスク (*) でマークされたプロパティは、スキンからアクセスできません。
| プロパティ | 説明 |
|---|---|
| cdromCollection | CdromCollection オブジェクトを取得します。 |
| closedCaption | ClosedCaption オブジェクトを取得します。 |
| コントロール | Controls オブジェクトを取得します。 |
| currentMedia | 現在の Media オブジェクトを指定または取得します。 |
| currentPlaylist | 現在の Playlist オブジェクトを指定または取得します。 |
| Dvd | DVD オブジェクトを取得します。 |
| enableContextMenu * | マウスの右ボタンをクリックしたときに表示されるコンテキスト メニューを有効にするかどうかを示す値を指定または取得します。 |
| 有効 * | Windows メディア プレーヤー コントロールが有効かどうかを示す値を指定または取得します。 |
| error | Error オブジェクトを取得します。 |
| フルスクリーン * | ビデオ コンテンツを全画面表示モードで再生するかどうかを示す値を指定または取得します。 |
| isOnline | ユーザーがネットワークに接続されているかどうかを示す値を取得します。 |
| isRemote * | Windows メディア プレーヤー コントロールがリモート モードで実行されているかどうかを示す値を取得します。 |
| mediaCollection | MediaCollection オブジェクトを取得します。 |
| network | Network オブジェクトを取得します。 |
| openState | コンテンツ ソースの状態を示す値を取得します。 |
| playerApplication * | リモート Windows メディア プレーヤー コントロールが実行されているときに PlayerApplication オブジェクトを取得します。 |
| playlistCollection | PlaylistCollection オブジェクトを取得します。 |
| playState | Windows メディア プレーヤー操作の状態を示す値を取得します。 |
| 設定 | Settings オブジェクトを取得します。 |
| status | Windows メディア プレーヤーの現在の状態を示す値を取得します。 |
| stretchToFit * | ビデオがWindows メディア プレーヤーコントロールのビデオ表示のサイズに合わせて拡大するかどうかを示す値を指定または取得します。 |
| uiMode * | Web ページに埋め込まれたときにユーザー インターフェイスに表示されるコントロールを示す値Windows メディア プレーヤー指定または取得します。 |
| URL | 再生するクリップの名前を指定または取得します。 |
| versionInfo | Windows メディア プレーヤーのバージョンを指定する文字列型 (String) の値を取得します。 |
| windowlessVideo * | Windows メディア プレーヤー コントロールがウィンドウレス モードでビデオをレンダリングするかどうかを示す値を指定または取得します。 |
*スキンにはアクセスできません。
Player オブジェクトは、次のメソッドをサポートしています。
| メソッド | 説明 |
|---|---|
| close | リソースWindows メディア プレーヤー解放します。 |
| launchURL | レンダリングするユーザーの既定のブラウザーに URL を送信します。 |
| newMedia | 新しい Media オブジェクトを作成します。 |
| newPlaylist | 新しい Playlist オブジェクトを作成します。 |
| openPlayer | 指定した URL を使用してWindows メディア プレーヤーを開きます。 |
Player オブジェクトは、次のイベントをサポートしています。 アスタリスク (*) でマークされたイベントは、スキンからアクセスできません。 スキンでのマウス イベントとキーボード イベントの処理については、「 外部イベント」を参照してください。
| Event | 説明 |
|---|---|
| AudioLanguageChange | 現在のオーディオ言語が変更されたときに発生します。 |
| バッファリング | Windows メディア プレーヤー コントロールがバッファリングを開始または終了したときに発生します。 |
| CdromMediaChange | CD または DVD が CD または DVD ドライブに挿入または取り出されたときに発生します。 |
| クリック * | ユーザーがマウス ボタンをクリックしたときに発生します。 |
| CurrentItemChange | コントロールが発生したときに発生 します。currentItem の 変更。 |
| CurrentMediaItemAvailable | 現在のメディア項目のグラフィック メタデータ項目が使用可能になったときに発生します。 |
| CurrentPlaylistChange | 現在のプレイリスト内で何かが変更されたときに発生します。 |
| CurrentPlaylistItemAvailable | 現在のプレイリスト項目が使用可能になったときに発生します。 |
| Disconnect (切断) | 将来使用するために予約されています。 |
| DomainChange | DVD ドメインが変更されたときに発生します。 |
| Doubleclick * | ユーザーがマウス ボタンをダブルクリックしたときに発生します。 |
| DurationUnitChange | 将来使用するために予約されています。 |
| EndOfStream | 将来使用するために予約されています。 |
| Error | Windows メディア プレーヤー コントロールにエラー条件があるときに発生します。 |
| KeyDown * | キーが押されたときに発生します。 |
| Keypress * | キーが押されてから解放されたときに発生します。 |
| KeyUp * | キーが離されたときに発生します。 |
| MarkerHit | マーカーに到達したときに発生します。 |
| MediaChange | メディア項目が変更されたときに発生します。 |
| MediaCollectionAttributeStringAdded | 属性値がライブラリに追加されたときに発生します。 |
| MediaCollectionAttributeStringChanged | ライブラリ内の属性値が変更されたときに発生します。 |
| MediaCollectionAttributeStringRemoved | 属性値がライブラリから削除されたときに発生します。 |
| MediaCollectionChange | メディア コレクションが変更されたときに発生します。 |
| MediaCollectionMediaAdded | メディア項目がローカル ライブラリに追加されたときに発生します。 |
| MediaCollectionMediaRemoved | メディア項目がローカル ライブラリから削除されたときに発生します。 |
| MediaError | Media オブジェクトにエラー条件がある場合に発生します。 |
| ModeChange | Windows メディア プレーヤーのモードが変更されたときに発生します。 |
| Mousedown * | マウス ボタンが押されたときに発生します。 |
| Mousemove * | マウス ポインターが移動したときに発生します。 |
| Mouseup * | マウス ボタンが離されたときに発生します。 |
| NewStream | 将来使用するために予約されています。 |
| OpenPlaylistSwitch | DVD のタイトルの再生が開始されたときに発生します。 |
| OpenStateChange | Windows メディア プレーヤー コントロールの状態が変更されたときに発生します。 |
| PlaylistChange | プレイリストが変更されたときに発生します。 |
| PlaylistCollectionChange | プレイリスト コレクションで何かが変更されたときに発生します。 |
| PlaylistCollectionPlaylistAdded | プレイリストがプレイリスト コレクションに追加されたときに発生します。 |
| PlaylistCollectionPlaylistRemoved | プレイリストがプレイリスト コレクションから削除されたときに発生します。 |
| PlaylistCollectionPlaylistSetAsDeleted | 将来使用するために予約されています。 |
| PlayStateChange | Windows メディア プレーヤー コントロールの再生状態が変更されたときに発生します。 |
| PositionChange | メディア項目の現在位置が変更されたときに発生します。 |
| ScriptCommand | 同期されたコマンドまたは URL を受信したときに発生します。 |
| StatusChange | 状態プロパティの値が変更されたときに発生します。 |
| StringCollectionChange | 文字列コレクションが変更されたときに発生します。 |
| 警告 | 将来使用するために予約されています。 |
*スキンにはアクセスできません。 スキンでのマウス イベントとキーボード イベントの処理については、「 アンビエント イベント ハンドラー」を参照してください。
Web ページに埋め込まれている場合、 Player オブジェクトには、OBJECT タグで指定された ID 値を使用してアクセスできます。 スキン定義ファイル内では、 player グローバル属性を使用してアクセスされます。 説明のために、 player は参照構文セクションのオブジェクト ID として使用されます。
関連項目
フィードバック
フィードバックの送信と表示