Competitions.
Currency.
Community.
To have your game perform as best as possible in the Yoo-Mee system, we
suggest the following best practices for game integration:
1. Sounds and Music
Please try to disable sounds, or default them to a very low level so users can play anywhere without being disruptive.
2. Splash Screen
Please eliminate as many splash screens as possible. We have found decreased plays with games that have more than one step to play the game. Our recommendation: The first screen should contain the instructions with a play now button that starts the game.
3. External Links
As per Hooked Policy, we don't allow external links in our games. Please don't have links that will take a user to another site, or out of the Yoo-Mee player.
4. Multiple Game Modes
We recommend limiting the number of game modes to choose from for ease of use and consistency.
Our recommendation: One game mode only. Game modes that have time limits are better because users will have more excitement and total game plays will increase.
Our recommendation: An average game play should be around 4 minutes or less.
5. Aesthetics
Games that have lots of vibrant colors and developed graphics tend to attract users better.
Our recommendation: By incorporating these features into your game, you should see increased game plays.
6. Post Game Screens
Our popup will take over once a score has been sent to us, but the user will drop back onto your post screen at when they exit the popup. Our recommendation: you have a post screen that clearly shows the score and option to play again.
7. Title Screens
It is extremely important to have high quality title screens so that users can easily distinguish and play your games.
Publishers also use these title screens to choose which games they would like to add to their site.
Our recommendation: Create a high-quality title screen complete with game title and an interesting graphic that will capture user and publisher interest.
8. Instructions Screen
It is important that users understand how to play the game. This will mitigate any unfair advantage a player might have when entering a challenge. Our recommendation: Have the title screen immediately go into the instruction screen then into the game play.
Integration is simple and quick. Follow these steps to get started and be done in no time!
1. Grab the API and Credentials
Grab the latest version of the API, Game API Key and Secret from the Developer page (at www.hookedmediagroup.com) These are unique values assigned to each of the games you upload. Import the .swc library into your game and include the following lines:
import com.hmg.api.service.session.*;
import com.hmg.api.service.events.ServiceResponseEvent;
2. Setup the code
Create a session variable and call the SessionFactory.create method at the time your game initializes and pass in the GameAPIKey and Secret. This step creates a session for communication with our server.
private var session:ISession = null;
session = SessionFactory.create(apiKey, secret);
Add event listeners for the appropriate API methods you will be calling in your code
if (session != null){
session.addEventListener(ServiceResponseEvent.HMG_SERVICE_SESSION, _handleSessionResponse);
session.addEventListener(ServiceResponseEvent.HMG_SERVICE_APIVER, _handleApiVersionResponse);
session.addEventListener(ServiceResponseEvent.HMG_SERVICE_GETDNAME, _handleDNameResponse);
session.addEventListener(ServiceResponseEvent.HMG_SERVICE_GETSCORES, _handleGetScoresResponse);
session.addEventListener(ServiceResponseEvent.HMG_SERVICE_REGEVENT, _handleRegisterEventResponse);
session.addEventListener(ServiceResponseEvent.HMG_SERVICE_SETSCORE, _handleSetScoreResponse);
}
*The above code quickly adds all the event listeners on the condition that the session variable has established connection with our systems.
Before any game events are called, it is important that your game has received and handled the session response. Please be sure a session response has occurred before calling any game events. Before you are able to send a score, you will need to register a new game event. This can be completed by inputting the following code:
session.score_eventRegister("gameEvent.newGame");
session.score_setScore(ScoreSheetName, Score);
3. Create Score Sheet(s)
A score sheet is where you store the gamers' scores. You can have more than one score sheet. Your game can maintain different score sheets for each of the modes of the game (Track1, Track2, Easy, Medium, Hard, etc.). Create the score sheets from the Upload Game page. You'll need to specify the score sheet name, score unit type, and if a larger value indicates a higher score.
4. Sending Scores
Sending us the gamers' scores is easy. Every time a new game begins, you register this event by calling:
session.score_eventRegister("gameEvent.newGame");
To send the score, simply call:
session.score_setScore(ScoreSheetName, Score);
On game completion, you can optionally call:
session.score_eventRegister("gameEvent.gameCompleted");
5. Upload game and complete)
Once you have incorporated the code changes to your game, compile your .swf code and you can access our developer servers to test integration. If you intend on site-locking your game, please be sure to have your game look for these three locations:
1. www.hookedmediagroup.com
2. www.hookednetworks.com
3. www.gamook.com
Download the Developer Testing Document from the upload page on our website and follow the instructions to verify your integration.
Once you have tested your integration, just go to the developer upload page at our live site ( www.hookedmediagroup.com ) and upload the game into our network. It's that easy!
The testing process will be quite similar to the actual process of uploading your integrated games. You will need to go to
hookednetworks.com in order to access our developer server.
1. Register and sign in as developer.
Please register as a developer into the system. This account is different and isolated from any existing account in our main site (www.hookedmediagroup.com). Any changes made to the games in this account will not affect your games on the regular Hooked Media Group site in any way. You can't, however, create the same account as your Hooked Media Group one because of our validation procedures.
2. Go to the game upload page to get your API Key and API Secret.
The upload game page is where you set up your game info and upload the game. Make sure to choose the enable Yoo-Mee API integration. You will now receive unique GameAPI Key and Secret values. You need to pass in this info when you initialize the API from your game. Please do not close the browser page without completing upload.
3. Compile your game code and test locally
We have included an .html file with the API package that will allow you to test your integration locally. Replace the existing SWF with your game SWF and test the integration. The HTML will enable you to create sessions, send scores, get user scores, etc. Please note that this testing is completely client-side and all data communication is imitated. The data returned is dummy data generated on client.
4. Upload the .swf into our developer environment
After incorporating all the necessary code and methods you will need into your game code, you will need to compile the code for upload on the testbed. Complete the game upload and submit the compiled .swf file.
5. Create the appropriate Scoresheets for your game
Once you successfully upload your game, you will now be prompted to create Scoresheets for your game. Scoresheets will house the incoming scores from your game. You will need to specify Scoresheet attributes such as score type, ascending, etc. for your particular game. If you have different levels of difficulty, modes, or tracks in your game, you might consider creating separate Scoresheets (assuming you haven't standardized a scoring procedure) to receive scores respectively.
