CameraCaptureUI Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Media.Capture

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Fornisce un'interfaccia utente completa della finestra per l'acquisizione di audio, video e foto da una fotocamera. Oltre ai controlli per il ritaglio video, il tempo ritardato per l'acquisizione e le impostazioni della fotocamera.

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

Ereditarietà: Object Platform::Object IInspectable CameraCaptureUI

Attributi: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	microphone webcam

Esempio

Questo codice illustra come usare la classe CameraCaptureUI per scattare un'immagine. Il codice proviene dal file CapturePhoto.xaml.cs dell'esempio C# di acquisizione fotocamera. L'esempio equivalente di acquisizione dell'interfaccia utente C++ della fotocamera è disponibile anche. La finestra di dialogo con l'utente si verifica quando si chiama il metodo asincrono 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);

Commenti

CameraCaptureUI offre un'esperienza completa dell'interfaccia utente della finestra per l'acquisizione di audio, video e immagini. Fornisce controlli per impostare un ritardo di tempo per le acquisizioni di foto, il video di ritaglio e la regolazione delle impostazioni della fotocamera, ad esempio la risoluzione video, il dispositivo audio, la luminosità e il contrasto.

Chiamare CaptureFileAsync per avviare l'interfaccia utente. L'utente ha il controllo su quando avviare l'acquisizione. Al termine dell'operazione CaptureFileAsync asincrona , viene restituito un oggetto StorageFile . Per indicazioni sull'uso di CameraCaptureUI, vedere Acquisire foto e video con l'interfaccia utente della fotocamera predefinita di Windows

Nota

Non è consigliabile specificare le funzionalità della webcam o del microfono nel file manifesto dell'app se si usa CameraCaptureUI. In tal caso, l'app verrà visualizzata nelle impostazioni di privacy della fotocamera del dispositivo, ma anche se l'utente nega l'accesso alla fotocamera all'app, non impedirà l'acquisizione di supporti da parte di CameraCaptureUI . Questo avviene perché l'app Fotocamera predefinita di Windows è un'app attendibile che richiede all'utente di avviare l'acquisizione di foto, audio e video premendo un pulsante. Se si specificano le funzionalità della webcam o del microfono quando si usa CameraCaptureUI, l'app potrebbe non riuscire a eseguire la certificazione di Windows Application Certification Kit quando si esegue l'invio allo Store.

È necessario specificare le funzionalità della webcam o del microfono nel file manifesto dell'app se si usa MediaCapture per acquisire audio, foto o video a livello di codice.

Nota

Questa classe non è agile, il che significa che è necessario considerare il relativo modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading e marshalling (C++/CX) e Uso di oggetti Windows Runtime in un ambiente multithreaded (.NET).

Costruttori

CameraCaptureUI()

Creare un nuovo oggetto CameraCaptureUI .

Proprietà

PhotoSettings	Fornisce le impostazioni per l'acquisizione di foto. Le impostazioni includono proporzioni, dimensioni dell'immagine, formato, risoluzione e se il ritaglio è consentito dall'interfaccia utente.
VideoSettings	Fornisce le impostazioni per l'acquisizione di video. Le impostazioni includono formato, risoluzione massima, durata massima e se consentire o meno il taglio.

Metodi

CaptureFileAsync(CameraCaptureUIMode)

Avvia l'interfaccia utente CameraCaptureUI .

Si applica a

Condividi tramite