गेम सेंटर का उपयोग करके प्रमाणित करें

आप Firebase पर निर्मित Apple प्लेटफ़ॉर्म गेम में खिलाड़ियों को साइन इन करने के लिए Game Center का उपयोग कर सकते हैं। फायरबेस के साथ गेम सेंटर साइन-इन का उपयोग करने के लिए, पहले सुनिश्चित करें कि स्थानीय खिलाड़ी गेम सेंटर के साथ साइन इन है, और फिर फायरबेस क्रेडेंशियल उत्पन्न करने के लिए GameCenterAuthProvider ऑब्जेक्ट का उपयोग करें, जिसका उपयोग आप फायरबेस के साथ प्रमाणित करने के लिए कर सकते हैं।

शुरू करने से पहले

फायरबेस निर्भरताओं को स्थापित और प्रबंधित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।

1. Xcode में, अपने ऐप प्रोजेक्ट को खोलने के साथ, File > Add Packages पर नेविगेट करें।
2. संकेत दिए जाने पर, Firebase Apple प्लेटफ़ॉर्म SDK रिपॉजिटरी जोड़ें:

  https://github.com/firebase/firebase-ios-sdk

3. फायरबेस ऑथेंटिकेशन लाइब्रेरी चुनें।
4. समाप्त होने पर, Xcode स्वचालित रूप से पृष्ठभूमि में आपकी निर्भरताओं को हल करना और डाउनलोड करना शुरू कर देगा।

अगला, कुछ कॉन्फ़िगरेशन चरण करें:

1. सुनिश्चित करें कि आपने अपने Apple ऐप को Firebase के साथ पंजीकृत कर लिया है। इसका अर्थ है पंजीकरण अनुभाग में अतिरिक्त वैकल्पिक जानकारी जैसे ऐप स्टोर आईडी और टीम आईडी आदि के साथ अपने ऐप की बंडल आईडी दर्ज करना। साइन-इन पूरा करने से पहले उपयोगकर्ता के गेम सेंटर क्रेडेंशियल के दर्शकों को सुरक्षित रूप से सत्यापित करने के लिए इसकी आवश्यकता होगी।
2. अपने फायरबेस प्रोजेक्ट के लिए साइन-इन प्रदाता के रूप में गेम सेंटर को सक्षम करें:
   1. फायरबेस कंसोल में, प्रमाणीकरण अनुभाग खोलें।
   2. साइन इन विधि टैब पर, गेम सेंटर साइन-इन प्रदाता को सक्षम करें।

गेम सेंटर साइन-इन को अपने गेम में एकीकृत करें

सबसे पहले, यदि आपका गेम पहले से गेम सेंटर का उपयोग नहीं करता है, तो ऐप्पल डेवलपर साइट पर अपने गेम में गेम सेंटर को शामिल करने और डिवाइस पर स्थानीय प्लेयर को प्रमाणित करने के निर्देशों का पालन करें।

सुनिश्चित करें कि आपके द्वारा iTunes Connect को प्रदान की जाने वाली बंडल आईडी उस बंडल आईडी से मेल खाती है जिसका उपयोग आपने अपने ऐप को अपने Firebase प्रोजेक्ट से कनेक्ट करते समय किया था।

आपके गेम सेंटर एकीकरण के हिस्से के रूप में, आप एक प्रमाणीकरण हैंडलर को परिभाषित करते हैं जिसे गेम सेंटर प्रमाणीकरण प्रक्रिया में एकाधिक बिंदुओं पर बुलाया जाता है। इस हैंडलर में, जांचें कि खिलाड़ी गेम सेंटर के साथ साइन इन है या नहीं। अगर ऐसा है, तो आप Firebase में साइन इन करना जारी रख सकते हैं।

