MediaCapture.SetEncodingPropertiesAsync Метод

Определение

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

Windows.Media.Capture

Асинхронно задает свойства кодирования мультимедиа.

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

Параметры

mediaStreamType

MediaStreamType

Тип данных мультимедиа, которые представляет поток, например видео или аудио.

mediaEncodingProperties

IMediaEncodingProperties

Свойства для кодировки мультимедиа.

encoderProperties

MediaPropertySet

Свойства кодировщика.

Возвращаемое значение

IAsyncAction

Объект , используемый для управления асинхронной операцией.

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

Возможности приложения

backgroundMediaRecording

Комментарии

Этот метод задает свойства кодирования кодировщика, который обрабатывает данные перед их передачей в CaptureElement для отображения, записи в IRandomAccessStream или StorageFile или доставки в пользовательский приемник мультимедиа. Этот метод не изменяет конфигурацию источника данных, который является устройством камеры. Можно задать для свойств кодирования разрешение, которое изначально не поддерживается камерой. В этом случае конвейер MediaCapture будет использовать кодировщик для преобразования в запрошенный формат. Обратите внимание, что это преобразование потребляет системные ресурсы и может привести к снижению производительности или даже ошибкам, особенно на устройствах с ограниченным или без ускорения графики. Для типичных сценариев рекомендуется выбрать разрешение, поддерживаемое камерой, которое ближе всего к нужному разрешению. Список поддерживаемых разрешений устройства захвата можно получить, вызвав VideoDeviceController.GetAvailableMediaStreamProperties. Дополнительные сведения см. в разделах Установка формата, разрешения и частоты кадров для MediaCapture и пример разрешения камеры.

Примечание

SetEncodingPropertiesAsync завершится успешно, только если поток предварительного просмотра по умолчанию находится в состоянии потоковой передачи, т. е. после успешного вызова StartPreviewAsync . Если метод SetEncodingPropertiesAsync вызывается, когда объект MediaCapture выполняет потоковую передачу видео из MediaFrameSource через MediaPlayerElement или MediaFrameReader, этот вызов завершится ошибкой.

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

Чтобы изменить свойства устройства захвата, используйте VideoDeviceController.SetMediaStreamPropertiesAsync.

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

• GetAvailableMediaStreamProperties(MediaStreamType)
• SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties)
• Установка формата, разрешения и частоты кадров для MediaCapture
• Обработка ориентации устройства с помощью MediaCapture
• Пример разрешения камеры