इस लेख में हम बात करेंगे कि अपने ऐप में GameCenter के लीडरबोर्ड को क्यों और कैसे लागू करें।
GameCenter एक बड़ी वापसी क्यों कर रहा है
आप स्कोरबोर्ड के बिना iPhone गेम बना सकते हैं, लेकिन लीडरबोर्ड गेम को अधिक प्रतिस्पर्धी महसूस कराने में मदद कर सकते हैं, जैसे दुनिया भर के लोग एक-दूसरे के खिलाफ प्रतिस्पर्धा कर रहे हों।
अपना खुद का बैकएंड बनाने और प्रबंधित करने के बजाय, GameCenter लीडरबोर्ड आपको ट्रैफिक के साथ अनंत रूप से स्केल करने, प्राधिकरण के लिए एक पूरे लॉगिन पेज को छोड़ने, छवि, नाम और वही गेम खेलने वाले दोस्तों को प्राप्त करने की अनुमति देता है — आपके उपयोगकर्ताओं को कुछ भी दर्ज किए बिना।
विशेष रूप से iOS 16 के साथ, Apple इसमें सुधार करने में अधिक निवेश कर रहा है, और पुश नोटिफिकेशन के माध्यम से अधिक ऐप उपयोग बढ़ा रहा है, जैसे जब आपका दोस्त गेम में आपका स्कोर हराता है।
SwiftUI सीखने की मेरी यात्रा में, मैं ऐप्स बना और प्रकाशित कर रहा हूं, क्योंकि मेरा मानना है कि सीखने का यह सबसे अच्छा तरीका है।
इसको कैसे करें, विशेष रूप से SwiftUI के साथ और Swift में async/await के आगमन के साथ, इस पर ज्यादा अपडेटेड डॉक्यूमेंटेशन नहीं था। इसलिए मैंने सभी के लिए अद्भुत ऐप्स बनाने के लिए इसे समेकित और सरल बनाया। इसलिए बेझिझक मुझे अपने ऐप्स टेस्ट करने के लिए आमंत्रित करें!
पूर्व-आवश्यकताएं:
- आपको एक पेड Apple Developer अकाउंट की आवश्यकता होगी
- Apple Developer Portal के प्रोविजनिंग प्रोफाइल सेक्शन में अपने ऐप के लिए App ID बनाना होगा
- iTunes Connect पोर्टल में ऐप बनाना होगा
6 चरणों में अपने iOS लीडरबोर्ड को कैसे लागू करें
लीडरबोर्ड के लिए अधिकांश कोड लॉजिक इस फ़ाइल में है यदि आप आगे छोड़ना चाहते हैं। यहां चरण निम्नानुसार हैं:
1. App Store Connect लीडरबोर्ड कैसे बनाएं
एक बार जब आप App Store Connect पोर्टल में ऐप सफलतापूर्वक बना लेते हैं, तो ऐप के लिए Services टैब पर जाएं -> और सुनिश्चित करें कि आप GameCenter पेज पर हैं।
फिर "+" चिह्न का उपयोग करके एक नया लीडरबोर्ड जोड़ें, जो या तो "क्लासिक" (स्कोर कभी रीसेट नहीं होते) या "आवर्ती" (आपकी फ्रीक्वेंसी सेटिंग्स के आधार पर स्कोर रीसेट होते हैं) हो सकता है।
अधिकांश गेम एक आवर्ती लीडरबोर्ड पसंद करते हैं ताकि लीडरबोर्ड पुराने असंभव उच्च स्कोर से अव्यवस्थित न हो।
वहां दर्ज किया गया LeaderboardID वही है जिसे आपको कोड में उन सभी स्थानों पर उपयोग करने की आवश्यकता है जो इसके लिए पूछते हैं।
2. GameCenter प्रमाणीकरण कैसे सेट करें
सबसे पहले, किसी भी कार्यक्षमता के काम करने के लिए उपयोगकर्ताओं को GameCenter में प्रमाणित करने की आवश्यकता होगी।
तो हम इसके लिए इस कोड का उपयोग करेंगे, जो मूल रूप से सुनिश्चित करता है कि आप (GKLocalPlayer.local) प्रमाणित हैं, या त्रुटि होने पर उसे प्रिंट करता है:
func authenticateUser() {
GKLocalPlayer.local.authenticateHandler = { vc, error in
guard error == nil else {
print(error?.localizedDescription ?? "")
return
}
}
}
यदि उपयोगकर्ता प्रमाणित है, तो आप UI में एक छोटा पॉपअप देखेंगे। यदि नहीं, तो उपयोगकर्ता को अपने GameCenter अकाउंट में लॉगिन करने के लिए एक पेज पर ले जाया जाएगा।
3. UI में लीडरबोर्ड आइटम कैसे प्रदर्शित करें
GameCenter ViewController लीडरबोर्ड (GKLeaderboard) से डेटा प्राप्त करने के लिए, आपको loadLeaderboards का उपयोग करने की आवश्यकता है।
आप loadEntries फ़ंक्शन को .global से .friends में बदल सकते हैं ताकि केवल अपने दोस्तों को खींचा जा सके।
आप प्रत्येक प्लेयर पर पुनरावृति करके और loadPhoto करके प्रत्येक प्लेयर की छवि भी प्राप्त कर सकते हैं।
NSRange(1...5) का उपयोग करके, आप चुन सकते हैं कि कितने प्लेयर प्रदर्शित करने हैं। यह लीडरबोर्ड से उच्चतम 5 स्कोर वाले उपयोगकर्ताओं को खींचता है और कोई नहीं लौटाता यदि कोई उपयोगकर्ता नहीं हैं, जैसे कि जब एक आवर्ती लीडरबोर्ड के लिए चक्र रीफ्रेश होता है।
यदि आप async-await का लाभ उठाते हैं तो लीडरबोर्ड से डेटा खींचना ऐसा दिख सकता है:
func loadLeaderboard() async {
playersList.removeAll()
Task {
var playersListTemp: [Player] = []
let leaderboards = try await GKLeaderboard.loadLeaderboards(IDs: [leaderboardIdentifier])
if let leaderboard = leaderboards.filter({ $0.baseLeaderboardID == self.leaderboardIdentifier }).first {
let allPlayers = try await leaderboard.loadEntries(for: .global, timeScope: .allTime, range: NSRange(1...5))
if allPlayers.1.count > 0 {
try await allPlayers.1.asyncForEach { leaderboardEntry in
var image = try await leaderboardEntry.player.loadPhoto(for: .small)
playersListTemp.append(Player(name: leaderboardEntry.player.displayName, score: leaderboardEntry.formattedScore, image: image))
print(playersListTemp)
playersListTemp.sort { $0.score < $1.score }
}
}
}
playersList = playersListTemp
}
}
4. SwiftUI में व्यू/पेज प्रकट होने पर कार्यक्षमता कैसे कॉल करें
आप वास्तव में प्रमाणित करने और लोड करने के लिए कॉल करने के लिए व्यू के onAppear लाइफसाइकिल फ़ंक्शन का लाभ उठा सकते हैं, लेकिन यदि आप पसंद करते हैं तो आप इसे बटन के टैप पर भी कर सकते हैं:
.onAppear() {
if !GKLocalPlayer.local.isAuthenticated {
authenticateUser()
} else if playersList.count == 0 {
Task {
await loadLeaderboard()
}
}
}
5. सबमिट किए गए स्कोर कैसे लोड करें
स्कोर लोड करने के लिए, आपको उन्हें सबमिट भी करना होगा। submitScore फ़ंक्शन इसमें आपकी मदद कर सकता है।
flightsClimbedवेरिएबल में वह स्कोर होना चाहिए जिसे आप सबमिट करना चाहते हैं।- GameKit लीडरबोर्ड के जीवन के लिए केवल आपका सर्वश्रेष्ठ स्कोर प्रदर्शित करना सुनिश्चित करता है।
leaderboardIdमें वह मान होता है जिसे आप मैन्युअल रूप से अपने App Store Connect अकाउंट में दर्ज करते हैं:
func leaderboard() async {
Task {
try await GKLeaderboard.submitScore(
flightsClimbed,
context: 0,
player: GKLocalPlayer.local,
leaderboardIDs: ["com.tfp.stairsteppermaster.flights"]
)
}
calculateAchievements()
}
6. GameCenter ViewController पोर्टल कैसे प्रदर्शित करें
जब आप GameCenter में लॉग इन होते हैं, तो आपकी स्क्रीन के ऊपरी दाएं कोने में एक छोटा कष्टप्रद आइकन दिखाई देता है। जब आप उस पर टैप करते हैं, तो आप GameCenter ViewController पर चले जाते हैं। सौभाग्य से आप इसे छिपा सकते हैं यदि यह आपके डिज़ाइन का हिस्सा नहीं है, GKAccessPoint.shared.isActive = false का उपयोग करके।
चूंकि GameCenter UI एक UIKit ViewController है न कि एक साधारण SwiftUI View, आपको पहले यह UIViewControllerRepresentable बनाना होगा (जैसा कि आप यहां देख सकते हैं), GameCenter को एक अलग बटन का उपयोग करके लॉन्च करने के लिए,
एक बार जब आप उस फ़ाइल को अपने प्रोजेक्ट में जोड़ लेते हैं, तो आप केवल इसका उपयोग करके GameCenter पोर्टल प्रदर्शित कर सकते हैं: GameCenterView(format: gameCenterViewControllerState) जहां gameCenterViewControllerState आपको GameCenter में एक डिटेल पेज पर जाने में मदद कर सकता है।
GameCenter के लीडरबोर्ड का उपयोग करते समय ध्यान रखने योग्य बातें:
- सिम्युलेटर डीबगिंग - किसी कारण से GameCenter पर प्रमाणीकरण सिम्युलेटर पर बेहद धीमा है, इसलिए सिम्युलेटर का उपयोग करते समय डेटा का मॉक बनाना भी समझदारी हो सकती है।
- चुनौतियां - आप अपने दोस्तों को प्रोग्रामेटिकली GameKit चुनौतियां जारी नहीं कर सकते क्योंकि यह डिप्रिकेटेड है। इसके बजाय, आपको अपने GameCenter डैशबोर्ड में GameKit उपलब्धियों के खिलाफ मैन्युअल रूप से ऐसा करना होगा। साथ ही, आपके द्वारा भेजी गई चुनौतियों को देखने का कोई तरीका नहीं है।
- उपलब्धियां - लीडरबोर्ड GameKit उपलब्धियों से अलग हैं, जिनकी गणना और प्रदर्शन अलग तरीके से किया जाता है, लेकिन बहुत आसान है। इन्हें भी ऐप में खींचा जा सकता है, जैसा कि आप नीचे देख सकते हैं:
समापन
आप ऊपर साझा किए गए फ्री ओपन-सोर्स Stair Master Climber iPhone Health & Fitness ऐप को आजमा सकते हैं। मुझे यह जानना अच्छा लगेगा कि आप क्या सोचते हैं ताकि हम एक साथ सीख सकें।
यदि आपके कोई प्रश्न हैं तो बेझिझक सोशल मीडिया या ईमेल द्वारा मुझसे संपर्क करें।