Unreal Engine

Forums

Forge TV on Razer Forums
UnrealEngine Forums

Getting Started

UE4 on Cortex (28:49)

Cortex Support for UE4 with Tappy Chicken

Customize Tappy Chicken (2:50)

Quick Start

First you need an Unreal account
Link your Github account with your Unreal account per the wiki instructions
Only after linking your Github account will you have access to the UE4 Source.
After linking your Github account, you should have access to the Cortex Branches
4.10-Cortex branch for the Cortex Fork of UE4
4.9-OUYA branch for the Cortex Fork of UE4
4.8-OUYA branch for the Cortex Fork of UE4
4.7-OUYA branch for the Cortex Fork of UE4
4.6-OUYA branch for the Cortex Fork of UE4
Quick Link: Building the Cortex Fork of UE4
Quick Link: Getting Started in the UE4 Editor
Quick Link: Deploying to the Forge TV
Quick Link: Tappy Chicken Example
Quick Link: Virtual Controller Example
Quick Link: In-App-Purchase Example

FAQ

If you run and the screen is just all black or weird it could be a few issues:

Did you compile for Development Editor/Win64, Development Client/Android, and run copy_client_for_game.cmd?
Did you disable Mobile HDR lighting?
Did you add a Camera to your scene and set a default Level?
Did you install the specific version of the Tegra Android Development Pack? A specific version of TADP needs to be installed which is found in the Engine\Extras\Android\ folder.

Resources

Get the Unreal Engine - Unreal Engine and Source, All for 5% of Revenue after more than $3k gross revenue
Unreal Forum Post - Unreal - Tracking Cortex Plugin process and requests for info
UE4 Video Tutorials - Unreal - Unreal 4 Documentation
UE4 Video Playlist - Unreal - Epic Video Playlists
UE4 Programming Playlist - Unreal - Introduction to UE4 Programming Playlist
Android Quick Start - Unreal - Documentation steps for getting started with Unreal
Android Reference Guide - Unreal - Environment variable setup for Android publishing
Blueprints - Unreal - Visual Scripting
Introduction to Paper2D - Unreal - Intro to 2D sprites
Unreal Chat - #UnrealEngine on Freenode
C# for Unreal Engine - Write gameplay, AI, UI elements, and more with C#
Zeef Resource Page - Tons of Unreal resource links
Master Unreal Blueprints - Books and other resources for mastering Blueprints
Syncing Remote Fork - As EpicGames releases branch updates, the fork needs to be synced

Training and Jams

Training Streams happen Tuesdays for Q&A training sessions.
Weekly Unreal Twitch Stream
Game Jams - Epic hosts monthly game jams.
Answer Hub is the best way to get your questions about UE4 answered.

Documentation

Coding Documentation: Delegates
Coding Documentation: Functions
Coding Documentation: Properties/Core Data Types
Artificial Intelligence - AI Overview and Behavior Tree Quick Start Guide
JNI Spec - UE4 to Android communication uses the JNI specification
BLUI - BLUI is an open-source HTML renderer to make fancy UIs by embedding a browser into UE4

Branch Upgrade Guide

As UnrealEngine releases occur, the branch is forked and then merged into a corresponding 4.X-Cortex branch. Rebranching releases are handled for you, and the following documents the process.

Remote:

Add a GIT remote to the fork of EpicGames\UnrealEngine and copy the latest 4.X branch into a new local 4.X branch.
Remove the GIT remote to EpicGames\UnrealEngine and push the new branch.
Create a new branch from the 4.X branch to 4.X-Cortex.

Native Plugin Changes:

Merge Engine\Build\Android\Java\jni\Application.mk to ensure that Android API Level 16 or better can use the Cortex SDK.
Copy ouya-sdk.jar to the Android libs folder Engine\Build\Android\Java\libs.

Java Engine Changes:

Manually merge Android Java source changes Engine\Build\Android\Java\src.

C++ Launcher Changes:

Manually merge JNI and Launch changes Engine\Source\Runtime\Launch\Private\Android.

C++ Engine Blueprints:

