Класс QCameraFeedbackControl
Класс QCameraFeedbackControl позволяет управлять обратной связью (звуками и т. д.) во время работы камеры Подробнее...
| Заголовок: | #include <QCameraFeedbackControl> |
| qmake: | QT += multimedia |
| С тех пор: | Qt 5.0 |
| Наследует: | QMediaControl |
Типы общего доступа
| перечисление | EventType { ViewfinderStarted, ViewfinderStopped, ImageCaptured, ImageSaved, ..., AutoFocusFailed } |
Функции общего доступа
| ~QCameraFeedbackControl() | |
| virtual bool | isEventFeedbackEnabled(EventType event) const = 0 |
| virtual bool | isEventFeedbackLocked(EventType event) const = 0 |
| virtual void | resetEventFeedback(EventType event) = 0 |
| virtual bool | setEventFeedbackEnabled(EventType event, bool enabled) = 0 |
| virtual bool | setEventFeedbackSound(EventType event, const QString &filePath) = 0 |
- 32 функции общего доступа, унаследованные от QObject
Защищенные функции
| QCameraFeedbackControl(QObject *parent = Q_NULLPTR) |
- 9 защищенных функций, унаследованных от QObject
Макросы
| QCameraFeedbackControl_iid |
Дополнительные унаследованные члены
- 1 свойство, унаследованное от QObject
- 1 публичный слот, унаследованный от QObject
- 2 сигналы, унаследованные от QObject
- 11 статические публичные члены, унаследованные от 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 = Q_NULLPTR)
Создаёт объект управления обратной связью камеры с parent.
QCameraFeedbackControl::~QCameraFeedbackControl()
Удаляет объект управления обратной связью камеры.
[pure virtual] bool QCameraFeedbackControl::isEventFeedbackEnabled(EventType event) const
Возвращает true, если обратная связь для event включена.
Функция была добавлена в Qt 5.0.
[pure virtual] bool QCameraFeedbackControl::isEventFeedbackLocked(EventType event) const
Возвращает true, если настройка обратной связи для event заблокирована. Это может быть вызвано проблемами соответствия нормам или потому что настройка обратной связи для этого события не поддерживается.
Функция была добавлена в Qt 5.0.
[pure virtual] void QCameraFeedbackControl::resetEventFeedback(EventType event)
Восстанавливает настройку обратной связи для данного event до её значения по умолчанию.
Функция была добавлена в Qt 5.0.
[pure virtual] bool QCameraFeedbackControl::setEventFeedbackEnabled(EventType event, bool enabled)
Включает обратную связь для определённого event, если enabled равно true, иначе отключает обратную связь. Возвращает true, если обратная связь могла быть изменена, или false в противном случае (например, этот тип обратной связи заблокирован).
Функция была добавлена в Qt 5.0.
См. также isEventFeedbackEnabled().
[pure virtual] bool QCameraFeedbackControl::setEventFeedbackSound(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.9/qcamerafeedbackcontrol.html
