Strona główna
» ADMINISTRATOR SIECI
»
Naprawa kamery internetowej BigBlueButton, która się nie ładuje: nie udało się połączyć z gniazdem ICE
Naprawa kamery internetowej BigBlueButton, która się nie ładuje: nie udało się połączyć z gniazdem ICE
Gdy kamera internetowa BigBlueButton pozostaje pusta, a przeglądarka lub spotkanie zgłasza komunikat „Niepowodzenie połączenia z gniazdem ICE”, komunikat wskazuje na nieudane połączenie z mediami, ale nie identyfikuje jednej, uniwersalnej przyczyny. Uprawnienia kamery, sieć użytkownika, zapora sieciowa serwera, adresowanie NAT i ustawienia przekaźnika TURN – wszystkie te czynniki mogą mieć znaczenie. Przed zmianą konfiguracji serwera należy rozpocząć od sprawdzenia, które wyizoluje problem.
Aktualny poradnik rozwiązywania problemów BigBlueButton opisuje powiązany błąd 1007: ICE negotiation failed ( Niepowodzenie negocjacji ICE), który oznacza brak możliwości wynegocjowania ścieżki między przeglądarką a serwerem multimediów. Zawiera on listę NAT, zablokowanych portów UDP oraz potencjalną potrzebę użycia polecenia TURN w sieciach z ograniczeniami. Dokładna fraza w Twojej przeglądarce może różnić się w zależności od wersji BigBlueButton, platformy hostingowej lub klienta. Potraktuj to jako wskazówkę, a nie diagnozę. Przeczytaj poradnik rozwiązywania problemów BigBlueButton 4.0 .
Najpierw sprawdź, czy problem dotyczy aparatu lub połączenia
Aby przeglądarka mogła uzyskać dostęp do kamery internetowej, wymagane jest zezwolenie na dostęp do kamery, a strona spotkania musi korzystać z bezpiecznego kontekstu, takiego jak HTTPS. Te sprawdzenia określają, czy przeglądarka może przechwytywać lokalne wideo. ICE to proces WebRTC, który znajduje trasę sieciową do przesyłania multimediów między przeglądarką a BigBlueButton. Odmowa dostępu do kamery i nieudana trasa ICE to różne problemy, chociaż oba mogą spowodować, że kamera internetowa będzie niedostępna. MDN dokumentuje wymagania dotyczące uprawnień przeglądarki i bezpiecznego kontekstu .
Koncepcyjny panel uprawnień przeglądarki z włączoną kamerą. Symbole mają charakter poglądowy i nie odzwierciedlają konkretnej przeglądarki ani ekranu BigBlueButton.
Sprawdź ikonę kamery obok paska adresu i ustawienia witryny w przeglądarce. Zezwól na dostęp do kamery dla witryny BigBlueButton, upewnij się, że wybrana kamera jest wybrana i zamknij inne aplikacje, które mogą z niej korzystać. Jeśli przeglądarka wyświetla podgląd lokalny, ale spotkanie nadal nie może opublikować obrazu, dostęp do urządzenia lokalnego prawdopodobnie działa; kontynuuj sprawdzanie sieci. Jeśli podgląd się nie pojawi, najpierw rozwiąż problem z wyborem urządzenia, ustawieniami prywatności systemu operacyjnego lub uprawnieniami przeglądarki.
Wypróbuj te kontrole uczestników w kolejności
Odśwież stronę raz i dołącz ponownie. Opuść spotkanie, odśwież stronę, a następnie dołącz ponownie i spróbuj ponownie włączyć kamerę internetową. To może rozwiązać chwilowy problem z przeglądarką lub sesją multimedialną, ale powtarzające się awarie ICE zazwyczaj wymagają naprawy po stronie sieci lub serwera.
Zaktualizuj lub zmień przeglądarkę na obsługiwaną. Wypróbuj aktualną wersję innej obsługiwanej przeglądarki na komputerze. Jeśli kamera internetowa działa w tym urządzeniu, zapisz oryginalną przeglądarkę i jej wersję dla organizatora spotkania. Mogą występować zachowania specyficzne dla danej przeglądarki, więc jedna udana próba uruchomienia przeglądarki nie oznacza, że serwer jest poprawnie skonfigurowany dla każdego użytkownika.
Porównaj inną sieć. Jeśli jest to dozwolone, połącz się z hotspotu telefonicznego lub innej zaufanej sieci. Prawidłowe połączenie z kamerą internetową podczas drugiego połączenia zdecydowanie sugeruje, że pierwotna sieć Wi-Fi, VPN, serwer proxy lub zapora sieciowa firmy ogranicza ruch multimedialny. Nie dowodzi to jednak, która konkretna reguła jest odpowiedzialna za ten proces.
Przetestuj ten sam pokój z innym uczestnikiem. Jeśli kilka osób w różnych sieciach nie może publikować obrazu z kamer internetowych, zgłoś administratorowi spotkania prawdopodobny problem z serwerem lub hostingiem. Jeśli problem dotyczy tylko jednej osoby, skup się najpierw na jej urządzeniu, przeglądarce i sieci.
Przetestuj inny pokój lub wersję demonstracyjną BigBlueButton. Jeśli Twoja organizacja na to pozwala, skorzystaj z osobnego pokoju lub oficjalnej usługi testowej BigBlueButton. Jeśli kamera działa tam, ale nie na serwerze Twojej organizacji, udostępnij porównanie administratorowi.
Lista punktów dostępowych w telefonie i lista sieci Wi-Fi na laptopie pozwalają na szybkie porównanie sieci z ograniczonym dostępem i oddzielnego połączenia.
Co powinni zweryfikować administratorzy
W przypadku problemów z kilkoma użytkownikami należy zweryfikować ścieżkę dostępu do mediów na każdej granicy sieci: zaporze hosta, grupie zabezpieczeń w chmurze, routerze lub urządzeniu NAT oraz każdej zaporze sieciowej nadrzędnej. Dokumentacja zapory BigBlueButton wymienia protokoły TCP 80 i 443 dla ruchu internetowego, a w udokumentowanej konfiguracji domyślnej – UDP 16384–32768 dla mediów. Instalacja może korzystać z niestandardowego zakresu lub stosu mediów specyficznego dla danej wersji, dlatego przed zmianą reguł należy potwierdzić rzeczywistą konfigurację. Nie należy otwierać szerszego zakresu niż wymagany przez instalację. Zapoznaj się z aktualnym przewodnikiem konfiguracji zapory BigBlueButton .
Koncepcyjna ścieżka sieciowa przedstawia spotkanie medialne przechodzące przez zaporę sieciową do serwera; sprawdź rzeczywiste reguły i zakres portów używany przez Twoją instalację.
W przypadku serwera za NAT należy sprawdzić, czy usługa multimedialna ogłasza osiągalny zewnętrzny adres IP. BigBlueButton 2.5 i nowsze wersje używają mediasoup do obsługi multimediów HTML5 WebRTC; oficjalny podręcznik zapory opisuje konfigurację ogłoszonego adresu zewnętrznego w /etc/bigbluebutton/bbb-webrtc-sfu/production.yml. Prywatny adres, nieaktualny adres publiczny, nieprawidłowe przekierowanie portów lub brakująca konfiguracja IPv6 mogą uniemożliwić klientom dostęp do usługi multimedialnej. Należy stosować tylko instrukcje zgodne z wersją BigBlueButton i układem sieci, a następnie ponownie uruchamiać usługi wyłącznie zgodnie z instrukcjami zawartymi w podręczniku.
Sprawdź również, czy dotknięci problemem użytkownicy korzystają z sieci blokujących wychodzący protokół UDP. Serwer TURN może przekazywać ruch WebRTC, gdy trasa bezpośrednia jest niedostępna, ale musi być zainstalowany, osiągalny i skonfigurowany dla odpowiedniej wersji BigBlueButton. Dokumentacja TURN i domyślne ustawienia pakietów różnią się w zależności od wersji; postępuj zgodnie z instrukcją dla konkretnej wersji, z której korzystasz. Nie kopiuj danych uwierzytelniających ani ustawień portów z innej wersji. Zapoznaj się z wytycznymi serwera TURN dla BigBlueButton 4.0 .
Koncepcyjna ścieżka WebRTC pokazuje punkty końcowe korzystające z serwera przekaźnikowego, gdy nie można nawiązać bezpośredniego połączenia.
Typowe założenia, których należy unikać
„Błąd kamery internetowej oznacza, że kamera jest uszkodzona”.
Niekoniecznie. Jeśli pojawi się podgląd lokalny, a przeglądarka ma uprawnienia, urządzenie może działać, mimo że trasa multimediów nie działa. Działanie: spróbuj innej sieci i zapytaj, czy problem dotyczy innych uczestników, zanim wymienisz kamerę.
„Umożliwienie korzystania z kamery rozwiązuje każdą awarię kamery internetowej”.
Uprawnienie pozwala przeglądarce jedynie na przechwytywanie wideo. Nie otwiera zablokowanego ruchu UDP ani nie koryguje adresu NAT serwera. Działanie: po potwierdzeniu uprawnień przetestuj połączenie z innej sieci.
„Spotkanie, które się kręci, zazwyczaj dowodzi, że jego sieć medialna jest otwarta”.
Strona i elementy sterujące spotkania mogą ładować się przez HTTPS, podczas gdy dźwięk lub obraz w czasie rzeczywistym nie mogą nawiązać oddzielnej ścieżki multimedialnej. BigBlueButton dokumentuje awarie ICE, a także zablokowane protokoły UDP i NAT jako możliwe przyczyny. Działanie: wykonaj test z użyciem kamery internetowej i porównaj wyniki w różnych sieciach.
„Każdy serwer powinien używać tych samych portów i ustawień TURN.”
Udokumentowane ustawienia domyślne stanowią przydatny punkt wyjścia, a nie dowód na poprawność konfiguracji. Porty można dostosować, a konfiguracja TURN różni się w zależności od wersji. Działanie: sprawdź wdrożoną wersję i konfigurację przed modyfikacją reguł zapory lub przekaźnika.
Jak potwierdzić poprawkę
Po zmianie dołącz do nowego spotkania i opublikuj obraz z kamery internetowej na co najmniej minutę. Upewnij się, że wyświetla się podgląd lokalny, inni uczestnicy widzą strumień, a ponowne połączenie nie powoduje wystąpienia błędu ICE. Poproś użytkownika w sieci, której dotyczył błąd, o powtórzenie tego samego testu. Jeśli tylko test hotspotu zakończy się powodzeniem, przekaż ten wynik administratorowi sieci i poproś o weryfikację ruchu wychodzącego WebRTC. Jeśli wszystkie sieci zawiodą dla wielu użytkowników, wyślij hostowi BigBlueButton informacje o wersji serwera, przybliżonym czasie, przeglądarkach, których dotyczy problem, kodzie błędu lub dokładnym komunikacie, informacji o działaniu dźwięku oraz wynikach każdego testu sieciowego. Unikaj publicznego publikowania linków do spotkań, tokenów dostępu ani nieocenzurowanych dzienników przeglądarek.
Przydatna diagnoza zawęża zakres wadliwej warstwy: lokalny dostęp do kamery, sieć jednego użytkownika lub trasa medialna serwera. Sam komunikat nie pozwala na rozróżnienie tych przypadków, ale te sprawdzenia mogą dostarczyć administratorowi dowodów na potrzeby kolejnej zmiany.