Manually merge Engine header blueprints Engine\Source\Runtime\Engine\Classes\OuyaSDK.
Manually merge Engine source blueprints Engine\Source\Runtime\Engine\Private\OuyaSDK.

Build:

Rerun GenerateProjectFiles.bat to generate UE4.sln.
Open UE4.sln in Visual Studio 2015.
Build Development Editor for Win64.
Build Development for Android.
Launch Development Editor for Win64.
Build and test the example apps.

Commit:

Add to .gitignore so that ouya-sdk.jar can be committed.

!/Engine/Build/Android/Java/libs/ouya-sdk.jar

Build UE4

Download the 4.10-Cortex branch to get the Cortex fork of the Unreal Engine

git clone -b 4.10-Cortex https://github.com/tgraupmann/UnrealEngine
Cloning into 'UnrealEngine'...
remote: Counting objects: 243979, done.
remote: Compressing objects: 100% (53/53), done.
remote: Total 243979 (delta 8), reused 13 (delta 6)
Receiving objects: 100% (243979/243979), 291.48 MiB | 2.50 MiB/s, done.
Resolving deltas: 100% (172998/172998), done.
Checking connectivity... done.
Checking out files: 100% (26995/26995), done.

Important: The 4.6 release introduces a new system for downloading binary dependencies - just run the 'Setup' script in the root of your UE folder to get started. See the README or forum post for more information.

Follow the Build the Engine steps to generate the Visual Studio solution.

Open the UE4.sln in Visual Studio

Add Solution Configurations and Solutions Platforms to the Visual Studio Toolbar to easily target the UE4 build platforms.

Build the Development Editor on the Win64 platform which will build the UnrealEngine\Engine\Binaries\Win64\UE4Editor.exe editor application.

Build the Development Client on the Android platform which will build the UnrealEngine\Engine\Binaries\Android\UE4Client-armv7-es2.so native library.

Run the script UnrealEngine\Engine\Binaries\Android\copy_client_for_game.cmd to copy the native library as the UE4Game-armv7-es2.so dependency to use when building BluePrint projects.

Launch the UE4 editor from UnrealEngine\Engine\Binaries\Win64\UE4Editor.exe.

`UE4 Editor`

Create a New Project as a Blueprint project in the Unreal Project Browser to publish to Android the fastest. Select No Starter Content to reduce the file size. Enter a location of an empty folder to place the project and give it a name. Click Create Project.

Use the File->New Level menu item to create a new level.

Choose an Empty Level to start fresh.

Use the Object Browser and search for OUYA to add the OuyaController and OuyaSDK actors to the level.

Use the File->Save As menu item to save the level.

Enter a name for the level and click Save.

Open the Level Blueprint.

With OuyaSDK selected in the Scene Outliner, Right-Click to add a reference in the Level Blueprint.

With OuyaController selected in the Scene Outliner, Right-Click to add a reference in the Level Blueprint.

Click the Compile button to update the latest Blueprint changes after adding the OuyaSDK and OuyaController object references to the Level Blueprint.

Right-Click on the Event Graph to add an Event Tick to the Level Blueprint. The event adds an update event to the flow.

Right-Click on the Event Graph while the OuyaSDK object in the Scene Outliner is selected to add Ouya Get Any Button Down to the Level Blueprint. The event checks if any controller has a pressed event for the button parameter.

OUYA-Everywhere Input

Right-Click on the Event Graph while the OuyaController object in the Scene Outliner is selected to add Get BUTTON O to the Level Blueprint. The event gets the KeyCode for the BUTTON_O on the OUYA Controller.

Right-Click on the Event Graph while the OuyaSDK object in the Scene Outliner is selected to add Ouya Clear Button States to the Level Blueprint. The event clears any detected pressed and released states so the next Update Tick can detect the next events.

Click the Compile button to update the latest Blueprint changes after adding a set of events that will detect a pressed event for the given button for any OuyaController.

Click the Play button to verify the flow is functioning properly to troubleshoot any issues.

Deployment

Before building for Android check your Project Settings in the Unreal Editor.

Check Use OBB in APK in the Packaging settings to output a single APK.

