تلقّي الرسائل على تطبيق عميل Unity

تلقّي الرسائل والتعامل معها

لتلقّي الرسائل، يجب أن يحدّد تطبيقك دالة ردّ لمعالج الحدث Firebase.Messaging.FirebaseMessaging.MessageReceived.

حدث واحد (MessageReceived)

من خلال إلغاء عملية تعيين دالة رد الاتصال إلى Firebase.Messaging.FirebaseMessaging.MessageReceived يمكنك تنفيذ إجراءات استنادًا إلى الرسالة المستلَمة والحصول على بيانات الرسالة:

public void OnMessageReceived(object sender, Firebase.Messaging.MessageReceivedEventArgs e) {
  UnityEngine.Debug.Log("From: " + e.Message.From);
  UnityEngine.Debug.Log("Message ID: " + e.Message.MessageId);
}

يمكن أن تمثّل الرسائل أنواعًا مختلفة من البيانات الواردة. في معظم الحالات، يتم إرسال الرسائل إلى التطبيق بعد أن يبدأها المطوّر. يتم أيضًا إرسال رسائل إلى تطبيقك لتمثيل أحداث الرسائل المرسَلة وأحداث أخطاء إرسال الرسائل وأحداث الرسائل المحذوفة. ويمكن التمييز بين هذه الأحداث الخاصة من خلال التحقّق من الحقل MessageType.

تم حذف الرسائل

يتم إرسال هذا الرمز إلى تطبيقك عندما يحذف خادم FCM الرسائل المعلّقة. سيصبح MessageType هو "deleted_messages". قد يتم حذف الرسائل في الحالات التالية:

1. يتم تخزين عدد كبير جدًا من الرسائل على خادم FCM.

   يمكن أن يحدث ذلك عندما ترسل خوادم أحد التطبيقات مجموعة من الرسائل غير القابلة للتصغير إلى خوادم FCM أثناء عدم اتصال الجهاز بالإنترنت.

2. لم يتصل الجهاز بالإنترنت لفترة طويلة، وأرسل خادم التطبيق رسالة إلى التطبيق على هذا الجهاز مؤخرًا (خلال آخر 4 أسابيع).

   يُنصح التطبيق بإجراء مزامنة كاملة مع خادم التطبيق بعد تلقّي هذا الاتصال.

إرسال حدث

يتم استدعاء هذه الطريقة عند إرسال رسالة من الخادم إلى الجهاز بنجاح إلى FCM. سيصبح MessageType هو "send_event".

حدث خطأ أثناء الإرسال

يتم استدعاء هذه الطريقة عند حدوث خطأ أثناء إرسال رسالة إلى الخادم. سيصبح MessageType هو "send_error".