CameraCaptureUI Clase

Definición

Espacio de nombres:

Windows.Media.Capture

Proporciona una interfaz de usuario de ventana completa para capturar audio, vídeo y fotos de una cámara. Además de los controles para recortar vídeo, la captura diferida de tiempo y la configuración de la cámara.

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

Herencia

Object Platform::Object IInspectable CameraCaptureUI

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
Características de aplicaciones	microphone webcam

Ejemplos

Este código muestra cómo usar la clase CameraCaptureUI para tomar una imagen. El código procede del archivo CapturePhoto.xaml.cs del ejemplo C# de captura de cámara. El ejemplo de C++ de captura de cámara equivalente también está disponible. El cuadro de diálogo con el usuario se produce cuando se llama al método asincrónico 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);

Comentarios

CameraCaptureUI proporciona una experiencia de interfaz de usuario de ventana completa para capturar audio, vídeo e imágenes. Proporciona controles para establecer un retraso de tiempo en las capturas de fotos, recortar vídeo y para ajustar la configuración de la cámara, como la resolución de vídeo, el dispositivo de audio, el brillo y el contraste.

Llame a CaptureFileAsync para iniciar la interfaz de usuario. El usuario tiene control sobre cuándo iniciar la captura. Cuando se completa la operación asincrónica CaptureFileAsync , se devuelve un objeto StorageFile . Para obtener instrucciones paso a paso para usar CameraCaptureUI, consulta Capturar fotos y vídeo con la interfaz de usuario de cámara integrada de Windows.

Nota:

No debes especificar las funcionalidades de cámara web o micrófono en el archivo de manifiesto de la aplicación si usas CameraCaptureUI. Si lo haces, la aplicación se mostrará en la configuración de privacidad de la cámara del dispositivo, pero incluso si el usuario deniega el acceso de la cámara a la aplicación, no impedirá que CameraCaptureUI capture medios. Esto es porque la aplicación de cámara integrada de Windows es una aplicación de origen de confianza que requiere que el usuario inicie la captura de fotos, audio y vídeo con la presión de un botón. La aplicación puede producir un error en la certificación del Kit de certificación de aplicaciones de Windows cuando se envía a la Tienda si especificas las funcionalidades de cámara web o micrófono al usar CameraCaptureUI.

Debes especificar las funcionalidades de cámara web o micrófono en el archivo de manifiesto de la aplicación si usas MediaCapture para capturar audio, fotos o vídeo mediante programación.

Nota:

Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, vea Subprocesos y serialización (C++/CX) y Uso de objetos Windows Runtime en un entorno multiproceso (.NET).

Constructores

CameraCaptureUI()

Cree un nuevo objeto CameraCaptureUI .

Propiedades

PhotoSettings	Proporciona la configuración para capturar fotos. La configuración incluye la relación de aspecto, el tamaño de la imagen, el formato, la resolución y si la interfaz de usuario (UI) permite o no el recorte.
VideoSettings	Proporciona la configuración para capturar vídeos. La configuración incluye el formato, la resolución máxima, la duración máxima y si se va a permitir el recorte.

Métodos

CaptureFileAsync(CameraCaptureUIMode)

Inicia la interfaz de usuario CameraCaptureUI .

Consulte también

• Audio, vídeo y cámara
• Capturar fotografías y vídeos con la interfaz de usuario de la cámara integrada de Windows