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 CameraCaptureUIfunction CameraCaptureUI()Public NotInheritable Class 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 . |