let localPlayer = GKLocalPlayer.localPlayer()
localPlayer.authenticateHandler = { (gcAuthViewController?, error) in
  if let gcAuthViewController = gcAuthViewController {
    // Pause any activities that require user interaction, then present the
    // gcAuthViewController to the player.
  } else if localPlayer.isAuthenticated {
    // Player is signed in to Game Center. Get Firebase credentials from the
    // player's Game Center credentials (see below).
  } else {
    // Error
  }
}

__weak GKLocalPlayer *localPlayer = [GKLocalPlayer localPlayer];
localPlayer.authenticateHandler = ^(UIViewController *gcAuthViewController,
                                    NSError *error) {
  if (gcAuthViewController != nil) {
    // Pause any activities that require user interaction, then present the
    // gcAuthViewController to the player.
  } else if (localPlayer.isAuthenticated) {
    // Player is signed in to Game Center. Get Firebase credentials from the
    // player's Game Center credentials (see below).
  } else {
    // Error
  }
};

फायरबेस के साथ प्रमाणित करें

यह निर्धारित करने के बाद कि स्थानीय खिलाड़ी ने गेम सेंटर के साथ साइन इन किया है, GameCenterAuthProvider.getCredential() के साथ एक AuthCredential ऑब्जेक्ट बनाकर खिलाड़ी को अपने गेम में साइन इन करें और उस ऑब्जेक्ट को signIn(with:) :

// Get Firebase credentials from the player's Game Center credentials
GameCenterAuthProvider.getCredential() { (credential, error) in
  if let error = error {
    return
  }
  // The credential can be used to sign in, or re-auth, or link or unlink.
  Auth.auth().signIn(with:credential) { (user, error) in
    if let error = error {
      return
    }
    // Player is signed in!
  }

// Get Firebase credentials from the player's Game Center credentials
[FIRGameCenterAuthProvider getCredentialWithCompletion:^(FIRAuthCredential *credential,
                                                         NSError *error) {
  // The credential can be used to sign in, or re-auth, or link or unlink.
  if (error == nil) {
    [[FIRAuth auth] signInWithCredential:credential
                              completion:^(FIRUser *user, NSError *error) {
      // If error is nil, player is signed in.
    }];
  }
}];

अगले कदम

उपयोगकर्ता द्वारा पहली बार साइन इन करने के बाद, एक नया उपयोगकर्ता खाता बनाया जाता है और उनके गेम सेंटर आईडी से लिंक किया जाता है। यह नया खाता आपके फायरबेस प्रोजेक्ट के हिस्से के रूप में संग्रहीत है, और इसका उपयोग आपके प्रोजेक्ट में प्रत्येक ऐप में उपयोगकर्ता की पहचान करने के लिए किया जा सकता है।

अपने गेम में, आप User ऑब्जेक्ट से उपयोगकर्ता का Firebase UID प्राप्त कर सकते हैं:

let user = Auth.auth().currentUser
if let user = user {
  let playerName = user.displayName

  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getToken(with:) instead.
  let uid = user.uid
}

FIRUser *user = [FIRAuth auth].currentUser;
if (user) {
  NSString *playerName = user.displayName;

  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use getTokenWithCompletion:completion: instead.
  NSString *uid = user.uid;
}

आपके फायरबेस रीयलटाइम डेटाबेस और क्लाउड स्टोरेज सुरक्षा नियमों में, आप auth चर से साइन-इन किए गए उपयोगकर्ता की विशिष्ट उपयोगकर्ता आईडी प्राप्त कर सकते हैं, और इसका उपयोग यह नियंत्रित करने के लिए कर सकते हैं कि उपयोगकर्ता किस डेटा तक पहुंच सकता है।

उपयोगकर्ता की गेम सेंटर प्लेयर जानकारी प्राप्त करने या गेम सेंटर सेवाओं तक पहुंचने के लिए, गेम किट द्वारा प्रदान की गई एपीआई का उपयोग करें।

किसी उपयोगकर्ता को Firebase से साइन आउट करने के लिए, Auth.signOut() पर कॉल करें:

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print ("Error signing out: %@", signOutError)
}

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}