BigBlueButton Breakout Roomsの音声が接続されない場合の対処法：確実なトラブルシューティング手順

BigBlueButtonのブレイクアウトルームの音声が接続できない場合、最初に確認すべき最も重要な質問は「どのサービスを再起動すればよいか？」ではなく、「音声がブレイクアウトルームに入った後だけ失敗するのか、それともメインミーティングでも失敗するのか？」です。この区別によって、ルーム切り替え時の問題と、ブラウザ、ネットワーク、メディアサーバーといったより広範な問題とを迅速に区別できます。

このガイドは BigBlueButton 3.0 を対象としており、2026 年 10 月現在、これが現在の安定版ドキュメントです。BigBlueButton 4.0 は開発中としてドキュメント化されています。BigBlueButton 3.0 は、ミーティング API を介して、、、などのさまざまなオーディオ ブリッジを使用できる可能性があるbbb-webrtc-sfuためlivekit、freeswitchすべてのデプロイメントで同じメディア パスが使用されると想定しないでください。公式のBigBlueButton API リファレンスにはこれらのブリッジの選択肢が記載されており、サーバー側のチェックについてはBigBlueButton トラブルシューティング ガイドが最適な出発点となります。

良い修理とはどのようなものか

修正が成功したと言えるのは、マイクアイコンが緑色に変わるだけではありません。修正後、参加者はブレイクアウトルームに入り、数秒以内に音声に接続し、他の参加者の声を聞き、発言し、相手の声も聞こえ、ミュートとミュート解除を正常に行い、再接続ループに陥ることなくメインルームに戻れる必要があります。他のすべてのブラウザまたはネットワークが正常に動作しているにもかかわらず、特定のブラウザまたはネットワークだけが問題を起こす場合は、サーバーの変更を中止し、そのクライアント環境に焦点を当ててください。

ステップ1：問題を正確に再現する

設定を変更する前に、モデレーター1名と参加者1名で問題を再現してください。参加者がメインルームで音声に参加できることを確認した後、その参加者をブレイクアウトルームに移動させ、何が起こるかを正確に記録してください。「音声接続中…」という表示がいつまでも終わらない場合は、ブラウザの権限拒否、マイクデバイスの欠落、または音声は接続されるものの音声が出ないといった問題とは異なります。

メインルームは正常に動作するのにブレイクアウトルームが動作しない場合は、ブレイクアウトルームから退出してメインルームに戻り、再度ブレイクアウトルームに一度入室してみてください。一度だけ発生したクライアントの状態は、正常に再接続することで解消されることがあります。問題が繰り返し発生する場合は、ページを繰り返し更新するのではなく、以下の手順で確認を続けてください。

成功チェック：参加者がブレイクアウトルームの音声に一度参加し、退出して再度参加し、音声が再び受信できることを確認します。これが安定して行われる場合は、問題は一時的なものであった可能性が高いです。同じ遷移が毎回失敗する場合は、次のステップに進みます。

ステップ2：ブラウザのマイク権限と選択したデバイスを確認します。

BigBlueButtonの音声はブラウザベースのWebRTCを使用しているため、マイクのアクセス許可が拒否された場合、ユーザーが小さな部屋に入った後に初めてそれに気づくと、ブレイクアウト特有の問題のように見えることがあります。ブラウザのサイト権限でBigBlueButtonホスト名を開き、マイクへのアクセスが許可されていることを確認してください。次に、目的のマイクが選択されていること、および他のアプリケーションがデバイスを占有していないことを確認してください。

最新バージョンのFirefoxまたはChromiumベースのブラウザでテストしてください。参加者が2つの最新バージョンのブラウザで同じ不具合を再現できる場合、ブラウザプロファイルの問題である可能性は低くなります。同じマシンとネットワークで、一方のブラウザは正常に動作し、もう一方は動作しない場合は、BigBlueButtonの設定を変更する前に、権限をリセットするか、クリーンなブラウザプロファイルでテストしてください。

成功確認：マイクアクティビティインジケーターが反応し、メインルームで音声が接続され、同じブラウザでブレイクアウトルームの音声にも接続できること。それでもメインルームで接続できない場合は、ブレイクアウトルームが根本原因ではありません。

ステップ3：再起動する前にBigBlueButtonを確認してください

サーバー上で、 を実行しますsudo bbb-conf --check。BigBlueButton のドキュメントでは、コアコンポーネントが正しく起動したかどうかを確認し、一般的な構成上の問題を明らかにするため、これを最初のサーバー側診断として推奨しています。「潜在的な問題」にリストされている項目については、すべてのサービスをすぐに再起動するのではなく、内容を確認してください。

また、sudo bbb-conf --statusオーディオブリッジに関連する systemd サービスを実行して確認してください。BigBlueButton 3.0 のデプロイメントでは、通常、bbb-webrtc-sfuデフォルトでオーディオに が使用されますが、LiveKit はミーティングごと、またはサーバー全体で有効にできます。統合が成功した場合はaudioBridge=livekit、従来の FreeSWITCH パスがブラウザのオーディオを伝送していると想定するのではなく、LiveKit のトラブルシューティングを行ってください。

公式の設定ファイルに関するドキュメントでは、/etc/bigbluebuttonパッケージのアップグレードによって上書きされないように、ローカルのオーバーライドを以下の場所に配置することを推奨しています。

成功チェック： bbb-conf --check説明のつかないエラーが表示されず、アクティブなオーディオブリッジサービスが実行されており、新しいテストミーティングが一貫して動作することを確認します。サービスの状態が良好なのにネットワークが1つでも失敗する場合は、ICE、NAT、およびTURNに注意してください。

ステップ4：ICE、NAT、ファイアウォール、およびTURNの問題を診断する