Uncheck Mobile HDR in the Rendering settings.

Be sure to select the default level by clicking the Game Default Map drop down and selecting your default level in the Maps & Modes settings page.

Click Android in the Platforms section. You may need to click Configure Now to configure the project for the Android platform.

Set the Orientation to Landscape for the TV.

Click the Open Manifest Folder button to customize the manifest.

Be sure to check Package game data inside .apk? which was added in the 4.7 update.

The Android settings now auto-generate the AndroidManifest.xml in the 4.7 update.

Edit the AndroidManifest.xml in a Text-Editor.

Add the intent-filter so the game will appear in the Play section in the OUYA Launcher.

<category android:name="tv.ouya.intent.category.GAME" />

Build for Tegra 3 devices using the File->Package Project->Android->Android (DXT) menu item.

Browse for an empty folder or use the previous path to output the APK from the build process.

Click Show Output Log to watch for any packaging errors that may occur while building the APK.

A Blueprint only project should build within a few minutes versus a Code project which will take much longer.

Run the Install_ProjectName_Development.bat script to install to the connected Forge TV.

Generally the install takes 1 second per MB and prints Success when the install has completed.

Examples

Tappy Chicken

Tappy Chicken is a complete example project in the Unreal Launcher. The complete project can be installed within the MarketPlace in the Complete Projects section.

Double-Click the BP_MainGame blueprint to open the Event Graph of the Class Blueprint.

Add a Custom Event named OUYA_PLAY that simulates clicking on the PLAY button at the start of the game.

Add a Custom Event named OUYA_TOUCH that simulates "tapping anywhere" at the start of the game.

Add a Custom Event named OUYA_FLAP that simulates flapping the chicken during gameplay.

Compile the blueprint changes.
Open the Level Blueprint.

The following event flow adds the custom events needed to play Tappy Chicken on Cortex. If the BUTTON_O pressed event is detected on Any Cortex Controller then the custom events will be invoked for OUYA_PLAY, OUYA_TOUCH, and OUYA_FLAP. OUYA Clear Button States clears the detected pressed and released events so they can be detected in the next update frame.

Compile the blueprint changes.
Backup the changes with the File->Save All menu item.

Virtual Controller

The Virtual Controller example shows 4 images of the OUYA Controller which moves axises and highlights buttons when the physical controller is manipulated.

The Level Blueprint has a Setup Camera step that sets the Camera Actor as the view target since for this example the camera will remain in a fixed position.

The BP_Controller class blueprint provides a custom event named Update Controller Sprite which takes sprite parameter references in order to toggle visibility. The custom event first sets the parameters in variables for cleaner flow organization.

The Ouya Get Button event is used to get the current state of each controller button.

The menu button detection uses Ouya Get Button Down to catch the pressed event and then uses a Timer Delegate to clear the highlighted Menu Button after a second.

One issue with the timer is that we need to pass which menu sprite should be hidden and delegate timers don't have parameters.

Since we can't pass a delegate parameter, we use an array to store the menu sprite references to clear sprite visibility after the timer completes. Before calling the timer, we add the sprite actor reference to the array. When the delegate fires, all the sprite actor references are hidden and then the array is cleared.

The Ouya Get Axis event is used to get the axis value for a given controller axis.

For the Left Stick and Right Stick, the input is rotated to match the camera angle. The axis sprites are also moved in the rotated direction using the axis input.

The level blueprint passes sprite actor references from the scene to the class blueprint. The OuyaSDK and OuyaController are also passed to the Update Controller Sprite custom event.

The Scene Outliner shows all the Sprite Actor objects that make up a controller in a subfolder. The highlighted buttons and axis sprites are hidden by default. The left and right stick sprites are marked as Movable in the details tab.

The level blueprint shows mapping all the Scene Outliner sprites to the Update Controller Sprite custom event.

In-App-Purchases

The In-App-Purchases example shows making purchases, checking receipts, adjusting the safe area, and exiting the app.

The IAP example exposes the request purchase dialog.

Note: When opening the IAP sample app, set the project settings -> Android -> Android Package Name to tv.ouya.examples.unreal.inapppurchases.

