Restructuring of the files
This commit is contained in:
303
Facepunch.Steamworks/Structs/UgcQuery.cs
Normal file
303
Facepunch.Steamworks/Structs/UgcQuery.cs
Normal file
@@ -0,0 +1,303 @@
|
||||
using System;
|
||||
using System.Collections.Generic;
|
||||
using System.Linq;
|
||||
using System.Threading.Tasks;
|
||||
using Facepunch.Steamworks.Data;
|
||||
|
||||
using QueryType = Facepunch.Steamworks.Ugc.Query;
|
||||
|
||||
namespace Facepunch.Steamworks.Ugc
|
||||
{
|
||||
public struct Query
|
||||
{
|
||||
UgcType matchingType;
|
||||
UGCQuery queryType;
|
||||
AppId consumerApp;
|
||||
AppId creatorApp;
|
||||
string searchText;
|
||||
|
||||
public Query( UgcType type ) : this()
|
||||
{
|
||||
matchingType = type;
|
||||
}
|
||||
|
||||
public static Query All => new Query( UgcType.All );
|
||||
public static Query Items => new Query( UgcType.Items );
|
||||
public static Query ItemsMtx => new Query( UgcType.Items_Mtx );
|
||||
public static Query ItemsReadyToUse => new Query( UgcType.Items_ReadyToUse );
|
||||
public static Query Collections => new Query( UgcType.Collections );
|
||||
public static Query Artwork => new Query( UgcType.Artwork );
|
||||
public static Query Videos => new Query( UgcType.Videos );
|
||||
public static Query Screenshots => new Query( UgcType.Screenshots );
|
||||
public static Query AllGuides => new Query( UgcType.AllGuides );
|
||||
public static Query WebGuides => new Query( UgcType.WebGuides );
|
||||
public static Query IntegratedGuides => new Query( UgcType.IntegratedGuides );
|
||||
public static Query UsableInGame => new Query( UgcType.UsableInGame );
|
||||
public static Query ControllerBindings => new Query( UgcType.ControllerBindings );
|
||||
public static Query GameManagedItems => new Query( UgcType.GameManagedItems );
|
||||
|
||||
|
||||
public Query RankedByVote() { queryType = UGCQuery.RankedByVote; return this; }
|
||||
public Query RankedByPublicationDate() { queryType = UGCQuery.RankedByPublicationDate; return this; }
|
||||
public Query RankedByAcceptanceDate() { queryType = UGCQuery.AcceptedForGameRankedByAcceptanceDate; return this; }
|
||||
public Query RankedByTrend() { queryType = UGCQuery.RankedByTrend; return this; }
|
||||
public Query FavoritedByFriends() { queryType = UGCQuery.FavoritedByFriendsRankedByPublicationDate; return this; }
|
||||
public Query CreatedByFriends() { queryType = UGCQuery.CreatedByFriendsRankedByPublicationDate; return this; }
|
||||
public Query RankedByNumTimesReported() { queryType = UGCQuery.RankedByNumTimesReported; return this; }
|
||||
public Query CreatedByFollowedUsers() { queryType = UGCQuery.CreatedByFollowedUsersRankedByPublicationDate; return this; }
|
||||
public Query NotYetRated() { queryType = UGCQuery.NotYetRated; return this; }
|
||||
public Query RankedByTotalVotesAsc() { queryType = UGCQuery.RankedByTotalVotesAsc; return this; }
|
||||
public Query RankedByVotesUp() { queryType = UGCQuery.RankedByVotesUp; return this; }
|
||||
public Query RankedByTextSearch() { queryType = UGCQuery.RankedByTextSearch; return this; }
|
||||
public Query RankedByTotalUniqueSubscriptions() { queryType = UGCQuery.RankedByTotalUniqueSubscriptions; return this; }
|
||||
public Query RankedByPlaytimeTrend() { queryType = UGCQuery.RankedByPlaytimeTrend; return this; }
|
||||
public Query RankedByTotalPlaytime() { queryType = UGCQuery.RankedByTotalPlaytime; return this; }
|
||||
public Query RankedByAveragePlaytimeTrend() { queryType = UGCQuery.RankedByAveragePlaytimeTrend; return this; }
|
||||
public Query RankedByLifetimeAveragePlaytime() { queryType = UGCQuery.RankedByLifetimeAveragePlaytime; return this; }
|
||||
public Query RankedByPlaytimeSessionsTrend() { queryType = UGCQuery.RankedByPlaytimeSessionsTrend; return this; }
|
||||
public Query RankedByLifetimePlaytimeSessions() { queryType = UGCQuery.RankedByLifetimePlaytimeSessions; return this; }
|
||||
|
||||
#region UserQuery
|
||||
|
||||
SteamId? steamid;
|
||||
|
||||
UserUGCList userType;
|
||||
UserUGCListSortOrder userSort;
|
||||
|
||||
internal Query LimitUser( SteamId steamid )
|
||||
{
|
||||
if ( steamid.Value == 0 )
|
||||
steamid = SteamClient.SteamId;
|
||||
|
||||
this.steamid = steamid;
|
||||
return this;
|
||||
}
|
||||
|
||||
public Query WhereUserPublished( SteamId user = default ) { userType = UserUGCList.Published; LimitUser( user ); return this; }
|
||||
public Query WhereUserVotedOn( SteamId user = default ) { userType = UserUGCList.VotedOn; LimitUser( user ); return this; }
|
||||
public Query WhereUserVotedUp( SteamId user = default ) { userType = UserUGCList.VotedUp; LimitUser( user ); return this; }
|
||||
public Query WhereUserVotedDown( SteamId user = default ) { userType = UserUGCList.VotedDown; LimitUser( user ); return this; }
|
||||
public Query WhereUserWillVoteLater( SteamId user = default ) { userType = UserUGCList.WillVoteLater; LimitUser( user ); return this; }
|
||||
public Query WhereUserFavorited( SteamId user = default ) { userType = UserUGCList.Favorited; LimitUser( user ); return this; }
|
||||
public Query WhereUserSubscribed( SteamId user = default ) { userType = UserUGCList.Subscribed; LimitUser( user ); return this; }
|
||||
public Query WhereUserUsedOrPlayed( SteamId user = default ) { userType = UserUGCList.UsedOrPlayed; LimitUser( user ); return this; }
|
||||
public Query WhereUserFollowed( SteamId user = default ) { userType = UserUGCList.Followed; LimitUser( user ); return this; }
|
||||
|
||||
public Query SortByCreationDate() { userSort = UserUGCListSortOrder.CreationOrderDesc; return this; }
|
||||
public Query SortByCreationDateAsc() { userSort = UserUGCListSortOrder.CreationOrderAsc; return this; }
|
||||
public Query SortByTitleAsc() { userSort = UserUGCListSortOrder.TitleAsc; return this; }
|
||||
public Query SortByUpdateDate() { userSort = UserUGCListSortOrder.LastUpdatedDesc; return this; }
|
||||
public Query SortBySubscriptionDate() { userSort = UserUGCListSortOrder.SubscriptionDateDesc; return this; }
|
||||
public Query SortByVoteScore() { userSort = UserUGCListSortOrder.VoteScoreDesc; return this; }
|
||||
public Query SortByModeration() { userSort = UserUGCListSortOrder.ForModeration; return this; }
|
||||
|
||||
public Query WhereSearchText(string searchText) { this.searchText = searchText; return this; }
|
||||
|
||||
#endregion
|
||||
|
||||
#region Files
|
||||
PublishedFileId[] Files;
|
||||
|
||||
public Query WithFileId( params PublishedFileId[] files )
|
||||
{
|
||||
Files = files;
|
||||
return this;
|
||||
}
|
||||
#endregion
|
||||
|
||||
public async Task<ResultPage?> GetPageAsync( int page )
|
||||
{
|
||||
if ( page <= 0 ) throw new System.Exception( "page should be > 0" );
|
||||
|
||||
if ( consumerApp == 0 ) consumerApp = SteamClient.AppId;
|
||||
if ( creatorApp == 0 ) creatorApp = consumerApp;
|
||||
|
||||
UGCQueryHandle_t handle;
|
||||
|
||||
if ( Files != null )
|
||||
{
|
||||
handle = SteamUGC.Internal.CreateQueryUGCDetailsRequest( Files, (uint)Files.Length );
|
||||
}
|
||||
else if ( steamid.HasValue )
|
||||
{
|
||||
handle = SteamUGC.Internal.CreateQueryUserUGCRequest( steamid.Value.AccountId, userType, matchingType, userSort, creatorApp.Value, consumerApp.Value, (uint)page );
|
||||
}
|
||||
else
|
||||
{
|
||||
handle = SteamUGC.Internal.CreateQueryAllUGCRequest( queryType, matchingType, creatorApp.Value, consumerApp.Value, (uint)page );
|
||||
}
|
||||
|
||||
ApplyReturns(handle);
|
||||
|
||||
if (maxCacheAge.HasValue)
|
||||
{
|
||||
SteamUGC.Internal.SetAllowCachedResponse(handle, (uint)maxCacheAge.Value);
|
||||
}
|
||||
|
||||
ApplyConstraints( handle );
|
||||
|
||||
var result = await SteamUGC.Internal.SendQueryUGCRequest( handle );
|
||||
if ( !result.HasValue )
|
||||
return null;
|
||||
|
||||
if ( result.Value.Result != Steamworks.Result.OK )
|
||||
return null;
|
||||
|
||||
return new ResultPage
|
||||
{
|
||||
Handle = result.Value.Handle,
|
||||
ResultCount = (int) result.Value.NumResultsReturned,
|
||||
TotalCount = (int)result.Value.TotalMatchingResults,
|
||||
CachedData = result.Value.CachedData
|
||||
};
|
||||
}
|
||||
|
||||
#region SharedConstraints
|
||||
public QueryType WithType( UgcType type ) { matchingType = type; return this; }
|
||||
int? maxCacheAge;
|
||||
public QueryType AllowCachedResponse( int maxSecondsAge ) { maxCacheAge = maxSecondsAge; return this; }
|
||||
string language;
|
||||
public QueryType InLanguage( string lang ) { language = lang; return this; }
|
||||
|
||||
int? trendDays;
|
||||
public QueryType WithTrendDays( int days ) { trendDays = days; return this; }
|
||||
|
||||
List<string> requiredTags;
|
||||
bool? matchAnyTag;
|
||||
List<string> excludedTags;
|
||||
Dictionary<string, string> requiredKv;
|
||||
|
||||
/// <summary>
|
||||
/// Found items must have at least one of the defined tags
|
||||
/// </summary>
|
||||
public QueryType MatchAnyTag() { matchAnyTag = true; return this; }
|
||||
|
||||
/// <summary>
|
||||
/// Found items must have all defined tags
|
||||
/// </summary>
|
||||
public QueryType MatchAllTags() { matchAnyTag = false; return this; }
|
||||
|
||||
public QueryType WithTag( string tag )
|
||||
{
|
||||
if ( requiredTags == null ) requiredTags = new List<string>();
|
||||
requiredTags.Add( tag );
|
||||
return this;
|
||||
}
|
||||
|
||||
public QueryType AddRequiredKeyValueTag(string key, string value)
|
||||
{
|
||||
if (requiredKv == null) requiredKv = new Dictionary<string, string>();
|
||||
requiredKv.Add(key, value);
|
||||
return this;
|
||||
}
|
||||
|
||||
public QueryType WithoutTag( string tag )
|
||||
{
|
||||
if ( excludedTags == null ) excludedTags = new List<string>();
|
||||
excludedTags.Add( tag );
|
||||
return this;
|
||||
}
|
||||
|
||||
void ApplyConstraints( UGCQueryHandle_t handle )
|
||||
{
|
||||
if ( requiredTags != null )
|
||||
{
|
||||
foreach ( var tag in requiredTags )
|
||||
SteamUGC.Internal.AddRequiredTag( handle, tag );
|
||||
}
|
||||
|
||||
if ( excludedTags != null )
|
||||
{
|
||||
foreach ( var tag in excludedTags )
|
||||
SteamUGC.Internal.AddExcludedTag( handle, tag );
|
||||
}
|
||||
|
||||
if ( requiredKv != null )
|
||||
{
|
||||
foreach ( var tag in requiredKv )
|
||||
SteamUGC.Internal.AddRequiredKeyValueTag( handle, tag.Key, tag.Value );
|
||||
}
|
||||
|
||||
if ( matchAnyTag.HasValue )
|
||||
{
|
||||
SteamUGC.Internal.SetMatchAnyTag( handle, matchAnyTag.Value );
|
||||
}
|
||||
|
||||
if ( trendDays.HasValue )
|
||||
{
|
||||
SteamUGC.Internal.SetRankedByTrendDays( handle, (uint)trendDays.Value );
|
||||
}
|
||||
|
||||
if ( !string.IsNullOrEmpty( searchText ) )
|
||||
{
|
||||
SteamUGC.Internal.SetSearchText( handle, searchText );
|
||||
}
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region ReturnValues
|
||||
|
||||
bool? WantsReturnOnlyIDs;
|
||||
public QueryType WithOnlyIDs(bool b) { WantsReturnOnlyIDs = b; return this; }
|
||||
bool? WantsReturnKeyValueTags;
|
||||
public QueryType WithKeyValueTag(bool b) { WantsReturnKeyValueTags = b; return this; }
|
||||
bool? WantsReturnLongDescription;
|
||||
public QueryType WithLongDescription(bool b) { WantsReturnLongDescription = b; return this; }
|
||||
bool? WantsReturnMetadata;
|
||||
public QueryType WithMetadata(bool b) { WantsReturnMetadata = b; return this; }
|
||||
bool? WantsReturnChildren;
|
||||
public QueryType WithChildren(bool b) { WantsReturnChildren = b; return this; }
|
||||
bool? WantsReturnAdditionalPreviews;
|
||||
public QueryType WithAdditionalPreviews(bool b) { WantsReturnAdditionalPreviews = b; return this; }
|
||||
bool? WantsReturnTotalOnly;
|
||||
public QueryType WithTotalOnly(bool b) { WantsReturnTotalOnly = b; return this; }
|
||||
uint? WantsReturnPlaytimeStats;
|
||||
public QueryType WithPlaytimeStats(uint unDays) { WantsReturnPlaytimeStats = unDays; return this; }
|
||||
|
||||
private void ApplyReturns(UGCQueryHandle_t handle)
|
||||
{
|
||||
if (WantsReturnOnlyIDs.HasValue)
|
||||
{
|
||||
SteamUGC.Internal.SetReturnOnlyIDs(handle, WantsReturnOnlyIDs.Value);
|
||||
}
|
||||
|
||||
if (WantsReturnKeyValueTags.HasValue)
|
||||
{
|
||||
SteamUGC.Internal.SetReturnKeyValueTags(handle, WantsReturnKeyValueTags.Value);
|
||||
}
|
||||
|
||||
if (WantsReturnLongDescription.HasValue)
|
||||
{
|
||||
SteamUGC.Internal.SetReturnLongDescription(handle, WantsReturnLongDescription.Value);
|
||||
}
|
||||
|
||||
if (WantsReturnMetadata.HasValue)
|
||||
{
|
||||
SteamUGC.Internal.SetReturnMetadata(handle, WantsReturnMetadata.Value);
|
||||
}
|
||||
|
||||
if (WantsReturnChildren.HasValue)
|
||||
{
|
||||
SteamUGC.Internal.SetReturnChildren(handle, WantsReturnChildren.Value);
|
||||
}
|
||||
|
||||
if (WantsReturnAdditionalPreviews.HasValue)
|
||||
{
|
||||
SteamUGC.Internal.SetReturnAdditionalPreviews(handle, WantsReturnAdditionalPreviews.Value);
|
||||
}
|
||||
|
||||
if (WantsReturnTotalOnly.HasValue)
|
||||
{
|
||||
SteamUGC.Internal.SetReturnTotalOnly(handle, WantsReturnTotalOnly.Value);
|
||||
}
|
||||
|
||||
if (WantsReturnPlaytimeStats.HasValue)
|
||||
{
|
||||
SteamUGC.Internal.SetReturnPlaytimeStats(handle, WantsReturnPlaytimeStats.Value);
|
||||
}
|
||||
}
|
||||
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user