Partilhar via


MediaCapture.SetEncodingPropertiesAsync Método

Definição

Define as propriedades de codificação de mídia de forma assíncrona.

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

O tipo de dados de mídia que o fluxo representa, como vídeo ou áudio.

mediaEncodingProperties
IMediaEncodingProperties

As propriedades da codificação de mídia.

encoderProperties
MediaPropertySet

As propriedades do codificador.

Retornos

Objeto usado para controlar a operação assíncrona.

Requisitos do Windows

Funcionalidades do aplicativo
backgroundMediaRecording

Comentários

Esse método define as propriedades de codificação do codificador que processa os dados antes de serem passados para um CaptureElement a serem exibidos, gravados em um IRandomAccessStream ou StorageFile ou entregues a um coletor de mídia personalizado. Esse método não altera a configuração da origem dos dados, que é o dispositivo de câmera. É possível definir as propriedades de codificação para uma resolução que não tem suporte nativo pela câmera. Nesse caso, o pipeline MediaCapture usará um codificador para executar a conversão no formato solicitado. Observe que essa conversão consome recursos do sistema e pode resultar em baixo desempenho ou até mesmo erros, especialmente em dispositivos com aceleração de elementos gráficos limitados ou sem aceleração gráfica. Para cenários típicos, é recomendável que você escolha uma resolução compatível com a câmera mais próxima da resolução desejada. Você pode obter uma lista das resoluções com suporte de um dispositivo de captura chamando VideoDeviceController.GetAvailableMediaStreamProperties. Para obter mais informações, consulte Definir formato, resolução e taxa de quadros para MediaCapture e o Exemplo de Resolução da Câmera.

Observação

SetEncodingPropertiesAsync só terá êxito quando o fluxo de visualização padrão estiver em um estado de streaming, ou seja, depois que StartPreviewAsync tiver sido chamado com êxito. Se SetEncodingPropertiesAsync for chamado enquanto o objeto MediaCapture estiver transmitindo vídeo de um MediaFrameSource por meio de um MediaPlayerElement ou MediaFrameReader, essa chamada falhará.

Para girar o registro ou o fluxo de visualização, use o GUID definido por MF_MT_VIDEO_ROTATION para adicionar metadados ao fluxo. Observe que essa rotação é executada pelo consumidor do fluxo, como CaptureElement ou um aplicativo player de vídeo, enquanto os pixels reais no fluxo ainda mantêm sua orientação original. Para obter diretrizes sobre como lidar com a orientação ao usar a câmera, consulte Manipular a orientação do dispositivo com MediaCapture.

Para modificar as propriedades do dispositivo de captura, use VideoDeviceController.SetMediaStreamPropertiesAsync.

Aplica-se a

Confira também