このドキュメントでは、ApsaraVideo Real-time Communication (ARTC) のサンプルプロジェクトを迅速に実行し、リアルタイム音声・映像機能を体験する方法について説明します。
サンプルソースコードのダウンロード
Alibaba Cloud では、ARTC SDK API の使用方法を示すオープンソースのサンプルプロジェクトを提供しています。このプロジェクトにより、開発者は SDK 機能をより直感的に理解し、統合できます。詳細については、「Windows サンプルプロジェクトリポジトリ」をご参照ください。
前提条件
サンプルプロジェクトを実行する前に、開発環境が以下の要件を満たしていることを確認してください。
開発ツール: Visual Studio 2015 以降(最新の安定版を使用してください)。
テストデバイス: Windows 7 以降を実行中の Windows PC。
ネットワーク環境: 安定したネットワーク接続。
アプリケーション設定: ApsaraVideo Real-time Communication アプリケーションの AppID および AppKey を取得済みであること。詳細については、「アプリケーションの作成」をご参照ください。
操作手順
ステップ 1:サンプルプロジェクトの取得
ARTC サンプルプロジェクトをローカルマシンにクローンします。
git clone https://github.com/MediaBox-Demos/amdemos-artcこのリポジトリには、ARTC SDK を使用した複数のネイティブプラットフォーム向けサンプルプロジェクトが含まれています。Windows プラットフォームのサンプルは Windows/ フォルダにあります。
サンプルプロジェクトには、テストを支援するためのトークン生成用クライアント側コードが含まれています。
以下に、Windows/ARTCExample プロジェクトのファイル構造を示します。
├── Windows // Windows プロジェクト構造のルートディレクトリ
│ ├── ARTCExample // API サンプルのソースコードディレクトリ
│ ├── ARTCExampleDefine.h // AppId、AppKey などの情報を設定
│ ├── include // ARTC SDK ヘッダーファイルディレクトリ
│ ├── ... // その他のファイル
│ ├── lib // ARTC SDK 静的ライブラリディレクトリ
│ ├── x64 // x64 版 ARTC ライブラリ
│ ├── AliRTCSdk.lib // シンボルファイル
│ ├── ... // その他の ARTC SDK ファイル
│ ├── x86 // x86 版 ARTC ライブラリ
│ ├── AliRTCSdk.lib // シンボルファイル
│ ├── ... // その他の ARTC SDK ファイル
│ ├── ARTCExample.sln // デモプロジェクトファイルステップ 2:サンプルプロジェクトの設定
ソースコードをダウンロード後、
Windowsフォルダを開きます。「SDK のダウンロード/統合」から Windows 向け ARTC SDK をダウンロードしてください。上記の構造に従い、静的ライブラリを lib フォルダに、ヘッダーファイルを include フォルダに配置する必要があります。メインプロジェクトのコンパイルが成功した後は、DLL ファイルをプロジェクトの出力ディレクトリに配置してください。
Windowsフォルダ内でプロジェクトファイルARTCExample.slnを開きます。ApsaraVideo Real-time Communication の AppID および AppKey を設定します。
Windows/ARTCExample/ARTCExampleDefine.hファイルを開き、コンソールから取得した AppID および AppKey を入力してください。
#define ARTC_APP_ID <ApsaraVideo Real-time Communication AppID>
#define ARTC_APP_KEY <ApsaraVideo Real-time Communication AppKey>ステップ 3:サンプルプロジェクトのコンパイルと実行
ARTCExample プロジェクトを選択してコンパイルできます。
実行時には、ARTC DLL ファイルをプロジェクトのアプリケーションバイナリ出力ディレクトリに配置する必要があります。デフォルトでは、このディレクトリは
ARTCExampleフォルダの 1 階層上にあるx64フォルダ内のdebug/releaseフォルダです。コンパイルが成功したら、アプリを実行して API サンプルを試すことができます。