WebRTCは、ブラウザとBigBlueButtonのメディアインフラストラクチャ間で使用可能なメディアパスを確立する必要があります。シグナリングが成功してもメディアが有効なネットワークパスを見つけられない場合、ユーザーはICEネゴシエーションの失敗を経験したり、音声接続中に接続が切断されたりする可能性があります。BigBlueButtonのファイアウォールに関するドキュメントでは、外部IPアドレスのアナウンスが不正確であることやUDPがブロックされていることが一般的な原因として挙げられています。

Firefoxでは、about:webrtcICE候補と接続状態が表示されるため便利です。サーバーが外部アドレスが期待される場所に内部アドレスをアドバタイズしている場合は、NATとアナウンスIPの設定を確認してください。BigBlueButtonのファイアウォール設定ガイドでは、サーバーがNATの背後にある場合にmediasoupがパブリックアドレスをアナウンスする方法を説明しています。

障害が、制限の厳しい企業ネットワーク、学校ネットワーク、ホテルネットワーク、またはVPNネットワークに集中している場合は、TURNサーバーを設定してください。BigBlueButtonのインストールドキュメントでは、制限の厳しいファイアウォールの内側にいるユーザーにはTURNの使用を推奨しています。有効な検証方法として、スマートフォンのホットスポットなど、別のネットワークで同じユーザーをテストしてみることが挙げられます。ホットスポットは正常に動作し、管理対象ネットワークが失敗する場合は、ブレイクアウトルームのロジックではなく、ネットワークパスが制限要因であるという強力な証拠となります。

古いフォーラム投稿からコピーした広範囲のポートを安易に開放しないでください。インストールされているBigBlueButtonのバージョンとデプロイメントトポロジーに応じたポートとブリッジの要件を使用してください。古いFreeSWITCHまたはSIP.js固有のアドバイスは、現在の3.0インストールには適用されない場合があります。

成功チェック： ICEが接続状態になり、想定されるパブリックまたはリレー候補が表示され、影響を受けたユーザーが以前失敗したネットワークからブレイクアウトオーディオに参加できることを確認します。同じネットワーク上の他のユーザーが成功しているにもかかわらず、このユーザーが依然として失敗する場合は、デバイス/ブラウザーのチェックに戻ります。

ステップ5：設定済みのオーディオブリッジを比較し、ルームトランジションを再テストする

メインルームの音声は正常に動作するのに、ブレイクアウトルームの音声が多くのユーザーで一貫して失敗する場合は、会議で実際に使用されているオーディオブリッジを確認してください。BigBlueButton 3.0 では、 create パラメータが、、audioBridgeなどの有効な値で公開されています。統合によって会議ごとにサーバーのデフォルト設定を上書きできるため、確認した構成が、失敗しているセッションで使用されているブリッジと一致しない場合があります。bbb-webrtc-sfulivekitfreeswitch

カスタムのミーティングごとの上書き設定を行わずに、新しいテストミーティングを作成し、メインルーム → ブレイクアウトルーム → メインルームという同じシーケンスを繰り返します。クリーンなミーティングは正常に動作するのに、LMSまたはカスタムアプリケーションで作成されたミーティングが失敗する場合は、その統合によって送信されるAPIパラメータを調べます。両方とも失敗する場合は、サーバーのメディア設定またはバージョン固有の不具合が原因である可能性が高いです。

設定変更後は、必要に応じてのみBigBlueButtonを再起動しsudo bbb-conf --restart、sudo bbb-conf --check再度実行してください。テストを行う前に複数の変更を重ねることは避けてください。一度に1つの変更を行うことで、どの調整が実際に問題を解決したかを特定できます。

成功確認：参加者2名がブレイクアウトルームで会話した後、メインルームに戻り、接続が途切れることなく再びブレイクアウトルームに入ることができること。少なくとも1つの外部ネットワークからこの手順を繰り返して、問題が解決したとみなしてください。

アプローチを変えるタイミング

ブラウザの権限、サーバーの状態、ICE/TURN、ブリッジの選択など、すべてを確認しても問題が解決しない場合は、推測を続けるのではなく、証拠を収集してください。BigBlueButton のバージョン、ブラウザとオペレーティングシステムのバージョン、公開されている BigBlueButton デモで問題が再現するかどうか、 の出力sudo bbb-conf --check、会議のオーディオブリッジ設定、および関連するブラウザの WebRTC 診断情報を記録してください。BigBlueButton のヘルプガイドでは、オーディオまたはビデオの障害をトラブルシューティングする際に、このようなネットワークおよび環境情報を明示的に要求しています。

2026年10月現在、BigBlueButton 3.0は依然として安定版のドキュメントラインであり、GitHub上で3.0のリリースが継続されています。一方、4.0のドキュメントは開発中とされています。これは、BigBlueButton 4.0ではデフォルトのメディアフレームワークがLiveKitに変更されるため、4.0固有のアドバイスを3.0サーバーに自動的に適用すべきではないからです。バージョンに依存する手順に従う前に、 BigBlueButtonの公式リリースページを確認してください。

最終確認チェックリスト

• 影響を受けた参加者向けに、メインルームの音声が接続されます。
• マイクの使用許可は有効であり、対象デバイスは入力動作を示しています。
• bbb-conf --check不明なメディアサービスエラーはありません。
• ICEは接続状態に達し、制限付きネットワークは必要に応じて使用可能なTURNパスを持つ。
• 会議では、あなたが考えている音声ブリッジが使用されます。
• 2人のユーザーはブレイクアウトルームで互いの声を聞きながら、メインルームに戻って再び参加することができます。

6つのチェック項目すべてに繰り返し合格すれば、修復作業は重要な結果、つまり部屋の移動時にも安定した音声が得られるという結果をもたらしており、単に一時的に緑色のマイクアイコンが表示されるだけではない。