Qt WebChannel
Qt WebChannel 서버(QML/C++ 애플리케이션)와 클라이언트(HTML/JavaScript 또는 QML 애플리케이션) 간의 피어 투 피어(P2P) 통신을 지원합니다. 이는 Qt WebEngine. 또한 WebSockets를 지원하는 모든 브라우저에서 작동하므로, Qt WebChannel 클라이언트가 어떤 JavaScript 환경(QML 포함)에서도 실행될 수 있습니다. 이를 위해서는 Qt WebSockets 를 기반으로 한 사용자 정의 전송 프로토콜을 구현해야 합니다.
이 모듈은 C++ 및 QML 애플리케이션을 HTML/JavaScript 및 QML 클라이언트와 원활하게 통합할 수 있는 JavaScript 라이브러리를 제공합니다. 클라이언트는 호스트 애플리케이션이 발행한 직렬화된 QObject에 접근하기 위해 이 JavaScript 라이브러리를 사용해야 합니다.
모듈 사용 방법
QML API
이 모듈의 QML 타입은 QtWebChannel 임포트를 통해 사용할 수 있습니다. 해당 타입을 사용하려면 .qml 파일에 다음 임포트 문을 추가하십시오:
import QtWebChannelC++ API
Qt 모듈의 C++ API를 사용하려면 모듈 라이브러리와 직접 또는 다른 종속성을 통해 링크해야 합니다. CMake 및 qmake를 비롯한 여러 빌드 도구가 이를 위해 전용 지원을 제공합니다.
CMake를 사용한 빌드
` find_package() ` 명령을 사용하여 Qt6 패키지 내에서 필요한 모듈 구성 요소를 찾으십시오:
find_package(Qt6 REQUIRED COMPONENTS WebChannel)
target_link_libraries(mytarget PRIVATE Qt6::WebChannel)자세한 내용은 ‘CMake를 사용한 빌드’ 개요를 참조하십시오.
qmake를 사용한 빌드
qmake를 사용하여 모듈을 빌드하도록 구성하려면, 프로젝트의 .pro 파일에서 QT 변수의 값으로 해당 모듈을 추가하십시오:
QT += webchannel예시
참조
라이선스
Qt WebChannel 는 The Qt Company의 상용 라이선스 하에 제공됩니다. 또한, 자유 소프트웨어 라이선스 하에서도 제공됩니다. 이러한 자유 소프트웨어 라이선스에는 GNU Lesser General Public License 버전 3 또는 GNU General Public License 버전 2가 포함됩니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.