보이스 인터페이스 샘플 - C SDK

이 보이스 샘플은 C SDK용 클라이언트와 서버 애플리케이션을 사용하여 보안 보이스 채팅 시스템을 구현하는 방법을 보여줍니다.

이 샘플의 주요 기능은 다음과 같습니다.

• 사용자가 다른 사용자와 함께 방에 참가할 수 있도록 토큰 요청하기(서버를 통해)
• 친구나 다른 사용자와 함께 방 참가하기
• 방 나가기
• 자신의 오디오 음소거하기
• 다른 사용자 오디오 음소거하기(서버를 통해 방 오너만 가능)
• 다른 사용자를 방에서 추방하기(서버를 통해 방 오너만 가능)
• 사용자가 말하거나 음소거할 때 상태 업데이트 표시하기
• 오디오 입출력 디바이스 변경하기

이 섹션에서는 32비트 및 64비트 Windows 운영 체제의 보이스 클라이언트(Voice Client) 샘플 앱을 빌드하고 실행하는 방법을 설명합니다.

1. 원하는 위치에 EOS-SDK.zip 파일의 압축을 풉니다.
2. EOS-SDK > Samples 로 이동합니다.
3. Samples.sln 을 더블 클릭합니다. 그러면 Visual Studio의 솔루션 탐색기(Solution Explorer) 에 열립니다.
4. 스타트업 프로젝트(StartUp Project) 를 Voice 로 설정합니다.
5. SampleConstants.h 를 열고 테스트 앱의 값에 따라 제품 ID, 샌드박스 ID, 디플로이 ID, 클라이언트 크리덴셜 ID, 클라이언트 크리덴셜 비밀 키 를 업데이트합니다.
6. 솔루션 구성을 Release_DX 또는 Debug_DX 중에서 선택합니다.
7. x64(Win64) 또는 x86(Win32) 중 솔루션 플랫폼을 선택합니다.
8. 솔루션 탐색기(Solution Explorer) 에서 보이스(Voice) 프로젝트를 우클릭하고 빌드(Build) 를 선택합니다.
9. 빌드에 성공하면 \EOS-SDK\Samples\Voice\Client\Bin\Win64\Release_DX\ 아래에 Voice.exe 가 보일 것입니다.

이제 샘플 애플리케이션을 실행할 수 있습니다.

보이스 클라이언트 샘플 앱을 실행하려면 다음 작업을 수행합니다.

1. \EOS-SDK\Samples\Voice\Client\Bin\Win64\Release_DX\ 등으로 이동합니다.
2. Voice.exe 파일을 실행합니다.
3. -serverport <포트> 를 추가하여 서버 리슨 포트를 변경합니다.
4. -serverurl <url> 을 추가하여 서버 URL을 변경합니다.

macOS에 보이스 클라이언트 샘플 애플리케이션을 빌드하려면 다음 종속성을 설치해야 합니다.

• SDL2
• SDL2_ttf
• GLEW
• cmake
• gcc (Mac용 Xcode의 Command Line Tools를 통해)

1. 원하는 위치에 EOS-SDK.zip 파일의 압축을 풉니다.
2. 터미널(Terminal)에서 /EOS-SDK/Samples/Voice/Client/ 로 이동합니다.
3. SampleConstants.h 를 열고 테스트 앱의 값에 따라 제품 ID, 샌드박스 ID, 디플로이 ID, 클라이언트 크리덴셜 ID, 클라이언트 크리덴셜 비밀 키 를 업데이트합니다.
4. ./Run.sh 를 실행합니다. 혹은 Mac의 Finder 에서 Build.command 를 실행해도 됩니다.
5. 빌드가 완료되면 /EOS-SDK/Samples/Voice/Client/Build/ 경로에 파일이 새로 생깁니다.

이제 샘플 애플리케이션을 실행할 준비가 되었습니다.

샘플 앱을 열려면 다음 작업을 수행합니다.

1. /EOS-SDK/Samples/Voice/Client/ 로 이동합니다.
2. ./Run.sh 를 실행합니다. 혹은 Mac의 Finder 에서 Run.command 를 실행해도 됩니다.
3. -serverport <포트> 를 추가하여 서버 포트를 변경합니다.
4. -serverurl <url> 을 추가하여 서버 URL을 변경합니다.

개발자 인증 툴로 로그인하려면 개발자 인증(Dev Auth) 옵션을 선택하고 로그인(Log In) 을 선택합니다. 로그인하면, 보이스 클라이언트 샘플 앱에 다음 옵션이 포함됩니다.

참가(JOIN) 를 클릭하여 방 참가 프로세스를 시작합니다. 서버 애플리케이션을 통해 방 참가에 사용할 방 참가 토큰을 요청합니다.

현재 방에 다른 플레이어가 없으므로 새로운 방이 생성되고 자신은 그 방에 추가됩니다. 방 ID가 '방:(Room:)' 박스에 표시되고 '방 멤버(ROOM MEMBERS)' 테이블이 업데이트되어 자신이 방에 추가되었음을 보여줍니다.

방 나가기(LEAVE) 를 사용하면 현재 참가 중인 방에서 나갈 수 있습니다.

음소거(MUTE) 는 로컬 사용자만 이용할 수 있으며, 오디오를 음소거하는 데 사용됩니다. 오디오가 음소거되면 아래 보이는 것처럼 오디오 상태 아이콘이 빨간색으로 변경됩니다.

방 오너는 현재 방에서 다른 사용자를 음소거하거나 추방할 수 있습니다.

원격 음소거(REMOTE MUTE) 를 클릭하면 사용자를 음소거합니다.

