ライブラリ アクセス

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

ライブラリにアクセスするWindows メディア プレーヤー オブジェクト モデルのプロパティとメソッドには、データベースへの読み取り専用または読み取り/書き込みアクセス権が必要です。 ライブラリには、一部のユーザーが非公開にしておきたい情報が含まれており、同意を得た場合にのみアクセスまたは変更する必要があります。

Windows メディア プレーヤー 9 シリーズ以降の場合は、プログラムでアクセス レベルを決定できます。 コードに付与されている現在のアクセス レベルを確認するには、[ 設定] を取得します。mediaAccessRights プロパティ。 このプロパティは、"none"、"read"、または "full" (読み取り/書き込み) を返します。 特定のアクセス権を要求するには、[ 設定] を呼び出します。requestMediaAccessRights メソッド。要求するレベルを指定するパラメーターを渡します。 メソッドは、要求されたアクセス レベルを説明するメッセージをユーザーに表示し、アクセスが許可されたかどうかを示す ブール 値を返します。

ユーザーのコンピューターを基準にしてコードが実行されている場所に応じて、特定のアクセス権が自動的に付与されます。

• Web ページまたはプログラムがユーザーのコンピューターにある場合、既定ではフル アクセス権が付与されます。

• Web ページには、Player への読み取りアクセス権があります。currentMedia、Player。currentPlaylist、および Media。sourceURL:Web ページがインターネット エクスプローラーセキュリティ ゾーンにあり、メディア アイテムまたはプレイリストのセキュリティ ゾーンと同じか、または制限されていない場合。

  セキュリティ ゾーンは、制限が最も少ないゾーンから最も制限の多いものまで、 信頼ゾーン (ユーザーのローカル コンピューターを含む)、 ローカル イントラネット ゾーン、 インターネット ゾーン、 制限付き ゾーンです。

  たとえば、ローカル イントラネット ゾーンの Web ページには、Player へのフル アクセス権があります。対応するメディア項目がローカル イントラネットまたはインターネット上にあるが、ユーザーのローカル コンピューターまたは信頼済みゾーンの Web サイトにあるメディアアイテムに対してアクセス権を要求する必要がある場合は currentMedia。

Web ベースまたは Windows ベースのアプリケーションは、発生する可能性があるすべてのセキュリティ ゾーンでテストする必要があります。 アプリケーションは、アクセス要求の拒否を正しく処理するように設計する必要があります。

Windows メディア プレーヤー 9 シリーズより前のバージョンWindows メディア プレーヤーオブジェクト モデルには、mediaAccessRights や requestMediaAccessRights は含まれません。 これらの以前のバージョンのWindows メディア プレーヤーを使用すると、ユーザーは [オプション] ダイアログ ボックスを使用してアクセス レベルを設定できます。

関連トピック

Settings オブジェクト

ライブラリの操作