अवधारणाएं

खिलाड़ी यह निर्णय करते हैं कि क्या आपका एप उन्हें सूचित कर सकता है। आपके सर्वर एक सीमा के भीतर प्रत्येक सूचना भेजता है, जो Lia निर्धारित करता है ताकि जो लोग हां कहते हैं, वे अच्छा महसूस करें।

#कैसे वे काम करते हैं

1. व्यक्ति उन्हें अनुमति देता हैआपका पृष्ठ कॉल करता है Lia.requestNotifications() एक अच्छे मौके पर, और Lia अपनी अलग शीट में पूछता है। लोग अपन एप के अधिसूचनाएं चालू या बंद कर सकते हैं।
2. आपके सर्वर एक भेजता हैPOST /notifications खिलाड़ी के आईडी, टेक्स्ट और एक वैकल्पिक के साथ startParam.
3. इसे उनके फोन पर पहुंचाता हैअपने एप्प के नाम के नीचे, एक पुश और Lia के घंटी में। इसे टैप करने से आपका एप्प खुलता है जब आप अपने startParam.

#पूछता है

जब एक सूचना व्यक्ति के लिए स्पष्ट रूप से मदद करती है: उनका खेल में बर्ताव, डिलीवरी, एक दोस्त के शामिल होने के बारे में। नहीं't अपने एप्प खोलते ही प्रश्न करें।

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 जब यह केवल घंटी तक पहुंचा।

स्वचालित अनुवाद। अंग्रेजी सत्य का स्रोत है। अंग्रेजी में पढ़ें