Agency-Phone تخزين الوسائط

أين تُخزَّن الصور ومقاطع الفيديو والرسائل الصوتية

كل صورة ومقطع فيديو وتسجيل شاشة ورسالة صوتية من Agency Phone يحفظها السكربت نفسه، بدءًا من الإصدار 27.1.1. أنت تختار مكان الحفظ:

لم يعد Fivemanage وDiscord يُستخدمان للتخزين. أما webhooks الخاصة بـ Discord فما زالت متاحة للسجلات.

التخزين المحلي (الافتراضي)

لا يوجد شيء لإعداده. ينشئ السكربت جدولين في قاعدة بياناتك عند أول تشغيل (agency_media وagency_media_parts) ويحفظ الملفات فيهما. كل ما تحتاجه هو oxmysql، وهو مطلوب للسكربت على أي حال.

ماذا يعني هذا لك:

• لا حساب ولا مفتاح API ولا resource إضافي. لا يعمل أي شيء خارج خادمك.
• التحديثات آمنة. الملفات موجودة في قاعدة البيانات وليس في مجلد الـ resource، لذلك فاستبدال المجلد عند التحديث يحافظ على كل الصور.
• النسخ الاحتياطية لقاعدة بياناتك تشمل الوسائط. تكبر قاعدة البيانات بنحو الثلث زيادة على حجم الملفات نفسها. تبلغ الصورة الواحدة حوالي 150 كيلوبايت.
• يتشارك Agency Phone وAgency Pad التخزين نفسه. الصورة الملتقطة بأحدهما تظهر في الآخر، بما في ذلك الصور المزامنة مع Agency Cloud.
• يعرضها تطبيق Agency Companion أيضًا، على iOS وAndroid وتطبيق الويب. ولا يحتاج هذا إلى أي إعداد كذلك.

السرعة

تنتقل الملفات عبر اتصال FiveM نفسه، دون أن توقف اللعبة. يحدّ FiveM من سرعة إرسال اللاعب للبيانات إلى الخادم (حوالي 165 كيلوبايت في الثانية)، وبناءً على ذلك:

عرض الملف للاعبين الآخرين سريع، فالمقطع كاملًا يصل خلال بضع ثوانٍ. إذا كان خادمك يسجل الكثير من الفيديو، فإن Cloudflare R2 يحفظ المقاطع تقريبًا فورًا.

الإعدادات في config.lua

AgencyConfig.MediaStorage = {
    Provider = 'local',                -- 'محلي' أو 'cloudflare': 'local' or 'cloudflare'

    MaxFileMegabytes = 10,             -- أكبر حجم لملف واحد (المقاطع، التسجيلات)
    TransferKilobytesPerSecond = 1000, -- 'local': سرعة إرسال الملفات إلى اللاعبين

    Local = {
        RetentionDays = 30,            -- حذف الملفات الأقدم من هذه المدة (0 = الاحتفاظ بها دائمًا)
        MaxStorageGigabytes = 10,      -- حذف الأقدم أولًا عند تجاوز هذا الحجم (0 = بلا حد)
    },
}

Cloudflare R2 خطوة بخطوة

Cloudflare R2 مجاني حتى 10 جيجابايت من التخزين ومليون عملية رفع و10 ملايين عملية تنزيل شهريًا، ولا تكلّف عمليات التنزيل أي شيء أبدًا. تطلب Cloudflare وسيلة دفع عند تفعيل R2 حتى للخطة المجانية. لن تدفع إلا إذا تجاوزت الحدود المجانية.

1. تفعيل R2

1. سجّل الدخول عبر dash.cloudflare.com (يكفي حساب مجاني).
2. من القائمة على اليسار افتح Storage & databases ثم R2 Object Storage.
3. أضف اشتراك R2. تعرض الصفحة أن المبلغ المستحق الآن هو $0.00. وافق على الشروط ثم اضغط Activate.

2. إنشاء bucket

1. اضغط Create bucket.
2. سمِّه مثلًا myserver-media. لا يمكن تغيير الاسم لاحقًا.
3. اترك الموقع على Automatic وفئة التخزين على Standard.
4. اضغط Create bucket.

3. جعل الملفات قابلة للعرض

1. افتح الـ bucket الخاص بك وانتقل إلى Settings.
2. ضمن Public Development URL اضغط Enable، واكتب allow ثم أكّد.
3. انسخ العنوان الذي يظهر، ويبدو مثل https://pub-1a2b3c….r2.dev. هذا هو PublicUrl الخاص بك.

تضع Cloudflare حدودًا على عنوان r2.dev للخوادم كثيرة الازدحام. إذا كان لديك نطاق خاص بك على Cloudflare، فيمكنك إضافته ضمن Custom Domains في المكان نفسه واستخدام ذلك العنوان بدلًا من ذلك كـ PublicUrl.

