QWebEngineView 웹 기능 100% 활용법 PySide6 브라우저

PySide6의 QWebEngineView로 웹 브라우저 기능 구현하기

QWebEngineView는 Qt의 웹 렌더링 엔진을 활용해, Python 기반 GUI 애플리케이션에서도 고급 웹 기능을 구현할 수 있게 해줍니다. 자바스크립트, 팝업창, 비디오 자동재생, 전체화면, 심지어 개발자 도구까지! 기본 설정만으로는 안 보이던 기능들을 설정할수 있습니다.

이 글에서는 PySide6를 , QWebEngineView를 웹 브라우저처럼 사용하는 데 필요한 설정 방법을 항목별로 정리 해봅니다. 각각의 기능이 왜 필요한지, 어떻게 설정하는지, 그리고 실무에서 어떻게 활용될 수 있는지 쉽게 파악할수 있습니다.

PySide6 QWebEngineView 자바스크립트, 팝업, 미디어 설정 정리

PySide6의

QWebEngineView를 사용하여 데스크탑 애플리케이션에서 웹 브라우저처럼 동작하도록 설정하는 방법입니다.

1. 기본 웹 기능 활성화

웹 페이지가 자바스크립트, 로컬스토리지 등을 사용할 수 있도록 설정합니다.

settings = self.webview.settings()
settings.setAttribute(QWebEngineSettings.JavascriptEnabled, True)
settings.setAttribute(QWebEngineSettings.LocalStorageEnabled, True)
settings.setAttribute(QWebEngineSettings.PluginsEnabled, True)
settings.setAttribute(QWebEngineSettings.WebGLEnabled, True)

• JavascriptEnabled: 대부분의 현대 웹 페이지가 자바스크립트를 사용하므로 필수입니다. 이 기능이 꺼져 있으면 웹 페이지가 정상 작동하지 않거나, 버튼 클릭, 메뉴 이동 등이 안 될 수 있습니다.
• LocalStorageEnabled: 웹 페이지가 브라우저 내에 정보를 저장할 수 있도록 합니다. 브라우저에 데이터를 저장해두고 다음 접속 시 불러올 수 있는 기능입니다.
• PluginsEnabled: PDF 뷰어나 미디어 기능을 위한 플러그인 지원.
• WebGLEnabled: 3D 그래픽 콘텐츠를 지원합니다.

2. 팝업 및 창 관련 기능

웹 페이지에서는 사용자의 클릭이나 자동 동작을 통해 새 창을 열거나 팝업을 띄우는 경우가 많습니다. 하지만 QWebEngineView는 보안 및 성능상의 이유로 이러한 기능들을 기본적으로 차단하고 있습니다.
그래서 일반 웹 브라우저처럼 동작하도록 하려면 직접 설정을 통해 기능을 활성화해줘야 합니다.

settings.setAttribute(QWebEngineSettings.JavascriptCanOpenWindows, True)
settings.setAttribute(QWebEngineSettings.AllowWindowActivationFromJavaScript, True)
settings.setAttribute(QWebEngineSettings.AllowGeolocationOnInsecureOrigins, True)
settings.setAttribute(QWebEngineSettings.FullScreenSupportEnabled, True)

• JavascriptCanOpenWindows
  자바스크립트가 새 창을 열 수 있도록 허용합니다.웹에서 window.open() 명령이 동작하려면 이 설정이 필요합니다.
  예: 링크 클릭 시 새 탭으로 열리는 경우, 광고 팝업 등.
• AllowWindowActivationFromJavaScript
  자바스크립트로 열린 새 창이 자동으로 활성화(포커스 이동) 되도록 허용합니다.사용하지 않으면 팝업이 뒤에 숨어 보이지 않을 수 있습니다.
• AllowGeolocationOnInsecureOrigins
  HTTPS가 아닌 웹사이트에서도 위치 정보(GPS 등)를 사용할 수 있도록 허용합니다.보안상 민감할 수 있으므로 필요할 때만 켜는 것이 좋습니다.
• FullScreenSupportEnabled
  웹 페이지에서 전체 화면 모드를 사용할 수 있게 해줍니다.웹 기반 프레젠테이션 앱이 전체 화면을 지원하려면 꼭 필요합니다.

3. 미디어 관련 기능

웹 페이지에서 비디오나 오디오를 재생하거나, 화면 캡처 기능을 제공하는 등의 미디어 관련 기능은 많은 웹 애플리케이션에서 중요한 역할을 합니다. QWebEngineView에서도 이러한 기능들을 활성화할 수 있습니다.

