MediaCapture Clase

Definición

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

Herencia

Object Platform::Object IInspectable MediaCapture

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable

Requisitos de Windows

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear e inicializar un 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 obtener información sobre cómo controlar la suspensión, consulta Controlar la suspensión de la aplicación.

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

Comentarios

La clase MediaCapture se usa para capturar audio, vídeo e imágenes de una cámara. Para obtener instrucciones paso a paso para mostrar la vista previa de la cámara, consulte Visualización de la vista previa de la cámara. Para empezar rápidamente a capturar fotos, audio o vídeo, consulte Captura básica de fotos, vídeos y audio con MediaCapture.

La página Cámara es el centro principal para obtener instrucciones paso a paso para usar MediaCapture en la aplicación. Además de las tareas básicas de cámara, en esta página se incluyen vínculos a artículos de procedimientos para escenarios avanzados, entre los que se incluyen:

• Uso del botón de cámara de hardware en los dispositivos que tienen una
• Control de la orientación del dispositivo y la pantalla
• Uso de perfiles de cámara para determinar las funcionalidades del dispositivo
• Establecimiento del formato, la resolución y la velocidad de fotogramas del vídeo capturado
• Uso de AdvancedPhotoCapture para capturar fotos HDR o de poca luz
• Uso de VideoDeviceController para acceder a controles manuales de cámara, como la exposición, el balance de blancos, el enfoque automático y el flash
• Uso de efectos al capturar vídeo
• Captura de secuencias de fotos
• Uso de MediaFrameReader para obtener una secuencia de fotogramas de una o varias cámaras, incluidas las cámaras rgb, infrarrojos y de profundidad
• Obtención de un fotograma de la secuencia de vista previa

En el artículo Cámara también se incluyen vínculos a todos los ejemplos del SDK para UWP para la cámara, como el ejemplo del kit de inicio de cámara.

Se debe llamar al método InitializeAsync , que inicializa el objeto MediaCapture , para poder empezar a obtener una vista previa o capturar desde el dispositivo. En las aplicaciones de C# o C++, el primer uso del objeto MediaCapture para llamar a InitializeAsync debe estar en el subproceso STA. Las llamadas desde un subproceso de MTA pueden dar lugar a un comportamiento indefinido. InitializeAsync iniciará una petición de consentimiento para obtener el permiso del usuario para que la aplicación acceda al micrófono o la cámara. Se debe llamar a InitializeAsync desde el subproceso principal de la interfaz de usuario de la aplicación. Las aplicaciones deben controlar la suspensión o la finalización de la aplicación limpiando correctamente los recursos de captura de medios. Para obtener información sobre cómo apagar correctamente el objeto MediaCapture , consulte Captura básica de fotos, vídeos y audio con MediaCapture.

En Windows, las aplicaciones de captura de música y multimedia deben supervisar SystemMediaTransportControls.SoundLevel para determinar si las secuencias de audio de la aplicación se han silenciado. En el caso de las aplicaciones que usan el objeto MediaCapture, la captura se detendrá automáticamente cuando se silencian las secuencias de captura de la aplicación. La captura no se vuelve a iniciar automáticamente cuando se desmutan las secuencias de audio, por lo que se puede usar la notificación de cambio SoundLevel para reiniciar la captura. Use el evento SystemMediaTransportControls.PropertyChanged para determinar cuándo cambia la propiedad SoundLevel .

Para Windows Phone aplicaciones 8.x, las aplicaciones de música y multimedia deben limpiar el objeto MediaCapture y los recursos asociados en el controlador de eventos Suspending y volver a crearlos en el controlador de eventos Resuming.

En Windows 8.1 solo aplicaciones de audio, si la configuración MediaCategory es Other, se usa el modo de latencia alta. Para una latencia baja, establezca la opción MediaCategory en Comunicaciones.

Agregar un efecto de edición local de Media Foundation Transform a la vista previa de captura no tendrá ningún efecto en la secuencia.

Windows 8 aplicaciones para UWP que han declarado las funcionalidades de cámara web y micrófono no funcionarán en Windows 8.1 si el usuario no ha habilitado la configuración de privacidad de la cámara web y del micrófono.

MediaCapture solo admite una codificación CBR de paso.

Notas sobre JPEG: Los tipos JPEG son solo de paso a través. Para capturar una imagen, el perfil de codificación de imágenes se puede establecer en Auto o debe especificar un perfil de codificación que coincida con el tipo nativo. Para agregar un efecto, debe cambiar a un tipo de medio nativo de vídeo sin comprimir, como NV12 o RGB32.

Notas sobre H.264: Si el tipo nativo es H.264, puede grabar mediante un tipo de medio de vídeo con el tipo idéntico al tipo nativo. No se puede agregar un efecto a una secuencia de tipo nativo H.264. Para capturar vídeo, el perfil de codificación de imágenes se puede establecer en Auto o debe especificar un perfil de codificación que coincida con el tipo nativo.

Historial de versiones

Constructores

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

• Cámara
• Captura básica de fotos, audio y vídeo con MediaCapture
• Ejemplo de captura de medios
• Ejemplo de interfaz de usuario de captura de cámara
• Ejemplo de interfaz de usuario de opciones de cámara
• Ejemplo de enumeración de dispositivos
• Ejemplo de comunicación en tiempo real
• Ejemplo de extensión multimedia
• Formatos de audio y vídeo admitidos
• Ejemplo de comunicación en tiempo real (Windows 10)
• Muestra de marco de vista previa de la cámara
• Ejemplo de estabilización de vídeo
• Ejemplo de captura de Mixed Reality holográfica