MediaCapture Classe

Definição

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

Herança

Object Platform::Object IInspectable MediaCapture

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable

Requisitos do Windows

Exemplos

O exemplo de código a seguir mostra como criar e inicializar um objeto 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();
}

Para obter informações sobre como lidar com a suspensão, consulte Manipular a suspensão do aplicativo.

<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;
}

Comentários

A classe MediaCapture é usada para capturar áudio, vídeo e imagens de uma câmera. Para obter diretrizes de instruções para exibir a visualização da câmera, consulte Exibir a visualização da câmera. Para começar rapidamente a capturar fotos, áudio ou vídeo, consulte Captura básica de foto, vídeo e áudio com MediaCapture.

A página Câmera é o hub main para obter diretrizes de instruções para usar o MediaCapture em seu aplicativo. Além das tarefas básicas da câmera, esta página é vinculada a artigos de instruções para cenários avançados, incluindo:

• Usando o botão de câmera de hardware em dispositivos que têm um
• Manipulando orientação de dispositivo e tela
• Usando perfis de câmera para determinar as funcionalidades do dispositivo
• Definir o formato, a resolução e a taxa de quadros do vídeo capturado
• Usando AdvancedPhotoCapture para capturar fotos HDR ou de pouca luz
• Usando o VideoDeviceController para acessar controles manuais de câmera, como exposição, equilíbrio em branco, foco automático e flash
• Usando efeitos durante a captura de vídeo
• Capturando sequências de fotos
• Usando MediaFrameReader para obter um fluxo de quadros de uma ou mais câmeras, incluindo câmeras rgb, infravermelhas e de profundidade
• Obtendo um quadro do fluxo de visualização

O artigo Câmera também é vinculado a todos os exemplos do SDK da UWP para câmera, como o exemplo de kit inicial da câmera .

O método InitializeAsync , que inicializa o objeto MediaCapture , deve ser chamado antes de começar a visualizar ou capturar do dispositivo. Em aplicativos C# ou C++, o primeiro uso do objeto MediaCapture para chamar InitializeAsync deve estar no thread STA. Chamadas de um thread MTA podem resultar em um comportamento indefinido. InitializeAsync iniciará um prompt de consentimento para obter a permissão do usuário para que o aplicativo acesse o microfone ou a câmera. InitializeAsync deve ser chamado do thread de interface do usuário main do aplicativo. Os aplicativos devem lidar com a suspensão ou o encerramento do aplicativo limpando corretamente os recursos de captura de mídia. Para obter informações sobre como desligar o objeto MediaCapture corretamente, consulte Captura básica de foto, vídeo e áudio com MediaCapture.

No Windows, os aplicativos de captura de música e mídia devem monitorar o SystemMediaTransportControls.SoundLevel para determinar se os fluxos de áudio no aplicativo foram silenciados. Para aplicativos que usam o objeto MediaCapture, a captura será interrompida automaticamente quando os fluxos de captura do aplicativo forem ativados. A captura não é reiniciada automaticamente quando os fluxos de áudio são desativados, portanto, a notificação alterada soundLevel pode ser usada para reiniciar a captura. Use o evento SystemMediaTransportControls.PropertyChanged para determinar quando a propriedade SoundLevel é alterada.

Para aplicativos Windows Phone 8.x, os aplicativos de música e mídia devem limpo o objeto MediaCapture e os recursos associados no manipulador de eventos Suspending e recriá-los no manipulador de eventos Resuming.

Em Windows 8.1 somente aplicativos de áudio, se a configuração MediaCategory for Outros, o modo de alta latência será usado. Para baixa latência, defina a configuração MediaCategory como Comunicações.

Adicionar um efeito in-loco de edição do Media Foundation Transform à visualização de captura não terá efeito sobre o fluxo.

Windows 8 aplicativos UWP que declararam que os recursos de webcam e microfone não funcionarão em Windows 8.1 se o usuário não tiver habilitado as configurações de privacidade da webcam e do microfone.

O MediaCapture dá suporte apenas a uma codificação CBR de passagem.

Observações sobre JPEG: Os tipos JPEG são apenas passagem. Para capturar uma imagem, o perfil de codificação de imagem pode ser definido como Automático ou você precisa especificar um perfil de codificação que corresponda ao tipo nativo. Para adicionar um efeito, você precisa alternar para um tipo de mídia nativa de vídeo descompactado, como NV12 ou RGB32.

Observações sobre H.264: Se o tipo nativo for H.264, você poderá gravar usando um tipo de mídia de vídeo com tipo idêntico ao tipo nativo. Não é possível adicionar um efeito a um fluxo de tipo nativo H.264. Para capturar vídeo, o perfil de codificação de imagem pode ser definido como Automático ou você precisa especificar um perfil de codificação que corresponda ao tipo nativo.

Histórico de versão

Construtores

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• Câmera
• Captura básica de fotos, áudio e vídeo com MediaCapture
• Exemplo de captura de mídia
• Exemplo de interface do usuário de captura de câmera
• Exemplo de interface do usuário de opções de câmera
• Exemplo de enumeração de dispositivo
• Exemplo de comunicação em tempo real
• Exemplo de extensão de mídia
• Formatos de áudio e vídeo com suporte
• Exemplo de comunicação em tempo real (Windows 10)
• Exemplo de quadro de visualização da câmera
• Exemplo de estabilização de vídeo
• Exemplo de Captura de Realidade Misturada Holográfica