Пространство имён WebEngineContext
Содержит функции, связанные с инициализацией веб-движка. Подробнее…
Классы
| class | ReadyToClose Представляет событие QT. Подробнее… |
Функции
| void | StartProcess (int argc, char *argv[], const std::vector< std::string > &additionalArgs={}, IEglContextDelegatePtr eglDelegate=nullptr) |
| void | InitBrowser (int argc, char *argv[], const std::vector< std::string > &additionalArgs={}, QMap< QString, QString > params={}, IEglContextDelegatePtr eglDelegate=nullptr) |
| void | InitBrowser (QMap< QString, QString > params={}) |
| void | Shutdown () Завершает работу движка браузера и WebView. Подробнее... |
Подробное описание
Содержит функции, связанные с инициализацией веб-движка.
Описание функций
InitBrowser() [1/2]
| void Aurora::WebView::WebEngineContext::InitBrowser (int argc, char * argv[], const std::vector< std::string > & additionalArgs = {}, QMap< QString, QString >params = {}, IEglContextDelegatePtreglDelegate = nullptr) |
Необходимо инициализировать движок браузера для выполнения реальной работы.
Можно использовать дополнительные аргументы командной строки или передать их из кода с помощью
параметра additionalArgs. Поддерживаемые аргументы приведены в таблице ниже.
| ignore-certificate-errors | Набор хэшей открытых ключей, которые следует игнорировать ошибки, связанные с сертификатом. Если цепочка сертификатов, представленная сервером, недействительна, и один или несколько сертификатов имеют хэши открытого ключа, которые соответствуют ключу из этого списка, ошибка игнорируется. Значение переключателя должно быть списком SHA-256 SPKI в кодировке Base64, разделённым запятыми Fingerprints (RFC 7469, Section 2.4). |
| disable-web-security | Не следует применять политику единого домена, предназначенную только для тестирования вебсайта. Он отключает проверки CORS, механизм ORB и проверки PNA. |
| host-resolver-rules | Пользовательский маппинг для имён хостов. Формат: MAP <шаблон_имени_хоста> <IP_адрес>[:<порт>]. Пример: MAP example.com 127.0.0.1:8080 или MAP *.example.com 192.168.1.1. Несколько правил могут быть разделены запятыми. |
| remote-debugging-port | Включает удалённую отладку по HTTP на указанном порту. |
| remote-allow-origins | Разрешает соединения веб-сокетов только с указанного домена. '*' позволяет использовать любой домен. |
| disable-accelerated-video-encode | Отключает аппаратное ускорение кодирования видео, если оно доступно. |
| default-encoding | Устанавливает кодировку, используемую по умолчанию. Значение по-умолчанию "ISO-8859-1". |
| browser-subprocess-path | Путь к отдельному исполняемому файлу, который будет запускается для подпроцессов. Его можно использовать только в параметре additionalArgs. |
Параметры
| params | Необязательные параметры веб-просмотра. |
| argc | Количество аргументов командной строки. |
| argv | Аргументы командной строки. |
| additionalArgs | Дополнительные аргументы для передачи в движок. Необязательный аргумент. |
| eglDelegate | Платформенный провайдер EGL контекста для GPU композиции. Может быть nullptr для приложений на основе QGuiApplication. |
InitBrowser() [2/2]
| void Aurora::WebView::WebEngineContext::InitBrowser (QMap< QString, QString >params = {}) |
Необходимо инициализировать движок браузера для выполнения реальной работы.
- Устарел:
- Вместо этого следует использовать
InitBrowser(int argc, ...).
Параметры
| params | Необязательные параметры веб-просмотра. |
Shutdown()
| void Aurora::WebView::WebEngineContext::Shutdown () |
Завершает работу движка браузера и WebView.
После завершения работы WebView публикует событие ReadyToClose QT.
StartProcess()
| void Aurora::WebView::WebEngineContext::StartProcess (int argc, char * argv[], const std::vector< std::string > & additionalArgs = {}, IEglContextDelegatePtreglDelegate = nullptr) |
Инициализация контекста процессов браузера.
Веб-движок создает вспомогательные процессы во время работы, несколько раз форкнув исходный процесс. Необходимо вызвать эту функцию как можно раньше, чтобы правильно инициализировать контекст и не смешивать его с логикой приложения.
Эта функция возвращается только для начального процесса.
Можно использовать дополнительные аргументы командной строки или передать их из кода с помощью
параметра additionalArgs. Поддерживаемые аргументы приведены в таблице ниже.
| ignore-certificate-errors | Набор хэшей открытых ключей, которые следует игнорировать ошибки, связанные с сертификатом. Если цепочка сертификатов, представленная сервером, недействительна, и один или несколько сертификатов имеют хэши открытого ключа, которые соответствуют ключу из этого списка, ошибка игнорируется. Значение переключателя должно быть списком SHA-256 SPKI в кодировке Base64, разделённым запятыми Fingerprints (RFC 7469, Section 2.4). |
| disable-web-security | Не следует применять политику единого домена, предназначенную только для тестирования вебсайта. Он отключает проверки CORS, механизм ORB и проверки PNA. |
| remote-debugging-port | Включает удалённую отладку по HTTP на указанном порту. |
| remote-allow-origins | Разрешает соединения веб-сокетов только с указанного домена. '*' позволяет использовать любой домен. |
| disable-accelerated-video-encode | Отключает аппаратное ускорение кодирования видео, если оно доступно. |
| default-encoding | Устанавливает кодировку, используемую по умолчанию. Значение по-умолчанию "ISO-8859-1". |
- Устарел:
- Вместо этого следует использовать
InitBrowser(int argc, ...).
Параметры
| argc | Количество аргументов командной строки. |
| argv | Аргументы командной строки. |
| additionalArgs | Дополнительные аргументы для передачи в движок. Необязательный аргумент. |
| eglDelegate | Платформенный провайдер EGL контекста для GPU композиции. Может быть nullptr для приложений на основе QGuiApplication. |