# サンプル集を使った接続確認

## 概要

このチュートリアルでは Sora Unity SDK のサンプル集を使って接続確認をするところまでを説明します。

[Sora Unity SDK サンプル集](https://github.com/shiguredo/sora-unity-sdk/tree/master/SoraUnitySdkExamples)

## チュートリアルの注意点

- このチュートリアルは Windows 10 でのみ動作確認をしています。
- このチュートリアルは Unity Editor 上での動作確認を前提としています。
- このチュートリアルは Python3 がインストールされていることを前提としています。

## 接続先の用意

接続確認を行うために接続先を用意します。
接続先は時雨堂が開発、販売している WebRTC SFU Sora を利用します。

検証目的であれば [Sora Labo](https://sora-labo.shiguredo.jp/) を利用することで、 Sora を無料で試すことができます。

GitHub アカウントを用意して [Sora Labo のドキュメント](https://github.com/shiguredo/sora-labo-doc) を読んだ後  にサインアップしてください。

## Sora Unity SDK サンプル集の取得

[Sora Unity SDK](https://github.com/shiguredo/sora-unity-sdk/) を clone してください。

安定版の master ブランチを使います。

```bash
$ git clone -b master https://github.com/shiguredo/sora-unity-sdk.git
```

> **注釈**
>
> Apple Vision Pro (visionOS) を利用する場合は `apple-vision-pro` タグが付与されたブランチを使用してください。

```bash
$ git clone -b 2026.1.0-apple-vision-pro.0 https://github.com/shiguredo/sora-unity-sdk.git
```

## Sora Unity SDK のインストール

clone が完了したら、作成されたディレクトリに移動後、 `python3 run.py install` を実行して Sora Unity SDK をインストールします。
Sora Unity SDK のインストール方法は以下の通りです。

```bash
$ cd sora-unity-sdk
$ python3 run.py install

# Ubuntu 以外のプラットフォーム、Ubuntu 24.04 を使用する場合は以下のコマンドを実行してください。
$ rm -rf SoraUnitySdkExamples/Assets/Plugins/SoraUnitySdk/ubuntu-22.04
# Ubuntu 22.04 を使用する場合は以下のコマンドを実行してください。
$ rm -rf SoraUnitySdkExamples/Assets/Plugins/SoraUnitySdk/ubuntu-24.04
```

> **注釈**
>
> Ubuntu 以外のプラットフォームでビルドを行う場合も、Ubuntu 22.04 と Ubuntu 24.04 いずれかのディレクトリを削除してください。
> ビルド時に同一ファイル名のバイナリが複数存在するとビルドエラーになります。

### Unity Editor で Sora Unity SDK サンプル集を開く

Sora Unity SDK のインストールが完了したら、 Unity Editor でサンプル集を開きます。

Unity Editor は [Sora Unity SDK 概要](overview.html) の対応 Unity バージョンを推奨しています。

Unity Editor でサンプル集を開くとこのようになっています。

![image](https://i.gyazo.com/3cebd97452cab92e4ab6b7ae31898206.png)

## 接続確認をする

ここでは Sora Labo を使って接続確認をします。

### シーンを開く

Sora Unity SDK サンプル集では接続サンプルとして以下のシーンが用意されています。

- multi_sendrecv
- multi_sendonly
- multi_recvonly

ここでは multi_sendrecv を使用します。

### 接続設定

サンプル集のシーンは Script オブジェクトで設定を行います。

![image](https://i.gyazo.com/d48fa446ae1e23856f1043e483f96f65.png)

Sora Labo で取得したシグナリング URLs 、チャネル ID 、アクセストークンを設定します。

![image](https://i.gyazo.com/b5ef947c329e1831927bf53a6d691b5e.png)

### 接続する

Sora Labo の Devtools と映像の送受信を行います。

事前に送受信確認のために Sora Labo の Devtools でマルチストリーム送受信を開いておき fakeMedia で接続しておきます。

Unity Editor の Play ボタンを押下してください。

Game Tab が開き以下のような画面になりますので開始ボタンを押下します。

![image](https://i.gyazo.com/6a0254bbdca453599c3f086cc0f5fcaf.png)

無事送受信が開始されると以下のような画面になります。

![image](https://i.gyazo.com/b28ca35c08b483a3c0101811fac9f82b.png)

以上で接続確認は完了です。

## 各プラットフォーム向けの設定

このチュートリアルで使用したサンプル集では各プラットフォーム向けの設定が行われています。

ご自身のプロジェクトで Sora Unity SDK を利用する場合は各プラットフォーム向けに設定をする必要があります。

それぞれのドキュメントを参照してください。

### Windows のビルド

Sora Unity SDK のインストール完了後に使うことができます。

Target Platform を Windows に指定してビルドしてください。

### macOS のビルド

[macOS で使ってみる](use_macos.html) をお読みください。

### iOS のビルド

[iOS で使ってみる](use_ios.html) をお読みください。

### Android のビルド

[Android で使ってみる](use_android.html) をお読みください。

### Linux のビルド

libva-drm2 パッケージの apt によるインストール、 Sora Unity SDK のインストール完了後に使うことができます。

Target Platform を Linux に指定してビルドしてください。

### visionOS のビルド

[visionOS で使ってみる](use_visionos.html) をお読みください。

## 次のステップ

Sora Unity SDK のサンプル集ではいろいろな機能を試せるようになっています。

それぞれの機能を試せるよう次項からサンプル集を使用した機能の試し方について説明します。