MediaCapture.SetEncodingPropertiesAsync Método

Definición

Espacio de nombres:

Windows.Media.Capture

Establece de forma asincrónica las propiedades de codificación multimedia.

public:
 virtual IAsyncAction ^ SetEncodingPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties ^ mediaEncodingProperties, MediaPropertySet ^ encoderProperties) = SetEncodingPropertiesAsync;

IAsyncAction SetEncodingPropertiesAsync(MediaStreamType const& mediaStreamType, IMediaEncodingProperties const& mediaEncodingProperties, MediaPropertySet const& encoderProperties);

public IAsyncAction SetEncodingPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties mediaEncodingProperties, MediaPropertySet encoderProperties);

function setEncodingPropertiesAsync(mediaStreamType, mediaEncodingProperties, encoderProperties)

Public Function SetEncodingPropertiesAsync (mediaStreamType As MediaStreamType, mediaEncodingProperties As IMediaEncodingProperties, encoderProperties As MediaPropertySet) As IAsyncAction

Parámetros

mediaStreamType

MediaStreamType

Tipo de datos multimedia que representa la secuencia, como vídeo o audio.

mediaEncodingProperties

IMediaEncodingProperties

Propiedades de la codificación multimedia.

encoderProperties

MediaPropertySet

Propiedades del codificador.

Devoluciones

IAsyncAction

Objeto que se usa para controlar la operación asincrónica.

Requisitos de Windows

Características de aplicaciones

backgroundMediaRecording

Comentarios

Este método establece las propiedades de codificación del codificador que procesa los datos antes de pasarlos a un objeto CaptureElement que se va a mostrar, escribir en IRandomAccessStream o StorageFile, o entregarlos a un receptor multimedia personalizado. Este método no cambia la configuración del origen de los datos, que es el dispositivo de cámara. Es posible establecer las propiedades de codificación en una resolución que no sea compatible de forma nativa con la cámara. En este caso, la canalización MediaCapture usará un codificador para realizar la conversión al formato solicitado. Tenga en cuenta que esta conversión consume recursos del sistema y puede dar lugar a un rendimiento deficiente o incluso a errores, especialmente en los dispositivos que tienen una aceleración limitada o sin gráficos. En escenarios típicos, se recomienda elegir una resolución compatible con la cámara más cercana a la resolución deseada. Puede obtener una lista de las resoluciones admitidas de un dispositivo de captura llamando a VideoDeviceController.GetAvailableMediaStreamProperties. Para obtener más información, vea Establecer formato, resolución y velocidad de fotogramas para MediaCapture y el ejemplo de resolución de cámara.

Nota

SetEncodingPropertiesAsync solo se realizará correctamente cuando la secuencia de vista previa predeterminada esté en un estado de streaming, es decir, después de llamar correctamente a StartPreviewAsync . Si se llama a SetEncodingPropertiesAsync mientras el objeto MediaCapture transmite vídeo desde mediaFrameSource a través de mediaPlayerElement o MediaFrameReader, se producirá un error en esta llamada.

Para rotar el registro o la secuencia de vista previa, use el GUID definido por MF_MT_VIDEO_ROTATION para agregar metadatos a la secuencia. Tenga en cuenta que el consumidor de la secuencia realiza esta rotación, como CaptureElement o una aplicación de reproductor de vídeo, mientras que los píxeles reales de la secuencia siguen conservando su orientación original. Para obtener instrucciones paso a paso sobre cómo controlar la orientación al usar la cámara, consulta Controlar la orientación del dispositivo con MediaCapture.

Para modificar las propiedades del dispositivo de captura, use VideoDeviceController.SetMediaStreamPropertiesAsync.

Consulte también

• GetAvailableMediaStreamProperties(MediaStreamType)
• SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties)
• Establecer el formato, la resolución y la velocidad de fotogramas para MediaCapture
• Controlar la orientación del dispositivo con MediaCapture
• Ejemplo de resolución de cámara