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
We highly encourage the use of sounds to make the game play experience more exciting. Please allow easy access to sound controls so our users can make changes in case they are being disruptive.
2. Splash Screens
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
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
If you would still like to have multiple modes in your game, it?s important that a user must go through them sequentially so they cannot bypass a ?Fair Competition? in our system
Our Recommendation: If you must have different game modes, explicitly say on the screen that scores are only kept for a particular mode.
Or please: use multipliers to account for different difficulties
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 one score sheet currently. Your game can maintain different game play styles by only using one game mode or using a multiplier for socres at different difficultues.Create the score sheet 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
4. media-yoomee.com
5. www.yoo-mee.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. Use the client side testing file to test your integration.
When you receive the API package you'll find a testing file to test your integrated game. Use that file to make sure the minimum integration has been implemented.
2. Submit your game for review to a Hooked team member.
We'll help you through the entire integration process and can answer any technical questions you may have. When finalizing your integration, be sure to get in touch with a Hooked member so we can test you game locally at the office for completion.
3. Receive approval for your integrated game and upload to our network.
Once your game has been approved, you can upload it into our live distribution network for final testing and review by our team.
4. Start game distribution and come back to make tweaks!
Once your game is out for distribution you can always come back and make tweaks. Work with our team members to maximize the play of your games. All changes will be approved with the help of someone at Hooked so make sure to stay in touch!
