Класс QCameraFeedbackControl
Класс QCameraFeedbackControl позволяет управлять обратной связью (звуками и т. д.) во время работы камеры. Подробнее...
| Заголовок: | #include <QCameraFeedbackControl> |
| qmake: | QT += multimedia |
| С момента: | Qt 5.0 |
| Наследует: | QMediaControl |
Типы public
| перечисление | EventType { ViewfinderStarted, ViewfinderStopped, ImageCaptured, ImageSaved, ..., AutoFocusFailed } |
Функции public
| virtual | ~QCameraFeedbackControl() |
| virtual bool | isEventFeedbackEnabled(QCameraFeedbackControl::EventType event) const = 0 |
| virtual bool | isEventFeedbackLocked(QCameraFeedbackControl::EventType event) const = 0 |
| virtual void | resetEventFeedback(QCameraFeedbackControl::EventType event) = 0 |
| virtual bool | setEventFeedbackEnabled(QCameraFeedbackControl::EventType event, bool enabled) = 0 |
| virtual bool | setEventFeedbackSound(QCameraFeedbackControl::EventType event, const QString &filePath) = 0 |
- 31 public functions inherited from QObject
Статические члены public
| const QMetaObject | staticMetaObject |
- 9 static public members inherited from QObject
Защищенные функции
| QCameraFeedbackControl(QObject *parent = nullptr) |
- 9 protected functions inherited from QObject
Макросы
| QCameraFeedbackControl_iid |
Дополнительные унаследованные члены
- 1 property inherited from QObject
- 1 public slot inherited from QObject
- 2 signals inherited from 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).
END_OF_DOCUMENT_MARKERПримечание: В случае, если указан допустимый путь к файлу с неподдерживаемым форматом, эта функция вернёт 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.12/qcamerafeedbackcontrol.html
