StationObscurum/Assets/com.rlabrecque.steamworks.net/Runtime/CallbackDispatcher.cs
2023-11-12 21:08:23 -05:00

401 lines
12 KiB
C#

// This file is provided under The MIT License as part of Steamworks.NET.
// Copyright (c) 2013-2022 Riley Labrecque
// Please see the included LICENSE.txt for additional information.
// This file is automatically generated.
// Changes to this file will be reverted when you update Steamworks.NET
#if !(UNITY_STANDALONE_WIN || UNITY_STANDALONE_LINUX || UNITY_STANDALONE_OSX || STEAMWORKS_WIN || STEAMWORKS_LIN_OSX)
#define DISABLESTEAMWORKS
#endif
#if !DISABLESTEAMWORKS
#if UNITY_3_5 || UNITY_4_0 || UNITY_4_1 || UNITY_4_2 || UNITY_4_3 || UNITY_4_5 || UNITY_4_6
#error Unsupported Unity platform. Steamworks.NET requires Unity 4.7 or higher.
#elif UNITY_4_7 || UNITY_5 || UNITY_2017 || UNITY_2017_1_OR_NEWER
#if UNITY_EDITOR_WIN || (UNITY_STANDALONE_WIN && !UNITY_EDITOR)
#define WINDOWS_BUILD
#endif
#elif STEAMWORKS_WIN
#define WINDOWS_BUILD
#elif STEAMWORKS_LIN_OSX
// So that we don't enter the else block below.
#else
#error You need to define STEAMWORKS_WIN, or STEAMWORKS_LIN_OSX. Refer to the readme for more details.
#endif
using System;
using System.Collections.Generic;
using System.Runtime.InteropServices;
namespace Steamworks {
public static class CallbackDispatcher {
// We catch exceptions inside callbacks and reroute them here.
// For some reason throwing an exception causes RunCallbacks() to break otherwise.
// If you have a custom ExceptionHandler in your engine you can register it here manually until we get something more elegant hooked up.
public static void ExceptionHandler(Exception e) {
#if UNITY_STANDALONE
UnityEngine.Debug.LogException(e);
#elif STEAMWORKS_WIN || STEAMWORKS_LIN_OSX
Console.WriteLine(e.Message);
#endif
}
private static Dictionary<int, List<Callback>> m_registeredCallbacks = new Dictionary<int, List<Callback>>();
private static Dictionary<int, List<Callback>> m_registeredGameServerCallbacks = new Dictionary<int, List<Callback>>();
private static Dictionary<ulong, List<CallResult>> m_registeredCallResults = new Dictionary<ulong, List<CallResult>>();
private static object m_sync = new object();
private static IntPtr m_pCallbackMsg;
private static int m_initCount;
public static bool IsInitialized {
get { return m_initCount > 0; }
}
internal static void Initialize() {
lock (m_sync) {
if (m_initCount == 0) {
NativeMethods.SteamAPI_ManualDispatch_Init();
m_pCallbackMsg = Marshal.AllocHGlobal(Marshal.SizeOf(typeof(CallbackMsg_t)));
}
++m_initCount;
}
}
internal static void Shutdown() {
lock (m_sync) {
--m_initCount;
if (m_initCount == 0) {
UnregisterAll();
Marshal.FreeHGlobal(m_pCallbackMsg);
m_pCallbackMsg = IntPtr.Zero;
}
}
}
internal static void Register(Callback cb) {
int iCallback = CallbackIdentities.GetCallbackIdentity(cb.GetCallbackType());
var callbacksRegistry = cb.IsGameServer ? m_registeredGameServerCallbacks : m_registeredCallbacks;
lock (m_sync) {
List<Callback> callbacksList;
if (!callbacksRegistry.TryGetValue(iCallback, out callbacksList)) {
callbacksList = new List<Callback>();
callbacksRegistry.Add(iCallback, callbacksList);
}
callbacksList.Add(cb);
}
}
internal static void Register(SteamAPICall_t asyncCall, CallResult cr) {
lock (m_sync) {
List<CallResult> callResultsList;
if (!m_registeredCallResults.TryGetValue((ulong)asyncCall, out callResultsList)) {
callResultsList = new List<CallResult>();
m_registeredCallResults.Add((ulong)asyncCall, callResultsList);
}
callResultsList.Add(cr);
}
}
internal static void Unregister(Callback cb) {
int iCallback = CallbackIdentities.GetCallbackIdentity(cb.GetCallbackType());
var callbacksRegistry = cb.IsGameServer ? m_registeredGameServerCallbacks : m_registeredCallbacks;
lock (m_sync) {
List<Callback> callbacksList;
if (callbacksRegistry.TryGetValue(iCallback, out callbacksList)) {
callbacksList.Remove(cb);
if (callbacksList.Count == 0)
callbacksRegistry.Remove(iCallback);
}
}
}
internal static void Unregister(SteamAPICall_t asyncCall, CallResult cr) {
lock (m_sync) {
List<CallResult> callResultsList;
if (m_registeredCallResults.TryGetValue((ulong)asyncCall, out callResultsList)) {
callResultsList.Remove(cr);
if (callResultsList.Count == 0)
m_registeredCallResults.Remove((ulong)asyncCall);
}
}
}
private static void UnregisterAll() {
List<Callback> callbacks = new List<Callback>();
List<CallResult> callResults = new List<CallResult>();
lock (m_sync) {
foreach (var pair in m_registeredCallbacks) {
callbacks.AddRange(pair.Value);
}
m_registeredCallbacks.Clear();
foreach (var pair in m_registeredGameServerCallbacks) {
callbacks.AddRange(pair.Value);
}
m_registeredGameServerCallbacks.Clear();
foreach (var pair in m_registeredCallResults) {
callResults.AddRange(pair.Value);
}
m_registeredCallResults.Clear();
foreach (var callback in callbacks) {
callback.SetUnregistered();
}
foreach (var callResult in callResults) {
callResult.SetUnregistered();
}
}
}
internal static void RunFrame(bool isGameServer) {
if (!IsInitialized) throw new InvalidOperationException("Callback dispatcher is not initialized.");
HSteamPipe hSteamPipe = (HSteamPipe)(isGameServer ? NativeMethods.SteamGameServer_GetHSteamPipe() : NativeMethods.SteamAPI_GetHSteamPipe());
NativeMethods.SteamAPI_ManualDispatch_RunFrame(hSteamPipe);
var callbacksRegistry = isGameServer ? m_registeredGameServerCallbacks : m_registeredCallbacks;
while (NativeMethods.SteamAPI_ManualDispatch_GetNextCallback(hSteamPipe, m_pCallbackMsg)) {
CallbackMsg_t callbackMsg = (CallbackMsg_t)Marshal.PtrToStructure(m_pCallbackMsg, typeof(CallbackMsg_t));
try {
// Check for dispatching API call results
if (callbackMsg.m_iCallback == SteamAPICallCompleted_t.k_iCallback) {
SteamAPICallCompleted_t callCompletedCb = (SteamAPICallCompleted_t)Marshal.PtrToStructure(callbackMsg.m_pubParam, typeof(SteamAPICallCompleted_t));
IntPtr pTmpCallResult = Marshal.AllocHGlobal((int)callCompletedCb.m_cubParam);
bool bFailed;
if (NativeMethods.SteamAPI_ManualDispatch_GetAPICallResult(hSteamPipe, callCompletedCb.m_hAsyncCall, pTmpCallResult, (int)callCompletedCb.m_cubParam, callCompletedCb.m_iCallback, out bFailed)) {
lock (m_sync) {
List<CallResult> callResults;
if (m_registeredCallResults.TryGetValue((ulong)callCompletedCb.m_hAsyncCall, out callResults)) {
m_registeredCallResults.Remove((ulong)callCompletedCb.m_hAsyncCall);
foreach (var cr in callResults) {
cr.OnRunCallResult(pTmpCallResult, bFailed, (ulong)callCompletedCb.m_hAsyncCall);
cr.SetUnregistered();
}
}
}
}
Marshal.FreeHGlobal(pTmpCallResult);
} else {
List<Callback> callbacks;
if (callbacksRegistry.TryGetValue(callbackMsg.m_iCallback, out callbacks)) {
List<Callback> callbacksCopy;
lock (m_sync) {
callbacksCopy = new List<Callback>(callbacks);
}
foreach (var callback in callbacksCopy) {
callback.OnRunCallback(callbackMsg.m_pubParam);
}
}
}
} catch (Exception e) {
ExceptionHandler(e);
} finally {
NativeMethods.SteamAPI_ManualDispatch_FreeLastCallback(hSteamPipe);
}
}
}
}
public abstract class Callback {
public abstract bool IsGameServer { get; }
internal abstract Type GetCallbackType();
internal abstract void OnRunCallback(IntPtr pvParam);
internal abstract void SetUnregistered();
}
public sealed class Callback<T> : Callback, IDisposable {
public delegate void DispatchDelegate(T param);
private event DispatchDelegate m_Func;
private bool m_bGameServer;
private bool m_bIsRegistered;
private bool m_bDisposed = false;
/// <summary>
/// Creates a new Callback. You must be calling SteamAPI.RunCallbacks() to retrieve the callbacks.
/// <para>Returns a handle to the Callback.</para>
/// <para>This MUST be assigned to a member variable to prevent the GC from cleaning it up.</para>
/// </summary>
public static Callback<T> Create(DispatchDelegate func) {
return new Callback<T>(func, bGameServer: false);
}
/// <summary>
/// Creates a new GameServer Callback. You must be calling GameServer.RunCallbacks() to retrieve the callbacks.
/// <para>Returns a handle to the Callback.</para>
/// <para>This MUST be assigned to a member variable to prevent the GC from cleaning it up.</para>
/// </summary>
public static Callback<T> CreateGameServer(DispatchDelegate func) {
return new Callback<T>(func, bGameServer: true);
}
public Callback(DispatchDelegate func, bool bGameServer = false) {
m_bGameServer = bGameServer;
Register(func);
}
~Callback() {
Dispose();
}
public void Dispose() {
if (m_bDisposed) {
return;
}
GC.SuppressFinalize(this);
if (m_bIsRegistered)
Unregister();
m_bDisposed = true;
}
// Manual registration of the callback
public void Register(DispatchDelegate func) {
if (func == null) {
throw new Exception("Callback function must not be null.");
}
if (m_bIsRegistered) {
Unregister();
}
m_Func = func;
CallbackDispatcher.Register(this);
m_bIsRegistered = true;
}
public void Unregister() {
CallbackDispatcher.Unregister(this);
m_bIsRegistered = false;
}
public override bool IsGameServer {
get { return m_bGameServer; }
}
internal override Type GetCallbackType() {
return typeof(T);
}
internal override void OnRunCallback(IntPtr pvParam) {
try {
m_Func((T)Marshal.PtrToStructure(pvParam, typeof(T)));
}
catch (Exception e) {
CallbackDispatcher.ExceptionHandler(e);
}
}
internal override void SetUnregistered() {
m_bIsRegistered = false;
}
}
public abstract class CallResult {
internal abstract Type GetCallbackType();
internal abstract void OnRunCallResult(IntPtr pvParam, bool bFailed, ulong hSteamAPICall);
internal abstract void SetUnregistered();
}
public sealed class CallResult<T> : CallResult, IDisposable {
public delegate void APIDispatchDelegate(T param, bool bIOFailure);
private event APIDispatchDelegate m_Func;
private SteamAPICall_t m_hAPICall = SteamAPICall_t.Invalid;
public SteamAPICall_t Handle { get { return m_hAPICall; } }
private bool m_bDisposed = false;
/// <summary>
/// Creates a new async CallResult. You must be calling SteamAPI.RunCallbacks() to retrieve the callback.
/// <para>Returns a handle to the CallResult.</para>
/// <para>This MUST be assigned to a member variable to prevent the GC from cleaning it up.</para>
/// </summary>
public static CallResult<T> Create(APIDispatchDelegate func = null) {
return new CallResult<T>(func);
}
public CallResult(APIDispatchDelegate func = null) {
m_Func = func;
}
~CallResult() {
Dispose();
}
public void Dispose() {
if (m_bDisposed) {
return;
}
GC.SuppressFinalize(this);
Cancel();
m_bDisposed = true;
}
public void Set(SteamAPICall_t hAPICall, APIDispatchDelegate func = null) {
// Unlike the official SDK we let the user assign a single function during creation,
// and allow them to skip having to do so every time that they call .Set()
if (func != null) {
m_Func = func;
}
if (m_Func == null) {
throw new Exception("CallResult function was null, you must either set it in the CallResult Constructor or via Set()");
}
if (m_hAPICall != SteamAPICall_t.Invalid) {
CallbackDispatcher.Unregister(m_hAPICall, this);
}
m_hAPICall = hAPICall;
if (hAPICall != SteamAPICall_t.Invalid) {
CallbackDispatcher.Register(hAPICall, this);
}
}
public bool IsActive() {
return (m_hAPICall != SteamAPICall_t.Invalid);
}
public void Cancel() {
if (IsActive())
CallbackDispatcher.Unregister(m_hAPICall, this);
}
internal override Type GetCallbackType() {
return typeof(T);
}
internal override void OnRunCallResult(IntPtr pvParam, bool bFailed, ulong hSteamAPICall_) {
SteamAPICall_t hSteamAPICall = (SteamAPICall_t)hSteamAPICall_;
if (hSteamAPICall == m_hAPICall) {
try {
m_Func((T)Marshal.PtrToStructure(pvParam, typeof(T)), bFailed);
}
catch (Exception e) {
CallbackDispatcher.ExceptionHandler(e);
}
}
}
internal override void SetUnregistered() {
m_hAPICall = SteamAPICall_t.Invalid;
}
}
}
#endif // !DISABLESTEAMWORKS