XBOX LIVE

What is Xbox Live?

• Global: Xbox Live is an online multiplayer gaming and digital media delivery service
created and operated by Microsoft.
• Gameloft: Xbox Live is the one of social feature we use on Gameloft game.
• Xbox Live need a microsoft account.

What is Xbox Live used to do?

• Used as Gameloft account to login to Gamloft game (for any game support Xbox)
• Gametag is an element of Xbox Live, used to replace user' name in game.
• Achievement is also an element of Xbox Live, There will be a list of achievements in
each Gameloft game. Players need to compeleted specific milestones to achieve it.
REQUIREMENT TOOLS
• Xbox Live SDK:
• SDK for Windows
8.1: https://svn01/vc/gllegacy/release_v2.0/trunk/tools/sdk/xblwinbluesdk.msi
• SDK for Windows Phone
8: https://svn01/vc/gllegacy/release_v2.0/trunk/tools/sdk/wp8_XBLPhoneSDK_201
2-11b.msi
• SDK for Windows Phone 8.1: No longer support
• Xbox Live Game Configuration:
• https://developer.xboxlive.com/en-us/workspace/crossplatform/xblpubtoolkit-en-
us.msi (require a Microsoft developer account to download)
• Xbox Live Utilities:
• You can download the last xbl utilities at https://docs.gameloft.org/xboxlive-base-version-
changer/#Latest_Version
XBOX LIVE GAME CONFIGURATION
• Input:
• Title Name
• Title ID
• Platform
• Supported Languages
• Game Tile(avatar)
• A list Achievements
• Achievement tile (for all supported languages)
• Achievement description (for all supported languages)
• Achievement how to (for all supported languages)
• Achievement score
• Achievement image

• Output: xbl.spa
IMPLEMENT
• Add Xbox Live in snsconfig.json
IMPLEMENT
• Add code
• All in GLSocialLib.

• Just follow GameCenter(iOS code) to handle Init, Login, Logout, conflict account.
• Login: void XBOXLiveGLSocialLib::HandleEventLogin()
• Lgout: void XBOXLiveGLSocialLib::HandleEventLogout()

• Gamertag: std::string XBOXLiveGLSocialLib::GetGamertag()

• Achievement: std::string XBOXLiveGLSocialLib::HandleEventUnlockAchie

vement()
IMPLEMENT – WP8.0
• Add references
• Xbox Live SDK for Windows Phone
IMPLEMENT – WP8.0
• Add references
• Add xbl.spa
IMPLEMENT – WP8.0

• Add references
• Add xbl.spa
• After build:
• You must change base version of the XAP to 1.0 to using xbox in development
process.
• You must change base version of the XAP to GOLD VERSION for submission build
• "GOLD VERSION" ask you manager.
• To change base version of a xap file, we use XBLUtilities tool.
XBLUTILITIES TOOL
This tool have 2 main functions:
• Base version changer:
• Open the tool (last version) then go to tab "Base Version Changer".
• Drop or browse the XAP into the tool.
• Write 1.0 in the box "Version"
• Press "Go!" Button and wait it done.
XBLUTILITIES TOOL
This tool have 2 main functions:
• Base version changer
• TitleID Checker: this function used to correct Title ID (gold or beta)
IMPLEMENT – W8.1/WP8.1/W10
• Add reference
IMPLEMENT – W8.1/W10
• Add reference
• Add xbl.spa: add to main project
IMPLEMENT – W8.1/W10
• Add reference
• Add xbl.spa: add to main project
• Add xboxlive extension into Package.appmainfest

• What "1195775860"?
• This is decimal TileID.
• Remember change it to GOLD decimal TileID when you make the submission build.
IMPLEMENT – W8.1/W10
• Add reference
• Add xbl.spa: add to main project
• Add xboxlive extension into Package.appmainfest
• Add config.json to main project for ONLY DEVELOPMENT PROCESS

• Remember remove CONFIG.JSON when you make the submission

build.
COMMON ISSUES & TROUBLESHOOTING
• Can not login to Xbox Live:
• Check base version, make sure base version in the XAP is 1.0 (Only WP8.0)
• Debug in the code:
• Break point and check it reached to HandleEventLogin() function
• View the error code in void
XBOXLiveGLSocialLib::AfterLoginAttempt(UserIdentityData^
userIdentity) function
• Correct information in the SPA and re-generate.
• If you see login succesfully in AfterLoginAttempt function, mabe the Xbox Live
account is limmited, you must go to https://tuna-staging.gameloft.org/#/account_links to
unlink
• To unlink on Tuna you need XUID, you can get it by break point
in AfterLoginAttempt function or on https://cxkes.me/projects/php/xuid without
debug just a gamertag, you can easily get the gamertag on https://account.xbox.com by
login to this page.
COMMON ISSUES & TROUBLESHOOTING
• My Achievements are not appearing on xbox.com, even if they were
unlocked in my game.
• => The system works offline in beta mode, so achievements will only be
unlocked locally. It’s normal that they do not appear on the xbox.com
website.
• The gamer tag is not updated in my game even after I changed it on the
xbox website.
• => It takes up to 4 hours for the change to propagate to the game. Even
if the gamer tag updates itself in the xbox menu, it may take extra time to
appear in game.
• I cannot change the Xbox Live account in Windows Phone 8 game hub?
• =>There is no way to change and each account with stick with the device
except resetting to factory default in order to sign-in with new account.
COMMON ISSUES & TROUBLESHOOTING
• The language of achievements does not change when changing the
phone’s language. Is this normal?
• => Yes, the local achievements tracking (needed for offline mode) is
generated on the language that the phone created it in the first place.
• On some phones, our title will appear in the Xbox section of the Games
app, while the same build will appear in other. Sometimes, it never
appears anywhere.
• => The icon should appear somewhere. Where it appears depends on
the device & firmware, but if the icon does not appear anywhere
however, it's a bug..
COMMON ISSUES & TROUBLESHOOTING
• How to build to can pass the certification on Microsoft Dev Center
• => You need generate to 2 build:
• Build GOLD without config.json
• Build GOLD with config.json
REFRENCES DOCUMENT

• https://docs.gameloft.org/xboxlive-for-windows-8-metro/
• https://confluence.gameloft.org/display/DADGLDN/Xboxlive+for+Windows+platf
orm
• https://confluence.gameloft.org/display/JP/Windows?preview=%2F75327726%2F75329
705%2FXBOX+LIVE.pptx
• https://docs.gameloft.org/xboxlive-base-version-changer/
• https://docs.gameloft.org/wp-xbox-live-title-id-test-procedure/
• https://confluence.gameloft.org/display/W8KB/XBox+Live
THANK YOU !