التعرّف على ميزة "الإعداد عن بُعد في الوقت الفعلي"

اختيار النظام الأساسي: iOS+ Android Web Flutter Unity C++

تتيح لك ميزة "الإعداد عن بُعد في الوقت الفعلي" تلقّي مفاتيح المَعلمات والقيم المعدَّلة فور نشرها على الخادم.Remote Config يتيح لك ذلك تعديل أي نوع من سمات التطبيق بسرعة، والتي يتم التحكّم فيها باستخدام قيمة مَعلمة Remote Config. باستخدام تعديلات Remote Config في الوقت الفعلي، يمكنك إجراء ما يلي:

  • تقليل المخاطر من خلال طرح الميزات بشكل تدريجي للمستخدمين المستهدَفين، وإجراء عملية استرجاع طارئة إذا لزم الأمر
  • زيادة تفاعل المستخدمين من خلال تخصيص تجاربهم بسرعة أثناء استخدامهم التطبيق. على سبيل المثال، يمكنك تعديل البنرات وتقديم حوافز لـ المستخدمين الذين يطابقون خصائص مستخدمين معيّنة Google Analyticsأو تعديل صعوبة اللعبة ديناميكيًا لمجموعات اللاعبين.
  • تقليل تبعيات الإصدار وزيادة إنتاجية المطوّرين: استخدِم Remote Config مَعلمات كعلامات ميزات لعرض الوظائف لفريقَي التطوير والاختبار، مع إبقائها مخفية عن المستخدمين في مرحلة الإنتاج

لمزيد من المعلومات عن الطرق التي يمكنك من خلالها استخدام Remote Config، اطّلِع على مقالة ما الذي يمكنك فعله باستخدام Remote Config؟

في هذا الدليل، ستتعرّف على ما يلي:

  • مزيد من المعلومات عن العلاقة بين العميل والخادم التي تتيح التعديلات في الوقت الفعلي
  • كيفية عمل وظيفة الوقت الفعلي في حزمة تطوير البرامج (SDK)
  • كيفية استخدام التعديلات في الوقت الفعلي للحفاظ على إعداد تطبيقك محدّثًا

الاتصال بين العميل والخادم في الوقت الفعلي

عند تنفيذ ميزة "Remote Config" في تطبيقك، يمكنك إنشاء مستمع في الوقت الفعلي يفتح اتصال HTTP بخادم "Remote Config " الخلفي. يتضمّن الطلب إصدار الإعداد المخزَّن مؤقتًا على الجهاز. يستخدم خادم "الإعداد عن بُعد في الوقت الفعلي" Remote Config رسالة إبطال لإعلام التطبيق عندما يجب استرجاع إصدار أحدث من إعداد من جهة الخادم.

إذا كان الخادم يتضمّن إصدارًا أحدث، سيرسل إشارة الإبطال على الفور. إذا لم يكن يتضمّن إصدارًا أحدث، سيُبقي الاتصال مفتوحًا وينتظر إلى أن يتم نشر إصدار على الخادم. عندما تتلقّى حزمة تطوير البرامج (SDK) للعميل إشارة إبطال، فإنّها تسترجعها تلقائيًا، ثم تستدعي معاودة الاتصال بالمستمع التي تم تسجيلها عند فتح اتصال المستمع. يشبه هذا الاسترجاع طلب الاسترجاع الذي يمكنك إجراؤه باستخدام حزمة تطوير البرامج (SDK)، ولكنّه يتجاوز أي إعدادات للتخزين المؤقت أو minimumFetchInterval. يتم الحفاظ على الاتصال بين العميل والخادم أثناء عمل التطبيق في المقدّمة.

سير عمل "الإعداد عن بُعد" في الوقت الفعلي بين العميل والخادم
سير العمل بين العميل والخادم في ميزة "Remote Configالإعداد عن بُعد في الوقت الفعلي"

بما أنّ الاتصال بين العميل والخادم يتم عبر HTTP، لا يتطلّب ذلك أي تبعيات على مكتبات أخرى.

الاستماع إلى التعديلات