4. السماح بالرفع من داخل اللعبة

1. ما زلت في Settings، ابحث عن CORS Policy واضغط Add.
2. احذف كل ما في حقل النص، والصق ما يلي ثم اضغط Save:

[
  {
    "AllowedOrigins": ["https://cfx-nui-agency-phone", "https://cfx-nui-agency-pad"],
    "AllowedMethods": ["PUT", "GET"],
    "AllowedHeaders": ["*"],
    "MaxAgeSeconds": 3600
  }
]

بدون هذه الخطوة لا تستطيع اللعبة الرفع، وتفشل عملية حفظ الصور. إذا غيّرت اسم مجلد الـ resource، فضع اسم مجلدك بعد cfx-nui-.

5. إنشاء مفتاح

1. ارجع إلى R2 Object Storage واضغط Manage API tokens.
2. اضغط Create API token (يكفي account token).
3. الصلاحيات: Object Read & Write.
4. عند اختيار الـ bucket، اختر الـ bucket الخاص بك فقط.
5. اضغط Create. تعرض Cloudflare قيمتي Access Key ID وSecret Access Key مرة واحدة فقط، فانسخهما الآن.
6. يظهر Account ID الخاص بك في نظرة R2 العامة، وهو أيضًا الجزء الأول من عنوان S3 (https://<Account ID>.r2.cloudflarestorage.com).

6. إدخال البيانات في السكربت

تُوضع المفاتيح في config_server.lua. يقرأ هذا الملف الخادم فقط ولا يُرسَل أبدًا إلى اللاعبين. لا تضعها في config.lua: فهذا الملف يُرسَل إلى كل لاعب.

-- config_server.lua
AgencyServerConfig.Cloudflare = {
    AccountId       = 'your account id',
    Bucket          = 'myserver-media',
    AccessKeyId     = 'your access key id',
    SecretAccessKey = 'your secret access key',
    PublicUrl       = 'https://pub-1a2b3c....r2.dev',
}

ثم اضبط الـ provider في config.lua وأعد تشغيل الـ resource:

AgencyConfig.MediaStorage = {
    Provider = 'cloudflare',
    ...
}

تعرض وحدة تحكم الخادم الآن Media: storage: Cloudflare R2, bucket myserver-media. إذا كان شيء ناقصًا، تذكر وحدة التحكم ما هو، ويواصل السكربت الحفظ محليًا إلى أن يُصلَح الأمر، فلا تتوقف الكاميرا عن العمل أبدًا.

هل تستخدم Agency Phone وAgency Pad معًا؟ يمكن للاثنين استخدام الـ bucket نفسه والمفتاح نفسه، ويحتفظ كل منهما بملفاته في مجلد خاص به.

التحقق من أن كل شيء يعمل

نفّذ هذا في وحدة تحكم الخادم (أو كمشرف داخل اللعبة)، مع ID لاعب متصل حاليًا:

phonemediatest 1

يحفظ Agency Phone الخاص باللاعب صورة اختبار صغيرة، ويحمّلها مجددًا بالطريقة نفسها التي يفعلها أي لاعب آخر، ويعرضها، ثم يشغّل رسالة صوتية قصيرة. تجيب وحدة التحكم:

Media test passed for player 1 in 1361 ms: upload ok, download ok, shown as picture ok, app markup and backgrounds ok, voice message plays ok

أضف big لاختبار مقطع فيديو بحجم 6 ميجابايت أيضًا: phonemediatest 1 big.

المشكلات وحلولها

إذا كنت قادمًا من Fivemanage أو Discord

لا شيء يحتاج إلى نقل. الصور المحفوظة سابقًا تحتفظ بروابطها القديمة وتبقى ظاهرة ما دامت تلك الخدمة لا تزال تقدمها. كل ما هو جديد يذهب إلى التخزين الذي اخترته. الإعدادات القديمة MediaStorageProvider وFiveManageApiUrl وFiveManageApiKey وScreenshotWebhook يتم تجاهلها ويمكن حذفها من ملف الإعدادات.

الأمان

• لا يستطيع الرفع إلا اللاعبون المتصلون بخادمك. يُعلَن عن كل عملية رفع أولًا ويُتحقق من نوع الملف وحجمه.
• يُفحَص المحتوى من خلال أولى بايتاته. لا يمكن أبدًا تخزين صفحة ويب أو سكربت متنكرًا في هيئة صورة.
• أسماء الملفات عشوائية بطول 128 بت، ولا يمكن تخمينها أو سرد قائمة بها.
• عمليات الرفع والتنزيل محدودة لكل لاعب.
• مع Cloudflare، تحصل كل عملية رفع على رابطها الخاص الصالح لمدة 5 دقائق، لملف واحد بالضبط من نوع واحد وبحجم واحد. ولا يغادر المفتاح السري خادمك أبدًا.