목차 · 찾기
위피스 설명서
사무실 밖 동료와 화상 통화가 안 될 때 통화 서버 넣기
메신저의 음성·화상 통화는 참가자의 브라우저끼리 직접 연결합니다. 회사 방화벽이나 통신사 공유기 때문에 직접 연결이 막히면 통화 화면은 열려도 소리와 영상이 오가지 않습니다. 이럴 때 연결을 중계하는 통화 서버(ICE 서버)를 넣어 줍니다. 같은 사무실 안에서는 대부분 잘 되므로, 바깥 동료나 거래처와의 통화가 자꾸 끊길 때 손대면 됩니다.
이 설정이 영향을 주는 곳
값은 시스템 매개변수(mail.use_call_server, mail.use_twilio_rtc_servers, mail.twilio_account_sid, mail.twilio_account_token)에 저장됩니다.
| 화면 | 영향 |
|---|---|
| 메신저 통화·회의 | 누군가 통화에 들어올 때마다 서버가 통화 서버 목록을 만들어 브라우저에 넘깁니다. 채팅, 채널, 회의 탭의 통화가 모두 해당합니다 |
| Twilio 계정 | 두 칸을 켜고 계정 값을 넣으면 통화에 들어올 때마다 Twilio에서 통화 서버 목록을 받아 옵니다 |
| ICE 서버 목록 | Twilio를 쓰지 않거나 Twilio에서 받아 오지 못하면 여기 등록한 서버를 앞에서부터 5개까지 씁니다 |
위피스에서 처음 들어 있는 값
| 칸 | 처음 값 | 뜻 |
|---|---|---|
| 맞춤형 통화 서버 | 꺼짐 | 아래 칸들이 숨어 있음 |
| Twilio를 활용한 맞춤형 ICE 서버 | 꺼짐 | Twilio를 쓰지 않음 |
| ICE 서버 목록 | 없음 | 등록한 통화 서버가 없음 |
아무것도 넣지 않으면 브라우저는 구글이 공개한 연결 확인용 서버(STUN)만 씁니다. 이 서버는 서로의 주소를 찾아 줄 뿐 통화를 중계하지는 않으므로, 직접 연결이 막힌 곳에서는 통화가 되지 않습니다.
위피스에서는 이렇게 고릅니다
- 같은 사무실 동료끼리만 통화한다면 그대로 둡니다.
- 재택 근무자나 거래처와 통화할 일이 많고 연결이 자주 실패하면 중계 서버(TURN)가 필요합니다. 두 길이 있습니다.
- Twilio 계정: Twilio에 가입해 계정 값 두 개를 넣습니다. 서버를 직접 운영하지 않아도 되지만 Twilio 요금이 듭니다.
- 직접 등록: 이미 쓰고 있는 TURN 서버가 있으면 ICE 서버 환경설정에 주소와 인증 정보를 넣습니다.
설정 순서
Twilio 계정을 쓸 때
- Twilio에 가입하고, 콘솔의 계정 정보에서 Account SID와 Auth Token을 확인합니다.
- 왼쪽 위 앱 메뉴에서 설정을 열고 일반 설정 탭의 메신저 칸으로 내려갑니다.
- 맞춤형 통화 서버를 체크합니다. 아래에 통화 서버 칸들이 나타납니다.
- Twilio를 활용한 맞춤형 ICE 서버를 체크하고 SID에 Account SID, 토큰에 Auth Token을 넣습니다.
- 위쪽의 저장을 누릅니다.
TURN 서버를 직접 등록할 때
- 위 2~3번처럼 맞춤형 통화 서버를 체크하고 저장합니다.
- 맞춤형 ICE 서버 아래의 ICE 서버 환경설정을 누릅니다.
- 신규를 누르고 칸을 채웁니다.
- 유형: 중계 서버는 「turn:」, 주소 확인용 서버는 「stun:」
- URL: 서버 주소와 포트. 「turn:」을 앞에 붙이지 않고
turn.example.com:3478처럼 씁니다 - 사용자 이름, 자격 증명: TURN 서버에서 받은 계정 값
- 저장합니다.
설정을 바꾼 뒤 통화에 새로 들어오는 사람부터 적용됩니다.
알아 둘 점
- 두 칸을 모두 켜야 Twilio를 씁니다. 맞춤형 통화 서버를 끄면 Twilio 칸에 값이 남아 있어도 쓰지 않습니다.
- ICE 서버 목록은 위 스위치와 상관없이 쓰입니다. 목록에 서버가 하나라도 있으면 Twilio를 쓰지 않는 동안 그 목록이 통화에 쓰입니다. 쓰지 않을 서버는 목록에서 지웁니다.
- Twilio에서 받아 오지 못하면 목록으로 넘어갑니다. 계정 값이 틀렸거나 Twilio에 접속하지 못하면 등록한 ICE 서버 목록을 쓰고, 목록도 비어 있으면 공개 STUN만으로 연결을 시도합니다.
- 목록은 5개까지만 씁니다. 브라우저 제한 때문에 서버는 등록한 순서대로 5개까지만 넘어갑니다.
- 같은 묶음의 맞춤형 SFU 서버는 여러 사람이 함께 하는 큰 회의를 위한 별도 중계 서버입니다. 직접 운영하는 SFU 서버가 있을 때만 씁니다.