The OuyaSDK provides methods to access In-App-Purchases:

AddInitOuyaPluginValues - Use to set the Developer Id
InitOuyaPlugin - Initialize the OuyaSDK to invoke IAP calls
RequestGamerInfo - Get the gamer's username and uuid
RequestProducts - Get the Product details
RequestPurchase - Purchase a Product
RequestReceipts - Verify the gamer has purchased the application
SetSafeArea - Adjust the safe area to control the border order
Shutdown - Shutdown/Exit the application

Delegates for onSuccess, onFailure, and onCancel parameters are created by using Custom Events. The red box on the top left of a Custom Event will connect to a Delegate parameter.

Add Init Ouya Plugin Values

Invoking Add Init Ouya Plugin Values has 2 delegates for onSuccess and onFailure. Add Init Ouya Plugin Values takes two String inputs for Key and Value. Key accepts tv.ouya.developer_id with the Value being your developer id from the developer portal.

Be sure to set your DEVELOPER_ID from the Developer Portal.

Upon success or failure, the Add Init Ouya Plugin Values callbacks will be invoked. onSuccess provides no arguments. onFailure receives an integer ErrorCode and string Error Message about the failure. Upon success, the InitOuyaPlugin can be invoked.

Xiaomi Initialization

Back to general info

addInitOuyaPluginValues supports additional strings to make the game compatible with OUYA Everywhere devices.

tv.ouya.developer_id - The developer UUID can be found in the developer portal after logging in.
com.xiaomi.app_id - The Xiaomi App Id is provided by the content team, email officehours@ouya.tv to obtain your key.
com.xiaomi.app_key - The Xiaomi App Key is provided by the content team, email officehours@ouya.tv to obtain your key.
tv.ouya.product_id_list - The product id list is a comma separated list of product ids that can be purchased in the game.

Init Ouya Plugin

Init Ouya Plugin has 2 delegates for onSuccess and onFailure. Be sure to invoke Add Init Ouya Plugin Values successfully before invoking Init Ouya Plugin.

Upon success or failure, the Init Ouya Plugin callbacks will be invoked. onSuccess provides no arguments. onFailure receives an integer ErrorCode and string Error Message about the failure. Upon success, the other OuyaSDK methods can be invoked.

Request Gamer Info

Request Gamer Info has 3 delegates for onSuccess, onFailure, and onCancel.

Upon success, failure, or cancel, the Request Gamer Info callbacks will be invoked. onSuccess provides a Gamer Info result object. onFailure receives an integer ErrorCode and string Error Message about the failure. onCancel receives no arguments.

The Gamer Info object has Username and Uuid fields that can be accessed.

Request Products

Request Products has 3 delegates for onSuccess, onFailure, and onCancel.

Before invoking Request Products be sure to create a string array of product identifiers.

Upon success, failure, or cancel, the Request Products callbacks will be invoked. onSuccess provides an Ouya Product result array. onFailure receives an integer ErrorCode and string Error Message about the failure. onCancel receives no arguments.

The example iterates through the Ouya Product array to get the details for each Ouya Product object.

Several Ouya Product fields are available. The example uses a highlight mechanism to select one of the returned Ouya Product object's identifier for the Request Purchase button.

Request Purchase

Request Purchase has 3 delegates for onSuccess, onFailure, and onCancel.

The example uses the Result Products array variable which is set in the onSuccessRequestProducts callback. Since the purchasable parameter for Request Purchase takes a string argument, you can hardcode the value, pass a string, or use an array element like the example.

Upon success, failure, or cancel, the Request Purchase callbacks will be invoked. onSuccess provides an Ouya Purchase Result result object. onFailure receives an integer ErrorCode and string Error Message about the failure. onCancel receives no arguments.

Request Receipts

Request Receipts has 3 delegates for onSuccess, onFailure, and onCancel.

Upon success, or failure, or cancel, the Request Receipts callbacks will be invoked. onSuccess provides an Ouya Receipt result array. onFailure receives an integer ErrorCode and string Error Message about the failure. onCancel receives no arguments.

