المفاهيم

يختار اللاعبون ما إذا كان تطبيقك يمكنه إعلامهم. ترسل خادمك كل إشعار، ضمن الحدود التي تحددها Lia حتى يشعر الأشخاص الذين وافقوا بالسعادة لأنهم فعلوا ذلك.

#كيف تعمل

1. الشخص يسمح لهمصفحتك تدعو Lia.requestNotifications() في لحظة جيدة، و Lia يسأل في ورقة خاصة به. يمكن للناس أيضًا تفعيل إشعارات تطبيقك أو إيقافها من قائمة ⋯ الخاصة به.
2. يُرسل خادمك واحدًاPOST /notifications مع معرّف اللاعب، النص وخيارات startParam.
3. يصل إلى هاتفهمتحت اسم تطبيقك، كإشعار وإشعار في جرس Lia. النقر عليه يفتح تطبيقك مع startParam.

#السؤال

اسأل عندما يكون الإشعار مفيدًا حقًا للشخص: دوره في اللعبة، التوصيل، صديق ينضم. لا'ت طلب اللحظة التي يفتح فيها تطبيقك.

if (!Lia.notificationsAllowed) {
  const { allowed } = await Lia.requestNotifications();
  if (allowed) tellYourServer(); // so it knows it may notify this player
}

• إذا سمحوا بهم بالفعل، requestNotifications() الإجابات { allowed: true } بدون طلب.
• إذا لم يُرسل تطبيقك إشعارات أبدًا (فريق Lia قام بإيقافها)، فسيفشل بـ notifications_off.
• Lia.notificationsAllowed تقول أين الأمور تقع، وال notificationsChanged يُطلق الحدث عندما يغير الشخص ذلك، من طلبك أو من قائمة ⋯.

Lia لم تتمكن'لإخبار خادمك عندما يسمح أو يتوقف أحد عن الإشعارات. أخبره بنفسك، أو فقط أرسل وتعامل not_allowed.

#إرسال

{ "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "text": "It's your move against @amara.", "startParam": "match-8k2d" }

انظر POST /notifications لكل مجال ورد.

#الحدود

الإشعارات هي ميزة يمنحها الناس تطبيقك، لذلك Lia يبقيها قليلة:

عند الوصول إلى حد، POST /notifications الإجابات 429 rate_limited. لتطبيقك'الحدود الخاصة بهم، كما تقول أيضًا متى يمكنك المحاولة مرة أخرى، كما retryAt (مللي ثانية منذ 1970).

"يوم" هو آخر 24 ساعات لتطبيقك'حدودها، والشخص'يوم التقويم الخاص بجميع التطبيقات.

#فتح تطبيقك من خلال واحد

إشعار يفتح تطبيقك معه startParam (من 1 إلى 64 من الحروف والأرقام، _ و -), والتي تقرأها صفحتك Lia.startParam. إذا كان تطبيقك مفتوحًا بالفعل عندما يضغط الشخص عليه، تسمع صفحتك startParam حدث بدلًا من ذلك.

function route(param) {
  if (param && param.startsWith("match-")) openMatch(param);
}
Lia.init().then(function () { route(Lia.startParam); Lia.ready(); });
Lia.on("startParam", function (data) { route(data.startParam); });

#الدفعات والجرس

كل إشعار يذهب إلى Lia'جرسه. إنه'س أيضًا تُرسل إلى الشخص'هاتفه عندما يكون لديه Lia'يتم تفعيل الطرد; POST /notifications الإجابات pushed: false عندما وصل فقط إلى الجرس.

تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية