주의 사항:
GME 3.x 버전은 실시간 음성 채팅 역할 설정 기능을 지원하지 않습니다.
개발자가 편리하게 GME(Game Multimedia Engine) API에 액세스하고 디버깅할 수 있도록, 본문에서는 GME 클랜전 음성 채팅 모드를 구현하는 방법을 설명합니다.
사용 사례
클랜전 게임 시나리오에서 GME는 호스트 및 청취자 역할을 제공합니다. 사용자가 방에 입장하기 전에 호스트 역할이 설정되면 마이크를 켜고 말할 수 있으며, 스피커를 켜고 방에서 다른 사람이 말하는 것을 들을 수 있습니다. 사용자가 청취자 역할로 방에 입장하면 마이크를 켜도 방에서 말할 수 없습니다.
전제 조건
서비스 활성화를 참고하여 GME 애플리케이션을 생성하고 SDK의 AppID 및 Key를 가져와야 합니다. GME 실시간 음성 채팅 서비스를 활성화해야 합니다. 서비스 활성화를 참고하십시오. 통합 단계
다음은 명령 음성 모드에 연결하는 과정입니다.
1단계: GME 서비스 사용
2단계: 역할 설정
EnterRoom API를 호출하기 전에 SetAudioRole API를 호출하여 실시간 음성 채팅의 역할을 설정해야 합니다.
함수 프로토타입
public abstract int SetAudioRole(ITMG_AUDIO_MEMBER_ROLE role);
|
| | ITMG_AUDIO_MEMBER_ROLE_ANCHOR 방에서 마이크와 스피커를 활성화할 수 있는 호스트 ITMG_AUDIO_MEMBER_ROLE_AUDIENCE 방에서 스피커만 활성화할 수 있는 청취자 |
예시 코드
ITMGContext.GetInstance().SetAudioRole(ITMG_AUDIO_MEMBER_ROLE.ITMG_AUDIO_MEMBER_ROLE_AUDIENCE);
3단계: 실시간 음성 채팅 서비스 사용
EnterRoom API를 호출하여 음성 채팅방에 입장합니다.
4단계: 마이크 활성화
역할이 호스트인 경우 EnableMic 및 EnableSpeaker API를 호출하여 마이크와 스피커를 각각 활성화할 수 있습니다.
역할이 청취자인 경우 EnableSpeaker API를 사용하여 스피커를 활성화할 수 있지만, EnableMic API 호출 시 AV_ERR_INVALID_ARGUMENT 오류 코드(1004)가 반환되어 사용자가 청취자 모드에 있으며 마이크를 활성화할 수 없음을 상기시킵니다.
5단계: 역할 변경
방에서 SetAudioRole을 호출하여 역할을 변경할 수 있습니다.
역할이 설정되지 않은 경우 새 역할이 적용됩니다.
역할이 설정된 경우 새 역할이 적용됩니다.
역할이 설정되지 않았거나 역할이 호스트이고 마이크가 활성화된 상태에서 말하는 경우 역할이 청취자로 변경되면 마이크가 활성화되어 있어도 방에서 말할 수 없습니다. 이 경우 비즈니스 레이어에서 EnableMic API를 호출하여 마이크 UI 상태를 변경하는 것이 좋습니다.
6단계: 방 퇴장
ExitRoom API를 호출하여 실시간 음성 채팅방을 나가면 역할 상태가 무효가 되며 역할을 다시 설정해야 합니다.