Класс 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.15/qcamerafeedbackcontrol.html
