RTC Engine
  • Overview
  • Web
    • Demo のクイックスタート
    • SDK クイックスタート
    • 基本機能
      • 画面共有
      • ライブブロードキャスト
      • メディアデバイス
      • 音量
      • エンコーディング構成ファイルの設定
      • ネットワーク品質の検出
      • 検出能力
    • 高度な機能
      • AI ノイズ低減の有効化
      • ミキシングを有効にします
      • ウォーターマークを有効にします
      • Enable Virtual Background
      • 美顔とエフェクトの有効化
      • データメッセージ
      • キャプチャーとレンタリングのカスタマイズ
    • インターフェースリスト
    • リリース説明
    • 対応するプラットホーム
    • Web に関するよくあるご質問
      • 複数人でのビデオ通話を最適化
      • 制限付き自動再生の処理
      • ファイアウォール制限への対応
      • その他
  • Android
    • Run Sample Code
    • Integration
    • インテグレーション
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. ビデオ品質の設定
      • 10. ビデオの回転
    • Advanced Features
      • ネットワーク品質のテスト
      • キャプチャーとレンタリングのカスタマイズ
      • オーディオキャプチャーと再生のカスタマイズ
    • 顧客インターフェース
      • Overview
      • TRTCCloud
      • TRTCStatistics
      • TRTCCloudListener
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • タイプ定義
      • 廃棄インタフェース
      • エラーコード
    • ソリューション
      • リアルタイムコーラス (TUIKaraoke)
        • クイックインテグレーション
        • 実施ステップ
        • 曲の同期
        • 歌詞の同期
        • 音声同期
        • ミクスストリーミングソリューション
        • TRTCKaraoke 関連インターフェース
        • よくあるご質問
    • リリース説明
  • iOS
    • Run Sample Code
    • Integration
    • インテグレーション
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. ビデオ品質の設定
      • 10. ビデオの回転
    • Advanced Features
      • ネットワーク品質のテスト
      • キャプチャーとレンタリングのカスタマイズ
      • オーディオキャプチャーと再生のカスタマイズ
    • 顧客インターフェース
      • Overview
      • TRTCCloud
      • TRTCCloudDelegate
      • TRTCStatistics
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • タイプ定義
      • 廃棄インタフェース
      • ErrorCode
    • ソリューション
      • クイックインテグレーション
      • 実施ステップ
      • 曲の同期
      • 歌詞の同期
      • 音声同期
      • ミクスストリーミングソリューション
      • TRTCKaraoke 関連インターフェース
      • よくあるご質問
    • リリース説明
  • macOS
    • Run Sample Code
    • Integration
    • インテグレーション
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. パソコンサウンドの共有
      • 10. ビデオ品質の設定
      • 11. ビデオの回転
    • Advanced Features
      • ハードウェアデバイスのテスト
      • ネットワーク品質のテスト
      • キャプチャーとレンタリングのカスタマイズ
      • オーディオキャプチャーと再生のカスタマイズ
    • 顧客インターフェース
      • Overview
      • TRTCCloud
      • TRTCCloudDelegate
      • TRTCStatistics
      • TXAudioEffectManager
      • TXBeautyManager
      • TXDeviceManager
      • タイプ定義
      • 廃棄インタフェース
      • ErrorCode
      • リリース説明
    • リリース説明
  • Windows
    • Run Sample Code
    • Integration
    • インテグレーション
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. ビデオ品質の設定
      • 10. ビデオの回転
    • Advanced Features
      • ハードウェアデバイスのテスト
      • ネットワーク品質のテスト
      • キャプチャーとレンタリングのカスタマイズ
      • オーディオキャプチャーと再生のカスタマイズ
    • 顧客インターフェース
      • Overview
      • ITRTCCloud
      • ITRTCStatistics
      • TRTCCloudCallback
      • ITXAudioEffectManager
      • ITXDeviceManager
      • タイプ定義
      • 廃棄インタフェース
      • エラーコード
    • リリース説明
  • Electron
    • インテグレーション
      • 1. インターフェースの例
      • 2. SDK のインポート
      • 3. ルームに入る
      • 4. オーディオ・ビデオストリームのサブスクリプション
      • 5. オーディオ・ビデオストリームのリリース
      • 6. ルームからの退出
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. パソコンサウンドの共有
      • 10. ビデオ品質の設定
      • 11. ビデオの回転
    • 顧客インターフェース
      • Overview
      • エラーコード
  • Flutter
    • インテグレーション
      • 1. インターフェースの例
      • 2. SDK のインポート
      • 3. ルームに入る
      • 4. オーディオ・ビデオストリームのサブスクリプション
      • 5. オーディオ・ビデオストリームのリリース
      • 6. ルームからの退出
      • 7. ネットワーク品質の検出
      • 8. 画面共有の有効化
      • 9. パソコンサウンドの共有
      • 10. ビデオ品質の設定
      • 11. ビデオの回転
    • 顧客インターフェース
      • Overview
      • エラーコード
  • Unity
    • インテグレーション
      • 1. インターフェースの例
      • 2. SDK のインポート
    • 顧客インターフェース
      • Overview
      • エラーコード
  • QT
    • インテグレーション
      • 1. SDK のインポート
  • Overview
    • Overview
  • 概念
  • Features
  • 性能統計
  • 価格
    • 無料時間
    • RTC-Engine パッケージ
    • サブスクリプションパッケージ期間の課金説明
    • 従量課金
      • 音声・ビデオ時間の課金説明
      • クラウド録画の課金説明
      • ミックストランスコーディングとCDNへのリレーの課金説明
  • よくあるご質問
    • 初心者のよくあるご質問
    • マイグレーションガイド
      • Twilio Video から TRTC への移行
      • 課金
      • Features
      • UserSig
      • ファイアウォール制限
      • インストールパッケージを削減する方法
      • TRTCCalling Web 関連
      • オーディオ・ビデオの品質
      • その他
