{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"21.1. KakaoTalk Invitation SDK Example","type":"text"}]},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"7"}},"macroMetadata":{"macroId":{"value":"cb9acb10-4492-4d46-abd7-98990561eff6"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"7b30e6c2-1339-43a0-9ed6-5558e9909d1f"}},{"type":"rule"},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Do not mix with new 3.9.0 or higher APIs.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"21.1.1. Example of KakaoTalk Invitation Message Sending","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":665,"id":"5777050a-1fb5-4597-98d5-943d8b4a64de","collection":"contentId-414646321","type":"file","height":1182}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"21.1.2. Querying KakaoTalk Invitation Target List","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"LoadInvitableFriendProfiles","type":"text","marks":[{"type":"strong"}]},{"text":"(has 3 arguments) API and ","type":"text"},{"text":"LoadRecommendedInvitableFriendProfiles","type":"text","marks":[{"type":"strong"}]},{"text":" API are deprecated. You can continue to use it, but we recommend replacing it with a new ","type":"text"},{"text":"LoadInvitableFriendProfiles","type":"text","marks":[{"type":"strong"}]},{"text":"(has 4 arguments) API.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"This section shows an example of a query of the KakaoTalk invitation target list.","type":"text"}]},{"type":"paragraph","content":[{"text":"KakaoGame Platform will recommend friend who will join the game with high possibility. The number of recommendable friends may less then limit of recommend friend set by you.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have more than 2,000 friends that you can get at once, you can only get list for 2,000 people.","type":"text"}]},{"type":"paragraph","content":[{"text":"'recomended' is a recommendation friend who is more likely to join a game, and you can use that value to design a differential reward. Through the callback, the list of recommended friends delivered is first arranged recommended friends with a high probability of joining, and then to be sorted by name.","type":"text"}]},{"type":"paragraph","content":[{"text":"Unity","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","localId":"6fe22a86-b09e-4e32-aaa5-801c350a9e1b"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[680.0]},"content":[{"type":"codeBlock","content":[{"text":"using Kakaogame.SDK;\n \n// [TODO] Set limit of recommend friend\nint recommendLimit = 5;\n \n// [TODO] Set start value for querying friend list\nint offset = 0; // Start value for querying friend list\n \n// [TODO] Set size of querying friend list\nint limit = 300; // Friend list size\n \nKGKakaoProfile.LoadInvitableFriendProfiles(\n recommendLimit,\n offset,\n limit,\n (result, totalCount, idpProfiles) => {\n if (result.isSuccess) {\n // Finding the list of inevitable friend profiles in KakaoTalk was successful.\n \n // Total number of invitable KakaoTalk friends\n int _totalCount = totalCount;\n \n // List of invitable KakaoTalk friend profiles\n foreach(var kakaoProfile in idpProfiles) {\n // is recommended\n bool isRecommended = kakaoProfile.isRecommended;\n \n // Since the friend does not have a playerId before running the game, it can be managed by using KGKakaoProfile.uuid.\n string uuid = kakaoProfile.uuid;\n }\n }\n else {\n // Finding the list of inevitable friend profiles in KakaoTalk was not successful.\n }\n });","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Android","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","localId":"9048e31a-426b-4889-bbc4-8b38732e8007"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[680.0]},"content":[{"type":"codeBlock","content":[{"text":"// [TODO] Set limit of recommend friend\nint recommendLimit = 5;\n \n// [TODO] Set start value of friend list query\nint offset; // Friend list query start value\n \n// [TODO] Set friend list query size\nint limit; // Friend list size\n \n// Querying the invitation target friend profile list\nKGKakaoProfile.loadInvitableFriendProfiles(recommendLimit, offset, limit, new KGResultCallback() {\n @Override\n public void onResult(KGResult result) {\n if (result.isSuccess()) {\n // Query of invitation target friend profile list successful\n \n KGKakaoFriendsResponse response = result.getContent();\n \n // Number of KakaoTalk invitation target friends\n int totalCount = response.getTotalCount();\n \n // List of invitation target friend profiles\n List friendList = response.getFriendList();\n \n for (KGKakaoProfile profile : friendList) {\n // is recommended\n boolean isRecommended = profile.isRecommended();\n \n // Since the friend does not have a playerId before running the game, it can be managed by using KGKakaoProfile.getUUID().\n String UUID = profile.getUUID();\n }\n } else {\n // Query of invitation target friend profile list failed\n }\n }\n});","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"iOS","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","localId":"9750a6e4-3e87-4132-8961-32699c8c0436"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[680.0]},"content":[{"type":"codeBlock","content":[{"text":"#import \n \n// [TODO] Set limit of recommend friend\nint recommendLimit = 5;\n// [TODO] Set start value of friend list query\nint offset = 0; // Friend list query start value\n \n// [TODO] Set friend list query size\nint limit = 300; // Friend list size\n \n// Querying the invitation target friend profile list\n[KGKakaoProfile loadInvitableFriendProfilesWithRecommendLimit:recommendLimit offset:offset limit:limit completionHandler:^(NSError *error, int totalCount, NSArray *idpProfiles) {\n if (IS_SUCCESS(error) == YES)\n {\n // Query of invitation target friend profile list successful\n \n // Number of KakaoTalk invitation target friends\n int _totalCount = totalCount;\n \n // List of invitation target friend profiles\n for(KGKakaoProfile *kakaoProfile in idpProfiles)\n {\n // is recommended\n BOOL isRecommended = kakaoProfile.isRecommended;\n \n // Since the friend does not have a playerId before running the game, it can be managed by using KGKakaoProfile.uuid.\n NSString* uuid = kakaoProfile.uuid;\n }\n }\n else\n {\n // Query of invitation target friend profile list failed\n }\n}];","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"21.1.3. Sending a KakaoTalk Invitation Message","type":"text"}]},{"type":"paragraph","content":[{"text":"This section shows an example of KakaoTalk invitation message sending.","type":"text"},{"text":"(Guide : ","type":"text","marks":[{"type":"strong"}]},{"type":"inlineCard","attrs":{"url":"https://kakaogames.atlassian.net/wiki/spaces/KS3GFC/pages/414253141"}},{"text":" ","type":"text"},{"text":")","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Unity","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","localId":"dff839d1-d4b2-4b45-b4ec-daf884bc8826"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[680.0]},"content":[{"type":"codeBlock","content":[{"text":"using Kakaogame.SDK;\n \n// [TODO] Retrieve the Kakao profile data from the invitation target friend list\nKGKakaoProfile kakaoProfile;\n \n// [TODO] Set the invitation message template ID\nstring templateId = \"1679\";\n \n// [TODO] Add the parameters needed in the invitation message\nDictionary argumentDic = new Dictionary() {\n {\"name\", \"MyName\"},\n {\"iphoneMarketParam\" : \"test\"},\n {\"iphoneExecParam\", \"test\"},\n {\"sender_name\", \"iOSTester\"},\n {\"invitation_event_id\", 29}\n};\n \n// Sending a KakaoTalk Invitation Message\nKGKakaoTalkMessage.SendNewInviteMessage(\n kakaoProfile,\n templateId,\n argumentDic,\n (result) => {\n if (result.isSuccess) {\n // KakaoTalk invitation message successfully sent.\n }\n else if (result.code == KGResultCode.MessageSettingDisabled) {\n // If the receiver has set up message rejection\n }\n else if (result.code == KGResultCode.ExceedDailyUsage) {\n // Occurs when the daily quota (regardless of receiver) of messages from a specific app that can be sent by a user has been exceeded\n }\n else if (result.code == KGResultCode.ExceedMonthlyUsage) {\n // Occurs when the monthly quota of messages that a user can send to another specific user has been exceeded\n }\n else {\n // Sending of KakaoTalk invitation message failed.\n }\n });","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Android","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","localId":"b0bb458f-0fba-44d7-81ed-1a1c11ae8a2b"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[680.0]},"content":[{"type":"codeBlock","content":[{"text":"// [TODO] Retrieve the Kakao profile data from the invitation target friend list\nKGKakaoProfile kakaoProfile;\n \n// [TODO] Set the invitation message template ID\nString templateId;\n \n// [TODO] Add the parameters needed in the invitation message\nMap args = new LinkedHashMap();\nString nickname = ((KGKakaoProfile)KGLocalPlayer.getCurrentPlayer().getIdpProfile()).getNickname();\nargs.put(\"${sender_name}\", nickname);\nargs.put(\"${invitation_event_id}\", \"\");\n \n// Sending a KakaoTalk Invitation Message\nKGKakaoTalkMessage.sendNewInviteMessage(kakaoProfile, templateId, args, new KGResultCallback() {\n @Override\n public void onResult(KGResult result) {\n writeLog(\"KGKakaoTalkMessage.sendInviteMessage() : \" + result);\n \n if (result.isSuccess()) {\n // Request successful\n \n } else {\n // Request failed\n \n if (result.getCode() == KGResult.KGResultCode.MESSAGE_SETTING_DISABLE) {\n // If the receiver has set up message rejection.\n } else if (result.getCode() == KGResult.KGResultCode.EXCEED_DAILY_USAGE) {\n // Occurs when the daily quota (regardless of receiver) of messages from a specific app that can be sent by a user has been exceeded.\n } else if (result.getCode() == KGResult.KGResultCode.EXCEED_MONTHLY_USAGE) {\n // Occurs when the monthly quota of messages that a user can send to another specific user has been exceeded.\n } else {\n // Other errors\n }\n }\n }\n});","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"iOS","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","localId":"0994d7aa-4598-4f96-a411-c7dd62efa322"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[680.0]},"content":[{"type":"codeBlock","content":[{"text":"#import \n \n// [TODO] Retrieve the Kakao profile data from the invitation target friend list\nKGKakaoProfile *kakaoProfile; // Kakao profile (KGKakaoProfile object)\n \n// [TODO] Set the invitation message template ID\nNSString *templateId = @\"1679\";\n \n// [TODO] Add the parameters needed in the invitation message\nNSDictionary* argumentDic = @{@\"name\" : @\"MyName\", @\"iphoneMarketParam\" : @\"test\", @\"iphoneExecParam\" : @\"test\", @\"sender_name\" : @\"iOSTester\", @\"invitation_event_id\" : @(29)};\n \n// Sending a KakaoTalk Invitation Message\n[KGKakaoTalkMessage sendNewInviteMessageWithKakaoProfile:kakaoProfile\n templateId:templateId\n argumentDic:argumentDic\n completionHandler:^(NSError *error) {\n if (IS_SUCCESS(error) == YES)\n {\n // KakaoTalk invitation message successfully sent\n }\n else\n {\n // Sending of KakaoTalk invitation message failed\n \n if (error.code == KGErrorMessageSettingDisabled)\n {\n // If the receiver has set up message rejection\n }\n else if (error.code == KGErrorExceedDailyUsage)\n {\n // Occurs when the daily quota (regardless of receiver) of messages from a specific app that can be sent by a user has been exceeded\n }\n else if (error.code == KGErrorExceedMonthlyUsage)\n {\n // Occurs when the monthly quota of messages that a user can send to another specific user has been exceeded\n }\n else\n {\n // Other errors\n }\n }\n}];","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}],"version":1}

지원되지 않는 브라우저