settings.setAttribute(QWebEngineSettings.PlaybackRequiresUserGesture, False)
settings.setAttribute(QWebEngineSettings.AutoLoadIconsForPage, True)
settings.setAttribute(QWebEngineSettings.ScreenCaptureEnabled, True)
settings.setAttribute(QWebEngineSettings.WebRTCPublicInterfacesOnly, False)

PlaybackRequiresUserGesture

• 기능: 이 설정은 웹 페이지에서 비디오나 오디오가 자동으로 재생될 수 있도록 허용합니다.
• 기본 동작: 대부분의 웹 브라우저에서는 사용자가 클릭하거나 스크롤을 한 후에야 미디어가 재생됩니다.
• 설명: PlaybackRequiresUserGesture를 False로 설정하면, 사용자의 클릭 없이도 자동으로 비디오나 오디오가 재생되도록 할 수 있습니다.

AutoLoadIconsForPage

• 기능: 웹 페이지를 로드할 때, 파비콘(작은 아이콘)을 자동으로 로드하도록 설정합니다.
• 설명: 각 웹사이트는 브라우저 탭에 작은 아이콘을 표시하는데, 이를 파비콘이라고 부릅니다. 이 설정을 True로 활성화하면, 웹 페이지가 로드될 때 자동으로 해당 사이트의 아이콘도 함께 로드됩니다.

ScreenCaptureEnabled

• 기능: 화면 캡처 기능을 활성화합니다.
• 설명: 이 설정을 활성화하면 웹 페이지에서 화면 캡처 기능을 사용할 수 있게 됩니다.
• 주의사항: 사용자가 페이지에서 캡처할 수 있는 콘텐츠가 무엇인지에 따라 보안이나 프라이버시와 관련된 고려가 필요할 수 있습니다.

WebRTCPublicInterfacesOnly

• 기능: WebRTC(웹 실시간 통신)를 사용할 때 공개된 인터페이스만 사용하도록 설정합니다.
• 설명: WebRTC는 실시간 비디오 및 오디오 통화를 지원하는 기술로, 예를 들어, 구글 Meet나 Zoom과 같은 화상 회의 앱에서 사용됩니다. 이 설정을 False로 설정하면, WebRTC의 전체 기능을 사용할 수 있습니다. 이를 통해, 실시간 통화, 비디오 스트리밍, P2P 연결 등의 기능을 활성화할 수 있습니다.
• 설정이 중요한 이유: WebRTCPublicInterfacesOnly를 True로 설정하면 WebRTC의 일부 기능만 사용 가능하며, 제한적인 통신만 지원되므로 전면적인 WebRTC 기능을 사용할 경우에는 False로 설정해야 합니다.

4. 보안 및 접근 권한

웹 페이지가 외부 리소스에 접근하거나, 로컬 파일을 사용할 수 있도록 하는 설정은 중요한 보안 측면을 다룹니다. 이러한 설정들은 웹 페이지가 로컬 파일이나 원격 리소스와 상호작용할 수 있도록 허용합니다.

settings.setAttribute(QWebEngineSettings.LocalContentCanAccessRemoteUrls, True)
settings.setAttribute(QWebEngineSettings.LocalContentCanAccessFileUrls, True)
settings.setAttribute(QWebEngineSettings.HyperlinkAuditingEnabled, True)
settings.setAttribute(QWebEngineSettings.AllowRunningInsecureContent, True)

LocalContentCanAccessRemoteUrls

