ملفات اللعبة

الأصول ملفات تنزّلها لعبتك أثناء التشغيل — نسيجات، وأصوات، وحزم، وكتل إعدادات، وغيرها. تستضيفها Flock وتقدّمها للعبتك عبر حزمة التطوير، فتستطيع تحديث المحتوى دون إطلاق نسخة جديدة.

النطاق: تنتمي الأصول إلى لعبتك؛ وتكوينات الأصول هي ما يصفها ويجمّعها.

لوحة التحكم
Unity
Unreal

تعمل صفحتان معًا:

الأصول — ارفع الملفات نفسها وأدرها.
تكوين الأصول — عرّف بيانات كل أصل وتجميعه، حتى تتمكن لعبتك من الوصول إلى الملف الصحيح أثناء التشغيل.

الأصول وتكويناتها — أدر الملفات من صفحة الأصول، وصِفها من صفحة تكوين الأصول.

اقرأ قائمة الأصول، وابحث عن أحدها بالاسم الذي أعطيته إيّاه في إعدادات الأصول، ثم نزّله عبر FlockClient.Instance.Asset. وتحوّل DownloadAsync<T> الملف إلى نوع من أنواع Unity: ‏T واحد من Texture2D وSprite وAudioClip وstring وbyte[]. وتُخزَّن التنزيلات مؤقّتًا على القرص بحسب الأصل وإصداره، فيكون الطلب الثاني للإصدار نفسه قراءةً محلية لا نقلًا.

using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Flock;
using Flock.Models;
using UnityEngine;

public class TitleBanner : MonoBehaviour
{
    [SerializeField] private SpriteRenderer bannerRenderer;

    private async void Start()
    {
        // الفهرس كاملًا: لقائمة محتويات، أو لتشغيل شاشة تحميل مسبق.
        List<AssetSchema> assets = await FlockClient.Instance.Asset.GetAllAsync();
        Debug.Log($"{assets.Count} assets in this game version");

        // بالاسم، كما تعرضه لوحة التحكم تمامًا؛ ويرمي FlockException حين لا يحمل أي أصل ذلك الاسم.
        AssetSchema banner = await FlockClient.Instance.Asset.GetByNameAsync("title_banner");

        // أهو على القرص بهذا الإصدار بالفعل؟ إذن لا يحدث تنزيل.
        Debug.Log($"Cached: {FlockClient.Instance.Asset.IsCached(banner)}");

        // نزّله على هيئة Sprite، مع الإبلاغ عن التقدّم من 0 إلى 1.
        Progress<float> progress = new Progress<float>(done => Debug.Log($"Downloading {done:P0}"));
        bannerRenderer.sprite = await FlockClient.Instance.Asset.DownloadAsync<Sprite>(banner, progress);
    }

    // خلف شاشة تحميل: نزّل إلى الذاكرة المؤقّتة دون تحويل الملفات إلى أنواع Unity.
    public Task PreloadSmallAssetsAsync()
    {
        return FlockClient.Instance.Asset.PreloadAsync(asset => asset.SizeBytes.HasValue && asset.SizeBytes.Value < 1_000_000);
    }
}

وbannerRenderer مكوّن SpriteRenderer تعيّنه في لوحة Inspector. وتُعيد GetUncached(assets) أصول القائمة التي لم تصل إلى القرص بعد، وتحذف ClearCache() كل تنزيل مُخزَّن. وتعمل قراءة الأصول وتنزيلها دون تسجيل دخول.الذاكرة المؤقّتة تُضبط في تبويب Advanced Settings من Flock → Settings، بطاقة Asset Cache: Enable Asset Cache، وAsset Cache Directory، وAsset Cache Max Size MB (‏100 افتراضيًا؛ وبعده تُحذف التنزيلات الأقدم استعمالًا)، وAsset Download Timeout Seconds، وAsset Download Retry Count.

WebGL: ألغِ تحديد Enable Asset Cache (وEnable Offline Cache في بطاقة Offline Cache) قبل أن تبني لـWebGL: فتخزين المتصفّح لا يحتمل الكتابة المتزامنة للملفات التي تُجريها الذاكرات المؤقّتة. فتُنزَّل الأصول حينئذ في كل مرّة تُطلب.

حدِّد كل أصل بالاسم الذي أعطيته له في تكوين الأصول، ثم نزّله عبر مزوّد الأصول. تُنقل التنزيلات إلى القرص مباشرة وتُخزَّن فيه، لذا يكون الطلب الثاني للإصدار نفسه قراءة محلية لا عملية نقل جديدة.

UFlockSubsystem* Sdk = UFlockSubsystem::Get(this);
FFlockAssetProvider* Assets = Sdk->GetAssetProvider();

// The whole index — for a manifest, or to drive a preload screen.
Assets->GetAll([](TFlockResult<TArray<FFlockAsset>> Index) {});

// Download by name, straight into a texture.
Assets->DownloadTexture(TEXT("title_banner"), FFlockAssetProgress(),
    [](TFlockResult<UTexture2D*> Result)
    {
        if (Result.IsSuccess())
        {
            // Result.Value is ready to use.
        }
    });

تغطي أربع صيغ للتنزيل الحالات الشائعة: DownloadTexture وDownloadText وDownloadBytes وDownloadFile الذي يعيد مسارًا على القرص. تقبل كل واحدة منها إمّا FFlockAsset وإمّا نصًّا يحمل المعرّف أو الاسم، إضافة إلى مفوِّض FFlockAssetProgress الذي يبلّغ عن البايتات المستلمة مقابل الإجمالي أثناء النقل.الصوت. لا توجد دالة مساعدة للصوت مماثلة لتلك الخاصة بالنسيج. استخدم DownloadFile وحمّل المسار عبر مسار المعالجة الصوتية الخاص بك — إذ لا يملك المحرك مستوردًا أثناء التشغيل للصيغ المضغوطة التي تحتفظ بها شبكات التوزيع عادةً.التحميل المسبق. يجلب Preload وPreloadWhere دفعة من الأصول خلف شاشة تحميل ويبلّغان بعدد ما وصل منها. التحميل المسبق أفضل-جهد بطبيعته: أصل واحد يتعذّر الوصول إليه لا يُفشل الدفعة كلها.وفي Blueprint تقابلها العقد Flock Get Assets وFlock Get Asset وFlock Download Asset Texture / Text / Bytes / File وFlock Preload Assets، ضمن Flock | Assets. وتضيف عقد التنزيل مخرج On Progress الذي يُطلق تكرارًا كلما وصلت بايتات. أما أسئلة التخزين المؤقت فلا تحتاج شبكة، لذا فهي دوال عادية: Flock Is Asset Cached وFlock Get Uncached Assets وFlock Get Cached Asset Path وFlock Clear Asset Cache.تسجيل الدخول. تعمل قراءة الأصول وتنزيلها دون تسجيل دخول.

أبقِ المحتوى الكبير أو كثير التغيّر خارج نسختك وقدّمه كأصول Flock — عندها تستطيع تحديثه دون إصدار عميل جديد.

بدء الاستخدام

المفاهيم

الميزات

المرجع

ملفات اللعبة