2024-NC2-M16-Game-Center

 Authors

강희주(Rad)	김유빈(Nini)
🎨 디자인 🎨	🍎 테크 🍎

🎥 Youtube Link

https://youtu.be/DZWRW-y7d7Y?si=BJJ8Ft5C82tiEMWN

💡 About Game Center

🎯 What we focus on?

멀티 플레이어(친구), 순위표(리더보드), 목표 달성(업적)

💼 Use Case

맛집 탐방이라는 주제를 게이미피케이션을 적용한 빙고를 통해 서비스를 제공하며, 게임센터의 기능을 통해 서버를 대신하여 사용자간의 경쟁과 재참여를 유도한다.

🖼️ Prototype

   

🕹️ Demo Video

prototype.mp4

🛠️ About Code

1️⃣ GameKit을 사용하여 현재 디바이스의 게임 센터 플레이어 인증

-> 인증되지 않은 경우, 게임 센터 로그인 화면을 표시하여 플레이어가 로그인할 수 있도록 해줌

import GameKit

// 로컬 플레이어 인증 메서드
    func authenticateLocalPlayer() {
        // 이미 인증 중이면 중복 실행 방지
        guard !authenticating else { return }
        authenticating = true

        // 인증 핸들러 설정
        GKLocalPlayer.local.authenticateHandler = { [weak self] viewController, error in
            guard let self = self else { return }
            self.authenticating = false
            if let error = error {
                print("Authentication failed: \\(error.localizedDescription)")
                self.isAuthenticated = false
            } else if let viewController = viewController {
                // 로그인 뷰 컨트롤러가 필요한 경우 표시
                print("Game Center login required")
                if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
                   let window = windowScene.windows.first {
                    window.rootViewController?.present(viewController, animated: true, completion: nil)
                }
            } else if GKLocalPlayer.local.isAuthenticated {
                // 인증 성공
                self.isAuthenticated = true
                print("Player authenticated")
            } else {
                // 인증 실패
                self.isAuthenticated = false
                print("Player not authenticated")
            }
        }
    }

2️⃣ Game Center 순위표(리더보드)에 사용자의 점수 보내기

// (순위표를 위한) 게임센터 점수 저장 메서드
    func reportBingoCount(_ count: Int) {
        // 인증 여부 확인
        guard isAuthenticated else {
            print("Player is not authenticated")
            return
        }

        let score = GKLeaderboardScore()
        score.leaderboardID = "순위표 ID"
        // 순위표에 부여해야 하는 영숫자 식별자 - 이 ID는 100자로 제한, 영구적으로 설정되며 나중에 변경할 수 없음
        score.value = Int(count)

        // 점수 저장
        GKLeaderboard.submitScore(score.value, context: 0, player: GKLocalPlayer.local, leaderboardIDs: [score.leaderboardID]) { error in
            if let error = error {
                print("Failed to report score: \\(error.localizedDescription)")
            } else {
                print("Score reported successfully")
            }
        }
    }

3️⃣ 목표 달성을 확인하기 위한 데이터 전달

// 목표(업적) 달성 메서드
    func reportAchievement(identifier: String, percentComplete: Double) {
        // 인증 여부 확인
        guard isAuthenticated else {
            print("Player is not authenticated")
            return
        }

        // 목표 객체 생성 및 설정
        let achievement = GKAchievement(identifier: identifier)
        achievement.percentComplete = percentComplete
        achievement.showsCompletionBanner = true

        // 목표 달성 보고
        GKAchievement.report([achievement]) { error in
            if let error = error {
                print("Failed to report achievement: \\(error.localizedDescription)")
            } else {
                print("Achievement reported successfully")
            }
        }
    }

4️⃣ Game Center 순위표 보기

// 순위표 보기 메서드
    func showLeaderboard() {
        let leaderboardID = "순위표 ID"
        let viewController = GKGameCenterViewController(leaderboardID: leaderboardID, playerScope: .friendsOnly, timeScope: .allTime)
        viewController.gameCenterDelegate = self

        if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene {
            if let window = windowScene.windows.first {
                window.rootViewController?.present(viewController, animated: true, completion: nil)
            }
        }
    }