Поделиться через


MediaEncodingProfile Класс

Определение

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

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
Наследование
Object Platform::Object IInspectable MediaEncodingProfile
Атрибуты

Требования к 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.

Применяется к

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