You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
339 lines
13 KiB
339 lines
13 KiB
using System;
|
|
using System.Collections;
|
|
using System.Collections.Generic;
|
|
using Epic.OnlineServices;
|
|
using Epic.OnlineServices.Lobby;
|
|
using Epic.OnlineServices.RTC;
|
|
using Epic.OnlineServices.RTCAudio;
|
|
using UnityEngine;
|
|
|
|
/// <summary>
|
|
/// Generic re-usable cross-platform class to provide common voice chat functionality based on the EOS Voice Chat service.
|
|
/// This class does not know anything about EOS platform initialization or authentication; it just takes the required
|
|
/// EOS interfaces and exposes a number of game-related voice functions.
|
|
/// </summary>
|
|
public class EOSVoiceChat
|
|
{
|
|
private const uint DefaultMaxChatPlayers = 16; // "Lobbies that generate conference rooms must have <= 16 max players"
|
|
|
|
private readonly LobbyInterface lobbyInterface;
|
|
private readonly RTCInterface rtcInterface;
|
|
private readonly RTCAudioInterface audioInterface;
|
|
private readonly Func<ProductUserId> productUserProvider;
|
|
|
|
private string connectedLobbyId;
|
|
public bool IsConnected => lobbyInterface != null && rtcInterface != null && audioInterface != null && !string.IsNullOrEmpty(connectedLobbyId);
|
|
|
|
private ulong? onConnectionChangedCallbackId, onParticipantStatusChangedCallbackId, onParticipantUpdatedCallbackId;
|
|
|
|
/// <summary>
|
|
/// Provide the required interfaces for voice chat. Product User ID is provided through a callback, so that the
|
|
/// same instance of this class can remain in use even if the logged in user changes.
|
|
/// </summary>
|
|
public EOSVoiceChat(
|
|
LobbyInterface lobbyInterface, RTCInterface rtcInterface, RTCAudioInterface audioInterface,
|
|
Func<ProductUserId> productUserProvider)
|
|
{
|
|
this.lobbyInterface = lobbyInterface;
|
|
this.rtcInterface = rtcInterface;
|
|
this.audioInterface = audioInterface;
|
|
this.productUserProvider = productUserProvider;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Join an existing chat lobby or create a new one.
|
|
/// The completion callback is invoked on both success and failure, and can be used to set up the chat lobby's initial parameters.
|
|
/// </summary>
|
|
public void ConnectToChat(string chatLobbyName, Action<bool> onCompleted = null, uint maxChatPlayers = DefaultMaxChatPlayers)
|
|
{
|
|
DisconnectChat(); // Leave any currently connected chat lobby
|
|
|
|
var connectArgs = new ChatConnectArgs(chatLobbyName, onCompleted, maxChatPlayers);
|
|
|
|
lobbyInterface.CreateLobbySearch(new CreateLobbySearchOptions { MaxResults = 1 }, out var searchHandle);
|
|
searchHandle.SetLobbyId(new LobbySearchSetLobbyIdOptions { LobbyId = chatLobbyName });
|
|
|
|
var localUserId = productUserProvider.Invoke();
|
|
searchHandle.Find(new LobbySearchFindOptions { LocalUserId = localUserId }, null, findData =>
|
|
{
|
|
switch (findData.ResultCode)
|
|
{
|
|
case Result.Success:
|
|
searchHandle.CopySearchResultByIndex(new LobbySearchCopySearchResultByIndexOptions { LobbyIndex = 0 }, out var lobbyDetails);
|
|
|
|
Debug.Log("Found existing chat lobby, joining...");
|
|
lobbyInterface.JoinLobby
|
|
(
|
|
new JoinLobbyOptions
|
|
{
|
|
LocalUserId = localUserId,
|
|
LobbyDetailsHandle = lobbyDetails,
|
|
PresenceEnabled = false,
|
|
},
|
|
connectArgs,
|
|
HandleLobbyJoined
|
|
);
|
|
break;
|
|
default:
|
|
Debug.Log($"Creating new chat lobby...");
|
|
lobbyInterface.CreateLobby
|
|
(
|
|
new CreateLobbyOptions
|
|
{
|
|
LocalUserId = localUserId,
|
|
AllowInvites = false,
|
|
PermissionLevel = LobbyPermissionLevel.Publicadvertised,
|
|
PresenceEnabled = false,
|
|
MaxLobbyMembers = maxChatPlayers,
|
|
DisableHostMigration = false,
|
|
LobbyId = chatLobbyName,
|
|
BucketId = Application.productName, // TODO: do we need anything more specific than this?
|
|
EnableRTCRoom = true,
|
|
},
|
|
connectArgs,
|
|
HandleLobbyCreated
|
|
);
|
|
break;
|
|
}
|
|
});
|
|
}
|
|
|
|
private void HandleLobbyCreated(CreateLobbyCallbackInfo data)
|
|
{
|
|
var connectArgs = (ChatConnectArgs)data.ClientData;
|
|
switch (data.ResultCode)
|
|
{
|
|
case Result.Success:
|
|
connectedLobbyId = data.LobbyId;
|
|
Debug.Log($"Chat lobby creation successful, lobby ID = {connectedLobbyId}");
|
|
connectArgs.onCompleted?.Invoke(true);
|
|
SubscribeToRoomNotifications();
|
|
break;
|
|
case Result.LobbyLobbyAlreadyExists:
|
|
// This can happen if two clients try to create the same lobby at the same time, a classic race condition.
|
|
// Try to join the other client's newly created chat lobby instead.
|
|
connectedLobbyId = null;
|
|
Debug.Log("Chat lobby already exists, attempting to join it...");
|
|
ConnectToChat(connectArgs.chatLobbyName, connectArgs.onCompleted, connectArgs.maxChatPlayers);
|
|
break;
|
|
default:
|
|
connectedLobbyId = null;
|
|
Debug.LogError($"Chat lobby creation failed, result code = {data.ResultCode}");
|
|
connectArgs.onCompleted?.Invoke(false);
|
|
break;
|
|
}
|
|
}
|
|
|
|
private void HandleLobbyJoined(JoinLobbyCallbackInfo data)
|
|
{
|
|
var connectArgs = (ChatConnectArgs)data.ClientData;
|
|
switch (data.ResultCode)
|
|
{
|
|
case Result.Success:
|
|
connectedLobbyId = data.LobbyId;
|
|
Debug.Log($"Chat lobby joined successfully, lobby ID = {connectedLobbyId}");
|
|
connectArgs.onCompleted?.Invoke(true);
|
|
SubscribeToRoomNotifications();
|
|
break;
|
|
default:
|
|
connectedLobbyId = null;
|
|
Debug.LogError($"Chat lobby join failed, result code = {data.ResultCode}");
|
|
connectArgs.onCompleted?.Invoke(false);
|
|
break;
|
|
}
|
|
}
|
|
|
|
public void DisconnectChat()
|
|
{
|
|
if (!IsConnected)
|
|
return;
|
|
|
|
// Unsubscribing first means we don't get a Disconnected notification for intentionally leaving the lobby
|
|
UnsubscribeFromRoomNotifications();
|
|
|
|
lobbyInterface.LeaveLobby
|
|
(
|
|
new LeaveLobbyOptions
|
|
{
|
|
LocalUserId = productUserProvider.Invoke(),
|
|
LobbyId = connectedLobbyId,
|
|
},
|
|
null,
|
|
data => { }
|
|
);
|
|
|
|
connectedLobbyId = null;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Mute or unmute the local player's voice chat. This can be used to implement push-to-talk.
|
|
/// </summary>
|
|
public void SetLocalMuted(bool muted)
|
|
{
|
|
if (!IsConnected)
|
|
return;
|
|
|
|
// TODO: can also disable Sending of data entirely
|
|
audioInterface.SetAudioInputSettings(new SetAudioInputSettingsOptions
|
|
{
|
|
LocalUserId = productUserProvider.Invoke(),
|
|
DeviceId = null, // Default input device
|
|
Volume = muted ? 0f : 100f,
|
|
});
|
|
}
|
|
|
|
/// <summary>
|
|
/// Mute or unmute a specific remove player. This can be used to filter out specific players in the chat lobby,
|
|
/// or for manually muting toxic players.
|
|
/// </summary>
|
|
public void SetRemoteMuted(string playerId, bool muted)
|
|
{
|
|
if (!IsConnected)
|
|
return;
|
|
|
|
|
|
}
|
|
|
|
/// <summary>
|
|
/// Set all remote players to muted. This can be used during loading screens, or to initialize the chat lobby
|
|
/// when chatting with only a small subset of players.
|
|
/// </summary>
|
|
public void MuteAllRemote()
|
|
{
|
|
if (!IsConnected)
|
|
return;
|
|
|
|
}
|
|
|
|
/// <summary>
|
|
/// Set global voice chat volume. Values range between 0.0 (muted) and 1.0 (full volume).
|
|
/// If desired, volume value can be increased up to 2.0 for an overdrive mode.
|
|
/// </summary>
|
|
public void SetOutputVolume(float volume)
|
|
{
|
|
audioInterface.SetAudioOutputSettings(new SetAudioOutputSettingsOptions
|
|
{
|
|
LocalUserId = productUserProvider.Invoke(),
|
|
DeviceId = null, // Default output device
|
|
Volume = volume * 50f,
|
|
});
|
|
}
|
|
|
|
// TODO: handle input/output device changes (keep track of current devices)
|
|
// TODO: handle participant changes (add/remove users) => also map to platform-specific player IDs
|
|
// TODO: query local/remote status (is talking or not)
|
|
|
|
private void SubscribeToRoomNotifications()
|
|
{
|
|
var localUserId = productUserProvider.Invoke();
|
|
|
|
if (lobbyInterface.GetRTCRoomName(
|
|
new GetRTCRoomNameOptions { LocalUserId = localUserId, LobbyId = connectedLobbyId },
|
|
out string roomName) != Result.Success)
|
|
{
|
|
Debug.LogError($"Failed to obtain RTC room name for lobby with ID {connectedLobbyId}");
|
|
return;
|
|
}
|
|
|
|
if (!onConnectionChangedCallbackId.HasValue)
|
|
{
|
|
onConnectionChangedCallbackId = lobbyInterface.AddNotifyRTCRoomConnectionChanged
|
|
(
|
|
new AddNotifyRTCRoomConnectionChangedOptions
|
|
{
|
|
LocalUserId = localUserId,
|
|
LobbyId = connectedLobbyId,
|
|
},
|
|
null,
|
|
HandleConnectionChanged
|
|
);
|
|
}
|
|
|
|
if (!onParticipantStatusChangedCallbackId.HasValue)
|
|
{
|
|
onParticipantStatusChangedCallbackId = rtcInterface.AddNotifyParticipantStatusChanged
|
|
(
|
|
new AddNotifyParticipantStatusChangedOptions
|
|
{
|
|
LocalUserId = localUserId,
|
|
RoomName = roomName,
|
|
},
|
|
null,
|
|
HandleParticipantStatusChanged
|
|
);
|
|
}
|
|
|
|
if (!onParticipantUpdatedCallbackId.HasValue)
|
|
{
|
|
onParticipantUpdatedCallbackId = audioInterface.AddNotifyParticipantUpdated
|
|
(
|
|
new AddNotifyParticipantUpdatedOptions
|
|
{
|
|
LocalUserId = localUserId,
|
|
RoomName = roomName,
|
|
},
|
|
null,
|
|
HandleParticipantUpdated
|
|
);
|
|
}
|
|
}
|
|
|
|
private void UnsubscribeFromRoomNotifications()
|
|
{
|
|
if (onConnectionChangedCallbackId.HasValue)
|
|
{
|
|
rtcInterface.RemoveNotifyDisconnected(onConnectionChangedCallbackId.Value);
|
|
onConnectionChangedCallbackId = null;
|
|
}
|
|
|
|
if (onParticipantStatusChangedCallbackId.HasValue)
|
|
{
|
|
rtcInterface.RemoveNotifyParticipantStatusChanged(onParticipantStatusChangedCallbackId.Value);
|
|
onParticipantStatusChangedCallbackId = null;
|
|
}
|
|
|
|
if (onParticipantUpdatedCallbackId.HasValue)
|
|
{
|
|
audioInterface.RemoveNotifyParticipantUpdated(onParticipantUpdatedCallbackId.Value);
|
|
onParticipantUpdatedCallbackId = null;
|
|
}
|
|
}
|
|
|
|
private void HandleConnectionChanged(RTCRoomConnectionChangedCallbackInfo data)
|
|
{
|
|
Debug.Log($"RTC Room connection changed, connected = {data.IsConnected}, disconnect reason = {data.DisconnectReason}");
|
|
// Note: reconnecting is handled automatically by the lobby system
|
|
}
|
|
|
|
private void HandleParticipantStatusChanged(ParticipantStatusChangedCallbackInfo data)
|
|
{
|
|
Debug.Log($"Participant status changed, participant = {data.ParticipantId}, status = {data.ParticipantStatus}");
|
|
}
|
|
|
|
private void HandleParticipantUpdated(ParticipantUpdatedCallbackInfo data)
|
|
{
|
|
Debug.Log($"Participant status changed, participant = {data.ParticipantId}, speaking = {data.Speaking}, audio status = {data.AudioStatus}");
|
|
}
|
|
|
|
private class ChatConnectArgs
|
|
{
|
|
public readonly string chatLobbyName;
|
|
public readonly Action<bool> onCompleted;
|
|
public readonly uint maxChatPlayers;
|
|
|
|
public ChatConnectArgs(string chatLobbyName, Action<bool> onCompleted, uint maxChatPlayers)
|
|
{
|
|
this.chatLobbyName = chatLobbyName;
|
|
this.onCompleted = onCompleted;
|
|
this.maxChatPlayers = maxChatPlayers;
|
|
}
|
|
}
|
|
|
|
private class ChatUser
|
|
{
|
|
public readonly ProductUserId productUserId;
|
|
public string platformPlayerId;
|
|
|
|
|
|
}
|
|
}
|