تلقّي الرسائل على تطبيق عميل 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".