Vivox Unity SDK 빠른 시작 가이드
Follow this workflow to get started with Vivox voice and text chat.
읽는 시간 3분최근 업데이트: 7달 전
Unity는 게임 개발자가 자체 호스팅 솔루션에 투자할 필요 없이 채널 방식의 워크플로를 통해 사용자 간 음성 및 텍스트 통신을 제공하는 방식으로 Vivox 서비스를 제공합니다. 멀티플레이어 통신을 위한 Unity의 음성 및 텍스트 채팅 서비스는 관리형 호스트 솔루션을 통해 음성 채팅 및 다이렉트 메시지 텍스트 서비스를 제공합니다. 게임에 연결하고 프로젝트에 통신을 즉각적으로 추가하도록 프로젝트 설정을 구성합니다. 2D 및 3D 채널에서 무제한의 사용자를 연결합니다. 사용자가 음성 볼륨을 제어하고 음소거 작업을 수행하며 채널을 관리할 수 있도록 합니다. 사용자를 팀 채팅에 배치합니다. 사용자가 여러 채널에 참여할 수 있도록 합니다.
Unity 프로젝트에서 Vivox 서비스를 활성화합니다
Unity 프로젝트를 위해 Vivox 음성 및 텍스트를 설정하는 과정은 다음과 같습니다.- Unity Cloud 대시보드에서 계정과 프로젝트를 생성합니다(https://cloud.unity3d.com).
- 왼쪽 창에서 Products를 선택합니다. Communication & Safety에서 Vivox Voice and Text Chat을 선택합니다.
- 온보딩 단계를 따릅니다. 온보딩 프로세스 중에 프로젝트에 사용할 Vivox API 인증정보가 제공됩니다.
Unity 프로젝트를 Vivox에 연결합니다
Unity 프로젝트를 Vivox에 연결하려면 다음 단계를 완료합니다.- 로컬 Unity 프로젝트를 만들거나 엽니다.
- Unity 에디터에서 Window > Package Manager > Search Unity Registry를 선택합니다.
- Vivox를 검색합니다. Install을 선택합니다.
- Edit > Project Settings > Services를 선택하고 프로젝트에 올바른 프로젝트 ID를 연결합니다.
-
Service에서 Vivox를 선택하고 프로젝트에서 올바른 인증정보를 가져왔는지 확인합니다.
참고필요한 패키지는 manifest.json 파일을 편집하거나 패키지 관리자를 사용하여 직접 추가할 수 있습니다. 이때 이름으로를 사용하여 Window > Package Manager > + > Add package by name을 선택하십시오. 자세한 내용은 Unity 기술 자료의 프로젝트 매니페스트를 참고하시기 바랍니다.
com.unity.services.vivox
라이프사이클 액션
Initialize
Unity Authentication 서비스를 사용하면 Vivox 패키지에서 인증정보와 토큰을 처리합니다.using System;using UnityEngine;using Unity.Services.Authentication;using Unity.Services.Core;using Unity.Services.Vivox;async void InitializeAsync(){ await UnityServices.InitializeAsync(); await AuthenticationService.Instance.SignInAnonymouslyAsync(); await VivoxService.Instance.InitializeAsync();}
로그인
Vivox SDK를 초기화한 후에는 VivoxService를 사용하여 로그인할 수 있습니다.참고
LoginOptionsVivoxService.Instance.LoginAsync(LoginOptions options = null)using Unity.Services.Vivox;public async void LoginToVivoxAsync(){ LoginOptions options = new LoginOptions(); options.DisplayName = UserDisplayName; options.EnableTTS = true; await VivoxService.Instance.LoginAsync(options);}
에코 채널 참여
로그인 후VivoxService.Instance.JoinEchoChannelAsync(string channelName, ChatCapability chatCapability, ChannelOptions channelOptions = null)using Unity.Services.Vivox;public async void JoinEchoChannelAsync(){ string channelToJoin = "Lobby"; await VivoxService.Instance.JoinEchoChannelAsync(channelToJoin, ChatCapability.TextAndAudio);}
참고
첫 번째 참여 요청이 전송되는 순간 채널이 생성됩니다.
VivoxService.Instance.JoinGroupChannelAsync((string channelName, ChatCapability chatCapability, ChannelOptions channelOptions = null))VivoxService.Instance.JoinPositionalChannelAsync(string channelName, ChatCapability chatCapability, Channel3DProperties positionalChannelProperties, ChannelOptions channelOptions = null)참고
채널 이름은 다양한 채널 유형에서 고유해야 합니다.
음성 및 텍스트 채널 나가기
채널에서 사용자를 제거하려면VivoxService.Instance.LeaveChannelAsync(string channelName)VivoxService.Instance.LeaveAllChannels()자세한 내용은 채널 나가기를 참고하시기 바랍니다.using Unity.Services.Vivox;public async void LeaveEchoChannelAsync(){ string channelToLeave = "Lobby"; await VivoxService.Instance.LeaveChannelAsync(channelToLeave);}
사용자 로그아웃
사용자를 로그아웃하려면VivoxService.Instance.LogoutAsync()자세한 내용은 게임에서 로그아웃을 참고하시기 바랍니다.using Unity.Services.Vivox;public async void LogoutOfVivoxAsync (){ VivoxService.Instance.LogoutAsync;}
채널 내 액션
참가자 이벤트 처리
Vivox SDK는 사용자가 속한 채널에서 새 플레이어가 추가되거나 제거될 때마다 이벤트를 게시합니다. 이러한 이벤트는 다음과 같이 구독 가능합니다. 이 이벤트는VivoxParticipantDisplayNamePlayerIdAudioEnergySpeechDetected, IsMutedudioEnergyVivoxParticipant.ParticipantMuteStateChangedVivoxParticipant.ParticipantSpeechDetectedVivoxParticipant.ParticipantAudioEnergyChanged
다음 코드 스니핏은using Unity.Service.Vivox;List<RosterItem> rosterList = new List<RosterItem>();private void BindSessionEvents(bool doBind){ if(doBind) { VivoxService.Instance.ParticipantAddedToChannel += onParticipantAddedToChannel; VivoxService.Instance.ParticipantRemovedFromChannel += onParticipantRemovedFromChannel; } else { VivoxService.Instance.ParticipantAddedToChannel -= onParticipantAddedToChannel; VivoxService.Instance.ParticipantRemovedFromChannel -= onParticipantRemovedFromChannel; }}private void onParticipantAddedToChannel(VivoxParticipant participant){ ///RosterItem is a class intended to store the participant object, and reflect events relating to it into the game's UI. ///It is a sample of one way to use these events, and is detailed just below this snippet. RosterItem newRosterItem = new RosterItem(); newRosterItem.SetupRosterItem(participant); rosterList.Add(newRosterItem);}private void onParticipantRemovedFromChannel(VivoxParticipant participant){ RosterItem rosterItemToRemove = rosterList.FirstOrDefault(p => p.Participant.PlayerId == participant.PlayerId); rosterList.Remove(rosterItemToRemove);}
RosterItem자세한 내용은 참가자 이벤트를 참고하시기 바랍니다.using Unity.Service.Vivox;using UnityEngine;public class RosterItem : MonoBehaviour{ public VivoxParticipant Participant; public Text PlayerNameText; public Image ChatStateImage; public Sprite MutedImage; public Sprite SpeakingImage; public Sprite NotSpeakingImage; public SetupRosterItem(VivoxParticipant participant) { Participant = participant; PlayerNameText.text = Participant.DisplayName; UpdateChatStateImage(); Participant.ParticipantMuteStateChanged += UpdateChatStateImage; Participant.ParticipantSpeechDetected += UpdateChatStateImage; } private void UpdateChatStateImage() { /// Update the UI of the game to the state of the participant if (Participant.IsMuted) { ChatStateImage.sprite = MutedImage; ChatStateImage.gameObject.transform.localScale = Vector3.one; } else { if (Participant.SpeechDetected) { ChatStateImage.sprite = SpeakingImage; ChatStateImage.gameObject.transform.localScale = Vector3.one; } else { ChatStateImage.sprite = NotSpeakingImage; } } }}
채널에 텍스트 메시지 전송
텍스트를 활성화한 상태에서 게임이 채널에 참여하면 사용자는 그룹 텍스트 메시지를 보내고 받을 수 있습니다. 메시지를 보낼 때에는 게임에서VivoxService.Instance.SendChannelTextMessageAsync(string channelName, string message)ChannelMessageReceivedVivoxMessage자세한 내용은 그룹 텍스트 메시지 보내기 및 받기를 참고하시기 바랍니다.using Unity.Service.Vivox;private async void SendMessageAsync(string channelName, string message){ VivoxService.Instance.SendChannelTextMessageAsync(channelName, message);}private void BindSessionEvents(bool doBind){ VivoxService.Instance.ChannelMessageReceived += onChannelMessageReceived;}private void onChannelMessageReceived(VivoxMessage message){ string messageText = message.MessageText; string senderID = message.SenderPlayerId; string senderDisplayName = message.SenderDisplayName; string messageChannel = message.ChannelName;}
다른 참가자 음소거
로컬 음소거를 사용하여 특정 사용자에 대해 다른 사용자를 음소거할 수 있습니다.VivoxParticipant.MutePlayerLocally()VivoxParticipant.UnmutePlayerLocally()자세한 내용은 특정 사용자에 대해 다른 사용자 음소거를 참고하시기 바랍니다.{if (participant.InAudio && setMute){ participant.MutePlayerLocally}else if (participant.InAudio){ participant.UnmutePlayerLocally}else{ //Tell player to try again Debug.Log("Try Again");}}
스스로 음소거
사용자의 마이크를 음소거하는 메서드로는AudioInputDevicesSetTransmissionMode()Transmission.None자세한 내용은 사용자의 마이크 음소거를 참고하시기 바랍니다.await VivoxService.Instance.SetChannelTransmissionModeAsync(Transmission.None, channelName)