클라이언트 커뮤니케이션
HandyCafe 커뮤니케이션은 서버와 클라이언트 PC 사이의 로컬 텍스트 채팅, 서버를 거치는 클라이언트 간 채팅, 운영자가 녹음한 음성 메시지를 제공합니다. 모든 통신은 로컬 네트워크의 HandyCafe 서버를 통해 이루어집니다. 클라이언트끼리 직접 연결하는 일은 없습니다.
커뮤니케이션 기능에는 HandyCafe Client 5.1.3 이상이 필요합니다. 연결된 이전 버전 클라이언트도 기존의 단방향 공지는 계속 지원하지만 새 채팅 및 음성 컨트롤에서는 지원되지 않는 것으로 표시됩니다.
커뮤니케이션 설정
클라이언트 그룹에서 설정 > 커뮤니케이션을 엽니다. 기본값은 운영자 채팅은 사용할 수 있게 두되 명시적으로 허용하기 전까지 손님이 새 대화를 시작하지 못하게 합니다.
| 설정 | 기본값 | 효과 |
|---|---|---|
| 채팅 사용 | 켜짐 | 새 채팅 화면을 표시하고 채팅 요청을 받습니다. |
| 운영자가 대화 시작 가능 | 켜짐 | 운영자가 연결된 클라이언트와 새 대화를 열 수 있습니다. |
| 클라이언트가 운영자에게 연락 가능 | 꺼짐 | 세션이 진행 중이거나 일시정지된 동안 손님이 운영자와 새 대화를 시작할 수 있습니다. |
| 클라이언트끼리 연락 가능 | 꺼짐 | 대화할 수 있는 PC를 표시하고 손님 메시지를 서버를 거쳐 전달합니다. |
| 음성 메시지 사용 | 꺼짐 | 운영자가 짧은 음성 메시지를 녹음해 보낼 수 있습니다. |
| 최대 녹음 길이 | 30초 | 녹음 한 건의 길이를 1~120초로 제한합니다. |
| 음성 메시지 자동 재생 | 켜짐 | 확인된 다운로드를 즉시 재생합니다. 끄면 클라이언트에 음성 메시지 재생 알림이 표시됩니다. |
| 채팅 기록 보관 기간 | 30일 | 로컬 기록을 1~365일 동안 보관합니다. |
저장하면 변경된 정책이 연결된 지원 클라이언트로 전송됩니다. 다시 연결되는 클라이언트는 일반 연결 과정에서 저장된 정책을 받습니다.
클라이언트와 채팅하기
컴퓨터의 명령 메뉴를 열고 채팅을 선택합니다. 채팅 창에 대화 기록과 전달 상태가 표시됩니다. 최대 1,000자를 입력하고 보내기를 선택합니다. 운영자가 새 메시지를 보내면 대상 클라이언트에서 같은 대화가 즉시 열립니다.
서버는 손님 세션이 없는 PC를 포함해 연결된 모든 지원 클라이언트에 텍스트를 보낼 수 있습니다. 손님이 시작하는 채팅은 세션이 진행 중이거나 일시정지된 상태여야 합니다. 세션이 바뀌면 이전 손님의 대화는 닫히고 새 손님에게 표시되지 않습니다.
시작 관련 설정은 새 대화가 만들어질 때만 적용됩니다. 허가된 참여자가 대화를 시작한 뒤에는 나중에 시작 권한이 꺼지더라도 양쪽 모두 답장할 수 있습니다. 채팅을 끄면 새 메시지와 지연된 요청이 모두 백엔드에서 차단됩니다.
클라이언트 간 채팅
클라이언트끼리 연락 가능을 켜면 클라이언트 채팅 패널에 세션이 진행 중이거나 일시정지되어 있고 커뮤니케이션을 지원하는 연결된 PC만 나열됩니다. 대화 상대 선택기를 열어 상대를 고릅니다. 현재 상대는 선택기에 표시되고 목록에는 체크 표시가 붙습니다. 클라이언트 간 대화에는 회원 이름이나 운영자라는 단어가 아니라 PC 표시 이름이 사용됩니다.
모든 메시지는 먼저 HandyCafe 서버로 갑니다. 서버는 발신자의 실시간 연결과 세션을 확인하고 메시지를 로컬에 저장한 뒤 대상 PC로 전달합니다. 대상의 세션이 바뀌거나 연결이 끊기면 다른 손님에게 메시지를 보여 주는 대신 전달을 거부합니다.
음성 메시지 보내기
음성 메시지를 사용하도록 설정합니다. 세션이 진행 중이거나 일시정지된 지원 PC의 명령 메뉴를 열고 음성 메시지 보내기를 선택합니다.
- 가운데의 마이크를 선택하고 서버의 기본 마이크에 대고 말합니다.
- 설정된 제한 시간 전에 빨간색 정지 컨트롤을 선택하거나 제한 시간이 되어 녹음이 멈추게 둡니다.
- 가운데의 재생 컨트롤을 선택해 녹음을 미리 듣습니다.
- 보내기를 선택합니다.
마이크가 켜져 있는 동안 녹음 창에는 실시간 음량 애니메이션과 경과 시간이 표시됩니다. 녹음은 또렷한 음성을 위해 48 kHz 모노 PCM을 사용합니다. 여러 PC에 보내려면 컴퓨터 필터 도구 모음의 음성 메시지 동작을 사용합니다. 전달에 성공하면 HandyCafe는 별도로 알리지 않습니다. 하나 이상의 대상이 메시지를 거부하거나 받을 수 없을 때만 실패 건수를 표시합니다.
음성 오디오는 기존 로컬 파일 포트로 전송되며 명령 채널에 포함되거나 SQLite에 저장되지 않습니다. 클라이언트는 재생 전에 파일 크기와 SHA-256 체크섬을 확인합니다. 각 전송 요청은 유효 시간이 짧고 대상 손님의 세션에 묶여 있습니다. 임시 오디오 파일은 재생, 취소, 만료 후 또는 시작 시 정리 작업에서 삭제됩니다.
전달 상태
텍스트와 음성 항목에는 대기 중, 전송 요청됨, 전달됨, 다운로드됨, 재생됨, 거부됨, 만료됨, 실패가 표시될 수 있습니다. 명령 확인 응답은 음성 전송 요청이 클라이언트에 도달했다는 뜻일 뿐입니다. 다운로드됨과 재생됨은 클라이언트가 보내는 별도의 수신 확인입니다.
접근 권한 및 문제 해결
채팅 기록을 읽거나 텍스트를 보내거나 음성을 녹음하거나 보내려면 캐셔 역할에 메시지 권한이 필요합니다. 음성 녹음에는 서버 운영체제의 마이크 접근 권한도 필요합니다.
컨트롤을 사용할 수 없으면 다음을 확인하세요:
- 설정 > 커뮤니케이션에서 채팅 또는 음성이 켜져 있는지
- 대상이 클라이언트 5.1.3 이상을 실행하는지
- PC가 연결되어 있는지
- 음성과 손님이 시작하는 채팅의 경우 세션이 진행 중이거나 일시정지되어 있는지
- 캐셔 역할에 메시지 권한이 있는지
- 서버의 마이크와 오디오 출력을 사용할 수 있는지
- 설정된 명령 포트와 파일 포트에 로컬 네트워크에서 접근할 수 있는지
컴퓨터 명령 메뉴에는 채팅, 메시지 보내기, 음성 메시지 보내기의 세 가지 동작이 따로 있습니다. 기존 메시지 보내기 공지는 대화 기록과 별도로 유지됩니다.