MediaCapture.SetEncodingPropertiesAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 IAsyncActionPará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
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.