الأصول

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

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

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

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

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

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

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

// الفهرس كاملًا — لبناء قائمة محتوى أو لتشغيل شاشة تحميل مسبق.
Assets->GetAll([](TFlockResult<TArray<FFlockAsset>> Index) {});

// تنزيل بالاسم، مباشرة إلى نسيج.
Assets->DownloadTexture(TEXT("title_banner"), FFlockAssetProgress(),
    [](TFlockResult<UTexture2D*> Result)
    {
        if (Result.IsSuccess())
        {
            // Result.Value جاهز للاستخدام.
        }
    });

تغطي أربع صيغ للتنزيل الحالات الشائعة: 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 — عندها تستطيع تحديثه دون إصدار عميل جديد.

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

المفاهيم

حزم التطوير

الميزات

المرجع