クイックインテグレーション(QT)

最終更新日:2021-07-29 18:39:10

    ここでは、主にTencent Cloud TRTC SDK(QTのMacバージョンおよびWindowsバージョン) をプロジェクトに素早く統合する方法を紹介します。以下の手順に従って設定すれば、SDKの統合作業を素早く完了できます。

    Mac端末統合

    開発環境要件

    • オペレーティングシステム:Mac10.10以上のバージョン。
    • 開発環境:Qt Creator 4.10.3以上のバージョン。Qt Creator 4.13.3以上のバージョンの使用を推奨。
    • 開発フレームワーク:Based on Qt 5.10以上。

    操作手順

    ここではゼロからの簡単なQTTest項目の作成を例に、Qt CreatorプロジェクトでC++クロスプラットフォームSDKを統合する方法をご紹介します。

    手順1: C++クロスプラットフォームSDKのダウンロード

    1. SDKをダウンロードし、ファイルを解凍して開きます。
    2. QTTestと同じクラスのディレクトリ下で空のSDKフォルダを作成し、手順1でダウンロードしたTXLiteAVSDKTRTCMacx.x.x/SDK/TXLiteAVSDKTRTC_Mac.framework を、QTTest プロジェクトディレクトリと同じクラスのディレクトリにあるSDKフォルダにコピーします。

    手順2:QTTest.proの設定

    QTTest プロジェクトディレクトリを開き、任意のテキストエディタを使用して QTTest.pro ファイルを開いてから、SDK関連の引用を追加します。

    INCLUDEPATH += $$PWD/.
    DEPENDPATH += $$PWD/.
    LIBS += "-F$$PWD/base/util/mac/usersig"
    LIBS += "-F$$PWD/../SDK"
    LIBS += -framework TXLiteAVSDK_TRTC_Mac
    LIBS += -framework Accelerate
    LIBS += -framework AudioUnit
    INCLUDEPATH += $$PWD/../SDK/TXLiteAVSDK_TRTC_Mac.framework/Headers/cpp_interface
    INCLUDEPATH += $$PWD/base/util/mac/usersig/include
    DEPENDPATH += $$PWD/base/util/mac/usersig/include
    

    手順3:カメラおよびマイクの使用権限の付与

    SDKではカメラおよびマイクを使用しますので、対応する Info.plist に該当する権限申請説明を追加する必要があります。

    NSMicrophoneUsageDescription:マイクの使用申請
    NSCameraUsageDescription:カメラの使用申請
    

    下図に示すとおり:

    手順4:TRTC SDKの引用

    1.ヘッダーファイル #include "ITRTCCloud.h" によって直接引用することができます。
    2. ネームスペースの利用:C++ のすべてのプラットフォームのインターフェースのメソッド、タイプなどはいずれも trtc ネームスペースで定義されています。コードをより簡潔にするため、trtc ネームスペースを直接使用することをお勧めします。

    説明:

    ここまでで統合作業はすでに完了していますので、プロジェクトをコンパイルして実行できます。 Demoを使用するためのクロスプラットフォームSDKのAPIの詳細については、QTDemo をダウンロードして詳細をご参照ください。

    Windows端末の統合

    開発環境要件

    • OS:Windows 7以上のバージョン。
    • 開発環境:Visual Studio 2015以上のバージョン、Visual Studio 2015の使用をお薦めします。VS関連のQT開発環境をすでに設定していることが前提になります。
      説明:

      VS 関連のQT開発環境の設定手順に詳しくない場合は、 README の第2条の内容をご参照ください。

    操作手順

    ここでは、簡単なQTTestプロジェクトの新規作成を例に、 Visual StudioプロジェクトでC++クロスプラットフォームSDKを統合する方法をご紹介します。

    手順1: C++クロスプラットフォームSDKのダウンロード

    1. SDKをダウンロードし、ファイルを解凍して開きます。
    2. QTTestと同じクラスのディレクトリ下で空のSDKフォルダを作成し、手順1でダウンロードしたTXLiteAVSDKTRTCWin_latest/SDK/CPlusPlusを、QTTest プロジェクトディレクトリと同じクラスのディレクトリにあるSDKフォルダにコピーします。

    手順2:QTTestプロジェクトリクエスト環境の設定

    シーン1:QtCreatorを使用したリクエスト環境の設定

    QTTestプロジェクトディレクトリを開き、任意のテキストエディタ(Sublime Textを推奨)を使用して QTTest.pro(Qt Creatorを使用して作成)ファイルを開いてから、SDKに関連する引用を追加します。

    INCLUDEPATH += $$PWD/.
                  $$PWD/../SDK/CPlusPlus/Win32/include \
                  $$PWD/../SDK/CPlusPlus/Win32/include/TRTC
    DEPENDPATH += $$PWD/.
                  $$PWD/../SDK/CPlusPlus/Win32/include \
                  $$PWD/../SDK/CPlusPlus/Win32/include/TRTC
    CONFIG += opengl
    CONFIG += debug_and_release
    debug {
    contains(QT_ARCH,i386) {
        LIBS += -L$$PWD/../SDK/CPlusPlus/Win32/lib -lliteav
    } else {
        LIBS += -L$$PWD/../SDK/CPlusPlus/Win64/lib -lliteav
    }
    }
    release {
    contains(QT_ARCH,i386) {
        LIBS += -L$$PWD/../SDK/CPlusPlus/Win32/lib -lliteav
    } else {
        LIBS += -L$$PWD/../SDK/CPlusPlus/Win64/lib -lliteav
    }
    }
    
    シーン2:VSを使用したリクエスト環境の設定

    プロジェクトがすでに本格的なVSプロジェクトになっている場合は、VSのプロジェクト属性 Properties->Linker->Input およびGeneral でSDKライブラリパスのリクエスト情報を設定し、同時に Properties -> C/C++ -> General でSDK のヘッダーファイルパスのリクエスト情報を設定します。

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

    VSを使用してQTTest.proプロジェクトを開き、関連する debug/releaseフォルダを自動的に生成してから、SDK/CPlusPlus/Win32/lib 下のすべての.dllファイルをプロジェクトディレクトリ下の debug/release フォルダにそれぞれコピーする必要があります。

    手順4:TRTC SDKの引用

    1.ヘッダーファイル #include "ITRTCCloud.h" によって直接引用することができます。
    2. ネームスペースの利用:C++ のすべてのプラットフォームのインターフェースのメソッド、タイプなどはいずれも trtc ネームスペースで定義されています。コードをより簡潔にするため、trtc ネームスペースを直接使用することをお勧めします。

    説明:

    ここまでで統合作業はすでに完了していますので、プロジェクトをコンパイルして実行できます。 Demoを使用するためのクロスプラットフォームSDKのAPIの詳細については、QTDemo をダウンロードして詳細をご参照ください。