दोस्तों को बुलाएँ: कोड, लिंक और इनाम

खिलाड़ी क्या देखता है

• "कॉपी" और "लिंक शेयर करें" (सिस्टम की शेयर शीट या क्लिपबोर्ड) के साथ खिलाड़ी का अपना छोटा कोड।
• कोड से कितने दोस्त आए और उनके लिए इनाम की सीढ़ी, एक या सब लें।
• दोस्त का कोड डालना: नए खिलाड़ी का गिफ़्ट दिखाता है और उसे एक बार देता है।
• इनवाइट लिंक से साइन-इन करते समय जुड़े खिलाड़ी के लिए "आप दोस्त के कोड से जुड़े"।
• "अभी शर्तें पूरी कर रहे हैं": ऐसे दोस्त जिन्होंने कोड डाला, पर अभी गेम की शर्तें पूरी नहीं कीं। जिस नए खिलाड़ी की शर्तें बाकी हैं, उसे बाकी शर्तें और जाँचें बटन दिखता है।

यह कैसे काम करता है

• स्क्रीन खुलने पर सर्वर कोड बनाता है; 8 अक्षर, विभाजक और अक्षरों का छोटा-बड़ा होना अनदेखा होता है।
• इनवाइट लिंक से आया नया खिलाड़ी साइन-इन पर अपने आप बुलाने वाले से जुड़ जाता है।
• इनवाइट बंद होने तक स्क्रीन यही बताती है और कोई अनुरोध नहीं भेजती।
• अगर आप आमंत्रण गिने जाने की शर्तें तय करते हैं, तो दोस्त तभी गिना जाता है जब वह उन्हें पूरा करे। तब तक सब कुछ रुका रहता है: आमंत्रित करने वाले का +1 और लीडरबोर्ड अंक, इनाम की सीढ़ी, नए खिलाड़ी का उपहार और दोस्त के खर्च का हिस्सा। कोई समय सीमा नहीं है।
• शर्तें तब जाँची जाती हैं जब दोस्त साइन इन करे, आमंत्रण स्क्रीन खोले, टोकन जमा करे या जाँचें दबाए।

डेवलपर के लिए

इनवाइट @idosgames/core में client.referral से काम करते हैं।

// खिलाड़ी का कोड और इनवाइट स्थिति, फिर नए खिलाड़ी से दोस्त का कोड
await client.referral.getUserState()
const res = await client.referral.activateReferralCode('KD7QPX2M') // पूरा लिंक भी चलता है
if (!res.ok) return showError(res.error)
await client.referral.claimInviteRewardsBatch(['friends_1', 'friends_3'])

• activateReferralCode सिर्फ़ कोड भी लेता है और खिलाड़ी का चिपकाया पूरा लिंक भी।
• तैयार सभी इनाम claimInviteRewardsBatch से एक साथ लें।
• जब तक दोस्त प्रतीक्षा में है, getUserState() QualificationPending और बाकी शर्तें Qualification में लौटाता है; client.referral.checkQualification() तुरंत जाँचता है। साइन इन के बाद SDK खुद जाँचता है, केवल प्रतीक्षा कर रहे खिलाड़ी के लिए।

हर फ़ील्ड referral-system स्किल में बताई गई है, जिसे SDK का MCP सर्वर देता है।