📞 diskuz Call – Discourse에서 음성 및 화상 통화 (P2P, 외부 앱 불필요)

[derak (Cristian Deraco)]

	요약	Discourse 내에서 P2P(피어 투 피어) 음성 및 영상 통화를 지원합니다 (WebRTC). 떠다니는 버튼 또는 1:1 채팅 작성창에서 1:1 통화를 시작할 수 있습니다. 내장 위젯 및 통화 UI를 제공합니다. 외부 앱 불필요. Discourse 서버는 **시그널링(미디어 전송 X)**만 담당합니다. 가능한 경우 오디오/비디오는 두 브라우저 간에 직접(P2P) 전송됩니다. 관리 설정에서 선택적 TURN 서버를 추가할 수 있으며, 직접 P2P가 실패할 경우(예: 엄격한 NAT/방화벽) 미디어가 TURN을 통해 중계되어 통화가 계속 가능합니다.
	저장소 링크	GitHub - idiskuz/diskuz-call: Voice calls (WebRTC) for Discourse. P2P calls between users, built-in UI. Created for diskuz.com. · GitHub
	설치 가이드	Discourse에 플러그인 설치하는 방법
	커뮤니티 diskuz Call	이 새로운 플러그인에 대한 지원 커뮤니티는 diskuz.com에서 확인하세요.

기능

• P2P 음성 및 영상 (WebRTC) — Discourse는 시그널링(offer/answer, ICE)만 처리하며, 오디오/비디오를 수신하거나 저장하지 않습니다. STUN(기본값: Google)은 두 브라우저가 서로를 찾을 수 있도록 도와주며, 이후 미디어는 직접 전송됩니다(진정한 P2P). TURN(선택적, 관리 → ICE 서버에서 설정 가능)은 중계 서버 역할을 합니다. 직접 P2P가 실패할 경우(대칭 NAT, 기업 방화벽 등) 미디어는 A → TURN 서버 → B 경로로 전송되어 통화가 계속 가능합니다. 사용자가 통화 실패나 단방향 오디오를 보고하는 경우 TURN을 추가하세요.
• 떠다니는 버튼 (오른쪽 아래) — 사용자명을 입력하고 통화를 시작할 수 있는 위젯을 엽니다. 토픽 작성창이나 채팅이 열려 있을 때 숨겨집니다. 관리자가 사이트 전체에서 비활성화할 수 있습니다.
• 1:1 채팅 내 통화 버튼 — 다른 사용자와 통화를 시작하기 위한 채팅 작성창 아이콘입니다. 관리자가 사이트 전체에서 비활성화할 수 있습니다. 활성화된 경우 허용된 그룹에게만 표시됩니다.
• 그룹 기반 접근 권한 — 설정된 그룹의 사용자만 diskuz Call을 보고 사용할 수 있습니다. 선택적 “수신자가 발신자를 팔로우해야 함” 기능( Discourse Follow 필요)를 지원합니다.
• 별도의 “영상 허용” 그룹 — 통화 중 카메라를 켤 수 있는 사용자를 제어합니다.
• 설정 가능한 벨소리 — 통화 수신 시 소리: 없음, 기본, 딩, 벨, 채팅, 사용자 지정(최대 10개의 MP3 URL; 사용자가 위젯에서 하나 선택), 또는 내장 대체 프리셋. 별도로, Discourse 알림(벨 아이콘)은 수신 시 "통화 중"을, 놓친 통화의 경우 시간과 함께 "놓친 통화"를 표시합니다.
• 위젯 — 두 개의 페이지: “친구에게 통화”(홈) 및 알림(수신, 발신, 최근, 놓친 통화; 탭당 최대 10개; 사용자명 클릭 시 다시 통화 가능). 데스크톱: 상단 바를 드래그하여 이동 가능. 모바일: 전체 화면.
• 통화 중 — 통화 시간, 음소거, 스피커, 영상 켜기/끄기, 흐림 효과(데스크톱/Android), 모바일 이어 모드(어두운 오버레이; 3회 탭하여 잠금 해제). 브라우저 내 사용자 상태(온라인, 바쁨, 오프라인); 바쁨/오프라인 상태에서는 수신 통화를 자동으로 거부할 수 있습니다. 사용자가 다른 탭으로 전환하면 60초 타이머가 시작되며, 돌아오지 않으면 통화가 종료됩니다.
• 로컬라이제이션 — 영어 및 이탈리아어(클라이언트 및 서버).

상태: 베타. 통화 실패 또는 단방향 오디오의 경우, 관리 → 플러그인 → ICE 서버에서 TURN을 구성하세요.

설정

1. 설치 — 플러그인을 추가합니다(예: app.yml 훅 또는 플러그인 디렉터리에 수동으로):
   • git clone https://github.com/idiskuz/diskuz-call.git
   • 앱을 다시 빌드합니다(예: ./launcher rebuild app).
2. 활성화 — 관리 → 플러그인: diskuz Call 활성화(목록에 있는 경우). 관리 → 설정 → 플러그인: diskuz Call 활성화 체크.
3. 접근 권한 — diskuz Call을 보고 사용할 수 있는 대상을 원하는 그룹으로 설정합니다(예: 관리자, 모더레이터, 스태프의 경우 1|2|3).
4. 선택 사항 — 필요 시 떠다니는 버튼 표시 / 채팅 버튼 표시, 수신자가 발신자를 팔로우하도록 요구(Discourse Follow와 함께), 수신 통화 소리, 사용자 지정 벨소리 또는 대체 벨소리, 영상 활성화 가능 그룹, 주요 색상, ICE 서버(NAT/방화벽을 위한 TURN JSON)를 구성합니다.

요구 사항: Discourse(시그널링을 위해 내장 실시간 메시징 사용). 선택 사항: Discourse Follow (“수신자가 발신자를 팔로우해야 함” 기능용). WebRTC, 마이크(영상의 경우 카메라)를 지원하는 브라우저.

설정 항목

이름	설명
diskuz Call 활성화	플러그인의 마스터 스위치.
diskuz Call을 보고 사용할 수 있는 대상	그룹 목록(예: ID로 관리자, 모더레이터, 스태프). 이 사용자만 플러그인을 보고 통화할 수 있습니다.
수신자가 발신자를 팔로우하도록 요구	활성화 시(Discourse Follow와 함께), 수신자는 통화를 받으려면 발신자를 팔로우해야 합니다.
떠다니는 버튼 표시	ON: 허용된 그룹에게만 떠다니는 버튼 표시. OFF: 모든 사람에게 숨김.
채팅 버튼 표시	ON: 1:1 채팅 내 통화 버튼이 허용된 그룹에게만 표시. OFF: 모든 사람에게 숨김.
영상 활성화 가능 그룹	통화 중 영상 버튼을 사용할 수 있는 그룹 목록.
주요 색상	버튼 및 강조 요소에 사용할 16진수 색상(예: #13c98c).
수신 통화 소리	없음, 기본, 딩, 벨, 채팅, 사용자 지정, 또는 대체.
사용자 지정 벨소리 1–10	MP3 URL. 소리가 사용자 지정일 때 사용; 사용자가 위젯에서 하나를 선택합니다.
대체 벨소리	소리가 대체일 때 사용할 프리셋(예: soft, classic, modern, festivo, marimba, relax1–5).
ICE 서버	STUN/TURN을 위한 선택적 JSON 배열. 비어 있음 = Google STUN만 사용.
디버그 로그	ON일 때 브라우저 콘솔(F12)에 [diskuz-call] 메시지 출력. 지원을 위해 사용; 프로덕션 환경에서는 비활성화하세요.

---

저자: diskuz.com, Cristian Deraco
크레딧: 컨셉, 기능 및 디자인은 Cristian Deraco (diskuz.com). AI 지원 개발로 구현.
버전: 0.4.0-beta

이것은 공식 Discourse 플러그인이 아닙니다.

귀하의 사이트에서 위젯이 어떻게 보이는지 보고 싶습니다. 플러그인 옵션 패널에서 diskuz Call 주요 색상을 직접 설정할 수 있습니다

모두와 이 소식을 공유하게 되어 정말 설렙니다 — diskuz Call이 마침내 출시되었습니다! 여러분의 의견을 기다립니다

[nathank (Nathan Kershaw)]

정말 기대가 됩니다! 직접 사용해보는 것이 기대됩니다. 대화가 필요할 때 포럼 멤버들 간의 연결을 쉽게 가능하게 하는 훌륭하고(그리고 오버헤드가 적은) 방법인 것 같습니다.

이 기능을 그룹 통화까지 확장하는 것을 고려해 보셨나요? 그룹 통화/회의는 영상 통화의 또 다른 핵심 사용 사례입니다. Discourse에는 이미 훌륭한 실시간 협업 도구가 몇 가지 있는데, 이 기능이 추가되면 완벽한 조합이 될 것입니다!