mediasoup公式導入手順

—

by

in

概要

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 構成を独自実装する必要があります。