إشعارات اللعبة

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

لوحة التحكم
Unity

تجد الإشعارات ضمن التسويق:

القوالب — الرسالة القابلة لإعادة الاستخدام: عنوان ونص (بلغة محدّدة)، والقنوات التي يمكن إرسالها عبرها، ومتغيّرات تملؤها عند الإرسال — اكتب إعلان بداية الموسم مرة واحدة واجعل اسم الموسم متغيّرًا، ثم أعد استخدامه كل موسم.
الحملات — عملية الإرسال الفعلية: اختر قالبًا، واملأ متغيّراته، وحدّد الجمهور — كل اللاعبين أو شريحة — ثم أرسل الآن، أو في وقت مجدول، أو على وتيرة متكرّرة. ويمكن إلغاء الحملة المجدولة في أي وقت قبل انطلاقها.
حالة التسليم — كيف جرى الإرسال: دورة حياته من مُجدولة إلى قيد الإرسال إلى مُرسَلة، مع أعداد التسليم لكل قناة وأي إخفاقات.

صندوق الوارد. اجلب إشعارات اللاعب المسجَّل دخوله، واعرض شارة غير المقروء، وضع العناصر كمقروءة واحدًا تلو الآخر أو دفعة واحدة.

PaginatedResponse<Notification> inbox = await FlockClient.Instance.Notification.GetInboxAsync();
NotificationSummary summary = await FlockClient.Instance.Notification.GetSummaryAsync();
Debug.Log($"{summary.UnreadCount} unread");

await FlockClient.Instance.Notification.MarkReadAsync(inbox.Items[0]);
await FlockClient.Instance.Notification.MarkAllReadAsync();

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

iOS — تطلب RegisterThisDeviceAsync() إذن الإشعارات من النظام وتسجّل رمز APNs الناتج في استدعاء واحد. وتتطلّب وجود com.unity.mobile.notifications في المشروع.
Android — احصل على رمز FCM من Firebase بنفسك، ثم مرّره إلى RegisterDeviceTokenAsync(token). فعميل Firebase للمراسلة غير قابل للتثبيت عبر UPM، ومن ثمّ لا تستطيع حزمة التطوير شحنه كاعتمادية ولا تحاول ذلك عمدًا.
ما عدا ذلك (الحاسب المكتبي وأجهزة الكونسول والمحرّر) — يرمي الاستدعاءان استثناءً، لأن خادم الإشعارات الفورية لا قيمة لديه لتلك المنصّات.

وأعد التسجيل كلما أصدر النظام رمزًا جديدًا. وتزيل UnregisterDeviceTokenAsync رمزًا مسجَّلًا.تذكيرات تجدولها اللعبة بنفسها. جدوِل قالبًا ليصل لاحقًا — «امتلأت الطاقة بعد ٤ ساعات» — وألغِه إن عاد اللاعب قبل ذلك.

ScheduledNotification pending = await FlockClient.Instance.Notification.ScheduleAsync(
    "energy_refilled", TimeSpan.FromHours(4));

await FlockClient.Instance.Notification.CancelScheduledAsync(pending);

والوسيط الأول هو اسم القالب لا معرّفه. مرّر variables لملء عناصر القالب النائبة، وchannels لحصر قنوات التسليم، وlocale لاختيار لغة بعينها. أما الاسم غير المعروف فيرمي FlockErrorCode.NotificationTemplateNotFound قبل أن يُجدول أي شيء.قراءة الكتالوج. تسرد GetTemplatesAsync() القوالب التي يمكن للعبتك جدولتها، وتجلب GetTemplateByNameAsync(name, locale) قالبًا واحدًا. وكلتاهما على نطاق اللعبة لا اللاعب، ولذلك تعملان دون تسجيل دخول بخلاف بقية هذا المزوّد.التفاعل مع الوصول. يُطلَق FlockEvents.OnNotificationReceived مرة واحدة لكل إشعار لم تعرضه حزمة التطوير من قبل، من الأقدم إلى الأحدث. وهو يعتمد على عمليات الجلب التي تجريها لعبتك أصلًا ولا يضيف أي حركة شبكية — إذ لا توجد قناة لحظية، وحزمة التطوير لا تستقصي عمدًا.

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

سطح الإشعارات في حزمة التطوير متاح في حزمة Unity. أما دعم Unreal فغير متاح بعد — ومع ذلك تصل الحملات التي ترسلها من لوحة التحكم إلى كل اللاعبين، لأن التسليم يجري من جهة الخادم؛ فالمقتصر على Unity حاليًا هو صندوق الوارد داخل اللعبة وواجهات الجدولة.

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

المفاهيم

حزم التطوير

الميزات

المرجع

إشعارات اللعبة