• 기능: 로컬 콘텐츠가 원격 URL에 접근할 수 있도록 허용합니다.
• 설명: 이 설정은 로컬 파일 시스템에서 실행 중인 HTML 파일이 외부 자원(예: 외부 서버에서 제공하는 이미지나 스타일 시트, JavaScript 파일 등)을 로드할 수 있도록 합니다. 보통 로컬 파일(file://)에서 원격 URL(http:// 또는 https://)을 참조하는 것은 보안상 제한이 있지만, 이 설정을 True로 설정하면 이러한 제한을 해제하여 웹 페이지가 로컬 콘텐츠에서 외부 자원에 접근하도록 허용합니다.

LocalContentCanAccessFileUrls

• 기능: 로컬 파일 콘텐츠가 로컬 파일 시스템에서 다른 파일에 접근할 수 있도록 허용합니다.
• 설명: 로컬 HTML 파일이 다른 로컬 파일에 접근하는 기능을 활성화합니다. 예를 들어, HTML 파일이 로컬의 이미지 파일이나 다른 리소스를 로드하려고 할 때 이 설정이 필요합니다.

HyperlinkAuditingEnabled

• 기능: 하이퍼링크 클릭 시 링크 감사 기능을 활성화합니다.
• 설명: 이 설정을 활성화하면 웹 페이지에서 하이퍼링크를 클릭할 때, 해당 링크의 방문 상태를 추적하고 기록하는 기능이 작동합니다. 이를 통해 링크가 클릭되었는지 여부를 추적할 수 있습니다. 이러한 링크 감사 기능은 사용자의 클릭을 추적하는 데 사용될 수 있습니다.

AllowRunningInsecureContent

• 기능: 혼합 콘텐츠(mixed content)가 실행되도록 허용합니다.
• 설명: 혼합 콘텐츠란, HTTPS 웹 페이지에서 HTTP를 통해 불러오는 리소스를 의미합니다. 예를 들어, 보안이 적용된 웹 페이지(HTTPS)에서 보안되지 않은 리소스(HTTP)를 호출할 때 발생합니다. AllowRunningInsecureContent를 True로 설정하면 HTTPS 웹 페이지에서 HTTP 콘텐츠를 불러오거나 실행할 수 있게 됩니다..

5. 개발자 도구 활성화

settings.setAttribute(QWebEngineSettings.DeveloperExtrasEnabled, True)
settings.setAttribute(QWebEngineSettings.Accelerated2dCanvasEnabled, True)
settings.setAttribute(QWebEngineSettings.ScrollAnimatorEnabled, True)

이 설정은 F12를 눌렀을 때 나오는 크롬 개발자 도구처럼 디버깅에 사용할 수 있습니다.

6. 사용자 에이전트(User-Agent) 설정

profile = self.webview.page().profile()
profile.setHttpUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64)...")

웹사이트에 접속 시 어떤 브라우저로 접속했는지를 서버에 알립니다. 모바일 사이트 우회, 특정 기능 해제 등에 사용됩니다.

7. 전체 코드 예시

def enable_full_browser_features(self):
    settings = self.webview.settings()
    settings.setAttribute(QWebEngineSettings.JavascriptEnabled, True)
    settings.setAttribute(QWebEngineSettings.LocalStorageEnabled, True)
    settings.setAttribute(QWebEngineSettings.PluginsEnabled, True)
    settings.setAttribute(QWebEngineSettings.WebGLEnabled, True)
    settings.setAttribute(QWebEngineSettings.JavascriptCanOpenWindows, True)
    settings.setAttribute(QWebEngineSettings.AllowWindowActivationFromJavaScript, True)
    settings.setAttribute(QWebEngineSettings.AllowGeolocationOnInsecureOrigins, True)
    settings.setAttribute(QWebEngineSettings.FullScreenSupportEnabled, True)
    settings.setAttribute(QWebEngineSettings.PlaybackRequiresUserGesture, False)
    settings.setAttribute(QWebEngineSettings.AutoLoadIconsForPage, True)
    settings.setAttribute(QWebEngineSettings.ScreenCaptureEnabled, True)
    settings.setAttribute(QWebEngineSettings.WebRTCPublicInterfacesOnly, False)
    settings.setAttribute(QWebEngineSettings.LocalContentCanAccessRemoteUrls, True)
    settings.setAttribute(QWebEngineSettings.LocalContentCanAccessFileUrls, True)
    settings.setAttribute(QWebEngineSettings.HyperlinkAuditingEnabled, True)
    settings.setAttribute(QWebEngineSettings.AllowRunningInsecureContent, True)
    settings.setAttribute(QWebEngineSettings.DeveloperExtrasEnabled, True)
    settings.setAttribute(QWebEngineSettings.Accelerated2dCanvasEnabled, True)
    settings.setAttribute(QWebEngineSettings.ScrollAnimatorEnabled, True)

    profile = self.webview.page().profile()
    profile.setPersistentCookiesPolicy(QWebEngineProfile.AllowPersistentCookies)
    profile.setCachePath("cache")
    profile.setHttpUserAgent("Mozilla/5.0 (...)")

문제 해결 방법

• OpenGL 문제: 다음 설정으로 해결 가능
  QApplication.setAttribute(Qt.AA_ShareOpenGLContexts)
• PySide6 버전: 6.4.0 이상 권장
  from PySide6.QtCore import __version__
print(__version__)