このページでは

Qt WebChannel

Qt WebChannel では、サーバー(QML/C++アプリケーション)とクライアント(HTML/JavaScriptまたはQMLアプリケーション)間のピアツーピア通信を実現します。これは Qt WebEngine。さらに、WebSocketsをサポートするすべてのブラウザで動作するため、Qt WebChannel クライアントはあらゆるJavaScript環境(QMLを含む)で実行可能です。これには、Qt WebSockets に基づくカスタムトランスポートの実装が必要です。

このモジュールは、C++およびQMLアプリケーションとHTML/JavaScriptおよびQMLクライアントをシームレスに統合するためのJavaScriptライブラリを提供します。クライアントは、ホストアプリケーションによって公開されたシリアライズされたQObjectにアクセスするために、このJavaScriptライブラリを使用する必要があります。

モジュールの使用方法

QML API

このモジュールのQML型は、QtWebChannel インポートを通じて利用可能です。これらの型を使用するには、.qmlファイルに以下のインポート文を追加してください:

import QtWebChannel

C++ 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.