تكمّل التعديلات في الوقت الفعلي طلبات Remote Config fetch. ننصحك باستدعاء `fetch` عند بدء تشغيل تطبيقك (أو في وقت ما خلال دورة حياة تطبيقك) والاستماع إلى تعديلات Remote Config أثناء جلسة المستخدم لضمان حصولك على أحدث القيم فور نشرها على الخادم.

للاستماع إلى التعديلات، استدعِ onConfigUpdate، مع تنفيذ معاودة اتصال يتم استدعاؤها كلما كان هناك تعديل في Remote Config متاحًا في التطبيق. وراء الكواليس، يبدأ هذا الاستدعاء في الاستماع إلى التعديلات من خادم Remote Config. لمزيد من المعلومات عن العلاقة بين العميل والخادم ، اطّلِع على القسم السابق.

غالبًا ما تكون معاودة الاتصال مكانًا جيدًا لاستخدام activate لإتاحة مَعلمات الإعداد المعدَّلة لتطبيقك. اطّلِع على مقالة Firebase Remote Config Loading Strategies للاطّلاع على استراتيجيات إضافية لتفعيل قيم المَعلمات عند استخدام ميزة "الإعداد عن بُعد في الوقت الفعلي" Remote Config.

تفعيل قيم المَعلمات بشكل انتقائي

عند استدعاء onConfigUpdate، يمكنك انتظار التغيير وتفعيله.

يتم استدعاء معاودة الاتصال next عندما يتم تلقائيًا استرجاع إصدار جديد من النموذج وعندما يتضمّن هذا الإصدار الجديد تغييرات في قيم المَعلمات النشطة في التطبيق.

يتم استدعاء معاودات الاتصال هذه باستخدام مَعلمة configUpdate. تحتوي configUpdate على updated_keys، وهي مجموعة من مفاتيح المَعلمات التي تم تغييرها والتي بدأت التعديل في الوقت الفعلي وتتضمّن ما يلي:

  • مفاتيح المَعلمات التي تمت إضافتها أو إزالتها
  • مفاتيح المَعلمات التي تغيّرت قيمها
  • مفاتيح المَعلمات التي تغيّرت بياناتها الوصفية (على سبيل المثال، Remote Config معلومات تخصيص)
  • مفاتيح المَعلمات التي تغيّر مصدر قيمتها (على سبيل المثال، قيمة تلقائية داخل التطبيق يتم تعديلها إلى قيمة من جهة الخادم)

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

في بعض الأحيان، لا يؤدي الاسترجاع (سواء تم بدؤه عند استدعاء طريقة fetch أو من خلال ميزة "الإعداد عن بُعد في الوقت الفعلي" Remote Config) إلى تعديل للعميل. في هذه الحالات، لن يتم استدعاء طريقة next أو إكمالها.

إضافة المستمعين وإزالتهم

onConfigUpdate هي نقطة الدخول الرئيسية لميزة "Remote Config" في الوقت الفعلي. يؤدي استدعاء هذا المستمع لأول مرة في دورة حياة تطبيقك إلى فتح الاتصال بالخادم الخلفي. تُعيد الاستدعاءات اللاحقة استخدام الاتصال نفسه، مع إرسال رسالة الإبطال الموصوفة في الاتصال بين العميل والخادم في الوقت الفعلي.

يعرض الاستدعاء "تسجيل مستمع"، والذي يتضمّن طريقة تُسمى Unsubscribe. لإيقاف الاستماع إلى التعديلات، استدعِ دالة Unsubscribe التي تم عرضها عند تسجيل المراقب في البداية. إذا كان هذا هو المستمع النشط الوحيد، سيؤدي استدعاء Unsubscribe إلى إغلاق الاتصال في الوقت الفعلي بالخادم.

على الرغم من إمكانية إيقاف الاستماع إلى التعديلات يدويًا، فإنّ ذلك ليس ضروريًا في أغلب الأحيان. تتوقف ميزة "في الوقت الفعلي" Remote Config تلقائيًا عن الاستماع إلى التعديلات عندما ينتقل التطبيق إلى الخلفية وتُعيد الاستماع عندما يكون التطبيق في المقدّمة.

الخطوات التالية

اطّلِع على مقالة البدء في استخدام Firebase Remote Config لضبط Remote Config والبدء في الاستماع إلى التعديلات في الوقت الفعلي.