mirror of
https://github.com/Facepunch/Facepunch.Steamworks.git
synced 2024-12-28 15:45:29 +03:00
254 lines
8.7 KiB
C#
254 lines
8.7 KiB
C#
using System;
|
|
using System.Collections.Generic;
|
|
using System.Runtime.InteropServices;
|
|
using System.Text;
|
|
using System.Threading.Tasks;
|
|
using Steamworks.Data;
|
|
|
|
namespace Steamworks
|
|
{
|
|
public static class SteamUserStats
|
|
{
|
|
static ISteamUserStats _internal;
|
|
internal static ISteamUserStats Internal
|
|
{
|
|
get
|
|
{
|
|
SteamClient.ValidCheck();
|
|
|
|
if ( _internal == null )
|
|
{
|
|
_internal = new ISteamUserStats();
|
|
_internal.Init();
|
|
|
|
RequestCurrentStats();
|
|
}
|
|
|
|
return _internal;
|
|
}
|
|
}
|
|
internal static void Shutdown()
|
|
{
|
|
_internal = null;
|
|
}
|
|
|
|
public static bool StatsRecieved { get; internal set; }
|
|
|
|
internal static void InstallEvents()
|
|
{
|
|
UserStatsReceived_t.Install( x =>
|
|
{
|
|
if ( x.SteamIDUser == SteamClient.SteamId )
|
|
StatsRecieved = true;
|
|
|
|
OnUserStatsReceived?.Invoke( x.SteamIDUser, x.Result );
|
|
} );
|
|
|
|
UserStatsStored_t.Install( x => OnUserStatsStored?.Invoke( x.Result ) );
|
|
UserAchievementStored_t.Install( x => OnAchievementProgress?.Invoke( new Achievement( x.AchievementNameUTF8() ), (int) x.CurProgress, (int)x.MaxProgress ) );
|
|
UserStatsUnloaded_t.Install( x => OnUserStatsUnloaded?.Invoke( x.SteamIDUser ) );
|
|
UserAchievementIconFetched_t.Install( x => OnAchievementIconFetched?.Invoke( x.AchievementNameUTF8(), x.IconHandle ) );
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
/// called when the achivement icon is loaded
|
|
/// </summary>
|
|
internal static event Action<string, int> OnAchievementIconFetched;
|
|
|
|
/// <summary>
|
|
/// called when the latests stats and achievements have been received
|
|
/// from the server
|
|
/// </summary>
|
|
public static event Action<SteamId, Result> OnUserStatsReceived;
|
|
|
|
/// <summary>
|
|
/// result of a request to store the user stats for a game
|
|
/// </summary>
|
|
public static event Action<Result> OnUserStatsStored;
|
|
|
|
/// <summary>
|
|
/// result of a request to store the achievements for a game, or an
|
|
/// "indicate progress" call. If both m_nCurProgress and m_nMaxProgress
|
|
/// are zero, that means the achievement has been fully unlocked
|
|
/// </summary>
|
|
public static event Action<Achievement, int, int> OnAchievementProgress;
|
|
|
|
|
|
/// <summary>
|
|
/// Callback indicating that a user's stats have been unloaded
|
|
/// </summary>
|
|
public static event Action<SteamId> OnUserStatsUnloaded;
|
|
|
|
/// <summary>
|
|
/// Get the available achievements
|
|
/// </summary>
|
|
public static IEnumerable<Achievement> Achievements
|
|
{
|
|
get
|
|
{
|
|
for( int i=0; i< Internal.GetNumAchievements(); i++ )
|
|
{
|
|
yield return new Achievement( Internal.GetAchievementName( (uint) i ) );
|
|
}
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Show the user a pop-up notification with the current progress toward an achievement.
|
|
/// Will return false if RequestCurrentStats has not completed and successfully returned
|
|
/// its callback, if the achievement doesn't exist/has unpublished changes in the app's
|
|
/// Steamworks Admin page, or if the achievement is unlocked.
|
|
/// </summary>
|
|
public static bool IndicateAchievementProgress( string achName, int curProg, int maxProg )
|
|
{
|
|
if ( string.IsNullOrEmpty( achName ) )
|
|
throw new ArgumentNullException( "Achievement string is null or empty" );
|
|
|
|
if ( curProg >= maxProg )
|
|
throw new ArgumentException( $" Current progress [{curProg}] arguement toward achievement greater than or equal to max [{maxProg}]" );
|
|
|
|
return Internal.IndicateAchievementProgress( achName, (uint)curProg, (uint)maxProg );
|
|
}
|
|
|
|
/// <summary>
|
|
/// Tries to get the number of players currently playing this game.
|
|
/// Or -1 if failed.
|
|
/// </summary>
|
|
public static async Task<int> PlayerCountAsync()
|
|
{
|
|
var result = await Internal.GetNumberOfCurrentPlayers();
|
|
if ( !result.HasValue || result.Value.Success == 0 )
|
|
return -1;
|
|
|
|
return result.Value.CPlayers;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Send the changed stats and achievements data to the server for permanent storage.
|
|
/// If this fails then nothing is sent to the server. It's advisable to keep trying until the call is successful.
|
|
/// This call can be rate limited. Call frequency should be on the order of minutes, rather than seconds.You should only be calling this during major state changes such as the end of a round, the map changing, or the user leaving a server. This call is required to display the achievement unlock notification dialog though, so if you have called SetAchievement then it's advisable to call this soon after that.
|
|
/// If you have stats or achievements that you have saved locally but haven't uploaded with this function when your application process ends then this function will automatically be called.
|
|
/// You can find additional debug information written to the %steam_install%\logs\stats_log.txt file.
|
|
/// This function returns true upon success if :
|
|
/// RequestCurrentStats has completed and successfully returned its callback AND
|
|
/// the current game has stats associated with it in the Steamworks Partner backend, and those stats are published.
|
|
/// </summary>
|
|
public static bool StoreStats()
|
|
{
|
|
return Internal.StoreStats();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Asynchronously request the user's current stats and achievements from the server.
|
|
/// You must always call this first to get the initial status of stats and achievements.
|
|
/// Only after the resulting callback comes back can you start calling the rest of the stats
|
|
/// and achievement functions for the current user.
|
|
/// </summary>
|
|
public static bool RequestCurrentStats()
|
|
{
|
|
return Internal.RequestCurrentStats();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets a leaderboard by name, it will create it if it's not yet created.
|
|
/// Leaderboards created with this function will not automatically show up in the Steam Community.
|
|
/// You must manually set the Community Name field in the App Admin panel of the Steamworks website.
|
|
/// As such it's generally recommended to prefer creating the leaderboards in the App Admin panel on
|
|
/// the Steamworks website and using FindLeaderboard unless you're expected to have a large amount of
|
|
/// dynamically created leaderboards.
|
|
/// </summary>
|
|
public static async Task<Leaderboard?> FindOrCreateLeaderboardAsync( string name, LeaderboardSort sort, LeaderboardDisplay display )
|
|
{
|
|
var result = await Internal.FindOrCreateLeaderboard( name, sort, display );
|
|
if ( !result.HasValue || result.Value.LeaderboardFound == 0 )
|
|
return null;
|
|
|
|
return new Leaderboard { Id = result.Value.SteamLeaderboard };
|
|
}
|
|
|
|
|
|
public static async Task<Leaderboard?> FindLeaderboardAsync( string name )
|
|
{
|
|
var result = await Internal.FindLeaderboard( name );
|
|
if ( !result.HasValue || result.Value.LeaderboardFound == 0 )
|
|
return null;
|
|
|
|
return new Leaderboard { Id = result.Value.SteamLeaderboard };
|
|
}
|
|
|
|
|
|
|
|
/// <summary>
|
|
/// Adds this amount to the named stat. Internally this calls Get() and adds
|
|
/// to that value. Steam doesn't provide a mechanism for atomically increasing
|
|
/// stats like this, this functionality is added here as a convenience.
|
|
/// </summary>
|
|
public static bool AddStat( string name, int amount = 1 )
|
|
{
|
|
var val = GetStatInt( name );
|
|
val += amount;
|
|
return SetStat( name, val );
|
|
}
|
|
|
|
/// <summary>
|
|
/// Adds this amount to the named stat. Internally this calls Get() and adds
|
|
/// to that value. Steam doesn't provide a mechanism for atomically increasing
|
|
/// stats like this, this functionality is added here as a convenience.
|
|
/// </summary>
|
|
public static bool AddStat( string name, float amount = 1.0f )
|
|
{
|
|
var val = GetStatFloat( name );
|
|
val += amount;
|
|
return SetStat( name, val );
|
|
}
|
|
|
|
/// <summary>
|
|
/// Set a stat value. This will automatically call StoreStats() after a successful call
|
|
/// unless you pass false as the last argument.
|
|
/// </summary>
|
|
public static bool SetStat( string name, int value )
|
|
{
|
|
return Internal.SetStat1( name, value );
|
|
}
|
|
|
|
/// <summary>
|
|
/// Set a stat value. This will automatically call StoreStats() after a successful call
|
|
/// unless you pass false as the last argument.
|
|
/// </summary>
|
|
public static bool SetStat( string name, float value )
|
|
{
|
|
return Internal.SetStat2( name, value );
|
|
}
|
|
|
|
/// <summary>
|
|
/// Get a Int stat value
|
|
/// </summary>
|
|
public static int GetStatInt( string name )
|
|
{
|
|
int data = 0;
|
|
Internal.GetStat1( name, ref data );
|
|
return data;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Get a float stat value
|
|
/// </summary>
|
|
public static float GetStatFloat( string name )
|
|
{
|
|
float data = 0;
|
|
Internal.GetStat2( name, ref data );
|
|
return data;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Practically wipes the slate clean for this user. If includeAchievements is true, will wipe
|
|
/// any achievements too.
|
|
/// </summary>
|
|
/// <returns></returns>
|
|
public static bool ResetAll( bool includeAchievements )
|
|
{
|
|
return Internal.ResetAllStats( includeAchievements );
|
|
}
|
|
}
|
|
} |