RTC Engine

1. SDK のインポート

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




Windows端末の統合

開発環境要件

OS:Windows 7以上のバージョン。
開発環境:Visual Studio 2015以上のバージョン、Visual Studio 2015の使用をお勧めします。VS関連のQT開発環境をすでに設定していることが前提になります。
説明:
VS関連のQT開発環境の設定手順に詳しくない場合は、READMEの操作手順のステップ4の関連内容をご参照ください。

操作手順

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

ステップ1: SDKのダウンロード

SDKのダウンロードを行い、解凍して開きます。 ここの例では、 SDKディレクトリのC++バージョンのSDKファイルをインポートしさえすればOKです。64ビットの場合、SDKは./SDK/CPlusPlus/Win64/にあり、主に次のいくつかの部分が含まれます。
ディレクトリ名
説明
include
詳細なインターフェースの説明がついたAPIヘッダーファイル
lib
編集用の.libファイルおよび実行時にローディングする.dllファイル

ステップ2:プロジェクトの新規作成

Visual Studio 2015を例にとると、ローカルですでにQTおよびVS開発プラグインをインストール済みという前提で、Visual Studioを開きます。下図のように、TRTCDemoという名前のQTアプリケーションを新規作成します。

クイックインテグレーションの方法を説明しやすくするため、ガイドの中でQt Widgets Applicationタイプを選択し、OKをクリックします。次のページでNextをクリックし、プロジェクトを作成すれば完了です。

ステップ3:ファイルのコピー

下図のように、解凍後のSDKフォルダをTRTCDemo.vcxprojが存在するディレクトリ下にコピーします。
説明:
この時点ではC++ SDKだけが必要なため、 SDKパスのCSharpディレクトリを削除しても構いません。




ステップ4:プロジェクト設定の修正

TRTCDemoの属性のページを開きます。ソリューションのResource Manager >TRTCDemoプログラムの右クリックメニュー>属性と進みます。次のステップにしたがって設定してください。
1. Includeのディレクトリの追加: 下図のように、C/C++ > 通常 > Includeディレクトリの追加で、64ビットの場合は、SDKヘッダーファイルディレクトリ$(ProjectDir)SDK\CPlusPlus\Win64\include$(ProjectDir)SDK\CPlusPlus\Win64\include\TRTCを追加します。
説明:
32ビットの場合は、SDKヘッダーファイルディレクトリを$(ProjectDir)SDK\CPlusPlus\Win32\include$(ProjectDir)SDK\CPlusPlus\Win32\include\TRTCに設定する必要があります。

2. ライブラリのディレクトリの追加: 下図のように、リンカー>通常>ライブラリディレクトリの追加で、64ビットの場合は、SDKライブラリディレクトリ $(ProjectDir)SDK\CPlusPlus\Win64\libを追加します。
説明:
32ビットの場合は、SDKライブラリディレクトリを$(ProjectDir)SDK\CPlusPlus\Win32\libに設定する必要があります。

3. ライブラリファイルの追加: 下図のように、リンカー>入力>依存プロジェクトの追加で、 SDKライブラリファイルliteav.libを追加します。

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




ステップ5: SDKバージョン番号の印刷

1. TRTCDemo.cppファイルのトップにヘッダーファイルをインポートして追加します。コードは次のとおりです。
#include "ITRTCCloud.h"
#include <QLabel>
2. TRTCDemo.cppファイルのTRTCDemo::TRTCDemoコンストラクタの中に、以下のテストコードを追加します。
ITRTCCloud * pTRTCCloud = getTRTCShareInstance();
std::string version(pTRTCCloud->getSDKVersion());

QString sdk_version = QString("SDK Version: %1").arg(version.c_str());
QLabel* label_text = new QLabel(this);
label_text->setAlignment(Qt::AlignCenter);
label_text->resize(this->width(), this->height());
label_text->setText(sdk_version);
3. F5を押下して動作させ、下図のとおり、SKDのバージョン番号を印刷します。



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.1 SDKをダウンロードし、ファイルを解凍して開きます。
1.2 QTTestと同じクラスのディレクトリ下で空のSDKフォルダを作成し、SDK内の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の引用
ヘッダーファイル #include "ITRTCCloud.h" によって直接引用することができます。
ネームスペースの利用:C++のすべてのプラットフォームのインターフェースのメソッド、タイプなどはいずれもtrtcネームスペースで定義されています。コードをより簡潔にするため、trtcネームスペースを直接使用することをお勧めします。
説明:
ここまでで統合作業はすでに完了していますので、プロジェクトをコンパイルして実行できます。 Demoを使用するためのクロスプラットフォームSDKのAPIの詳細については、QTDemoをダウンロードしてご参照ください。

よくあるご質問

次のエラーが生じた場合は、前述のプログラム設定にしたがって、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) の中に引用されています