Класс QCameraFeedbackControl
Класс QCameraFeedbackControl позволяет управлять обратной связью (звуками и т. п.) во время работы камеры. Подробнее...
| Заголовок: | #include <QCameraFeedbackControl> |
| qmake: | QT += multimedia |
| С тех пор: | Qt 5.0 |
| Наследует: | QMediaControl |
Этот класс был представлен в Qt 5.0.
Общие типы
| перечисление | EventType { ViewfinderStarted, ViewfinderStopped, ImageCaptured, ImageSaved, ..., AutoFocusFailed } |
Открытые функции
| 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 |
Защищённые функции
| 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::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.13/qcamerafeedbackcontrol.html
