MediaEncodingProfile Класс

Определение

Пространство имен:

Windows.Media.MediaProperties

Описывает профиль кодирования для звукового или видеофайла. Профиль кодирования содержит описания форматов кодирования аудио и видео, а также описание контейнера мультимедиа.

public ref class MediaEncodingProfile 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.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaEncodingProfile 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.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaEncodingProfile

function MediaEncodingProfile()

Public NotInheritable Class MediaEncodingProfile

Наследование

Object Platform::Object IInspectable MediaEncodingProfile

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Автокодирование качества — это специальная предустановка, которая заполняет правильные параметры на основе текущих параметров камеры. Параметры, которые изменяются вручную, игнорируются. Например, если создать предустановленный профиль с помощью статического метода create, например CreateM4a, и указать Авто в качестве качества кодирования, любые изменения, внесенные в свойства, будут перезаписаны значениями на основе текущих параметров камеры.

Примечание

Можно создать MediaEncodingProfile , который не поддерживается на определенном устройстве. Например, можно успешно вызвать CreateMp3, но если кодировщик mp3 отсутствует на устройстве, попытка закодировать звук с помощью свойств, возвращаемых этим методом, завершится ошибкой. Список кодеков, присутствующих по умолчанию для каждого семейства устройств, см. в разделе Поддерживаемые кодеки.

Примечание

Только типы профилей кодирования видео поддерживают параметр качества кодирования auto. Профили аудио не поддерживают этот параметр и при использовании параметра будет возникать ошибка. Например, если создать профиль с помощью MediaEncodingProfile.CreateMp3 с AudioEncodingQuality.Auto , а затем вызвать PrepareStreamTranscodeAsync, вы получите ошибку NullReferenceException . В этом случае необходимо выбрать параметр качества кодирования, отличный от Auto, чтобы можно было создать функциональный профиль.

Инструкции по настройке свойств кодирования для захваченных изображений с помощью MediaEncodingProfile см. в статье Основные возможности захвата фотографий, видео и аудио с помощью MediaCapture. Сведения об использовании MediaEncodingProfile при перекодировки файлов мультимедиа см. в разделе Перекодирование файлов мультимедиа.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
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

Конструкторы

MediaEncodingProfile()

Создает новый экземпляр класса MediaEncodingProfile .

Свойства

Audio	Возвращает или задает свойства кодирования для звукового потока.
Container	Возвращает или задает свойства контейнера мультимедиа.
Video	Возвращает или задает свойства кодирования для видеопотока.

Методы

CreateAlac(AudioEncodingQuality)	Создает экземпляр MediaEncodingProfile для аудиокодека Apple Lossless Audio (ALAC).
CreateAv1(VideoEncodingQuality)	Создает профиль кодирования для видео AOMedia Video 1 (AV1).
CreateAvi(VideoEncodingQuality)	Создает экземпляр MediaEncodingProfile для AVI.
CreateFlac(AudioEncodingQuality)	Создает экземпляр MediaEncodingProfile для бесплатного аудиокодека без потерь (FLAC).
CreateFromFileAsync(IStorageFile)	Создает профиль кодирования из существующего файла мультимедиа.
CreateFromStreamAsync(IRandomAccessStream)	Создает профиль кодирования из потока, содержащего данные мультимедиа.
CreateHevc(VideoEncodingQuality)	Создает экземпляр видео MediaEncodingProfile для видео с высокой эффективностью (HEVC), также известного как видео H.265.
CreateM4a(AudioEncodingQuality)	Создает профиль кодирования для звука AAC.
CreateMp3(AudioEncodingQuality)	Создает профиль кодирования для звука MP3 (MPEG-1 уровня 3).
CreateMp4(VideoEncodingQuality)	Создает профиль кодирования для видео H.264.
CreateVp9(VideoEncodingQuality)	Создает профиль кодирования для видео VP9.
CreateWav(AudioEncodingQuality)	Создает экземпляр MediaEncodingProfile для WAV.
CreateWma(AudioEncodingQuality)	Создает профиль кодирования для Windows Media Audio (WMA).
CreateWmv(VideoEncodingQuality)	Создает профиль кодирования для Windows Media Video (WMV).
GetAudioTracks()	Извлекает список объектов AudioStreamDescriptor, описывающих звуковые потоки, включенные в MediaEncodingProfile.
GetTimedMetadataTracks()	Извлекает список объектов TimedMetadataStreamDescriptor , описывающих потоки метаданных времени, включенные в MediaEncodingProfile.
GetVideoTracks()	Извлекает список объектов VideoStreamDescriptor , описывающих видеопотоки, включенные в MediaEncodingProfile.
SetAudioTracks(IIterable<AudioStreamDescriptor>)	Задает список объектов AudioStreamDescriptor, описывающих звуковые потоки, включенные в MediaEncodingProfile.
SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)	Задает список объектов TimedMetadataStreamDescriptor, описывающих потоки метаданных, включенные в MediaEncodingProfile.
SetVideoTracks(IIterable<VideoStreamDescriptor>)	Задает список объектов VideoStreamDescriptor, описывающих видеопотоки, включенные в MediaEncodingProfile.

См. также раздел

• Пример перекодирования мультимедиа (Windows 10)
• Основные принципы фото-, аудио- и видеозахвата с помощью MediaCapture
• Перекодирование файлов мультимедиа