MediaCaptureInitializationSettings.VideoProfile プロパティ

定義

名前空間:

Windows.Media.Capture

さまざまなキャプチャ シナリオに合わせて最適化するためのヒントをドライバーに提供するビデオ プロファイルを取得または設定します。

public:
 property MediaCaptureVideoProfile ^ VideoProfile { MediaCaptureVideoProfile ^ get(); void set(MediaCaptureVideoProfile ^ value); };

MediaCaptureVideoProfile VideoProfile();

void VideoProfile(MediaCaptureVideoProfile value);

public MediaCaptureVideoProfile VideoProfile { get; set; }

var mediaCaptureVideoProfile = mediaCaptureInitializationSettings.videoProfile;
mediaCaptureInitializationSettings.videoProfile = mediaCaptureVideoProfile;

Public Property VideoProfile As MediaCaptureVideoProfile

プロパティ値

MediaCaptureVideoProfile

ビデオ プロファイル。

Windows の要件

アプリの機能

backgroundMediaRecording

注釈

ビデオ プロファイルは、特定のキャプチャ デバイスで動作することが保証され、目的のキャプチャ シナリオに合わせて最適化された設定のグループを使用してビデオ キャプチャ デバイスを構成する簡単な方法を提供します。 ビデオキャプチャやビデオ会議中に高品質の写真をキャプチャするなど、一般的なシナリオに対してシステムが提供する一連の既知のビデオ プロファイルがあります。 特定のビデオ デバイスの既知のビデオ プロファイルの一覧を取得するには、 MediaCapture.FindKnownVideoProfiles を使用します。 一部のハードウェア ベンダーは、 MediaCapture.FindAllVideoProfiles を呼び出すことによって取得できる他のビデオ プロファイルを公開する場合があります。 ビデオ プロファイルの詳細については、「 MediaCaptureVideoProfile」を参照してください。

このプロパティに使用する値によって、 MediaCaptureInitializationSettings の他のプロパティの値がどのように処理されるかが決まります。

• VideoProfile を有効な MediaCaptureVideoProfile オブジェクトに設定すると、システムはプロファイルに関連付けられているドライバー ヒントを使用し、 PhotoMediaDescription、PreviewMediaDescription、 RecordMediaDescription の各プロパティに指定したメディア記述値 を 使用します。
• VideoProfile を有効な MediaCaptureVideoProfile オブジェクトに設定し、PhotoMediaDescription、PreviewMediaDescription、または RecordMediaDescription プロパティを設定しない場合、システムはプロファイルに関連付けられているドライバー ヒントを使用し、プロファイルの SupportedPhotoMediaDescription、SupportedPreviewMediaDescription、SupportedRecordMediaDescription の最初の (0 インデックス) エントリを使用します。は、それぞれのプロパティのメディアの説明として一覧表示されます。
• VideoProfile の値がまったく設定されていない場合、システムは PhotoMediaDescription、 PreviewMediaDescription、 RecordMediaDescription の値を無視し、ビデオ プロファイル API が導入される前にレガシ動作に戻します。

ビデオ プロファイルを使用する前に、MediaCapture.IsVideoProfileSupported によって返される値をチェックして、ビデオ プロファイルがキャプチャ デバイスでサポートされていることを確認する必要があります。

ビデオ プロファイルの使用方法に関するガイダンスについては、「カメラ プロファイルを使用したカメラ機能の検出と選択」を参照してください