Класс QCameraFeedbackControl
Класс QCameraFeedbackControl позволяет управлять обратной связью (звуками и т. д.) во время работы камеры. Подробнее...
| Заголовок: | #include <QCameraFeedbackControl> |
| qmake: | QT += multimedia |
| С тех пор: | Qt 5.0 |
| Наследует: | QMediaControl |
Этот класс был представлен в Qt 5.0.
Открытые типы
| перечисление | EventType { ViewfinderStarted, ViewfinderStopped, ImageCaptured, ImageSaved, ImageError, …, AutoFocusFailed } |
Открытые функции
| виртуальный | ~QCameraFeedbackControl() |
| виртуальный bool | isEventFeedbackEnabled(QCameraFeedbackControl::EventType event) const = 0 |
| виртуальный bool | isEventFeedbackLocked(QCameraFeedbackControl::EventType event) const = 0 |
| виртуальный void | resetEventFeedback(QCameraFeedbackControl::EventType event) = 0 |
| виртуальный bool | setEventFeedbackEnabled(QCameraFeedbackControl::EventType event, bool enabled) = 0 |
| виртуальный bool | setEventFeedbackSound(QCameraFeedbackControl::EventType event, const QString &filePath) = 0 |
Защищенные функции
| QCameraFeedbackControl(QObject *parent = nullptr) |
Макросы
| QCameraFeedbackControl_iid |
Подробное описание
При работе с камерой в несколько моментов происходит обратная связь с пользователем — например, при съемке изображения или начале записи. Вы можете включить или отключить некоторые из этих обратных связей или настроить воспроизведение звука для этих действий.
В некоторых случаях воспроизведение звукового эффекта может быть нежелательным — например, при запуске видеозаписи сам звук может быть записан.
Примечание: В некоторых странах или регионах звуковые сигналы обратной связи или другие индикации (например, красный свет) являются обязательными при работе с камерой. В этих случаях вы можете проверить isEventFeedbackLocked для проверки возможности изменения этого типа обратной связи. Любые попытки изменить заблокированный тип обратной связи будут проигнорированы.
Имя интерфейса QCameraFeedbackControl — org.qt-project.qt.camerafeedbackcontrol/5.0 согласно определению в QCameraFeedbackControl_iid.
См. также QCamera.
Документация по типу члена
перечисление QCameraFeedbackControl::EventType
Это перечисление описывает определенные события, происходящие во время использования камеры. Вы можете связать какую-либо форму обратной связи с событием, или проверить, включена или заблокирована обратная связь для этого события, чтобы изменения нельзя было сделать.
| Постоянная | Значение | Описание |
|---|---|---|
QCameraFeedbackControl::ViewfinderStarted |
1 |
Поток видоискателя был запущен (даже если он не отображается) |
QCameraFeedbackControl::ViewfinderStopped |
2 |
Поток видоискателя был остановлен |
QCameraFeedbackControl::ImageCaptured |
3 |
Изображение было снято, но еще не полностью обработано |
QCameraFeedbackControl::ImageSaved |
4 |
Изображение полностью доступно и сохранено где-то. |
QCameraFeedbackControl::ImageError |
5 |
При съемке изображения произошла ошибка |
QCameraFeedbackControl::RecordingStarted |
6 |
Началась запись видео |
QCameraFeedbackControl::RecordingInProgress |
7 |
Запись видео выполняется |
QCameraFeedbackControl::RecordingStopped |
8 |
Запись видео остановлена |
QCameraFeedbackControl::AutoFocusInProgress |
9 |
Камера пытается выполнить автоматическую фокусировку |
QCameraFeedbackControl::AutoFocusLocked |
10 |
Камера успешно выполнила автоматическую фокусировку |
QCameraFeedbackControl::AutoFocusFailed |
11 |
Камера не смогла выполнить автоматическую фокусировку |
Документация по функции члена
[protected] QCameraFeedbackControl::QCameraFeedbackControl(QObject *parent = nullptr)
Создает объект управления обратной связью камеры с parent.
[virtual] QCameraFeedbackControl::~QCameraFeedbackControl()
Уничтожает объект управления обратной связью камеры.
[pure virtual] bool QCameraFeedbackControl::isEventFeedbackEnabled(QCameraFeedbackControl::EventType event) const
Возвращает true, если обратная связь для event включена.
Эта функция была представлена в Qt 5.0.
[pure virtual] bool QCameraFeedbackControl::isEventFeedbackLocked(QCameraFeedbackControl::EventType event) const
Возвращает true, если настройка обратной связи для event заблокирована. Это может быть истинно из-за проблем с соблюдением правовых норм или потому, что конфигурирование обратной связи для этого события не поддерживается.
Эта функция была представлена в Qt 5.0.
[pure virtual] void QCameraFeedbackControl::resetEventFeedback(QCameraFeedbackControl::EventType event)
Восстанавливает настройку обратной связи для этого event до ее значения по умолчанию.
Эта функция была представлена в Qt 5.0.
[pure virtual] bool QCameraFeedbackControl::setEventFeedbackEnabled(QCameraFeedbackControl::EventType event, bool enabled)
Включает обратную связь для указанного event, если enabled равно true, иначе отключает обратную связь. Возвращает true, если обратная связь может быть изменена, или false в противном случае (например, этот тип обратной связи заблокирован).
Эта функция была представлена в Qt 5.0.
См. также isEventFeedbackEnabled().
[pure virtual] bool QCameraFeedbackControl::setEventFeedbackSound(QCameraFeedbackControl::EventType event, const QString &filePath)
При возникновении данного event будет воспроизведен звуковой эффект, указанный в filePath, вместо стандартного звука.
Если этот тип обратной связи заблокирован или указанный путь недоступен, функция вернет false. Кроме того, некоторые виды обратной связи могут быть незвуковыми (например, красный свет или вибрация), и в этом случае может быть возвращено false.
Указанный файл должен быть линейным PCM (формат WAV).
Примечание: В случае, если задан недопустимый путь к файлу, эта функция вернет true, но обратная связь будет использовать исходное значение.
Эта функция была представлена в Qt 5.0.
Документация по макросу
QCameraFeedbackControl_iid
org.qt-project.qt.camerafeedbackcontrol/5.0
Определяет имя интерфейса класса QCameraFeedbackControl.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qcamerafeedbackcontrol.html
