konajugames / ouya-csharp

C# bindings for the OUYA Development Kit

ouya-csharp

C# bindings for the OUYA Development Kit 1.0.13

To get your Mono for Android game showing up in the OUYA Launcher, you will need to:

• set the project to use API Level 16. If using MonoGame, it requires the project be compiled with at least API Level 17.

• add the Launcher image (732x412 pixels) in Resources/Drawable-xhdpi/ouya_icon.png

• add the following IntentFilter attribute to your Activity class

  [IntentFilter(new[] { Intent.ActionMain } , Categories = new[] { Intent.CategoryLauncher, OuyaIntent.CategoryGame })]

• add your application key key.der file to your project under Resources/Raw.

Deploy the game to the device. Now it will show up in the OUYA Launcher.

Disclaimer: This project is a community-supported extension to the OUYA Development Kit and is in no way connected to OUYA, Inc. The OUYA name is owned by OUYA, Inc.

Prerequisites

The library uses the new async/await keywords that were introduced in Xamarin.Android 4.8. In order to use these keywords in Visual Studio 2010, you will need the Async CTP version 3.0 installed.

Examples

Using the new async/await style APIs is very simple. This example retrieves the products from the Store, initiates a purchase for the first item and if successful, retrieves the receipts.

    products = await facade.RequestProductListAsync("__TEST__01", "__TEST__02");
    var purchaseResult = await facade.RequestPurchaseAsync(products[0]);
    if (purchaseResult)
        receipts = await facade.RequestReceiptsAsync();

Error handling for this example simply involves wrapping it in a try..catch block.

Features

The gamer UUID and the receipts are now cached on the device. This allows the gamer UUID and the receipts to be retrieved even if there is no network connection. This requires no code support from the game as this is all done entirely within the OUYA C# library. The receipts are stored in an encrypted file to minimize potential for modification or falsification.

ouya-csharp's Issues

OuyaEncryptionHelper.DecryptReceiptResponse NoSuchMethodError

This causes a NoSuchMethodError at runtime:

var helper = new OuyaEncryptionHelper();
helper.DecryptReceiptResponse(jsonObject, publicKey);

The reason seems to be a signature mismatch: OuyaEncryptionHelper.DecryptReceiptResponse is defined with the first parameter being a org.json.JSONObject but this is overridden to become a java.lang.Object. This was done in f6e8084, in lines 49-50 of Metadata.xml:

<attr path= "//parameter[@type='org.json.JSONObject']" name="type">java.lang.Object</attr>
<attr path= "//parameter[@type='org.json.JSONArray']" name="type">java.lang.Object</attr>

The comment suggests it's only a temporary workaround. Could you explain why you had to override the JSON types?

ODK 1.0.4

ODK 1.0.4 was released a few days ago. Could you upgrade ouya-csharp to that ODK version? It's not urgent, but it's nice to be up to date.