CameraCaptureUI Класс

Определение

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

Windows.Media.Capture

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

public ref class CameraCaptureUI sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class CameraCaptureUI final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class CameraCaptureUI

function CameraCaptureUI()

Public NotInheritable Class CameraCaptureUI

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

Object Platform::Object IInspectable CameraCaptureUI

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Семейство устройств	Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)
Возможности приложения	microphone webcam

Примеры

В этом коде показано, как использовать класс CameraCaptureUI для создания снимка. Код взят из файла CapturePhoto.xaml.cs примера C# пользовательского интерфейса захвата камеры. Также доступен эквивалентный пример пользовательского интерфейса записи камеры C++ . Диалоговое окно с пользователем возникает при вызове асинхронного метода CaptureFileAsync.

// Using Windows.Media.Capture.CameraCaptureUI API to capture a photo
CameraCaptureUI dialog = new CameraCaptureUI();
Size aspectRatio = new Size(16, 9);
dialog.PhotoSettings.CroppedAspectRatio = aspectRatio;

StorageFile file = await dialog.CaptureFileAsync(CameraCaptureUIMode.Photo);

Комментарии

CameraCaptureUI предоставляет полноэкранный пользовательский интерфейс для записи звука, видео и изображений. Он предоставляет элементы управления для настройки временной задержки при съемке фотографий, обрезки видео, а также для настройки параметров камеры, таких как разрешение видео, звуковое устройство, яркость и контрастность.

Вызовите CaptureFileAsync , чтобы запустить пользовательский интерфейс. Пользователь может контролировать время начала записи. После завершения асинхронной операции CaptureFileAsync возвращается объект StorageFile . Инструкции по использованию CameraCaptureUI см. в статье Захват фотографий и видео с помощью встроенного пользовательского интерфейса камеры Windows.

Примечание

При использовании CameraCaptureUI не следует указывать возможности веб-камеры или микрофона в файле манифеста приложения. В этом случае приложение будет отображаться в параметрах конфиденциальности камеры устройства, но даже если пользователь запретит доступ к вашему приложению с камеры, это не помешает CameraCaptureUI захватывать мультимедиа. Это обусловлено тем, что встроенное приложение камеры Windows является доверенным основным приложением, которое требует, чтобы пользователь инициировал захват фото, звука и видео нажатием кнопки. Если вы укажете возможности веб-камеры или микрофона при использовании CameraCaptureUI, ваше приложение может не получить сертификацию комплекта сертификации приложений Windows при отправке в Магазин.

Если вы используете MediaCapture для программного захвата звука, фотографий или видео, необходимо указать возможности веб-камеры или микрофона в файле манифеста приложения.

Примечание

Этот класс не является гибким. Это означает, что необходимо учитывать его модель потоков и поведение маршалинга. Дополнительные сведения см. в разделах Потоки и маршалинг (C++/CX) и Использование среда выполнения Windows объектов в многопоточной среде (.NET).

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

CameraCaptureUI()

Создайте объект CameraCaptureUI .

Свойства

PhotoSettings	Предоставляет параметры для захвата фотографий. Параметры включают пропорции, размер изображения, формат, разрешение и то, разрешена ли обрезка пользовательским интерфейсом.
VideoSettings	Предоставляет параметры для записи видео. Параметры включают формат, максимальное разрешение, максимальную длительность и возможность обрезки.

Методы

CaptureFileAsync(CameraCaptureUIMode)

Запускает пользовательский интерфейс CameraCaptureUI .

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

• Звук, видео и камера
• Фото- и видеосъемка с использованием встроенного пользовательского интерфейса камеры в Windows