chrome.gcm

الوصف

استخدِم chrome.gcm للسماح للتطبيقات والإضافات بإرسال الرسائل وتلقّيها من خلال المراسلة عبر السحابة الإلكترونية من Firebase (FCM).

الأذونات

gcm

الخصائص

MAX_MESSAGE_SIZE

الحد الأقصى لحجم جميع أزواج المفتاح/القيمة في الرسالة (بالبايت).

القيمة

4096

الطُرق

register()

الوعد 
chrome.gcm.register(
  senderIds: string[],
  callback?: function,
): Promise<string>

تسجيل التطبيق في خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" سيعرض callback رقم تعريف التسجيل. إذا تم استدعاء register مرة أخرى باستخدام قائمة senderIds نفسها، سيتم عرض معرّف التسجيل نفسه.

المعلمات

  • senderIds

    string[]

    قائمة بأرقام تعريف الخوادم المسموح لها بإرسال رسائل إلى التطبيق. يجب أن يحتوي على رقم تعريف مرسِل واحد على الأقل و100 رقم تعريف مرسِل كحد أقصى.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (registrationId: string) => void

    • registrationId

      سلسلة

      معرّف تسجيل يخصّصه FCM للتطبيق.

المرتجعات

  • Promise<string>

    الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

send()

الوعد 
chrome.gcm.send(
  message: object,
  callback?: function,
): Promise<string>

يرسل رسالة وفقًا لمحتواها.

المعلمات

  • رسالة

    عنصر

    رسالة لإرسالها إلى الطرف الآخر من خلال خدمة "المراسلة من خلال السحابة الإلكترونية من Firebase"

    • البيانات

      عنصر

      بيانات الرسالة التي سيتم إرسالها إلى الخادم لا يُسمح باستخدام goog. وgoogle غير الحسّاسَين لحالة الأحرف، بالإضافة إلى collapse_key الحسّاس لحالة الأحرف، كبادئات للمفاتيح. يجب ألا يتجاوز مجموع كل أزواج المفتاح/القيمة gcm.MAX_MESSAGE_SIZE.

    • destinationId

      سلسلة

      معرّف الخادم الذي سيتم إرسال الرسالة إليه كما هو محدّد في وحدة تحكّم Google API

    • messageId

      سلسلة

      معرّف الرسالة. يجب أن يكون فريدًا لكل رسالة ضمن نطاق التطبيقات. راجِع مستندات Cloud Messaging للحصول على نصائح حول اختيار معرّف والتعامل معه.

    • timeToLive

      number اختياري

      تشير إلى مدة بقاء الرسالة بالثواني. إذا لم يكن من الممكن إرسال الرسالة خلال هذا الوقت، سيتم إنشاء حدث onSendError. يشير وقت البقاء على قيد الحياة الذي تبلغ قيمته 0 إلى أنّه يجب إرسال الرسالة على الفور أو تعذُّر إرسالها إذا لم يكن ذلك ممكنًا. القيمة التلقائية لمدة البقاء على قيد الحياة هي 86,400 ثانية (يوم واحد)، والحد الأقصى للقيمة هو 2,419,200 ثانية (28 يومًا).

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (messageId: string) => void

    • messageId

      سلسلة

      رقم تعريف الرسالة التي تم إصدار ردّ الاتصال بشأنها.

المرتجعات

  • Promise<string>

    الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

unregister()

الوعد 
chrome.gcm.unregister(
  callback?: function,
): Promise<void>

لإلغاء تسجيل التطبيق من خدمة FCM.

المعلمات

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوافق الوعود إلا مع الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى عمليات رد الاتصال.

الفعاليات

onMessage

chrome.gcm.onMessage.addListener(
  callback: function,
)

يتم تنشيطه عند تلقّي رسالة من خلال ميزة "المراسلة عبر السحابة الإلكترونية من Firebase".

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (message: object) => void

onMessagesDeleted

chrome.gcm.onMessagesDeleted.addListener(
  callback: function,
)

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

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    () => void

onSendError

chrome.gcm.onSendError.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما يتعذّر إرسال رسالة إلى خادم FCM.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (error: object) => void

    • خطأ

      عنصر

      • التفاصيل

        عنصر

        تفاصيل إضافية متعلّقة بالخطأ، إذا كانت متاحة

      • errorMessage

        سلسلة

        رسالة الخطأ التي تصف المشكلة

      • messageId

        سلسلة اختيارية

        معرّف الرسالة التي تتضمّن هذا الخطأ، إذا كان الخطأ مرتبطًا برسالة معيّنة