MediaCapture Classe

Definizione

public ref class MediaCapture sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class MediaCapture final : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaCapture final : IClosable

[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.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class MediaCapture : System.IDisposable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaCapture : System.IDisposable

function MediaCapture()

Public NotInheritable Class MediaCapture
Implements IDisposable

Ereditarietà

Object Platform::Object IInspectable MediaCapture

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IClosable IDisposable

Requisiti Windows

Esempio

Nell'esempio di codice seguente viene illustrato come creare e inizializzare un oggetto MediaCapture .

// Create and initialze the MediaCapture object.
public async void InitMediaCapture()
{
    _mediaCapture = null;
    _mediaCapture = new Windows.Media.Capture.MediaCapture();

    // Set the MediaCapture to a variable in App.xaml.cs to handle suspension.
    (App.Current as App).MediaCapture = _mediaCapture;

    await _mediaCapture.InitializeAsync(_captureInitSettings);

    CreateProfile();
}

Per informazioni su come gestire la sospensione, vedi Gestire la sospensione dell'app.

<StackPanel Orientation="Horizontal">
    <CaptureElement x:Name="capturePreview" Width="320" Height="240" />
    <Image x:Name="imagePreview" Stretch="None" Width="320" Height="240" />
</StackPanel>

<StackPanel Orientation="Horizontal">
    <Button Click="InitCamera_Click" Content="Initialize Camera" />
    <Button Click="StartCapturePreview_Click" Content="Start Capture Preview" />
    <Button Click="CapturePhoto_Click" Content="Capture Photo"/>
    <Button Click="StopCapturePreview_Click" Content="Stop Capture Preview" />
</StackPanel>

Windows.Media.Capture.MediaCapture captureManager;

async private void InitCamera_Click(object sender, RoutedEventArgs e)
{
    captureManager = new MediaCapture();
    await captureManager.InitializeAsync();
}

async private void StartCapturePreview_Click(object sender, RoutedEventArgs e)
{
    capturePreview.Source = captureManager;
    await captureManager.StartPreviewAsync();
}

async private void StopCapturePreview_Click(object sender, RoutedEventArgs e)
{
    await captureManager.StopPreviewAsync();
}

async private void CapturePhoto_Click(object sender, RoutedEventArgs e)
{
    ImageEncodingProperties imgFormat = ImageEncodingProperties.CreateJpeg();

    // create storage file in local app storage
    StorageFile file = await ApplicationData.Current.LocalFolder.CreateFileAsync(
        "TestPhoto.jpg",
        CreationCollisionOption.GenerateUniqueName);

    // take photo
    await captureManager.CapturePhotoToStorageFileAsync(imgFormat, file);

    // Get photo as a BitmapImage
    BitmapImage bmpImage = new BitmapImage(new Uri(file.Path));

    // imagePreview is a <Image> object defined in XAML
    imagePreview.Source = bmpImage;
}

Commenti

La classe MediaCapture viene usata per acquisire audio, video e immagini da una fotocamera. Per indicazioni sulle procedure per visualizzare l'anteprima della fotocamera, vedi Visualizzare l'anteprima della fotocamera. Per iniziare rapidamente a acquisire foto, audio o video, vedi Acquisizione di foto, video e audio di base con MediaCapture.

La pagina Fotocamera è l'hub principale per indicazioni sulle procedure per l'uso di MediaCapture nell'app. Oltre alle attività di base della fotocamera, questa pagina contiene collegamenti ad articoli sulle procedure per scenari avanzati, tra cui:

• Uso del pulsante della fotocamera hardware nei dispositivi con uno
• Gestione dell'orientamento del dispositivo e dello schermo
• Uso dei profili della fotocamera per determinare le funzionalità del dispositivo
• Impostazione del formato, della risoluzione e della frequenza dei fotogrammi del video acquisito
• Uso di AdvancedPhotoCapture per acquisire foto HDR o di scarsa illuminazione
• Uso di VideoDeviceController per accedere a controlli manuali della fotocamera, ad esempio esposizione, bilanciamento del bianco, messa a fuoco automatica e flash
• Uso degli effetti durante l'acquisizione di video
• Acquisizione di sequenze fotografiche
• Uso di MediaFrameReader per ottenere un flusso di fotogrammi da una o più fotocamere, tra cui fotocamere rgb, infrarossi e di profondità
• Recupero di un frame dal flusso di anteprima

L'articolo Fotocamera include anche collegamenti a tutti gli esempi UWP SDK per la fotocamera, ad esempio l'esempio di kit di avvio fotocamera .

Il metodo InitializeAsync , che inizializza l'oggetto MediaCapture , deve essere chiamato prima di avviare l'anteprima o l'acquisizione dal dispositivo. Nelle app C# o C++ il primo uso dell'oggetto MediaCapture per chiamare InitializeAsync deve trovarsi nel thread STA. Le chiamate da un thread MTA possono comportare un comportamento non definito. InitializeAsync avvierà una richiesta di consenso per ottenere l'autorizzazione dell'utente per consentire all'app di accedere al microfono o alla fotocamera. InitializeAsync deve essere chiamato dal thread principale dell'interfaccia utente dell'app. Le app devono gestire la sospensione o la terminazione dell'app pulendo correttamente le risorse di acquisizione multimediale. Per informazioni sull'arresto corretto dell'oggetto MediaCapture , vedi Acquisizione di foto, video e audio di base con MediaCapture.

In Windows, le app di acquisizione di musica e multimediale devono monitorare SystemMediaTransportControls.SoundLevel per determinare se i flussi audio nell'app sono stati disattivati. Per le app che usano l'oggetto MediaCapture, l'acquisizione verrà arrestata automaticamente quando i flussi di acquisizione dell'app vengono disattivati. L'acquisizione non viene riavviata automaticamente quando i flussi audio non vengono attivati, quindi è possibile usare la notifica di modifica SoundLevel per riavviare l'acquisizione. Utilizzare l'evento SystemMediaTransportControls.PropertyChanged per determinare quando cambia la proprietà SoundLevel .

Per Windows Phone app 8.x, le app musicali e multimediali devono pulire l'oggetto MediaCapture e le risorse associate nel gestore eventi Suspending e ricrearle nel gestore eventi Ripresa.

In Windows 8.1 app solo audio, se l'impostazione MediaCategory è Other, viene usata la modalità di latenza elevata. Per bassa latenza, impostare l'impostazione MediaCategory su Comunicazioni.

L'aggiunta di un effetto di modifica sul posto di Media Foundation Transform nell'anteprima di acquisizione non avrà alcun effetto sul flusso.

Windows 8 le app UWP dichiarate sia le funzionalità webcam che del microfono non funzioneranno in Windows 8.1 se l'utente non ha abilitato sia le impostazioni di privacy della webcam che del microfono.

MediaCapture supporta solo una codifica CBR pass.

Note su JPEG: I tipi JPEG sono solo pass-through. Per acquisire un'immagine, il profilo di codifica delle immagini può essere impostato su Auto oppure è necessario specificare un profilo di codifica corrispondente al tipo nativo. Per aggiungere un effetto, è necessario passare a un tipo di supporto nativo video non compresso, ad esempio NV12 o RGB32.

Note sulla H.264: Se il tipo nativo è H.264, è possibile registrare usando un tipo di supporto video con tipo identico al tipo nativo. Non è possibile aggiungere un effetto a un flusso di tipi nativi H.264. Per acquisire video, il profilo di codifica delle immagini può essere impostato su Auto oppure è necessario specificare un profilo di codifica corrispondente al tipo nativo.

Cronologia delle versioni

Costruttori

Proprietà

Metodi

Eventi

Si applica a

Vedi anche

• Fotocamera
• Acquisizione di foto, video e audio di base con MediaCapture
• Esempio di acquisizione multimediale
• Esempio di interfaccia utente di acquisizione della fotocamera
• Esempio di interfaccia utente delle opzioni della fotocamera
• Esempio di enumerazione del dispositivo
• Esempio di comunicazione in tempo reale
• Esempio di estensione multimediale
• Formati audio e video supportati
• Esempio di comunicazione in tempo reale (Windows 10)
• Esempio di fotogrammi di anteprima della fotocamera
• Esempio di stabilizzazione video
• Esempio di acquisizione di holographic Realtà mista