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 傳回的值，以確定擷取裝置支援視訊設定檔。

如需使用視訊設定檔的作法指引，請參閱 使用相機設定檔探索及選取相機功能