Gamasutra: The Art & Business of Making Gamesspacer
View All     RSS
August 31, 2014
arrowPress Releases
August 31, 2014
PR Newswire
View All
View All     Submit Event





If you enjoy reading this site, you might also want to check out these UBM Tech sites:


 
Setting Up OUYA for Unity
by Josh Sutphin on 05/05/13 02:09:00 pm   Expert Blogs   Featured Blogs

The following blog post, unless otherwise noted, was written by a member of Gamasutra’s community.
The thoughts and opinions expressed are those of the writer and not Gamasutra or its parent company.

 

(This article originally appeared at third-helix.com)

OUYA devkits have been in the hands of Kickstarter backers since the beginning of the year, but I’ve only just recently gotten around to setting mine up to work with Unity. I ran into a bunch of stumbling blocks along the way, but now that I’ve got everything up and running I thought I’d write up my experiences and fixes in an easy-to-use step-by-step guide.

A couple notes first:

  • The most up-to-date (if sparse) setup information is located at https://devs.ouya.tv/developers/docs/setup
  • I found a lot of these solutions in IQpierce’s excellent forum thread, although I had to tweak the formula slightly to get everything working with ODK 1.0.0
  • I set this up on a Mac using Unity Pro 3.5.7f6 and ODK 1.0.0. From what I’ve seen, Unity 4 setup should be the same. And if you’re on Windows, you’ll probably just have to tweak a couple paths during the part where we’re going to use Terminal (which for you will just be regular ol’ cmd.exe).

Ok, let’s get to it!

Android SDK

Since OUYA runs on Android, you’ll need the Android SDK. Go to http://developer.android.com/sdk/index.html and click the big blue button on the right, “Download the SDK (ADT Bundle for Mac)”. Unzip it directly to wherever you want to install it; I just dragged the adt-bundle-mac-x86_64-20130219 folder directly into Applications.

Open a Terminal instance and execute the following two commands (adjust the path if you installed the SDK somewhere else):

  • cd /Applications/adt-bundle-mac-x86_64-20130219/sdk/tools
  • ./android sdk

The Android SDK Manager will open. It looks like this:

android sdk install

Check the packages you want to install, as shown in the screenshot. They are:

  • Tools (all)
  • Android 4.1.2 (API 16) (all)
  • Android 4.0 (API 14) (all)
  • Extra/Android Support Library

Click “Install Packages”. A license window will pop up; check everything on the left and click “Accept Licenses”. Wait for everything to download and install.

Once that’s done, you’ll also need to install the Android NDK. Download it from http://developer.android.com/tools/sdk/ndk/index.html and unzip it somewhere; I simply dragged the ndk folder into Applications/adt-bundle-mac-x86_64-20130219 to keep it with the SDK.

There is a bug in NDK version r8d (current as of this writing) that you’ll need to fix manually. Navigate to ndk/build/gmsl and open the file __gmsl in a text editor. Replace line 512 with the following:

  • int_encode = $(__gmsl_tr1)$(wordlist 1,$(words $1),$(__gmsl_input_int))

Save __gmsl, and you’re done setting up the Android SDK.

OUYA Development Kit (ODK)

Download the latest ODK from https://devs.ouya.tv/developers/odk and unzip it somewhere; I simply dragged the OUYA-ODK folder into Applications/adt-bundle-mac-x86_64-20130219, even though it’s not technically part of the Android SDK, just to keep all this stuff together.

For reference, this is what my final SDK install directory looks like:

sdk install folder

Unity Project Setup

Launch Unity and create a new, blank project. Your first order of business will be to import the core ODK. Go to “Assets -> Import Package -> Custom Package” and navigate to OUYA-ODK/Packages/Unity. There are three packages here, but you only need one: OuyaSDK-Core.

(The other packages are OUYA samples and an NGUI distribution upon which they depend, in case you’re curious. For this guide, we are not.)

After importing the OuyaSDK-Core package you’ll probably see some script errors. Unfortunately package version 0.0.5.1d (current as of this writing) contains a few bugs that you’ll need to fix manually:

  • In OuyaInputManager.cs: Comment out line 445 (call to nonexistent NGUIDebug.Log)
  • In OuyaPanel.cs: On line 717 remove the \”{0}/IOuyaActivity.java\” portion from the String.Format call
  • In OuyaMenuAdmin.cs: On line 166 remove the \”{0}/IOuyaActivity.java\” portion from the String.Format call
  • In OuyaMenuAdmin.cs: Comment out line 236 which refers to tv.ouya.sdk.IOuyaActivity

These should clear up any script errors, as well as inoculating us against a problem that otherwise would’ve killed our build dead in its tracks here in a few minutes.

Next, go to “File -> Build Settings”, then select Android as your platform and click “Switch Platform”. I also set Texture Compression to “DXT (Tegra)” and checked “Development Build”.

Click into “Player Settings” and pop open the “Resolution and Presentation” section, and set the Default Orientation to “Landscape Left”.

