Windows C++

このドキュメントでは、Tencent Cloud TRTC SDK(Windows C++ 版)をMFCプロジェクトに素早く統合する方法を紹介します。




開発環境要件

OS:Windows 7以上のバージョン。
開発環境:Visual Studio 2010およびそれ以上のバージョン、Visual Studio 2015の使用を推奨します。

MFCプロジェクトによるC++ SDKの統合

このセグメントでは、簡単なMFC プロジェクトを作成し、Visual Studio プログラムの中で C++ SDKを統合する方法を紹介します。

手順1:SDKのダウンロード

SDKダウンロードし、解凍して開きます。この例では、SDKディレクトリ下のC++バージョンのSDKファイルを参照するだけで済みます。64ビットを例にとると、SDKの場所は./SDK/CPlusPlus/Win64/です。これには主に次の部分が含まれます:
ディレクトリ名
説明
include
詳細なインターフェース注釈つきのAPIヘッダファイル
lib
コンパイル用の.libファイルと実行時にローディングされる.dllファイル

手順2:プロジェクトの新規作成

Visual Studioを開き、TRTCDemoという名前のMFC アプリケーションプログラムを作成します。 迅速に統合する方法を紹介しやすいように、ガイドのアプリケーションプログラムのタイプの画面では、比較的簡単なダイアログベースのタイプを選択しています。 その他のガイドの設定は、デフォルトの設定を選択してください。

手順3:**ファイルのコピー

解凍後のSDKフォルダをTRTCDemo.vcxprojが存在するディレクトリ下にコピーします。下図のとおりです:
説明:
現在はC++ SDKがあれば、SDKパス下のCsharpディレクトリを削除できます。




手順4:プロジェクト構成の変更

TRTCDemoの属性ページを開きます。ソリューションのResource Manager >TRTCDemoプロジェクトのメニュー>属性を右クリックして、次の手順にしたがって設定してください:
1. Includeのディレクトリの追加:C/C++ > 常規 > 添付ファイル付きディレクトリから、以下のSDKヘッダファイルディレクトリを追加します。なお、64bitの例: $(ProjectDir)SDK\CPlusPlus\Win64\include$(ProjectDir)SDK\CPlusPlus\Win64\include\TRTC、下図のとおりです:
説明:
32bitの場合、SDKヘッダファイルディレクトリを$(ProjectDir)SDK\CPlusPlus\Win32\include$(ProjectDir)SDK\CPlusPlus\Win32\include\TRTCとして設定してください。

2. ライブラリのディレクトリの追加:リンカ > 常規 > 添付ライブラリ付きディレクトリから、以下のSDKヘッダファイルディレクトリを追加します。なお、64bitの例: $(ProjectDir)SDK\CPlusPlus\Win64\lib、下図のとおりです:
説明:
32bitの場合、SDKライブラリディレクトリを$(ProjectDir)SDK\CPlusPlus\Win32\libとして設定してください。

3. ライブラリファイルの追加:リンカ > 入力 > 依存項目の追加からSDKライブラリファイルliteav.libを追加します。下図のとおりです:

4. copy コマンドの追加:イベントの生成 > 後続イベントの生成 > コマンドラインから、コピーコマンドcopy /Y $(ProjectDir)SDK\CPlusPlus\Win64\lib\*.dll $(OutDir)を追加します。コンパイルが完了すると、自動的にSDKの.dllファイルがプログラムの実行ディレクトリの下にコピーされます。下図のとおりです。
説明:
32bitの場合、コピーコマンドcopy /Y $(ProjectDir)SDK\CPlusPlus\Win32\lib\*.dll $(OutDir)を追加します。




手順5: SDKバージョン番号のプリント

1. TRTCDemoDlg.cppファイルのヘッドにヘッダファイルを追加してください。コードは以下のとおりです:
#include "ITRTCCloud.h"
2. CTRTCDemoDlg::OnInitDialog関数の中に、以下のテストコードを追加します:
ITRTCCloud * pTRTCCloud = getTRTCShareInstance();
CString szText;
szText.Format(L"SDK version: %hs", pTRTCCloud->getSDKVersion());

CWnd *pStatic = GetDlgItem(IDC_STATIC);
pStatic->SetWindowTextW(szText);
3. F5キーを押して実行すると、SDKのバージョン番号がプリントされます。下図のとおりです:



よくあるご質問

次のエラーが生じた場合は、前述のプログラム設定にしたがって、 SDKヘッダーファイルのディレクトリが正しく追加されているかチェックしてください。
fatal error C1083: include ファイルを開くことができません: “TRTCCloud.h”: No such file or directory
次のエラーが生じた場合は、前述のプログラム設定にしたがって、SDKライブラリのディレクトリとライブラリファイルが正しく追加されているかチェックしてください。
error LNK2019: 解析できない外部シンボル "__declspec(dllimport) public: static class TXString __cdecl TRTCCloud::getSDKVersion(void)" (__imp_?getSDKVersion@TRTCCloud@@SA?AVTXString@@XZ)、この記号が関数 "protected: virtual int __thiscall CTRTCDemoDlg::OnInitDialog(void)" (?OnInitDialog@CTRTCDemoDlg@@MAEHXZ) の中に引用されています