Класс QCameraFeedbackControl
Класс QCameraFeedbackControl позволяет управлять обратной связью (звуками и т. п.) во время работы камеры. Подробнее...
| Заголовок: | #include <QCameraFeedbackControl> |
| qmake: | QT += multimedia |
| С момента: | Qt 5.0 |
| Наследуется от: | QMediaControl |
Типы публичного доступа
| перечисление | EventType { ViewfinderStarted, ViewfinderStopped, ImageCaptured, ImageSaved, ..., 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 |
- 34 функции публичного доступа, унаследованные от QObject
Защищённые функции
| QCameraFeedbackControl(QObject *parent = nullptr) |
- 9 защищённых функций, унаследованных от QObject
Макросы
| QCameraFeedbackControl_iid |
Дополнительные унаследованные члены
- 1 свойство, унаследованное от QObject
- 1 слот публичного доступа, унаследованный от QObject
- 2 сигнала, унаследованные от QObject
- 1 переменная публичного доступа, унаследованная от QObject
- 10 статические члены публичного доступа, унаследованные от QObject
- 2 защищённые переменные, унаследованные от QObject
Подробное описание
Класс QCameraFeedbackControl позволяет управлять обратной связью (звуками и т. п.) во время работы камеры.
При работе с камерой в несколько моментов пользователю предоставляется обратная связь, например, при съёмке изображения или запуске записи. Можно включить или отключить некоторые из этих видов обратной связи или настроить звуки для этих действий.
В некоторых случаях воспроизведение звукового эффекта может быть нежелательным, например, при запуске видеозаписи, чтобы сам звук не записывался.
Примечание: В некоторых странах или регионах звуковые сигналы обратной связи или другие индикации (например, красный свет) являются обязательными во время работы камеры. В этих случаях можно проверить 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, но обратная связь будет использовать исходные настройки.
END_OF_DOCUMENT_MARKERДанная функция была добавлена в 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/archives/qt-5.11/qcamerafeedbackcontrol.html