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. abs-capture-time을 비활성화하는 클라이언트 측 우회 방법이 포함된 최신 릴리스로 MiroTalk SFU를 업데이트하세요:
docker compose pull
docker compose up -d
2. 업데이트된 클라이언트를 로드하려면 Chrome에서 Ctrl+Shift+R (Windows) 또는 Cmd+Shift+R (Mac)로 MiroTalk 페이지를 강력 새로고침하세요.
3. 룸에 다시 참여하고 카메라/화면 공유를 다시 시도하세요.

사용자 지정 클라이언트를 유지 관리하는 경우 mediasoup-client/MiroTalk를 업데이트하거나 클라이언트 RTP capabilities에서 urn:ietf:params:rtp-hdrext:abs-capture-time 헤더 확장을 비활성화하세요. 임시 우회 방법으로 Chrome/업스트림 WebRTC 수정이 릴리스될 때까지 영향을 받지 않는 다른 브라우저를 사용하세요.

Question 2

MiroTalk SFU 통화 중 아무 곳이나 클릭할 때 발생하는 오디오 끊김과 원격 에코를 해결하는 방법

Accepted Answer

오디오 출력 수정이 포함된 최신 버전으로 MiroTalk SFU를 v2.2.86에서 업그레이드한 다음, 서버를 재시작하고 브라우저를 강력 새로고침하세요:

git pull
npm install
npm run start

버그는 RoomClient.js에 있었습니다: 새 오디오 consumer를 생성할 때 user activation 없이 changeAudioDestination(elem)를 호출했기 때문에 setSinkId()가 다음 클릭까지 지연되었습니다. 그 클릭은 오디오 파이프라인을 재설정하고 원격 오디오를 중지시켰으며 echo cancellation을 망가뜨렸고, 종종 Success, audio output device attached: <sinkId>를 로깅했습니다.

패치는 consumer 생성 시 setSinkId()가 자동으로 실행되는 것을 방지합니다; 이제 오디오 출력 변경은 user activation과 함께 명시적인 스피커 선택이 필요합니다. 즉시 업그레이드할 수 없다면, RoomClient.js 3942번째 줄 근처의 자동 changeAudioDestination(elem) 호출을 제거하거나 가드하고, 스피커 선택 핸들러에서만 호출하세요.

Question 3

authRequired가 true일 때 "state mismatch, expected /favicon.ico, got /" 오류가 발생하는 OIDC 로그인 실패를 어떻게 수정하나요?

Accepted Answer

이 오류는 브라우저의 동시 /favicon.ico 요청이 OIDC 미들웨어를 통과하면서 또 다른 로그인 흐름을 시작하고, 원래 페이지 콜백이 완료되기 전에 OIDC 상태 쿠키를 덮어쓰기 때문에 발생합니다.

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

Firefox에서 MiroTalk SFU의 drop-up 메뉴가 열리자마자 닫히는 이유는 무엇인가요?

Accepted Answer

이는 MiroTalk SFU에서 확인된 버그로, 드롭업 메뉴(예: 위쪽 화살표 버튼)가 마우스 오버 시 열리면서 마우스가 화살표 아이콘 위쪽에서 진입할 경우 Firefox에서 즉시 닫히는 문제였습니다. 이 버그는 유지 관리자에 의해 수정되었으며 현재 https://sfu.mirotalk.com에 적용되어 있습니다. 메뉴가 여전히 닫히는 경우, Ctrl+F5로 강력 새로 고침을 하여 Firefox에 캐시된 이전 스크립트를 제거하세요. Chrome은 영향을 받지 않았습니다.

MiroTalk SFU

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트