The example iterates through the Ouya Receipt array to get the details for each Ouya Receipt object.

Several Ouya Receipt fields are available including the identifier which games can check for if a entitlement was purchased.

Shutdown

Shutdown has 2 delegates for onSuccess and onFailure.

Upon success or failure, the Shutdown callbacks will be invoked.

Community Content

The Community Content example shows how to interact with the Community Content API from blueprints.

Success Callbacks

The examples use a Status text field to display the current status. The setTextStatus custom event is reused as a helper to display the status.

Failure Callbacks

Most failure callbacks have an errorCode and errorMessage which are displayed in status text field for the examples. The setErrorTextStatus custom event can be reused to simplify the failure callbacks.

Get OUYA Content

Before interacting with the Community Content API, get a reference to the OUYA Content actor.
Upon success, or failure the Get OUYA Content callbacks will be invoked.
onSuccess receives a reference to the OuyaContent actor.
onFailure receives an errorCode and errorMessage details about the failure.

Initialize OUYA Content

Init has 2 delegates for onContentInitialized and onContentDestroyed. The onContentInitialized delegate will be called with OuyaContent has been initialized. The onContentDestroyed delegate will be called with OuyaContent has been destroyed.
OuyaContent should be initialized before invoking other Community Content methods.

Create OUYA Mod

CreateOuyaMod creates a local Community Content record which you can use for editing and publishing.
Upon success or failure the CreateOuyaMod callbacks will be invoked.
onSuccess receives a reference to the OuyaMod actor.
onFailure receives an errorCode and errorMessage details about the failure.

Delete OUYA Mod

Upon success, or failure, the Delete callbacks will be invoked.
onSuccess receives the Ouya Mod object that was deleted.
onFailure receives an Ouya Mod object, an integer ErrorCode and string Error Message about the failure.

Download OUYA Mod

Upon download complete, download progress, or download failure, the Download callbacks will be invoked.
onComplete receives the Ouya Mod object that was downloaded.
onProgress receives the Ouya Mod object that is downloading and an integer progress.
onFailure receives the Ouya Mod object that failed to download.

Edit OUYA Mod

Upon success, or failure, the Edit OuyaMod callbacks will be invoked.
onSuccess receives a reference to the OuyaModEditor and OuyaMod actors.
onFailure receives the associated OuyaMod actor, an errorCode and errorMessage details about the failure.

Flag OUYA Mod

The Flag function will open the dialog to Flag the content item for review.

Get Category

Get Category on the OuyaMod actor gets the string category field.

Get Description

Get Description on the OuyaMod actor gets the string description field.

Get Filenames

Get Filenames on the OuyaMod actor gets an array of filename string objects.

Get Meta Data

Get Meta Data on the OuyaMod actor gets the string meta data field.

Get Installed OUYA Content

Upon success, or error, the Get Installed OUYA Content callbacks will be invoked.
onSuccess receives a reference to an array of OuyaMod actors, and the Integer count of installed items.
onError receives an errorCode and errorMessage details about the failure.

Get Published OUYA Content

Upon success, or error, the Get Published OUYA Content callbacks will be invoked.
onSuccess receives a reference to an array of OuyaMod actors, and the Integer count of published items.
onError receives an errorCode and errorMessage details about the failure.

Get Rating Average

Get Rating Average on the OuyaMod actor gets the float rating average field.

Get Rating Count

Get Rating Count on the OuyaMod actor gets the integer rating count field.

Get Screenshots

Upon success, or failure, the Get Screenshots callbacks will be invoked.
onSuccess provides an Ouya Mod object and Ouya Mod Screenshot result array.
onFailure receives an Ouya Mod object, an integer ErrorCode and string Error Message about the failure.

Get Tags

Get Tags on the OuyaMod actor gets an array of tag string objects.

Get Text File

Get Text File on the OuyaMod actor passes a FString filename argument and returns a FString of the file contents.

Get Title

Get Title on the OuyaMod actor gets the string title field.

Get User Rating

Get User Rating on the OuyaMod actor gets the float user rating field.

Is Downloading

Is Downloading on the OuyaMod actor gets the boolean is downloading field.

Is Flagged

Is Flagged on the OuyaMod actor gets the boolean is flagged field.

Is Installed

Is Installed on the OuyaMod actor gets the boolean is installed field.

Is Published

Is Published on the OuyaMod actor gets the boolean is published field.

Rate OUYA Mod

The Rate function will open the dialog to Rate the content item by the user.

OUYA Mod Editor Add Screenshot

The Add Screenshot function on OuyaModEditor will add the UTexture2D to the OuyaMod actor being edited.

OUYA Mod Editor Add Tag

The Add Tag function on OuyaModEditor will add the string tag to the associated OuyaMod actor being edited.

OUYA Mod Editor Delete Filename

The Delete Filename function on OuyaModEditor will delete string filename associated OuyaMod actor being edited.

OUYA Mod Editor New Text File

The New Text File function on OuyaModEditor will create a string filename associated OuyaMod actor being edited and the contents of the file are passed as a string .

OUYA Mod Editor Remove Screenshot

The Remove Screenshot function on OuyaModEditor will remove the OuyaModScreenshot from the OuyaMod actor being edited.

OUYA Mod Editor Remove Tag

The Remove Tag function on OuyaModEditor will remove the string tag from the OuyaMod actor being edited.

OUYA Mod Editor Save

The Save function on OuyaModEditor will save the associated OuyaMod actor being edited.

OUYA Mod Editor Set Category

The Set Category function on OuyaModEditor will set the string category on the OuyaMod actor being edited.

OUYA Mod Editor Set Description

The Set Description function on OuyaModEditor will set the string description on the OuyaMod actor being edited.

OUYA Mod Editor Set Meta Data

The Set Meta Data function on OuyaModEditor will set the string meta data on the OuyaMod actor being edited.

OUYA Mod Editor Set Title

The Set Title function on OuyaModEditor will set the string title on the OuyaMod actor being edited.

Publish OUYA Mod

Upon success, or failure, the Publish callbacks will be invoked.
onSuccess receives the Ouya Mod object that was published.
onFailure receives an Ouya Mod object, an integer ErrorCode and string Error Message about the failure.

Unpublish OUYA Mod

Upon success, or failure, the Unpublish callbacks will be invoked.
onSuccess receives the Ouya Mod object that was unpublished.
onFailure receives an Ouya Mod object, an integer ErrorCode and string Error Message about the failure.

GetImage

Invoking GetImage on the OuyaModScreenshot actor returns a UTexture2D image.

GetThumbnail

Invoking GetThumbnail on the OuyaModScreenshot actor returns a UTexture2D image.

Forge TV

To be able to run UE4 on the Forge TV be sure to use the 4.7-OUYA, 4.8-OUYA, or 4.9-OUYA branch.

Building Source

Be sure to upgrade the Android NDK to R10E or later. And update your environment variables to point to the downloaded location.

ANDROID_NDK_ROOT
NDKROOT
NDK_ROOT

Build the following targets before launching the Unreal Editor to support publishing to ARM for Forge TV.

Development Editor for Win64
Development Client for Android
Development for Win64
Development for Android

Texture Compression

For sprites to appear in the Forge TV be sure to set the compression format as the default compression format will not display on Forge TV.

Browse to your texture images in the Content Browser and double-click on the texture item.

Change the texture format to TC_UserInterface2D or similar format and click Save to support the texture on Forge TV.

Android settings

UE4 version 4.7 added AndroidManifest.xml editing to the Project Settings.

Be sure to enable Package game data inside apk?.
Add the following intent-filter entry for Extra Settings for <activity> section which should fit all on the same line. This allows the game to appear on the main Forge TV launcher and in the OUYA play store.

<intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /><category android:name="tv.ouya.intent.category.GAME" /></intent-filter>

Wake Lock

Be sure to add the WAKE_LOCK permission to prevent a screensaver from displaying while the UE4 game is running.

Click the + button next to Extra Permissions to add an element.
In the new element enter android.permission.WAKE_LOCK.

Files

unreal.md

Latest commit

History