Condividi tramite


MediaEncodingProfile Classe

Definizione

Descrive il profilo di codifica per un file audio o video. Il profilo di codifica include descrizioni dei formati di codifica audio e video e una descrizione del contenitore multimediale.

public ref class MediaEncodingProfile sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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.MTA)]
class MediaEncodingProfile final
/// [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.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaEncodingProfile final
[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.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class MediaEncodingProfile
[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.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaEncodingProfile
function MediaEncodingProfile()
Public NotInheritable Class MediaEncodingProfile
Ereditarietà
Object Platform::Object IInspectable MediaEncodingProfile
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

La qualità di codifica Auto è un set di impostazioni speciali che riempie le impostazioni appropriate in base alle impostazioni correnti della fotocamera. Le impostazioni modificate manualmente vengono ignorate. Ad esempio, se si crea un profilo preimpostato usando uno dei metodi di creazione statici, ad esempio CreateM4a e si specifica Auto come qualità di codifica, tutte le modifiche apportate alle proprietà verranno sovrascritte con i valori in base alle impostazioni correnti della fotocamera.

Nota

È possibile creare un file MediaEncodingProfile non supportato in un determinato dispositivo. Ad esempio, è possibile chiamare CreateMp3, ma se un codificatore mp3 non è presente nel dispositivo, il tentativo di codificare l'audio con le proprietà restituite da questo metodo avrà esito negativo. Per un elenco dei codec presenti per impostazione predefinita per ogni famiglia di dispositivi, vedere Codec supportati.

Nota

Solo i tipi di profilo di codifica video supportano l'impostazione di qualità di codifica auto. I profili audio non supportano questa impostazione e genereranno un errore quando viene usata l'impostazione. Ad esempio: se si crea un profilo usando MediaEncodingProfile.CreateMp3 con AudioEncodingQuality.Auto e quindi chiamare PrepareStreamTranscodeAsync, verrà visualizzato un errore NullReferenceException . In questo caso è necessario scegliere un'impostazione di qualità di codifica diversa da Auto per consentire di creare un profilo funzionale.

Per indicazioni sull'uso di MediaEncodingProfile per impostare le proprietà di codifica per le immagini acquisite, vedere Foto di base, video e acquisizione audio con MediaCapture. Per informazioni sull'uso di MediaEncodingProfile durante la transcodatura dei file multimediali, vedere File multimediali transcode.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1703 15063 CreateAlac
1703 15063 CreateFlac
1703 15063 CreateHevc
1709 16299 GetAudioTracks
1709 16299 GetVideoTracks
1709 16299 SetAudioTracks
1709 16299 SetVideoTracks
1803 17134 GetTimedMetadataTracks
1803 17134 SetTimedMetadataTracks

Costruttori

MediaEncodingProfile()

Crea una nuova istanza della classe MediaEncodingProfile .

Proprietà

Audio

Ottiene o imposta le proprietà di codifica per il flusso audio.

Container

Ottiene o imposta le proprietà del contenitore multimediale.

Video

Ottiene o imposta le proprietà di codifica per il flusso video.

Metodi

CreateAlac(AudioEncodingQuality)

Crea un'istanza di MediaEncodingProfile per l'audio ALAC (Apple Lossless Audio Codec).

CreateAv1(VideoEncodingQuality)

Crea un profilo di codifica per il video AOMedia Video 1 (AV1).

CreateAvi(VideoEncodingQuality)

Crea un'istanza di MediaEncodingProfile per AVI.

CreateFlac(AudioEncodingQuality)

Crea un'istanza di MediaEncodingProfile per l'audio audio senza perdita di dati (FLAC).

CreateFromFileAsync(IStorageFile)

Crea un profilo di codifica da un file multimediale esistente.

CreateFromStreamAsync(IRandomAccessStream)

Crea un profilo di codifica da un flusso che contiene dati multimediali.

CreateHevc(VideoEncodingQuality)

Crea un'istanza del video MediaEncodingProfile per il video HEVC (High Efficiency Video Coding), noto anche come video H.265.

CreateM4a(AudioEncodingQuality)

Crea un profilo di codifica per l'audio AAC.

CreateMp3(AudioEncodingQuality)

Crea un profilo di codifica per l'audio MP3 (MPEG-1 layer 3).

CreateMp4(VideoEncodingQuality)

Crea un profilo di codifica per il video H.264.

CreateVp9(VideoEncodingQuality)

Crea un profilo di codifica per il video VP9.

CreateWav(AudioEncodingQuality)

Crea un'istanza di MediaEncodingProfile per WAV

CreateWma(AudioEncodingQuality)

Crea un profilo di codifica per Windows Media Audio (WMA).

CreateWmv(VideoEncodingQuality)

Crea un profilo di codifica per Windows Media Video (WMV).

GetAudioTracks()

Recupera l'elenco di oggetti AudioStreamDescriptor che descrivono i flussi audio inclusi nel File MediaEncodingProfile.

GetTimedMetadataTracks()

Recupera l'elenco di oggetti TimedMetadataStreamDescriptor che descrivono i flussi di metadati temporali inclusi nel MediaEncodingProfile.

GetVideoTracks()

Recupera l'elenco di oggetti VideoStreamDescriptor che descrivono i flussi video inclusi nel File MediaEncodingProfile.

SetAudioTracks(IIterable<AudioStreamDescriptor>)

Imposta l'elenco di oggetti AudioStreamDescriptor che descrivono i flussi audio inclusi nel File MediaEncodingProfile.

SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)

Imposta l'elenco di oggetti TimedMetadataStreamDescriptor che descrivono i flussi di metadati temporali inclusi nel File MediaEncodingProfile.

SetVideoTracks(IIterable<VideoStreamDescriptor>)

Imposta l'elenco di oggetti VideoStreamDescriptor che descrivono i flussi video inclusi nel File MediaEncodingProfile.

Si applica a

Vedi anche