Computer >> कंप्यूटर ट्यूटोरियल >  >> स्मार्टफोन्स >> iPhone

SwiftUI में GameCenter लीडरबोर्ड इंटीग्रेट करें: निर्बाध वैश्विक प्रतियोगिता के लिए

इस लेख में हम बात करेंगे कि अपने ऐप में 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 लीडरबोर्ड कैसे बनाएं

SwiftUI में GameCenter लीडरबोर्ड इंटीग्रेट करें: निर्बाध वैश्विक प्रतियोगिता के लिए
Apple iTunes Connect पोर्टल से स्क्रीनशॉट

एक बार जब आप App Store Connect पोर्टल में ऐप सफलतापूर्वक बना लेते हैं, तो ऐप के लिए Services टैब पर जाएं -> और सुनिश्चित करें कि आप GameCenter पेज पर हैं।

फिर "+" चिह्न का उपयोग करके एक नया लीडरबोर्ड जोड़ें, जो या तो "क्लासिक" (स्कोर कभी रीसेट नहीं होते) या "आवर्ती" (आपकी फ्रीक्वेंसी सेटिंग्स के आधार पर स्कोर रीसेट होते हैं) हो सकता है।

अधिकांश गेम एक आवर्ती लीडरबोर्ड पसंद करते हैं ताकि लीडरबोर्ड पुराने असंभव उच्च स्कोर से अव्यवस्थित न हो।

वहां दर्ज किया गया LeaderboardID वही है जिसे आपको कोड में उन सभी स्थानों पर उपयोग करने की आवश्यकता है जो इसके लिए पूछते हैं।

SwiftUI में GameCenter लीडरबोर्ड इंटीग्रेट करें: निर्बाध वैश्विक प्रतियोगिता के लिए
नया लीडरबोर्ड बनाने के लिए आवश्यक विवरण

2. GameCenter प्रमाणीकरण कैसे सेट करें

सबसे पहले, किसी भी कार्यक्षमता के काम करने के लिए उपयोगकर्ताओं को GameCenter में प्रमाणित करने की आवश्यकता होगी।

तो हम इसके लिए इस कोड का उपयोग करेंगे, जो मूल रूप से सुनिश्चित करता है कि आप (GKLocalPlayer.local) प्रमाणित हैं, या त्रुटि होने पर उसे प्रिंट करता है:

func authenticateUser() {
    GKLocalPlayer.local.authenticateHandler = { vc, error in
        guard error == nil else {
            print(error?.localizedDescription ?? "")
            return
        }
    }
}

यदि उपयोगकर्ता प्रमाणित है, तो आप UI में एक छोटा पॉपअप देखेंगे। यदि नहीं, तो उपयोगकर्ता को अपने GameCenter अकाउंट में लॉगिन करने के लिए एक पेज पर ले जाया जाएगा।

SwiftUI में 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
    }
}
SwiftUI में GameCenter लीडरबोर्ड इंटीग्रेट करें: निर्बाध वैश्विक प्रतियोगिता के लिए
आप लीडरबोर्ड डेटा को अपने ऐप में प्राप्त कर सकते हैं

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 में एक डिटेल पेज पर जाने में मदद कर सकता है।

SwiftUI में GameCenter लीडरबोर्ड इंटीग्रेट करें: निर्बाध वैश्विक प्रतियोगिता के लिए
GameCenter का लीडरबोर्ड व्यू

GameCenter के लीडरबोर्ड का उपयोग करते समय ध्यान रखने योग्य बातें:

  • सिम्युलेटर डीबगिंग - किसी कारण से GameCenter पर प्रमाणीकरण सिम्युलेटर पर बेहद धीमा है, इसलिए सिम्युलेटर का उपयोग करते समय डेटा का मॉक बनाना भी समझदारी हो सकती है।
  • चुनौतियां - आप अपने दोस्तों को प्रोग्रामेटिकली GameKit चुनौतियां जारी नहीं कर सकते क्योंकि यह डिप्रिकेटेड है। इसके बजाय, आपको अपने GameCenter डैशबोर्ड में GameKit उपलब्धियों के खिलाफ मैन्युअल रूप से ऐसा करना होगा। साथ ही, आपके द्वारा भेजी गई चुनौतियों को देखने का कोई तरीका नहीं है।
  • उपलब्धियां - लीडरबोर्ड GameKit उपलब्धियों से अलग हैं, जिनकी गणना और प्रदर्शन अलग तरीके से किया जाता है, लेकिन बहुत आसान है। इन्हें भी ऐप में खींचा जा सकता है, जैसा कि आप नीचे देख सकते हैं:
SwiftUI में GameCenter लीडरबोर्ड इंटीग्रेट करें: निर्बाध वैश्विक प्रतियोगिता के लिए
GameKit चुनौतियां और उपलब्धियां

समापन

आप ऊपर साझा किए गए फ्री ओपन-सोर्स Stair Master Climber iPhone Health & Fitness ऐप को आजमा सकते हैं। मुझे यह जानना अच्छा लगेगा कि आप क्या सोचते हैं ताकि हम एक साथ सीख सकें।

यदि आपके कोई प्रश्न हैं तो बेझिझक सोशल मीडिया या ईमेल द्वारा मुझसे संपर्क करें।

  1. iPhone पर ऐप सब्सक्रिप्शन को 3 सरल चरणों में आसानी से रद्द करें iPhone पर ऐप सब्सक्रिप्शन को 3 सरल चरणों में आसानी से रद्द करें

    ऐप स्टोर इन-ऐप खरीदारी से भरा हुआ है और हम आमतौर पर उन्हें आज़माने के लिए एप्लिकेशन के लिए साइन अप करते हैं। अगर आपने ऐप्स के लिए सब्सक्रिप्शन खरीदे हैं या फ्री ट्रायल के लिए साइन अप किया है और इसके लिए बिल नहीं करवाना चाहते, तो आपको ऐप सब्सक्रिप्शन को समाप्त होने से पहले रद्द करना होगा। नहीं जानते

  1. iMessage से ऐप आइकन आसानी से हटाएं: चरण-दर-चरण गाइड iMessage से ऐप आइकन आसानी से हटाएं: चरण-दर-चरण गाइड

    iOS 11 शानदार सुविधाओं से भरा है! यह अब तक का Apple का सबसे बड़ा सॉफ्टवेयर अपडेट है। हमें पूरा यकीन है कि आप अब तक अपने डिवाइस को Apple द्वारा हाल ही में जारी किए गए नवीनतम सॉफ्टवेयर संस्करण में अपग्रेड कर चुके होंगे। पुनर्निर्मित कंट्रोल सेंटर, नए डिजाइन किए गए ऐप स्टोर, उन्नत Siri समर्थन से, यह कु

  1. iOS 12 पर Messages में फोटो एक्सेस करना: चरण-दर-चरण गाइड iOS 12 पर Messages में फोटो एक्सेस करना: चरण-दर-चरण गाइड

    आप iOS 3 लॉन्च होने के बाद से Apple डिवाइस पर Messages के माध्यम से वीडियो और फोटो भेज सकते हैं। ऐसा करने के लिए आपको बस कैमरा आइकन पर टैप करना होगा और उन फोटो या वीडियो को चुनना होगा जिन्हें आप भेजना चाहते हैं। iOS 12 के साथ, चीजें बदल गई हैं। हालांकि, इसका मतलब यह नहीं है कि यह पूरी तरह से अक्षम ह