Now pop open the “Other Settings” section and set the Minimum API Level to “Android 4.1 ‘Jelly Bean’ (API Level 16)”, which matches the Android OS version on the OUYA hardware.

Bundle Identifier

Your game must have a unique “bundle identifier” which is used in a number of places. If it’s invalid or doesn’t match across the board, your game will either fail to build or fail to run, so it’s important to get this part right.

First, you need to come up with a bundle identifier. These are expressed in reverse-domain notation, usually something like com.CompanyName.ProductName. Note that you can only use alphanumeric characters and underscores, and the first character must be a letter.

Now you need to enter that bundle identifier in three places:

  • In Unity’s Player Settings, in the “Other Settings” section, in the “Bundle Identifier” field.
  • In Assets/Plugins/Android/AndroidManifest.xml there is a tag with a “package” attribute, the value for which should be your bundle identifier.
  • In Assets/Plugins/Android/src/OuyaUnityApplication.java, the first line should read “package YOUR_BUNDLE_IDENTIFIER;”. (Don’t include the quotes, but do include the semicolon!)

The OUYA Panel

Back in Unity, go to “Window -> Open OUYA Panel”. It looks like this:

ouya panel setup

This panel shows you a bunch of information about your build environment. If anything is grayed out, or displayed in red, then something is wrong. Most notably, if “App Java Pack” and/or “Manifest Pack” are shown in red, then that probably means there’s a bundle identifier mismatch somewhere: double-check the steps in the previous section and make sure there aren’t any dumb typos or anything.

Click through the five tabs across the top and make sure everything is in the clear: nothing grayed out, nothing highlighted red. (On the Android SDK and Android NDK tabs you may need to click “Select SDK Path…” and navigate to your SDK/NDK install folders; you should only need to do this once, ever.)

Once all that’s resolved, click back to the OUYA tab and click the “Compile” button. This will compile a bunch of, um… stuff. That you need. It’s rather opaque. You should only need to do it just the once, though (unless you change your bundle identifier in the future, in which case you’ll need to recompile everything).

Create a Test Scene

Create a new scene, and create an instance of the OuyaGameObject prefab in it. This object “communicates with the Ouya SDK” and it’s necessary to have one. You only need one, though: it’s got DontDestroyOnLoad set, so ultimately you can toss it in your intro/startup scene and never have to think about it again.

You need to make one change to it, though: on the instance you just added, set the DEVELOPER_ID field to your OUYA developer UUID. This is displayed on the landing page at https://devs.ouya.tv/developers once you sign in.

App Name and Icon

Your app’s display name — as displayed to players in the OUYA dashboard — is contained in Assets/Plugins/Android/res/values/strings.xml. There’s only the one string (called “app_name”) so this should be pretty straightforward.

Your app icon is located in Assets/Plugins/Android/res/drawable/app_icon.png. Simply replace it with a 96x96 icon of your own devising. (I recommend doing this soon if only because the default icon is shockingly ugly and I promise you don’t want it associated with your game any longer than it needs to be!)

Build and Deploy

Connect your OUYA to your computer using the supplied USB cable (note that it’s mini-USB at the OUYA end!) and turn it on. It probably goes without saying, but make sure it’s connected to some kind of display, too. ;)

In Unity, go to “File -> Build Settings” and add your test scene, then click “Build and Run”. If all goes well, your test scene should (finally!) come up on the OUYA in a few moments!

Once your application is running, double-tap the home button on the controller to return to the OUYA system menu. From here you can re-launch the game (or any other installed builds) by going to “Make -> Software”.

Have a Drink!

Seriously: after all that, maybe consider having two. ;)

Let me know in the comments if you run into any errors in this guide, particularly with respect to any ODK and/or Unity plugin updates I might've missed, and I'll update the article accordingly.

Happy OUYA-ing!

(Josh Sutphin is an indie game developer, former lead designer of Starhawk (PS3), and creator of the Ludum Dare-winning RTS/tower-defense hybrid Fail-Deadly. He blogs at third-helix.com and tweets nonsense at @invicticide.)


Related Jobs

Raven Software / Activision
Raven Software / Activision — Madison, Wisconsin, United States
[08.30.14]

Sr. Software Engineer (Gameplay)
Infinity Ward / Activision
Infinity Ward / Activision — Woodland Hills, California, United States
[08.30.14]

Senior AI Engineer
Infinity Ward / Activision
Infinity Ward / Activision — Woodland Hills, California, United States
[08.30.14]

Lead Tools Engineer - Infinity Ward
Insomniac Games
Insomniac Games — Burbank , California, United States
[08.29.14]

Senior Engine Programmer






Comments


Timothy Graupmann
profile image
The latest release of the ODK is 1.0.3.

The latest release of the OUYA Unity Package is 1.0.3.11 updates can be found here:
http://tagenigma.com/ouya/OuyaSDK-1.0.0/

The package consists of core, examples, and a starter-kit. The update page also has a detailed PDF to help you get started.

Going forward updates will be posted to a public GIT repository owned by OUYA, which I will moderate.

Steve Cawood
profile image
Thanks for this tutorial.


none
 
Comment: