- 개인적인 용도로 요약한 글이라 글에서는 경어체를 사용하지 않습니다. 양해부탁드립니다.
- 회사에서 진행하고 있는 프로젝트와 관련이 있어 과도한 모자이크가 있습니다. 양해부탁드립니다.
- Mac 의 Pages로 작업했으나 블로그에 올릴때 레이아웃이 많이 깨졌으므로 PDF로 다운받아보시는것을 권장합니다.
iOS 4.1 부터 지원하기 시작한 Apple의 GameCenter 를 내 어플에 붙여보는 작업을 해보자.
GameCenter 의 가이드가 잘 되어있으니 전체적인 개발방법은 가이드를 참고해보고 이번 포스팅에서는 속성으로 필요한 부분만 정리해서 올려본다.
간단히 GameCenter는 지원하는 어플의 세계 랭킹, 도전 목표, 같이 게임을 하는 친구목록 등을 지원하고 또한 Auto-Match (대전상대 매치), 음성채팅같은 API도 제공된다. (이전에 Apple이 지원하기전에는 OpenFeint 등이 유명한 솔루션이었다)
-참고 : Apple의 GameCenter Developer guide
http://developer.apple.com/library/ios/#documentation/NetworkingInternet/Conceptual/GameKit_Guide/GameCenterOverview/GameCenterOverview.html
1. 사전작업
먼저 어플이 iTunes connect 에 등록이 되어있어야한다. (https://itunesconnect.apple.com)
개발자 계정을 입력후 로그인하면 Manage Your Applications 라는 메뉴를 누른다.
그 다음화면에서 GameCenter를 적용할 어플을 클릭한다.
그다음 Manage Game Center 를 눌러서 게임센터 관리로 들어간다.
여기서 Game Center 를 Enable 시켜준다.
이미 테스트용도로 Enable 시켰기때문에 화면에서는 Disable 로 표시된다.
Leaderboard 는 간단히 말해 점수판이다. 전세계 사용자들과 나 자신의 점수를 비교해볼수도 있고 GameCenter에 친구들이 같은 어플(게임)을 사용한다면 친구들간의 순위도 제공된다.
먼저 점수판을 하나 셋팅해본다. Edit 를 누른뒤 Add Leaderboard 버튼으로 점수판을 하나 생성한다.
테스트 용도이므로 Single Leaderboard 로 생성을 했다.
Leaderboard Reference Name 은 내가 알아볼만한 이름으로 셋팅하면 되고
Leaderboard ID 가 중요한데 프로그램에서 참조되는 값이므로 유니크한 이름으로 셋팅해야된다.
Sort Order 는 오름차순,내림차순 정렬등을 선택하고 Add Language 버튼으로 언어별 표시되는 이름 뒤에 붙는 점수표시법등을 설정할수 있다.
그다음 다시 Manage 화면으로 와서 이번엔 게임 목표(Achievements)를 설정해본다.
목표는 어플당 1000점 한도 내에서 목표1개당 1~100점 이내로 여러개를 설정할수 있다.
Add New Achievement 버튼으로 새로운 목표를 하나 만들어 본다.
Achievement Reference Name 은 iTunes Connect 에서 관리하게 편하게 알아볼만한 이름으로 설정한다.
Achievement ID 는 마찬가지로 프로그램에서 참조할 이름을 적어준다.
Hidden 은 공개된 목표인지, 숨겨진 목표인지 설정하고
Point Value 로 목표를 완수했을때 주어지는 점수를 셋팅한다. 100점까지 셋팅이 가능하다.
Add Language 버튼으로 언어별로 표시될 이름, 목표 완수전에 표시될 설명, 완수 후에 표시될 설명, 그리고 목표에 해당하는 아이콘이미지를 넣어준다.
테스트로 몇개 만들어보고 이상으로 iTunes Connect 사이트에서 설정할 사전작업은 완료되었다.
2. 코드적용
2.1. 라이브러리 추가
xcode 를 열고 즐거운 코딩작업을 시작한다.
먼저 GameKit 라이브러리가 프로젝트에 포함이 되어야한다.
xcode 4 로 넘어오면서 이게 어디있나 한참 찾았는데 xcode 4에서는 다음에서 필요한 라이브러리를 포함시킬수 있다.
프로젝트파일을 선택하고 Targets 에서 선택하고 Build Phases 를 누른후 Link Binary with Libraries 에서
GameKit.framework 를 추가해준다.
그리고 게임센터에서 점수를 기록하거나 목표를 달성했을때 게임센터 스타일의 노티를 붙여주기 위해 typeoneerror블로그의 GKAchievementNotification 소스를 추가로 붙이기 위해서 ,다운받은 (링크는 아래에... 그리고 블로그에도 첨부파일로) 소스와 이미지들을 프로젝트에 추가해준다.
(여기에선 typeoneerror-GKAchievementNotification-8a90404.zip 사용)
http://www.typeoneerror.com/articles/post/game-center-achievement-notification
겜센터 스타일의 노티가 기본적으로 뜰때 풀사이즈의 어플을 기준으로 했기때문에 내가 작업하고 있는 어플에서 보면 노티가 나오다가 짤려보인다.
문제는 20픽셀을 잡고있는 스테이더스바 때문인데 스테이더스바의 길이만큼 더해서 노티가 더 내려오도록 수정을 했다.
다음 수정은 상단에 스테이더스 바가 있는 어플일때만 해주면 된다. (자신의 어플에 맞게 Customize 해서 쓰도록하자)
다운받은 소스의 GKAchievementNotification.h 의 파일을 보면 다음과 같은 정의구문이 있는데 기본 10픽셀만큼 내려오는걸 30필셀만큼 내려오도록 수정한다.
#define kGKAchievementFrameEnd CGRectMake(18.0f, 10.0f, 284.0f, 52.0f);
여기서 10.0f 를
#define kGKAchievementFrameEnd CGRectMake(18.0f, 30.0f, 284.0f, 52.0f);
이렇게 30.0f 로. (20픽셀만큼 더함)
2.2. 게임센터 접속 메소드 구현
게임센터를 접속시켜야하는데 MainView 쪽에 작업해도 되지만 나는 어플안에서 마구 가져다 쓸수 있는 인스턴스 클래스에 접속,점수 보내는등의 메소드를 구현해놨다.
인스턴스 클래스 AppUtils.h
#import <GameKit/GameKit.h>
#import "GKAchievementHandler.h" //이건 노티를 위해서 임포트
@interface AppUtils : NSObject {
~~~~
}
~~~~
/////////////////Geunwon,Mo : GameCenter 추가 start /////////////
+ (BOOL) isGameCenterAvailable ; //게임센터가 사용가능하지 알아보는 메소드
+ (void) connectGameCenter; //게임센터에 접속하는 메소드
+(void) sendScoreToGameCenter:(int)_score; //게임센터서버에 점수 보내는 메소드
+ (void) sendAchievementWithIdentifier: (NSString*) identifier percentComplete: (float) percent;//게임센터서버에 목표달성 보내는 메소드
+ (void) resetAchievements; //테스트용으로 목표달성도를 리셋하는 메소드
/////////////////Geunwon,Mo : GameCenter 추가 end /////////////
@end
AppUtils.m
~~~(생략)
/////////////////Geunwon,Mo : GameCenter 추가 start /////////////
//GameCenter 사용 가능 단말인지 확인
+ (BOOL) isGameCenterAvailable {
// check for presence of GKLocalPlayer API
Class gcClass = (NSClassFromString(@"GKLocalPlayer"));
// check if the device is running iOS 4.1 or later
NSString *reqSysVer = @"4.1";
NSString *currSysVer = [[UIDevice currentDevice] systemVersion];
BOOL osVersionSupported = ([currSysVer compare:reqSysVer options:NSNumericSearch] !=NSOrderedAscending);
return (gcClass && osVersionSupported);
}
//GameCenter 로그인
+ (void) connectGameCenter{
NSLog(@"connect... to gamecenter");
if([GKLocalPlayer localPlayer].authenticated == NO) { //게임센터 로그인이 아직일때
[[GKLocalPlayer localPlayer] authenticateWithCompletionHandler:^(NSError* error){
if(error == NULL){
NSLog(@"게임센터 로그인 성공~");
} else {
NSLog(@"게임센터 로그인 에러. 별다른 처리는 하지 않는다.");
}
}];
}
}
// 게임센터 서버로 점수를 보낸다.
+(void) sendScoreToGameCenter:(int)_score{
GKScore* score = [[[GKScore alloc] initWithCategory:@"kPoint"]autorelease];
// 위에서 kPoint 가 게임센터에서 설정한 Leaderboard ID
score.value = _score;
// 아래는 겜센터 스타일의 노티를 보여준다. 첫번째가 타이틀, 두번째가 표시할 메세지
[[GKAchievementHandler defaultHandler] notifyAchievementTitle:@"NBank Point!"andMessage:[NSString stringWithFormat:@"NBank Point %d점을 기록하셨습니다.",_score]];
// 실지로 게임센터 서버에 점수를 보낸다.
[score reportScoreWithCompletionHandler:^(NSError* error){
if(error != NULL){
// Retain the score object and try again later (not shown).
}
}];
}
// 게임센터 서버로 목표달성도를 보낸다. 첫번째가 목표ID, 두번째가 달성도. 100%면 목표달성임
+ (void) sendAchievementWithIdentifier: (NSString*) identifier percentComplete: (float) percent{
NSLog(@"--겜센터 : sendAchievementWithIdentifier %@ , %f",identifier,percent);
GKAchievement *achievement = [[[GKAchievement alloc] initWithIdentifier: identifier]autorelease];
if (achievement)
{
achievement.percentComplete = percent;
[achievement reportAchievementWithCompletionHandler:^(NSError *error)
{
if (error != nil)
{
}
}];
// 이 아래는 게임센터로부터 목표달성이 등록되면 실행되는 리스너(?)
[GKAchievementDescription loadAchievementDescriptionsWithCompletionHandler:
^(NSArray *descriptions, NSError *error) {
if (error != nil){}
// process the errors
if (descriptions != nil){
//목표달성이 등록되면 노티로 알려준다.
for (GKAchievementDescription *achievementDescription in descriptions){
if ([[achievementDescription identifier] isEqualToString:identifier]){
// 보낸 ID와 일치하면 달성도에 따라 노티를 보여준다.
if (percent >= 100.0f) { // 100%면 달성완료 노티를...
[[GKAchievementHandler defaultHandler]notifyAchievement:achievementDescription];
} else { // 100%가 안되면 진행도를 노티.
[[GKAchievementHandler defaultHandler]notifyAchievementTitle:achievementDescription.title andMessage:[NSStringstringWithFormat:@"%.0f%% 완료하셨습니다.",percent]];
}
}
}
}
}];
}
}
// 테스트할때 현재까지 모든 진행도를 리셋하는 메소드.
+ (void) resetAchievements
{
// Clear all progress saved on Game Center
[GKAchievement resetAchievementsWithCompletionHandler:^(NSError *error)
{
if (error != nil){}
// handle errors
}];
}
/////////////////Geunwon,Mo : GameCenter 추가 end /////////////
이제 어플을 실행하고 메인 뷰 컨트롤러의 viewDidLoad 메소드에 게임센터 접속을 코딩한다.
이 프로그램에서는 MainMenuViewController.m 에다가 코딩해놨다.
#import "AppUtils.h"
~~~~~(생략)
- (void)viewDidLoad {
~~~~~(생략)
/////////////////Geunwon,Mo : GameCenter 추가 start /////////////
//AppUtils 가 인스턴스 메소드이기 때문에 걍 쓴다
if ([AppUtils isGameCenterAvailable]) { //게임센터가 가능한 단말이면...
[AppUtils connectGameCenter]; //게임센터 접속~
}
/////////////////Geunwon,Mo : GameCenter 추가 end /////////////
~~~~~(생략)
}
이제 게임센터에 접속하고, 점수를 보여줄 준비는 끝났다.
프로그램을 실행해보면 다음과 같이 게임센터에 접속하는 모습을 볼수 있다.
2.3. 게임센터로 점수와 목표달성도를 보내보자
이제 자신의 프로그램 플로우에 따라 게임센터 서버로 점수와 목표달성도를 보내보는 메소드를 구현해보자.
사실 보내는 메소드는 위에 구현해놨기 때문에 테스트 메소드로 사용법만을 적어본다.
프로그램에서 적당한 위치에 (실제로 게임센터로 데이터를 보내야하는 클래스에서) 테스트 메소드들을 만들었다.
//테스트 메소드들
-(IBAction)test1:(id)sender {
//이렇게 보내면 er10 이라는 ID를 가지는 목표 달성도가 25%가 찍히게 된다.
[AppUtils sendAchievementWithIdentifier:@"er10" percentComplete:25.0f];
}
-(IBAction)test2:(id)sender {
//이렇게 보내면 er10 이라는 ID를 가지는 목표 달성도가 완료되게 된다.
[AppUtils sendAchievementWithIdentifier:@"er10" percentComplete:100.0f];
}
-(IBAction)test3:(id)sender {
//이렇게 보내면 sit 이라는 ID를 가지는 목표 달성도가 완료되게 된다.
[AppUtils sendAchievementWithIdentifier:@"sit" percentComplete:100.0f];
}
- (IBAction)testpoint:(id)sender {
int r = rand() % 1000;
//이렇게 보내면 점수판에 1000사이의 정수가 랜덤으로 기록되게 된다.
[AppUtils sendScoreToGameCenter:r];
//이렇게 보내면 목표달성도가 리셋되게 된다.
[AppUtils resetAchievements];
}
2.4. 점수판도 띄워보고 목표달성판도 띄워보자!
메뉴또는 About 화면등.. 원하는 위치에 버튼을 만들고 누르면 게임센터의 점수판과 목표달성판이 나오도록 해보자.
나는 AppInfoViewController 라는 클래스에 코딩을 해놨다.
포인트 순위표, 목표 달성이란 버튼을 만들고 각각 Touch Up Inside 이벤트에 openLeaderBD 라는 점수판을 띄우는 메소드와 openArchivementBD 라는 목표달성판을 띄우는 메소드를 만들었다. (Archivement 는 오타인데 만들고 나서 나중에 수정하기 귀찮아서 그냥 사용 -_-)
AppInfoViewController.h
#import <GameKit/GameKit.h>
@interface AppInfoViewController : UIViewController<GKLeaderboardViewControllerDelegate, GKAchievementViewControllerDelegate>{
//점수판,목표달성판을 띄우는 뷰컨트롤러 딜리게이트 구현
}
/////////////////Geunwon,Mo : GameCenter 추가 start
- (IBAction)openLeaderBD:(id)sender; //점수판을 띄운다
- (IBAction)openArchivementBD:(id)sender; //목표달성판을 띄운다
- (void) showLeaderboard; //실제로 점수판을 띄우는 부분 구현 메소드
- (void) leaderboardViewControllerDidFinish:(GKLeaderboardViewController *)viewController;//점수판이 닫힐때 호출되는 메소드
- (void) showArchboard; //목표달성판을 띄우는 부분 구현 메소드
- (void)achievementViewControllerDidFinish:(GKAchievementViewController *)viewController;//목표달성판이 닫힐때 호출되는 메소드
/////////////////Geunwon,Mo : GameCenter 추가 end
@end
AppInfoViewController.m
~~~(생략)
/////////////////Geunwon,Mo : GameCenter 추가 start /////////////
///////////////// 점수판
// 점수판 버튼이 눌리면 호출된다.
- (IBAction)openLeaderBD:(id)sender{
NSLog(@"open leader board");
[self showLeaderboard]; // 실행~
}
- (void) showLeaderboard {
GKLeaderboardViewController *leaderboardController = [[[GKLeaderboardViewControlleralloc] init]autorelease];
if (leaderboardController != nil) {
// 레더보드 델리게이트는 나임
leaderboardController.leaderboardDelegate = self;
// 레더보드를 현재 뷰에 모달로 띄운다.
[self presentModalViewController:leaderboardController animated: YES];
}
}
// 레더보드 델리게이트를 구현한 부분. 닫힐때 호출된다.
- (void) leaderboardViewControllerDidFinish:(GKLeaderboardViewController *)viewController {
[self dismissModalViewControllerAnimated:YES]; //점수판 모달뷰를 내림
// 추가적으로 자신의 어플에 맞게 구현해야할것이 있으면 한다.
}
///////////////// 목표달성. (점수판 구현과 방법은 똑같음)
// 목표달성판 버튼이 눌리면 호출된다.
- (IBAction)openArchivementBD:(id)sender {
NSLog(@"open archivement board");
[self showArchboard];
}
- (void) showArchboard {
GKAchievementViewController *archiveController = [[[GKAchievementViewController alloc]init] autorelease];
if (archiveController != nil) {
archiveController.achievementDelegate = self;
[self presentModalViewController:archiveController animated: YES];
}
}
- (void)achievementViewControllerDidFinish:(GKAchievementViewController *)viewController{
[self dismissModalViewControllerAnimated:YES];
}
////////////////////Geunwon,Mo : GameCenter 추가 끝 //////////////
따로 주의해야할점은 점수판과 목표달성판은 UIView 위에 띄워주게 되어있는데 지금 작업한 어플은 UIView에서 도는 어플이라 상관없지만 cocos2d 나 기타 openGLES 등을 이용한 어플이라면 UIView 를 하나 띄워주고 그 뷰의 모달로 띄워주어야 화면에 표시가 될것이다. (해보지는 않았음-_- 구글링 추천)
이제 누르면 다음과 같이 점수판과 목표달성판이 이쁘게 뜬다.
끗.
iOS의 GameCenter를 내어플에 붙여보자.pdf
typeoneerror-GKAchievementNotification-8a90404.zip
