[SDK-600] Feature/avatar template element (#164)

- added avatar template element and other required logic and classes + prefabs

Author: HarrisonHough

Runtime/AvatarCreator/AvatarTemplateFetcher.cs

@@ -0,0 +1,61 @@
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace ReadyPlayerMe.AvatarCreator
+{
+    /// <summary>
+    /// This class can be used to fetch avatar template data including icon renders from the avatarAPI.
+    /// </summary>
+    public class AvatarTemplateFetcher
+    {
+        private readonly CancellationToken ctx;
+        private readonly AvatarAPIRequests avatarAPIRequests;
+
+        public AvatarTemplateFetcher(CancellationToken ctx = default)
+        {
+            this.ctx = ctx;
+            avatarAPIRequests = new AvatarAPIRequests(ctx);
+        }
+
+        /// <summary>
+        /// Fetches all avatar templates without the icon renders via the avatarAPI.
+        /// </summary>
+        /// <returns></returns>
+        public async Task<List<AvatarTemplateData>> GetTemplates()
+        {
+            return await avatarAPIRequests.GetAvatarTemplates();
+        }
+
+        /// <summary>
+        /// Fetches all avatar template data with the icon renders via the avatarAPI.
+        /// This will wait for all the icons to be downloaded. 
+        /// </summary>
+        /// <returns></returns>
+        public async Task<List<AvatarTemplateData>> GetTemplatesWithRenders()
+        {
+            var templates = await avatarAPIRequests.GetAvatarTemplates();
+            return await FetchTemplateRenders(templates);
+        }
+
+        /// <summary>
+        /// Fetches the renders for all the templates provided.
+        /// </summary>
+        public async Task<List<AvatarTemplateData>> FetchTemplateRenders(List<AvatarTemplateData> templates)
+        {
+            var tasks = templates.Select(async templateData =>
+            {
+                templateData.Texture = await avatarAPIRequests.GetAvatarTemplateImage(templateData.ImageUrl);
+            }).ToList();
+
+            while (!tasks.All(x => x.IsCompleted) &&
+                   !ctx.IsCancellationRequested)
+            {
+                await Task.Yield();
+            }
+
+            return templates;
+        }
+    }
+}

Runtime/AvatarCreator/TemplateFetcher.cs.meta renamed to Runtime/AvatarCreator/AvatarTemplateFetcher.cs.meta

@@ -0,0 +1,13 @@
+namespace ReadyPlayerMe.AvatarCreator
+{
+    public struct AssetLibrary
+    {
+        public PartnerAsset[] Assets;
+        public Pagination Pagination;
+    }
+
+    public struct Pagination
+    {
+        public int TotalPages;
+    }
+}

Runtime/AvatarCreator/Data/AssetLibrary.cs

@@ -6,7 +6,7 @@
 namespace ReadyPlayerMe.AvatarCreator
 {
     [Serializable]
-    public class TemplateData
+    public class AvatarTemplateData
     {
         public string ImageUrl;
         [JsonConverter(typeof(GenderConverter))]

Runtime/AvatarCreator/Data/AssetData.cs.meta renamed to Runtime/AvatarCreator/Data/AssetLibrary.cs.meta

@@ -1,14 +1,8 @@
-using Newtonsoft.Json;
+using Newtonsoft.Json;
 using ReadyPlayerMe.Core;
 
 namespace ReadyPlayerMe.AvatarCreator
 {
-    public struct AssetData
-    {
-        public PartnerAsset[] Assets;
-        public Pagination Pagination;
-    }
-
     public struct PartnerAsset
     {
         public string Id;
@@ -17,15 +11,8 @@ public struct PartnerAsset
         [JsonConverter(typeof(GenderConverter))]
         public OutfitGender Gender;
         [JsonProperty("iconUrl")]
-        public string Icon;
-        [JsonProperty("maskUrl")]
-        public string Mask;
+        public string ImageUrl;
         [JsonProperty("lockedCategories")]
         public string[] LockedCategories;
     }
-
-    public struct Pagination
-    {
-        public int TotalPages;
-    }
 }

Runtime/AvatarCreator/Data/TemplateData.cs renamed to Runtime/AvatarCreator/Data/AvatarTemplateData.cs

@@ -29,7 +29,7 @@ public PartnerAssetsManager()
             assetsByCategory = new Dictionary<Category, List<PartnerAsset>>();
         }
 
-        public async Task<Dictionary<Category,List<PartnerAsset>>> GetAssets(BodyType bodyType, OutfitGender gender, CancellationToken token = default)
+        public async Task<Dictionary<Category, List<PartnerAsset>>> GetAssets(BodyType bodyType, OutfitGender gender, CancellationToken token = default)
         {
             var startTime = Time.time;
 
@@ -96,7 +96,7 @@ private async Task DownloadIcons(List<PartnerAsset> chunk, Action<string, Textur
 
             foreach (var asset in chunk)
             {
-                var url = asset.Category == Category.EyeColor ? asset.Mask + EYE_MASK_SIZE_SIZE : asset.Icon + ASSET_ICON_SIZE;
+                var url = $"{asset.ImageUrl}{ASSET_ICON_SIZE}";
                 var linkedTokenSource = CancellationTokenSource.CreateLinkedTokenSource(token);
                 var iconTask = partnerAssetsRequests.GetAssetIcon(url, icon =>
                     {
@@ -126,7 +126,7 @@ public PrecompileData GetPrecompileData(Category[] categories, int numberOfAsset
                 .Select(kvp => kvp.Key)
                 .ToArray();
 
-            var dictionary = categoriesFromMap.ToDictionary(category => category, category => 
+            var dictionary = categoriesFromMap.ToDictionary(category => category, category =>
                 GetAssetsByCategory(CategoryHelper.PartnerCategoryMap[category])
                     .Take(numberOfAssetsPerCategory)
                     .ToArray());