Question 1

Chrome 148 で MiroTalk SFU エラー「A BUNDLE group contains a codec collision for header extension id=5」を修正するにはどうすればよいですか？

Accepted Answer

これは Chrome 148+ のリグレッションであり、カメラや MiroTalk ルームの設定問題ではありません。Chrome は、オプションの abs-capture-time RTP ヘッダー拡張 (id 5) がバンドルされた audio/video/screen メディア記述間で一貫してマッピングされていないため、ローカル SDP を誤って拒否します。この拡張は高度なレイテンシ/テレメトリ統計にのみ使用され、通話には必須ではありません。

自己ホスト型 Docker デプロイの修正:
1. MiroTalk SFU を最新リリースに更新します。これには abs-capture-time を無効にするクライアント側の回避策が含まれています:
docker compose pull
docker compose up -d
2. 更新されたクライアントを読み込むため、Chrome で MiroTalk ページを Ctrl+Shift+R (Windows) または Cmd+Shift+R (Mac) でハードリフレッシュします。
3. ルームに再度参加し、カメラ/画面共有を再試行します。

カスタムクライアントを保守している場合は、mediasoup-client/MiroTalk を更新するか、クライアント RTP ケイパビリティで urn:ietf:params:rtp-hdrext:abs-capture-time ヘッダー拡張を無効にしてください。一時的な回避策として、Chrome/アップストリームの WebRTC 修正がリリースされるまで、影響を受けていない別のブラウザを使用してください。

Question 2

MiroTalk SFU 通話中にどこかをクリックしたときの音声の途切れとリモートエコーを修正するには？

Accepted Answer

MiroTalk SFU を v2.2.86 から audio-output 修正を含む最新バージョンにアップグレードし、その後サーバーを再起動してブラウザをハードリフレッシュしてください：

git pull
npm install
npm run start

バグは RoomClient.js にありました。新しい audio consumer を作成する際に、ユーザーアクティベーションなしで changeAudioDestination(elem) を呼び出していたため、setSinkId() が次のクリックまで延期されていました。そのクリックによって audio pipeline がリセットされ、リモート audio が停止し、echo cancellation が壊れ、しばしば Success, audio output device attached: <sinkId> をログに記録しました。

このパッチは、consumer 作成時に setSinkId() が自動的に実行されるのを防ぎます。audio output の変更には、ユーザーアクティベーションを伴う明示的な speaker 選択が必要になりました。すぐにアップグレードできない場合は、RoomClient.js の 3942 行目付近にある自動 changeAudioDestination(elem) 呼び出しを削除するかガードし、speaker-selection handler からのみ呼び出すようにしてください。

Question 3

authRequired が true の場合に "state mismatch, expected /favicon.ico, got /" で OIDC ログインが失敗するのを修正するにはどうすればよいですか？

Accepted Answer

エラーは、ブラウザの同時 /favicon.ico リクエストが OIDC ミドルウェアを通り、別のログインフローを開始し、元のページコールバックが完了する前に OIDC state cookie を上書きするために発生します。

修正するには、Server.js で auth() ミドルウェアを登録する前に、静的アセットを OIDC 認証から除外します。

if (oidc.enabled) {
    const staticAssetRegex = /\.(ico|png|jpg|jpeg|gif|svg|css|js|woff2?|ttf|eot|mp3|mp4|webm)$/i;

app.use((req, res, next) => {
        if (staticAssetRegex.test(req.path)) return next('route');
        next();
    });

app.use(auth(oidc.config));
}

あるいは、この静的アセット除外を含むリリースに MiroTalk を更新してください。authRequired: true のままにしてください。false に設定すると問題を回避するだけで、グローバル認証の適用が削除されます。

MiroTalk が NGINX リバースプロキシの背後で動作している場合は、プロキシバッファ設定も追加または増加してください。

proxy_buffer_size 128k;
proxy_buffers 8 256k;
proxy_busy_buffers_size 512k;

その後、アプリケーションと NGINX を再起動してください。

Question 4

Mirotalk SFU で HTTP/2 を有効にするにはどうすればよいですか？

Accepted Answer

MiroTalk アプリケーションの変更は不要です。HTTP/2 はリバースプロキシ層で有効にする必要がありますが、MiroTalk は内部で HTTP/1.1 を引き続き使用できます。

NGINX では、TLS リスナーで HTTP/2 を使用します：

server {
    listen 443 ssl http2;
    server_name your-domain.com;

ssl_certificate     /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

location / {
        proxy_pass http://127.0.0.1:3010;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

設定を適用するには：

sudo nginx -t
sudo systemctl reload nginx

ブラウザの DevTools → Network → Protocol で確認します。静的アセットは h2 と表示されるはずです。NGINX から MiroTalk への接続が HTTP/1.1 のままであることは想定されており、標準的な本番アーキテクチャです。

Question 5

MiroTalk SFUでFirefoxを使用しているときに、ドロップアップメニューが開いた直後に閉じてしまうのはなぜですか?

Accepted Answer

これは、MiroTalk SFU において確認されたバグで、ドロップアップメニュー（上矢印ボタンなど）がホバーで開き、マウスが矢印アイコンの上方から入った場合に Firefox 上で即座に閉じてしまうというものでした。この問題はメンテナーによって修正され、https://sfu.mirotalk.com に反映されています。それでもメニューが閉じる場合は、Ctrl+F5 でハードリフレッシュして、Firefox にキャッシュされた古いスクリプトをクリアしてください。Chrome は影響を受けていませんでした。

MiroTalk SFU

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト