Voice Interface Sample - C SDK

보이스 C 인터페이스 샘플은 보이스 구현 방법과 보이스를 사용하는 기본 기능을 보여줍니다.

Preview
6 분 소요

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

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

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

보이스 클라이언트

Windows 32/64비트용 설정

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

Win64/Win32용 보이스 클라이언트 샘플 앱 빌드하기

  1. 원하는 위치에 EOS-SDK.zip 파일의 압축을 풉니다.
  2. EOS-SDK > 샘플(Samples) 로 이동합니다.
  3. Samples.sln 을 더블클릭합니다. 솔루션 탐색기(Solution Explorer) 에서 Visual Studio가 함께 열립니다.
  4. 스타트업 프로젝트(StartUp Project)보이스(Voice) 로 설정합니다.
  5. SampleConstants.h 를 열고 테스트 앱의 값에 따라 ProductId , SandboxId , DeploymentId , ClientCredentialsId , ClientCredentialsSecret 을 업데이트합니다.
  6. 솔루션 구성을 선택합니다. Release_DX 또는 Debug_DX 를 사용합니다.
  7. 솔루션 플랫폼을 선택합니다. x64(Win64) 또는 x86(Win32)을 사용합니다.
  8. 솔루션 탐색기 에서 보이스 프로젝트를 우클릭하고 빌드(Build) 를 선택합니다.
  9. 빌드에 성공하면 \EOS-SDK\Samples\Voice\Client\Bin\Win64\Release_DX\ 아래에 Voice.exe 가 보일 것입니다.

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

보이스 클라이언트 샘플 앱 실행하기(Win64/Win32)

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

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

MacOS 또는 Linux용 설정

설정 전제 조건

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

MacOS용 또는 Linux용 보이스 클라이언트 샘플 앱 빌드하기

  1. 원하는 위치에 EOS-SDK.zip 파일의 압축을 풉니다.
  2. 터미널(Terminal)에서 /EOS-SDK/Samples/Voice/Client/ 로 이동합니다.
  3. SampleConstants.h 를 열고 테스트 앱의 값에 따라 ProductId , SandboxId , DeploymentId , ClientCredentialsIdClientCredentialsSecret 을 업데이트합니다.
  4. 다음을 실행합니다. ./Build.sh (아니면 Mac의 Finder 에서 Build.command 를 실행할 수 있습니다).
  5. 빌드가 완료되고 나면 아래 경로에 파일이 새로 생깁니다. /EOS-SDK/Samples/Voice/Client/Build/

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

MacOS용 또는 Linux용 보이스 클라이언트 샘플 앱 실행하기

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

  1. /EOS-SDK/Samples/Voice/Client/ 로 이동합니다.
  2. 다음을 실행합니다. ./Run.sh (아니면 Mac의 Finder 에서 Run.command 를 실행할 수 있습니다).
  3. -serverport <port> 를 추가하여 서버 포트를 변경합니다.
  4. -serverurl <url> 을 추가하여 서버 URL을 변경합니다.

보이스 클라이언트 샘플 앱 사용하기

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

참가

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

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

나가기

나가기(LEAVE) 를 사용하여 현재 참가 중인 룸에서 나갑니다.

음소거

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

오너 전용

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

원격 음소거

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

추방

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

채팅

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

참가(JOIN) 콘솔 명령을 사용하여 친구가 아닌 플레이어와 같은 룸에 참가할 수도 있습니다.

오디오 디바이스

설정(SETUP) 대화창의 드롭다운에서 입출력 오디오 디바이스를 변경할 수 있습니다.

말하기 상태

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

콘솔 명령

참가

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

나가기

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

추방

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

원격 음소거

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

보이스 서버

Windows 32/64비트용 설정

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

Win64/Win32용 보이스 서버 샘플 앱 빌드하기

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

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

보이스 서버 샘플 앱 실행하기(Win64/Win32)

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

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

MacOS 또는 Linux용 설정

설정 전제 조건

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

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

MacOS용 또는 Linux용 보이스 클라이언트 샘플 앱 빌드하기

  1. 원하는 위치에 EOS-SDK.zip 파일의 압축을 풉니다.
  2. 터미널(Terminal) 에서 /EOS-SDK/Samples/Voice/Server/ 로 이동합니다.
  3. SampleConstants.h 를 열고 테스트 앱의 값에 따라 ProductId , SandboxId , DeploymentId , ClientCredentialsIdClientCredentialsSecret 을 업데이트합니다.
  4. 다음을 실행합니다. ./Build.sh (아니면 Mac의 Finder 에서 Build.command 를 실행할 수 있습니다).
  5. 빌드가 완료되고 나면 아래 경로에 파일이 새로 생깁니다. /EOS-SDK/Samples/Voice/Server/Build/

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

보이스 서버 샘플 앱 실행하기(MacOS)

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

  1. /EOS-SDK/Samples/Voice/Server/ 로 이동합니다.
  2. 다음을 실행합니다. ./Run.sh (아니면 Mac의 Finder 에서 Run.command 를 실행할 수 있습니다).
  3. -voiceserverport <port> 를 추가하여 서버 리슨 포트를 변경합니다.
  4. -voiceserverurl <url> 을 추가하여 서버 URL을 변경합니다.

보이스 서버 샘플 앱 사용하기

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

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

서버 애플리케이션을 중지하려면 Ctrl+C 를 사용합니다.