agora.io VideoSDK for Unity クイックスタートガイド

#概要
agora.io に VideoSDK for Unity が公開されています。

Unity とは Unity Technologies が開発しているマルチプラットフォーム対応のゲームエンジンです。
Unity プロジェクトに VideoSDK を組み込むことで iOS/Android/MacOSX/Windows のアプリ開発が可能となります。
※ 開発には C# でのコーディングが必要となります。

この記事では VideoSDK に含まれているサンプルデモの使い方を紹介します。


#準備する物
1. AppID 
※ agora.io からデベロッパー登録を行い取得する必要があります。

2. 最新版の Unity Hub および 2017.4.35f1 以降の Unity 
※ ユーザー登録が必要となります。


#ビルド方法
##SDK の入手

次のいずれかの方法で SDK を入手してください: 
方法 1: Agora Developer Center から入手
方法 2: Unity Asset Store からインポート

###方法 1

1. Agora Developer Center の [SDK Download ページ](https://docs.agora.io/en/Agora%20Platform/downloads)から、最新版の VideoSDK for Unity をダウンロードします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/34163c1a-da40-e996-96bd-ed98bc0fb8c5.png)


2. ダウンロードしたファイルを解凍し、適当なディレクトリの下に配置します。

3. Unity Hub を起動した後 「ADD」 をクリックし、配置したディレクトリから 「Agora_Unity_SDK_FULL > samples > Hello-Video-Unity-Agora」 まで遷移します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/e78df007-7d08-e43a-649a-fb329c3bc39e.png)

4. 「Select Folder」 を押してプロジェクトを追加します。

5. 使用する Unity Version を選択し、プロジェクト名 (ここでは 「Hello-Video-Unity-Agora」) をクリックしてプロジェクトを開きます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/53aaf982-ea37-febe-2c3f-69800dd6c9e4.png)
※ 「プロジェクトをアップグレードしますか」 という内容のダイアログが出てきた場合、「Confirm」 を押して続行します。


###方法 2
1. 新規 Unity プロジェクトを作成します。

2. Asset Store タブを開き、「Agora Video SDK for Unity」を検索します。

3. 「Download」 をクリックし、完了すると 「Import」 に変わるので、再びクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/5d377943-c53d-f9c0-9bbe-281440cd9bcb.png)


4. Import Unity Package の画面が開くので 右下の「Import」 を押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/24bb596b-8691-62e1-35ab-12207ed8e1ca.png)



##サンプルデモの起動
1. プロジェクトが開いたのを確認し、Project タブから SceneHome をダブルクリックします。
※ AssetStore から SDK を入手した場合 「Assets > AgoraEngine > Demo」直下にあります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/188bf584-50bf-2cd6-ad14-b8df6c2d3077.png)

2. Hierachy タブから GameController をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/e16dfee8-8543-5ab9-6f47-47377d05ffa4.png)

3. Inspector タブ内に AppID を埋める欄が表示されますので、予め取得した ID を記入します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/923ba193-fdc4-44fb-8709-603d1d7a30db.png)

4. 「File > Build Settings」 を開き 「SceneHome」「SceneHelloVideo」 の順番に表示されていることを確認します。
※ されていない場合は、シーン名をドラッグして入れ替え、Delete で消去、または Project タブから追加等で修正してください
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/605deb28-0f78-0ed8-9235-e00c9feb2f17.png)

5. Build Settings を閉じ、Project タブから SceneHome をダブルクリックして開きます。

6. エディタ上部にある 「▶」 をクリックすることで、エディタ上から動作確認できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/6e07c00d-f981-be44-87dd-c99de90523bf.png)

7. チャンネル名を指定し「Join」をクリックすると画面が切り替わり、下図のように自映像が表示されます。
※ 実際の画面と異なる場合があります
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/ae97f272-eb4f-1699-4261-083249e069f1.png)

#関連リンク
・[Unity アプリに埋め込んだオーディオファイルを PlayEffect() で再生したい場合、パスの指定はどうすれば良いですか?](https://vcube-support.zendesk.com/hc/ja/articles/360036127692) 
・[カメラ映像を Unity オブジェクト上に描画させたいのですが、縦または横に伸びてしまいます。](https://vcube-support.zendesk.com/hc/ja/articles/360037315111)
・[Unity エディタの「ゲーム再生ボタン」を押すことで Agora SDK アプリの動作確認はできますか?](https://vcube-support.zendesk.com/hc/ja/articles/360035141052)

#最後に
[**agora.ioに関するお問い合わせはこちらから**](https://jp.vcube.com/lp/agora?utm_campaign=Agora&utm_source=Qiita&arc_id=b043065c7504a372f2b2)
[<img width="912" alt="スクリーンショット 0001-08-15 13.41.56.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/300377/5d815376-9b89-08fa-9434-6fa7e8e67bcf.png">](https://jp.vcube.com/lp/agora?utm_campaign=Agora&utm_source=Qiita&arc_id=b043065c7504a372f2b2)