VideoEncodingProperties Classe

Definição

Namespace:

Windows.Media.MediaProperties

Descreve as propriedades de codificação de um fluxo de vídeo.

public ref class VideoEncodingProperties sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class VideoEncodingProperties final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class VideoEncodingProperties

function VideoEncodingProperties()

Public NotInheritable Class VideoEncodingProperties

Herança

Object Platform::Object IInspectable VideoEncodingProperties

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IMediaEncodingProperties

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

As propriedades definidas manualmente são ignoradas para VideoEncodingProperties criadas a partir de um dos perfis de codificação predefinidos: CreateH264 e CreateMpeg2.

A qualidade de codificação Automática é uma predefinição especial que preenche as configurações adequadas com base nas configurações atuais da câmera. As configurações modificadas manualmente são ignoradas. Por exemplo, se você criar um perfil predefinido usando um dos métodos de criação estáticos, como CreateM4a, e especificar Auto como a qualidade de codificação, todas as alterações feitas nas propriedades serão substituídas com valores com base nas configurações atuais da câmera.

Observação

É possível criar um VideoEncodingProperties sem suporte em um dispositivo específico. Por exemplo, você pode chamar CreateH264 com êxito, mas se um codificador h264 não estiver presente no dispositivo, a tentativa de codificar vídeo com as propriedades retornadas desse método falhará. Para obter uma lista dos codecs presentes por padrão para cada família de dispositivos, consulte Codecs com suporte..

Para obter diretrizes sobre como definir as propriedades de codificação para vídeo capturado, consulte Captura básica de foto, vídeo e áudio com MediaCapture.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	StereoscopicVideoPackingMode
1703	15063	CreateHevc
1703	15063	SphericalVideoFrameFormat
1803	17134	Copiar

Construtores

VideoEncodingProperties()

Cria uma nova instância da classe VideoEncodingProperties .

Propriedades

Bitrate	Obtém ou define a taxa de bits de vídeo.
FrameRate	Obtém ou define a taxa de quadros de vídeo.
Height	Obtém ou define a altura da imagem de vídeo.
PixelAspectRatio	Obtém ou define a taxa de proporção de pixel.
ProfileId	Obtém ou define o perfil de formato de mídia.
Properties	Obtém propriedades de formato adicionais para o fluxo de vídeo.
SphericalVideoFrameFormat	Obtém um valor que especifica o formato de vídeo esférico de um quadro de vídeo.
StereoscopicVideoPackingMode	Obtém um valor que indica o modo de empacotamento de vídeo estereoscópico do fluxo de vídeo.
Subtype	Obtém ou define o subtipo do formato.
Type	Obtém o tipo de formato.
Width	Obtém ou define a largura da imagem de vídeo.

Métodos

Copy()	Cria uma cópia do objeto VideoEncodingProperties .
CreateAv1()	Cria uma instância de VideoEncodingProperties para um vídeo aoMedia Video 1 (AV1).
CreateH264()	Cria uma instância de VideoEncodingProperties para um vídeo H.264.
CreateHevc()	Cria uma instância de VideoEncodingProperties para HEVC (Codificação de Vídeo de Alta Eficiência).
CreateMpeg2()	Cria uma instância de VideoEncodingProperties para um vídeo MPEG-2.
CreateUncompressed(String, UInt32, UInt32)	Cria uma instância de VideoEncodingProperties para um vídeo não compactado.
CreateVp9()	Cria uma instância de VideoEncodingProperties para um vídeo VP9.
GetFormatUserData(Byte[])	Obtém os dados do usuário de formato de mídia.
SetFormatUserData(Byte[])	Define os dados do usuário de formato de mídia.

Confira também

• Captura básica de fotos, áudio e vídeo com MediaCapture