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


CameraCaptureUI Класс

Определение

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

public ref class CameraCaptureUI 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.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.STA)]
class CameraCaptureUI final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class CameraCaptureUI
[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
Атрибуты

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

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

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