추방(KICK) 을 클릭하면 현재 방에서 사용자를 추방합니다. 추방된 사용자는 새로운 방 참가 토큰을 요청해서 허가를 받지 않는 한 추방된 방에 다시 참가할 수 없습니다.

친구 목록의 친구 이름 옆에 있는 채팅(CHAT) 을 클릭하면 친구의 방에 추가되어 채팅할 수 있게 됩니다.

설정(SETUP) 대화 박스의 드롭다운 메뉴를 사용하여 입출력 오디오 디바이스를 변경할 수 있습니다.

사용자가 말하는 동안에는 오디오 상태 아이콘이 녹색으로 바뀌고 풀 스피커가 됩니다.

• 사용법: 'JOIN ROOM_NAME'.
• 로컬 사용자를 위한 방 참가 프로세스를 시작합니다.
• ROOM_NAME 이 제공되면 허용 시 해당 방에 참가합니다.
• ROOM_NAME 이 제공되지 않으면 새로운 방이 생성되고 그 방에 참가합니다.

• 사용법: 'LEAVE'
• 로컬 사용자가 현재 방에서 나갑니다.

• 사용법: 'KICK USER_ID'.
• 사용자를 현재 방에서 추방합니다.
• 방 오너가 실행하지 않으면 아무 일도 일어나지 않습니다.
• USER_ID 는 제품 사용자 ID입니다.

• 사용법: 'REMOTEMUTE USER_ID MUTE'.
• 사용자의 원격 음소거 상태를 설정합니다.
• 방 오너가 실행하지 않으면 아무 일도 일어나지 않습니다.
• USER_ID 는 제품 사용자 ID입니다.
• MUTE 는 1 이 음소거, 0 이 음소거 해제입니다.

이 섹션에서는 32비트 및 64비트 Windows 운영 체제의 보이스 서버(Voice Server) 샘플 앱을 빌드하고 실행하는 방법을 설명합니다.

1. 원하는 위치에 EOS-SDK.zip 파일의 압축을 풉니다.
2. \EOS-SDK\Samples\ 로 이동합니다.
3. Samples.sln 을 더블 클릭합니다. 그러면 Visual Studio의 솔루션 탐색기(Solution Explorer) 에 열립니다.
4. 스타트업 프로젝트(StartUp Project) 를 VoiceServer 로 설정합니다.
5. SampleConstants.h 를 열고 테스트 앱의 값에 따라 제품 ID, 샌드박스 ID, 디플로이 ID, 클라이언트 크리덴셜 ID, 클라이언트 크리덴셜 비밀 키 를 업데이트합니다.
6. 솔루션 구성을 선택합니다. Release 나 Debug 를 사용합니다.
7. 솔루션 플랫폼을 x64(Win64) 또는 x86(Win32) 중에서 선택합니다.
8. 솔루션 탐색기(Solution Explorer) 에서 VoiceServer 프로젝트를 우클릭하고 빌드(Build) 를 선택합니다.
9. 빌드에 성공하면 \EOS-SDK\Samples\Voice\Server\Bin\Win64\Release\ 아래에 VoiceServer.exe 가 보일 것입니다.

이제 샘플 애플리케이션을 실행할 수 있습니다.

보이스 서버 샘플 앱을 실행하려면 다음 작업을 수행합니다.

1. \EOS-SDK\Samples\Voice\Server\Bin\Win64\Release\ (예시)로 이동합니다.
2. VoiceServer.exe 파일을 실행합니다.
3. -voiceserverport <포트> 를 추가하여 서버 리슨 포트를 변경합니다.
4. -voiceserverurl <url> 을 추가하여 서버 URL을 변경합니다.

macOS에 보이스 서버 샘플 애플리케이션을 빌드하려면 다음 종속성을 설치해야 합니다.

• cmake
• gcc(Mac용 Xcode의 Command Line Tools를 통해)

1. 원하는 위치에 EOS-SDK.zip 파일의 압축을 풉니다.
2. 터미널(Terminal) 에서 /EOS-SDK/Samples/Voice/Server/ 로 이동합니다.
3. SampleConstants.h 를 열고 테스트 앱의 값에 따라 제품 ID, 샌드박스 ID, 디플로이 ID, 클라이언트 크리덴셜 ID, 클라이언트 크리덴셜 비밀 키 를 업데이트합니다.
4. ./Run.sh 를 실행합니다. 혹은 Mac의 Finder 에서 Build.command 를 실행해도 됩니다.
5. 빌드가 완료되면 /EOS-SDK/Samples/Voice/Server/Build/ 경로에 파일이 새로 생깁니다.

이제 샘플 애플리케이션을 실행할 준비가 되었습니다.

샘플 앱을 열려면 다음 작업을 수행합니다.

1. /EOS-SDK/Samples/Voice/Server/ 로 이동합니다.
2. ./Run.sh 를 실행합니다. 혹은 Mac의 Finder 에서 Run.command 를 실행해도 됩니다.
3. -voiceserverport <포트> 를 추가하여 서버 리슨 포트를 변경합니다.
4. -voiceserverurl <url> 을 추가하여 서버 URL을 변경합니다.

보이스 서버는 콘솔 기반 애플리케이션이므로 GUI 요소가 없으며, 디버그 텍스트가 콘솔과 디버그 로그 파일(디폴트: DebugOutput.log )에 출력됩니다. 오류는 빨간색 텍스트, 경고는 노란색 텍스트로 출력됩니다.

보이스 서버 애플리케이션이 시작되면 실행 상태로 남겨둘 수 있으며, 여러 클라이언트의 요청을 처리할 것입니다.

Ctrl+C 키를 사용하면 서버 애플리케이션을 중지할 수 있습니다.