using System; using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; using Steamworks.Data; using QueryType = Steamworks.Ugc.Query; namespace Steamworks.Ugc { public struct Query { UgcType matchingType; UGCQuery queryType; AppId consumerApp; AppId creatorApp; string searchText; bool returnLongDescription; 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 Query WithLongDescription() { returnLongDescription = true; return this; } public Query WithSummaryDescription() { returnLongDescription = false; return this; } public async Task 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.CreateQueryAllUGCRequest1( queryType, matchingType, creatorApp.Value, consumerApp.Value, (uint)page ); } 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; } 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; } bool? WantsReturnPlaytimeStats; public QueryType WithPlaytimeStats( bool b ) { WantsReturnPlaytimeStats = b; 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 requiredTags; bool? matchAnyTag; List excludedTags; Dictionary requiredKv; /// /// Found items must have at least one of the defined tags /// public QueryType MatchAnyTag() { matchAnyTag = true; return this; } /// /// Found items must have all defined tags /// public QueryType MatchAllTags() { matchAnyTag = false; return this; } public QueryType WithTag( string tag ) { if ( requiredTags == null ) requiredTags = new List(); requiredTags.Add( tag ); return this; } public QueryType WithTags( IEnumerable tags ) { if (requiredTags == null) requiredTags = new List(); requiredTags.AddRange(tags); return this; } public QueryType WithoutTag( string tag ) { if ( excludedTags == null ) excludedTags = new List(); 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 ); } SteamUGC.Internal.SetReturnLongDescription( handle, returnLongDescription ); } #endregion } }