목차 | ||
---|---|---|
|
...
Initialization and Status Change Event Processing
...
App Event Method Initialization (iOS Only)
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube @main class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? override init() { KGTApplication.setSwizzleAppDelegate(delegate: AppDelegate.description()) } } |
SDK Initialization
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube /** * When using a single app */ let config = KGTConfig(appId: "909428", appSecret: "c3c38bbfa3828b342d946e9770c974d0", appVersion: "1.0.0", market: "appStore", ageRating: "14", serverType: .QA, logLevel: .Verbose) /** * When using an app group */ let apps: [String : String] = [ "909428" : "c3c38bbfa3828b342d946e9770c974d0", "921478" : "5891c32124ca35821890a0bc1cec77a5"] let config = KGTConfig(appGroupId: "tubeAppGroup", apps: apps, appVersion: "1.0.0", market: "appStore", ageRating: "14", serverType: .QA, logLevel: .Verbose) KGTApplication.initSDK(config) |
Start
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube KGTApplication.start { error in if error.isSuccess { // If the start is successful // Check if auto-login is enabled let isLoggedIn = KGTPlayer.isLoggedIn if isLoggedIn { // The current Player's ID issued by the platform let playerId = KGTPlayer.currentPlayer?.playerId // Platform access token let accessToken = KGTPlayer.accessToken // Retrieve the current IDP authentication information let idpProfile = KGTPlayer.currentPlayer?.idpProfile // [TODO] Move to the game screen. } else { // [TODO] If auto-login is not enabled, move to the login screen. } } else { //If the start fails - since initialization failed, retry the start or close the app. if error.code == KGTErrorCode.networkFailure || error.code == KGTErrorCode.serverTimeout || error.code == KGTErrorCode.serverConnectionFalied { // [TODO] If a network error occurs, notify the user that the start failed due to a network issue and retry. } else { // [TODO] If other errors occur, provide an error notification and request a retry of the start process. - If the issue persists, check the error code and logs to determine the cause. } } } |
Pause
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube KGTApplication.pause() |
Resume
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube KGTApplication.resume { error in if error.isSuccess { // [TODO] If resume is successful, resume the game screen. } else { // [TODO] If resume fails, navigate to the login screen if it’s an authentication failure; otherwise, show an error popup and check if the user wants to retry. if error.code == KGTErrorCode.authFailure || error.code == KGTErrorCode.idpAuthFailure { // [TODO] In case of authentication failure, move to the start screen and perform the new login flow again. } else { // [TODO] If other errors occur, provide an error notification and retry the resume. - If the issue persists, close the app. } } }) |
Login
...
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
Logging In Without Using the Default Login UI
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube // Set the IdpCode for login let idpCode = KGTIdpCode.Kakao // Login with a specific IDP KGTPlayer.login(with: idpCode) { error in if error.isSuccess { // IDP login and platform login successful // The current Player's ID issued by the platform let playerId = KGTPlayer.currentPlayer?.playerId // Platform access token let accessToken = KGTPlayer.accessToken // Retrieve the current IDP authentication information let idpProfile = KGTPlayer.currentPlayer?.idpProfile // [TODO] Since login was successful, proceed to the game screen. } else { // IDP login or platform login failed // [TODO] If login fails, inform the user and prompt them to retry. if error.code == KGTErrorCode.networkFailure || error.code == KGTErrorCode.serverTimeout || error.code == KGTErrorCode.serverConnectionFailed { // [TODO] If other errors occur, provide an error notification and prompt the user to retry logging in. } else if error.code == KGTErrorCode.blockedByPolicy { // [TODO] Login attempt from a blocked country code or IP range. Handle this accordingly. } else if error.code == KGTErrorCode.userCanceled { // [TODO] Since the user canceled during the login process, the login screen should be maintained. } else { // [TODO] If other errors occur, provide an error notification and prompt the user to retry logging in. - It is necessary to check the error code and logs to determine the cause. } } }) |
Logout
...
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
Logging Out Without Using the Default Logout UI
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube // Logout request KGTPlayer.logout(showUI: false) { error in if error.isSuccess { // Logout successful // [TODO] Return to the start screen } else { // Logout failed } }) |
Unregistration
...
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
Unregistering Without Using the Default Unregistration UI
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube // Unregister request KGTPlayer.unregister(showUI: false) { error in if error.isSuccess { // Unregistration successful // [TODO] Return to the start screen } else { // Unregistration failed } }) |
Account Linking
...
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
Linking Accounts Without Using the Default Account Linking UI
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube // Set the IdpCode you want to log in with let idpCode = KGTIdpCode.Kakao // Connect to a specific IDP account KGTPlayer.connect(idpCode: idpCode) { error in if error.isSuccess { // IDP connection successful // Player ID does not change. } else { // IDP connection failed if error.code == KGTErrorCode.invalidParameter { // Invalid parameter was passed } else if error.code == KGTErrorCode.notAuthorized { // The user is not currently logged in } else if error.code == KGTErrorCode.invalidState { // The current authenticated IDP is not eligible for account connection } else if error.code == KGTErrorCode.alreadyUsedIdpAccount { // The account is already connected } else { // Other errors occurred } } }) |
Profile
...
Retrieve My Information
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube let localPlayer = KGTPlayer.currentPlayer |
Retrieve My IDP Information
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube let idpProfile = KGTPlayer.currentPlayer?.idpProfile |
System Information
...
Retrieve Language Code
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube let languageCode = KGTSystem.languageCode |
Retrieve Country Code
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube let countryCode = KGTSystem.countryCode |
Retrieve IP-based Country Code
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube let countryCode = KGTSystem.geoCountryCode |
Retrieve Device ID
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube let deviceId = KGTSystem.deviceId |
Retrieve Device Model
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube let deviceModel = KGTSystem.deviceModel |
Retrieve OS Name
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube let osName = KGTSystem.osName |
Retrieve Network Connection Status
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube let isNetworkConnected = KGTSystem.isNetworkConnected |
Retrieve Connected Network Type
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube let networkType = KGTSystem.networkType |
Kakao Integration Feature
...
Setting Up KakaoTalk Game Message Reception
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube import KakaoGameTubeKakao // Display the view to set the KakaoTalk game message reception settings KGTKakaoTalk.showSetting { error, isAllowedMe in if error.isSuccess { // Successfully set the KakaoTalk game message reception settings let isAllowedMe = isAllowedMe // Whether message reception is allowed as per the settings } else if error.code == KGTErrorCode.notKakaoTalkUser { // The logged-in user is not a 'KakaoTalk' user. This occurs when the user is only registered with KakaoStory and not KakaoTalk. } else { // Failed to set the KakaoTalk game message reception settings } }) |
Retrieve KakaoTalk Profile
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGame import KakaoGameKakao // Retrieve KakaoTalk profile KGTKakaoTalk.talkProfile { error, profile in if error.isSuccess { // Successfully retrieved KakaoTalk profile let talkProfile = profile // The KakaoTalk profile information of the logged-in user } else if error.code == KGTErrorCode.notKakaoTalkUser { // The logged-in user is not a 'KakaoTalk' user. This occurs when the user is only registered with KakaoStory and not KakaoTalk. } else { // Failed to retrieve KakaoTalk profile } }) |
Retrieve KakaoTalk Game Friend List
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube import KakaoGameTubeKakao // Retrieve the list of game friends KGTKakaoTalk.friends { error, players in if error.isSuccess { // Successfully retrieved KakaoTalk game friends list. for player in players { if let kakaoFriendProfile = player.idpProfile as? KGTKakaoFriendProfile { // You can now access kakaoFriendProfile properties here } } } else if error.code == KGTErrorCode.notKakaoTalkUser { // The logged-in user is not a 'KakaoTalk' user. This occurs when the user is only registered with KakaoStory and not KakaoTalk. } else { // Failed to retrieve KakaoTalk game friends list } }) |
Sending KakaoTalk Game Messages
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube import KakaoGameTubeKakao // Friend object retrieved via the friends API let kakaoProfile: KGTKakaoFriendProfile = // Kakao profile (KGTKakaoFriendProfile object) // [TODO] Set the template Id let templateId = "" // [TODO] Set the arguments for the message template var argumentDic: [String: Any]? = [:] argumentDic?["rog_link"] = "test=100&hello20111" argumentDic?["bruce2"] = "test=100&hello=20111" // Send KakaoTalk game message KGTKakaoTalk.sendGameMessage(kakaoProfile: kakaoProfile, templateId: templateId, argumentDic: argumentDic) { error in if error.isSuccess { // Successfully sent KakaoTalk chat message } else { if error.code == KGTErrorCode.messageSettingDisabled { // The recipient has set message reception to be disabled. } else if error.code == KGTErrorCode.exceedDailyUsage { // Occurs when the daily quota for sending messages to a specific app (regardless of the recipient) is exceeded. } else if error.code == KGTErrorCode.exceedMonthlyUsage { // Occurs when the monthly quota for sending messages to a specific person for a specific app is exceeded. } else { // Failed to send KakaoTalk chat message } } }) |
Sending KakaoTalk Friend Invitation Messages
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
코드 블럭 | ||
---|---|---|
| ||
import KakaoGameTube import KakaoGameTubeKakao // [TODO] Set whether to display as a popup window let isSingle = true // [TODO] Set whether to display as a popup window let isPopup = true // [TODO] Set the template Id let templateId = "" // [TODO] Set the arguments for the message template var argumentDic: [String: Any]? = [:] argumentDic?["rog_link"] = "test=100&hello20111" argumentDic?["bruce2"] = "test=100&hello=20111" KGTKakaoTalk.sendInviteMessage(isSingle: isSingle, isPopup: isPopup, templateId: templateId, argumentDic: argumentDic) { error, users in if error.isSuccess { // Successfully sent KakaoTalk invite message for user in users { // Check the list of users who received the invite message } } else { // Failed to send to all users (common cause needs to be returned) if error.code == KGTErrorCode.messageSettingDisabled { // The recipient has set message reception to be disabled. } else if error.code == KGTErrorCode.exceedDailyUsage { // Occurs when the daily quota for sending messages to a specific app (regardless of the recipient) is exceeded. } else if error.code == KGTErrorCode.exceedMonthlyUsage { // Occurs when the monthly quota for sending messages to a specific person for a specific app is exceeded. } else { // Failed to send KakaoTalk invite message } } }) |
Adding a KakaoTalk Channel
발췌문 삽입 | ||||||||
---|---|---|---|---|---|---|---|---|
|
...