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


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

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

لمزيد من المعلومات حول طرق استخدام ميزة "الإعداد عن بُعد"، يُرجى الاطّلاع على ما أهمية "الإعداد عن بُعد" بالنسبة إليك؟

في هذا الدليل، سوف:

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

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

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

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

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

نظرًا لأن الاتصال بخادم العميل يتم عبر HTTP، فإنه لا يتطلب أي التي يمكن استخدامها لاحقًا في المكتبات الأخرى.

الاستماع إلى آخر الأخبار

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

للاستماع إلى آخر المعلومات، يُرجى الاتصال addOnConfigUpdateListener، تنفيذ استدعاء يتم استدعاءه عندما يتم تحديث الإعداد عن بُعد المتوفرة في التطبيق. وراء الكواليس، تبدأ هذه المكالمة في الاستماع إلى آخر الأخبار من خادم "الإعداد عن بُعد". لمزيد من المعلومات عن خادم العميل علاقة، انظر القسم السابق.

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

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

عند الاتصال addOnConfigUpdateListener، فيمكنك انتظار التغيير وتفعيله.

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

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

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

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

من حين لآخر، تظهر عملية جلب (إما يتم بدؤها عند استدعاء طريقة fetch أو من خلال في الوقت الفعلي عن بُعد) لا تؤدي إلى تحديث للبرنامج. ضِمن هذه الحالات، onUpdate أو إتمام العملية.

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

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

يعرض المكالمة "تسجيل المستمع"، والتي لها طريقة تسمى remove.

لإيقاف الاستماع، خزِّن المرجع الخاص بتسجيل المستمعين. اتصل remove للتوقّف عن الاستماع عند هذا التسجيل. إذا كان هو الناشر الوحيد المستمع، يؤدي استدعاء remove إلى إغلاق الاتصال في الوقت الفعلي بالخادم.

وعلى الرغم من أنه يمكنك إيقاف الاستماع يدويًا إلى التحديثات، إلا أنه غالبًا لا اللازمة. تتوقّف ميزة "الإعداد عن بُعد في الوقت الفعلي" عن الاستماع تلقائيًا. للحصول على تحديثات عندما يدخل التطبيق في الخلفية ويعيد تشغيله عندما يكون التي يتم تشغيلها في المقدمة.

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

يمكنك الاطّلاع على مقالة بدء استخدام ميزة "الإعداد عن بُعد في Firebase" لضبط هذه الميزة وبدء الاستماع إلى التعديلات في الوقت الفعلي.