9-3 基本テンプレートプロジェクトの構築：Hello NexVDO SDK！

第 3 章へようこそ！前章の「開発環境のインストール」では、開発の武器（Qt Creator と CMake）を無事に準備することができました。さあ、いよいよ本格的な開発フェーズに入りましょう！

「何事も最初が肝心」と言われるように、映像キャプチャのコードを書き始める前に、まずは Qt プロジェクトに NexVDO SDK の基盤となるライブラリを認識させる必要があります。環境設定の悩みを一度に解決するために、本章では複雑なオーディオ・ビデオのロジックは一切書かず、「完璧な空のテンプレートプロジェクトを構築する」 という 1 つのコア目標に集中します。

続くステップでは、ゼロから Qt プロジェクトを作成し、SDK の  include および lib フォルダをインポートし、 CMakeLists.txt を正しく修正する方法を解説します。

私たちの最終的な目標は、「黒い空のウィンドウ」をコンパイルして実行することです！この黒い画面を見くびってはいけません。これが無事にポップアップしたということは、あなたのソフトウェアが強力な NexVDO SDK の基盤と完璧に連携できたことを意味するのです！さらに素晴らしいことに、このプロジェクトは今後の最強のバックアップとなります。今後、Capture（ キャプチャ ）、Record（ 録画 ）、Stream（ 配信 ）、または AI 分析機能を開発する際、このテンプレートを直接コピーするだけで煩雑な事前準備をスキップでき、真の「痛みのない開発スタート」を実現できます。
あなた専用の開発ベースを構築する準備はできましたか？Qt Creator を開いて、早速始めましょう！

QT プロジェクトの作成と環境設定

プロジェクトの作成

QT Creator（ 本チュートリアルでは QT 6.7.3 バージョンを使用します ）を開き、まったく新しい Qt Widgets Application プロジェクトを作成します。セットアップウィザードで、ビルドシステム（Build system）に CMake を選択し、メインのクラス（ Class ）名を MainWindow  に設定します。

 

 

 

 

 

 

SDK ライブラリのインポート

入手した NexVDO SDK ファイルを展開（解凍）した後、その中にある include と lib の 2 つのフォルダを、先ほど作成した QT プロジェクトのフォルダに丸ごとコピーします。

 

 

CMakeLists.txt の修正

プロジェクト内の CMakeLists.txt を開きます。システムに SDK の場所を認識させ、ライブラリをリンクさせる必要があります。以下の構文を追加してください：

• ディレクトリの設定：set(QCAP_DIR ${CMAKE_CURRENT_SOURCE_DIR}/qcap) および include_directories(${QCAP_DIR}/include)を追加します。

• ライブラリのリンク： ファイルの一番下に target_link_libraries( ... ${QCAP_DIR}/lib/libqcap.so)を追加します。

 

苦労して CMakeLists.txt を修正し、システムを SDK の LIB ファイル ( libqcap.so ) に正常にリンクさせた後ですが、まだ UI デザインには急がないでください！

この段階では、上記の環境構築手順が完全に正しいことを確認するために、まずプロジェクトのテストを行う必要があります。Qt Creator の左下にある緑色の三角形の「実行 (Run)」ボタンを直接クリックしてください。

コンパイル中にエラーが発生せず、真っ黒で空の MainWindow が無事にポップアップすれば、おめでとうございます！これは、あなたのプロジェクトが NexVDO SDK の基盤と完璧かつ正確にリンクされたことを意味します。これで、安心してキャンバスのデザインと機能開発に進むことができます！

UI 表示インターフェースの構築

グラフィカルなアプリケーションである以上、映像を表示するための「キャンバス」が必要です。QT プロジェクトで mainwindow.ui をダブルクリックして開き、デザインモード (Design mode) に入ってください。

左側のツールバーから QFrame コンポーネントをメインウィンドウ上にドラッグし、右側の属性（プロパティ）パネルでその objectName を PreviewWindow と命名します。

直接 QT Creator の左下にある 緑色の三角形の「実行 (Run)」ボタンを をクリックすると、 キャンバスが配置された MainWindow ウィンドウ が無事にポップアップします。

ミッション完了：あなた専用の開発ベースが整いました！

おめでとうございます！ここまでで、「基本テンプレートプロジェクト」の構築は正式に完了しました。

「黒い画面のテスト」を通じて基盤となる SDK ライブラリとの完璧な接続を確認しただけでなく、将来映像を表示するための専用キャンバス（ PreviewWindow ) も UI インターフェース上にしっかりと固定しました。現在のプロジェクトの状態をバックアップしておくことを強くお勧めします。今後、録画、ストリーミング、または AI 分析アプリケーションを開発する際、このクリーンなテンプレートから直接スタートでき、煩雑な環境設定をすべて省略できます！

準備は万端です。続く 10-4 章では、NexVDO SDK の「4 つのコア・ライフサイクル API」を正式にご紹介します。C++ のコードファイルを開き、キャプチャカードからの実際の映像を、あなたが先ほど作成したこのキャンバスに完璧に投影してみせます！準備はいいですか？次の章でお会いしましょう！