Partilhar via


CameraCaptureUI Classe

Definição

Fornece uma interface do usuário de janela completa para capturar áudio, vídeo e fotos de uma câmera. Além de controles para cortar vídeo, captura com atraso no tempo e configurações da câmera.

public ref class CameraCaptureUI sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class CameraCaptureUI final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class CameraCaptureUI
[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
Herança
Object Platform::Object IInspectable CameraCaptureUI
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo
microphone webcam

Exemplos

Esse código mostra como usar a classe CameraCaptureUI para tirar uma foto. O código é do arquivo CapturePhoto.xaml.cs do exemplo C# da interface do usuário de captura de câmera. O exemplo de C++ da interface do usuário de captura de câmera equivalente também está disponível. A caixa de diálogo com o usuário ocorre quando você chama o método assíncrono 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);

Comentários

CameraCaptureUI fornece uma experiência de interface do usuário de janela completa para capturar áudio, vídeo e imagens. Ele fornece controles para definir um atraso de tempo em capturas de fotos, cortar vídeo e ajustar as configurações da câmera, como resolução de vídeo, dispositivo de áudio, brilho e contraste.

Chame CaptureFileAsync para iniciar a interface do usuário. O usuário tem controle sobre quando iniciar a captura. Quando a operação Assíncrona CaptureFileAsync é concluída, um objeto StorageFile é retornado. Para obter diretrizes sobre como usar o CameraCaptureUI, consulte Capturar fotos e vídeos com a interface do usuário da câmera interna do Windows

Observação

Você não deve especificar os recursos de webcam ou microfone no arquivo de manifesto do aplicativo se estiver usando CameraCaptureUI. Se você fizer isso, seu aplicativo será exibido nas configurações de privacidade da câmera do dispositivo, mas mesmo que o usuário negue o acesso à câmera ao seu aplicativo, ele não impedirá que o CameraCaptureUI capture mídia. Isso ocorre porque o aplicativo de câmera interno do Windows é um aplicativo de terceiros confiável que exige que o usuário inicie a captura de foto, áudio e vídeo pressionando um botão. Seu aplicativo poderá falhar na certificação do Kit de Certificação de Aplicativos Windows quando enviado para a Loja se você especificar os recursos de webcam ou microfone ao usar CameraCaptureUI.

Você deve especificar os recursos de webcam ou microfone no arquivo de manifesto do aplicativo se estiver usando o MediaCapture para capturar áudio, fotos ou vídeo programaticamente.

Observação

Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e o comportamento de marshaling. Para obter mais informações, consulte Threading and Marshaling (C++/CX) e Using Windows Runtime objects in a multithreaded environment (.NET).

Construtores

CameraCaptureUI()

Crie um novo objeto CameraCaptureUI .

Propriedades

PhotoSettings

Fornece configurações para capturar fotos. As configurações incluem taxa de proporção, tamanho da imagem, formato, resolução e se o corte é permitido ou não pela interface do usuário.

VideoSettings

Fornece configurações para capturar vídeos. As configurações incluem formato, resolução máxima, duração máxima e se o corte deve ou não ser permitido.

Métodos

CaptureFileAsync(CameraCaptureUIMode)

Inicia a interface do usuário CameraCaptureUI .

Aplica-se a

Confira também