概要
mediasoup 公式 demo は、SFU の基本構成(Router / Transport / Producer / Consumer / signaling)を一通り確認できるサンプルです。最初に mediasoup の動作全体を理解するには公式 demo の起動が最も効率的です。
前提環境
- Ubuntu 22.04 以降
- Node.js 20 以上
- git / build-essential / python3
1. 必要パッケージを導入
sudo apt update
sudo apt install -y git build-essential python3
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
2. demo を clone
git clone https://github.com/versatica/mediasoup-demo.git
cd mediasoup-demo
3. 依存関係インストール
npm install
初回は mediasoup worker の C++ ビルドが実行されるため時間がかかります。
4. 設定ファイル確認
デフォルトでは HTTPS 用証明書が必要です。ローカル検証では自己署名証明書を使います。
cd server
npm run create-self-signed-cert
cd ..
5. 起動
npm start
6. ブラウザアクセス
https://localhost:3000
自己署名証明書警告を許可すると demo が表示されます。
7. Docker 利用例
docker compose up
Dockerfile が用意されているため、依存環境差異を避けたい場合はこちらが簡単です。
確認できるポイント
- 複数ユーザー参加
- 映像/音声 publish
- consumer 自動生成
- Simulcast / bitrate 制御
補足
公式 demo は production 向けではなく学習用途です。本番では signaling 設計・認証・TURN 構成を独自実装する必要があります。