Differences
This shows you the differences between two versions of the page.
|
pjv:laboratoare:2025:a06 [2025/09/29 08:30] alexandru.gradinaru created |
pjv:laboratoare:2025:a06 [2026/01/16 08:28] (current) alexandru.gradinaru |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ===== 6. Livrarea online a conținutului ===== | + | ===== 6. Livrarea online a conținutului (bonus) ===== |
| + | |||
| + | <hidden> | ||
| + | livrarea de conținut digital (patch-uri, asseturi, DLC-uri) printr-o rețea distribuită (CDN) | ||
| + | unity addressables | ||
| + | etc | ||
| + | </hidden> | ||
| + | |||
| + | ==== Cerinte ===== | ||
| + | |||
| + | Realizati un joc de curse simplu cu urmatoarele funcitonalitati: | ||
| + | * un main menu (sau launcher) din care se poate selecta o scena (minim 2): scenele trebuie sa se descarce inainte de a se putea juca | ||
| + | * fiecare scena are un traseu de curse, si cateva panouri publicitare configurate intr-o platforma web externa/baza de date externa (de ex se poate configura o reclama cu Coca Cola sau Pepsi) | ||
| + | |||
| + | |||
| + | ==== Documentatie ===== | ||
| + | |||
| + | In Unity principalele metode de a folosi continut gestionat extern sunt Unity AssetBundles si Addressables. | ||
| + | |||
| + | |||
| + | === AssetBundles === | ||
| + | |||
| + | AssetBundles sunt arhive binare generate de Unity care conțin asset-uri (texturi, prefabs, scene etc.) pentru o platformă țintă. | ||
| + | |||
| + | La ce ajută: livrare de conținut după instalare (patch/DLC), reducerea dimensiunii build-ului, streaming de conținut. | ||
| + | |||
| + | Cum funcționează: | ||
| + | |||
| + | * în Editor creezi bundle-uri (prin scripting sau AssetBundle labels) | ||
| + | * faci BuildPipeline.BuildAssetBundles(...) (sau pipeline modern) | ||
| + | * la runtime descarci fișierul bundle (din CDN/local) | ||
| + | * îl încarci cu AssetBundle.LoadFromFile / LoadFromMemoryAsync | ||
| + | * extragi asset-uri cu LoadAssetAsync<T>() | ||
| + | |||
| + | Limitări: management manual pentru dependențe, caching, versioning, naming, update logic. | ||
| + | |||
| + | === Addressables === | ||
| + | |||
| + | Addressables un layer peste AssetBundles care oferă: | ||
| + | |||
| + | * address (cheie logică) pentru asset-uri | ||
| + | * catalog (index/manifest) cu ce există și unde se găsește (local/remote) | ||
| + | * management automat al dependențelor, caching, update, profiling | ||
| + | |||
| + | În spate: Addressables generează AssetBundles + catalog. | ||
| + | |||
| + | De ce sunt preferate: workflow mult mai simplu pentru patch/DLC: | ||
| + | |||
| + | * CheckForCatalogUpdates → UpdateCatalogs | ||
| + | * GetDownloadSizeAsync(label/address) | ||
| + | * DownloadDependenciesAsync(...) | ||
| + | * LoadAssetAsync<T>(address) / LoadSceneAsync(address) | ||
| + | |||
| + | Când folosești labels: pentru a grupa conținut (ex: track_winter, ads, skins_pack_01) și a descărca “pachetul”. | ||
| + | |||
| + | Exemple: | ||
| + | |||
| + | AssetBundle de pe disc și aplicarea unei texturi | ||
| + | |||
| + | <code c#> | ||
| + | |||
| + | using UnityEngine; | ||
| + | using System.Collections; | ||
| + | |||
| + | public class LoadTextureFromBundle : MonoBehaviour | ||
| + | { | ||
| + | public string bundlePath; // ex: Application.persistentDataPath + "/bundles/ads" | ||
| + | public string textureAssetName; // ex: "coke_start_tex" | ||
| + | public Renderer targetRenderer; | ||
| + | |||
| + | private IEnumerator Start() | ||
| + | { | ||
| + | var bundleCreateRequest = AssetBundle.LoadFromFileAsync(bundlePath); | ||
| + | yield return bundleCreateRequest; | ||
| + | |||
| + | var bundle = bundleCreateRequest.assetBundle; | ||
| + | if (bundle == null) | ||
| + | { | ||
| + | Debug.LogError("AssetBundle load failed: " + bundlePath); | ||
| + | yield break; | ||
| + | } | ||
| + | |||
| + | var texRequest = bundle.LoadAssetAsync<Texture2D>(textureAssetName); | ||
| + | yield return texRequest; | ||
| + | |||
| + | var tex = texRequest.asset as Texture2D; | ||
| + | if (tex == null) | ||
| + | { | ||
| + | Debug.LogError("Texture not found in bundle: " + textureAssetName); | ||
| + | bundle.Unload(false); | ||
| + | yield break; | ||
| + | } | ||
| + | |||
| + | // aplică textura | ||
| + | ApplyTexture(targetRenderer, tex); | ||
| + | |||
| + | // bundle.Unload(false) păstrează asset-urile încărcate în memorie | ||
| + | bundle.Unload(false); | ||
| + | } | ||
| + | |||
| + | private void ApplyTexture(Renderer r, Texture2D tex) | ||
| + | { | ||
| + | // material instanțiat ca să nu modifici sharedMaterial global | ||
| + | var mat = r.material; | ||
| + | mat.mainTexture = tex; | ||
| + | } | ||
| + | } | ||
| + | |||
| + | </code> | ||
| + | |||
| + | AssetBundle din memorie (de ex. după download) | ||
| + | |||
| + | <code c#> | ||
| + | var req = AssetBundle.LoadFromMemoryAsync(downloadedBytes); | ||
| + | yield return req; | ||
| + | AssetBundle bundle = req.assetBundle; | ||
| + | </code> | ||
| + | |||
| + | Addressables | ||
| + | |||
| + | <code c#> | ||
| + | |||
| + | using UnityEngine; | ||
| + | using UnityEngine.AddressableAssets; | ||
| + | using UnityEngine.ResourceManagement.AsyncOperations; | ||
| + | using System.Collections; | ||
| + | using System.Collections.Generic; | ||
| + | |||
| + | public class AddressablesDlcExample : MonoBehaviour | ||
| + | { | ||
| + | public string dlcLabel = "track_winter"; | ||
| + | public string textureAddress = "ads/coke_start_tex"; | ||
| + | public Renderer targetRenderer; | ||
| + | |||
| + | private IEnumerator Start() | ||
| + | { | ||
| + | // 1) verifică update catalog | ||
| + | var check = Addressables.CheckForCatalogUpdates(false); | ||
| + | yield return check; | ||
| + | |||
| + | List<string> catalogs = check.Result; | ||
| + | Addressables.Release(check); | ||
| + | |||
| + | if (catalogs != null && catalogs.Count > 0) | ||
| + | { | ||
| + | var update = Addressables.UpdateCatalogs(catalogs, false); | ||
| + | yield return update; | ||
| + | Addressables.Release(update); | ||
| + | } | ||
| + | |||
| + | // 2) află dimensiunea de download pentru DLC | ||
| + | var sizeOp = Addressables.GetDownloadSizeAsync(dlcLabel); | ||
| + | yield return sizeOp; | ||
| + | long bytes = sizeOp.Result; | ||
| + | Addressables.Release(sizeOp); | ||
| + | |||
| + | Debug.Log($"DLC size: {bytes / (1024f * 1024f):0.00} MB"); | ||
| + | |||
| + | // 3) descarcă dependențele (bundles) pentru label | ||
| + | var download = Addressables.DownloadDependenciesAsync(dlcLabel, true); | ||
| + | while (!download.IsDone) | ||
| + | { | ||
| + | Debug.Log($"Download progress: {download.PercentComplete:0.00}"); | ||
| + | yield return null; | ||
| + | } | ||
| + | |||
| + | if (download.Status != AsyncOperationStatus.Succeeded) | ||
| + | { | ||
| + | Debug.LogError("DownloadDependencies failed"); | ||
| + | Addressables.Release(download); | ||
| + | yield break; | ||
| + | } | ||
| + | Addressables.Release(download); | ||
| + | |||
| + | // 4) încarcă textura după address | ||
| + | var loadTex = Addressables.LoadAssetAsync<Texture2D>(textureAddress); | ||
| + | yield return loadTex; | ||
| + | |||
| + | if (loadTex.Status == AsyncOperationStatus.Succeeded) | ||
| + | { | ||
| + | ApplyTexture(targetRenderer, loadTex.Result); | ||
| + | } | ||
| + | else | ||
| + | { | ||
| + | Debug.LogError("LoadAssetAsync failed: " + textureAddress); | ||
| + | } | ||
| + | |||
| + | // când nu mai ai nevoie de asset: | ||
| + | // Addressables.Release(loadTex); | ||
| + | } | ||
| + | |||
| + | private void ApplyTexture(Renderer r, Texture2D tex) | ||
| + | { | ||
| + | var mat = r.material; | ||
| + | mat.mainTexture = tex; | ||
| + | } | ||
| + | } | ||
| + | |||
| + | </code> | ||
| + | |||
| + | Încărcare scenă Addressable (DLC track) | ||
| + | |||
| + | <code c#> | ||
| + | using UnityEngine; | ||
| + | using UnityEngine.AddressableAssets; | ||
| + | using UnityEngine.SceneManagement; | ||
| + | using System.Collections; | ||
| + | |||
| + | public class LoadSceneAddressable : MonoBehaviour | ||
| + | { | ||
| + | public string sceneAddress = "Track_Winter"; | ||
| + | |||
| + | private IEnumerator Start() | ||
| + | { | ||
| + | var op = Addressables.LoadSceneAsync(sceneAddress, LoadSceneMode.Single, true); | ||
| + | yield return op; | ||
| + | } | ||
| + | } | ||
| + | </code> | ||
| + | |||
| + | Pentru gestiunea reclamelor, puteti folosi texturi gestionate/acutalizate din cod: | ||
| + | |||
| + | <code c#> | ||
| + | |||
| + | Renderer r = GetComponent<Renderer>(); | ||
| + | Texture2D tex = /* încărcată din URL / bundle / addressables */; | ||
| + | r.material.mainTexture = tex; | ||
| + | |||
| + | |||
| + | var r = GetComponent<Renderer>(); | ||
| + | var mat = r.material; | ||
| + | mat.SetTexture("_BaseMap", tex); // URP Lit | ||
| + | |||
| + | |||
| + | using UnityEngine.UI; | ||
| + | |||
| + | Texture2D tex = ...; | ||
| + | Sprite sp = Sprite.Create(tex, new Rect(0,0,tex.width, tex.height), new Vector2(0.5f,0.5f)); | ||
| + | GetComponent<Image>().sprite = sp; | ||
| + | |||
| + | </code> | ||
| + | |||
