CameraCaptureUI 類別

定義

命名空間:

Windows.Media.Capture

提供從相機擷取音訊、視訊和相片的完整視窗 UI。 以及修剪視訊、時間延遲擷取和相機設定的控制項。

public ref class CameraCaptureUI sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class CameraCaptureUI final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class CameraCaptureUI

function CameraCaptureUI()

Public NotInheritable Class CameraCaptureUI

繼承

Object Platform::Object IInspectable CameraCaptureUI

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
應用程式功能	microphone webcam

範例

此程式碼示範如何使用 CameraCaptureUI 類別來拍攝圖片。 程式碼來自 相機擷取 UI C# 範例的 CapturePhoto.xaml.cs 檔案。 您也可以使用對等 的相機擷取 UI C++ 範例 。 當您呼叫非同步方法 CaptureFileAsync時，就會發生與使用者的對話方塊。

// Using Windows.Media.Capture.CameraCaptureUI API to capture a photo
CameraCaptureUI dialog = new CameraCaptureUI();
Size aspectRatio = new Size(16, 9);
dialog.PhotoSettings.CroppedAspectRatio = aspectRatio;

StorageFile file = await dialog.CaptureFileAsync(CameraCaptureUIMode.Photo);

備註

CameraCaptureUI 提供擷取音訊、視訊和影像的完整視窗 UI 體驗。 它提供控制項來設定相片擷取的時間延遲、修剪視訊，以及調整相機的設定，例如視訊解析度、音訊裝置、亮度和對比。

呼叫 CaptureFileAsync 以啟動 UI。 使用者可控制何時啟動擷取。 當非同步 CaptureFileAsync 作業完成時，會傳回 StorageFile 物件。 如需使用 CameraCaptureUI的作法指引，請參閱 使用 Windows 內建相機 UI 擷取相片和視訊

注意

如果您使用CameraCaptureUI，則不應該在應用程式資訊清單檔案中指定網路攝影機或麥克風功能。 如果您這樣做，您的應用程式將會顯示在裝置的相機隱私權設定中，但即使使用者拒絕相機存取您的應用程式，它也不會防止 CameraCaptureUI 擷取媒體。 原因是 Windows 內建相機應用程式是信任的第一方應用程式，需要使用者透過按下按鈕來起始相片、音訊和視訊擷取。 如果您在使用CameraCaptureUI時指定網路攝影機或麥克風功能，您的應用程式可能會在提交至市集時失敗 Windows 應用程式認證套件認證。

如果您使用MediaCapture以程式設計方式擷取音訊、相片或視訊，則必須在應用程式資訊清單檔案中指定網路攝影機或麥克風功能。

注意

這個類別不是敏捷的，這表示您必須考慮其執行緒模型和封送處理行為。 如需詳細資訊，請參閱執行緒和封送處理 (C++/CX) 和在多執行緒環境中使用 Windows 執行階段 物件 (.NET) 。

建構函式

CameraCaptureUI()

建立新的 CameraCaptureUI 物件。

屬性

PhotoSettings	提供擷取相片的設定。 這些設定包括外觀比例、影像大小、格式、解析度，以及使用者介面是否允許裁剪 (UI) 。
VideoSettings	提供擷取影片的設定。 這些設定包括格式、解析度上限、持續時間上限，以及是否允許修剪。

方法

CaptureFileAsync(CameraCaptureUIMode)

啟動 CameraCaptureUI 使用者介面。

另請參閱

• 音訊、視訊和相機
• 使用 Windows 內建相機 UI 來擷取相片和視訊