x


API integration for Unity

I have been doing a lot of research into iPhone development and have seen the light of APIs. I would like to use Xcode for the APIs but I want to use Unity for the engine. Is there a way I can integrate the APIs (like CoreMotion) into Unity so it compiles altogether so I don't have to worry about everything working together? Or are there unity APIs that do the same thing?

I am a beginning developer and need help. Links are great but explanations on how to integrate are better.

Thank you in advance!

more ▼

asked Sep 10 '10 at 02:41 AM

user-2241 (yahoo) gravatar image

user-2241 (yahoo)
34 1 1 4

(comments are locked)
10|3000 characters needed characters left

1 answer: sort voted first

Sure, Unity iPhone Advanced 1.7 supports "plugins" and Unity iPhone 3.0 will also support plugins (in other words, starting with 3.0 you will no longer need Unity iPhone Advanced in order to be able to use that feature).

There's a related question and answer: Specific steps to set up a plugin for iphone in XCode

There's also a couple of vendors that sell Plugins that make it very easy to access many of the iOS features that are not directly supported by Unity. One example would be: Unity 3 iPhone Plugins - Native Made Easy. As these come with full source code, they might also be a good starting point to learn the trade ;-)

EDIT: How to connect Unity scripts with plugins ... it's in the documentation but I only have a local link which wouldn't work for you, so I'm duplicating some of the information here (EDIT2: That documentation is now available online: Unity Manual > Advanced > Plugins - Pro/Mobile-Only Feature, thanks to ForceMagic for the note):

  1. Define your extern method like:

    [DllImport ("__Internal")] private static extern float FooPluginFunction();

  2. Hit build in Unity iPhone

  3. Add your native implementation to the generated XCode project's "Classes" folder (this folder is not overwritten when project is updated, but don't forget to backup your native code).

If you are using C++ (.cpp) or Objective-C (.mm) to implement the plugin you have to make sure the functions are declared with C linkage to avoid name mangling issues.

extern "C" {
  float FooPluginFunction();
} 

Using your plugin from C#

iPhone native plugins can be called only when deployed on the actual device, so it is recommended to wrap all native code methods with an additional C# code layer. This code could check Application.platform and call native methods only when running on the actual device and return mockup values when running in the Editor. Check the Bonjour browser sample application.

Calling C# / JavaScript back from native code Unity iPhone supports limited native->managed callback functionality via UnitySendMessage:

UnitySendMessage("GameObjectName1", "MethodName1", "Message to send");

This function has three parameters : game object name, game object script method to call, message to pass to the called method. Limitations to know:

only script methods that correspond to the following signature can be called from native code :

function MethodName(message:string)

calls to UnitySendMessage are asynchronous and have a one frame delay.

more ▼

answered Sep 10 '10 at 04:51 AM

jashan gravatar image

jashan
10.1k 25 40 116

Thanks Jashan! Those are very helpful links. The next thing that is holding me back is this. I can put these plugins into unity but how do I connect them to the object on the screen? Like for instance I add in accelerometer support but how do I connect it to lets say hit a drum?

Sep 10 '10 at 04:07 PM user-2241 (yahoo)

Well, with accelerometer support it might be a little tricky because for "hitting a drum", you may want to do some fancy calculations from the data you get from the accelerometer to figure out the user shook the device so that the drum should be hit. That's not trivial. But connecting the two technically is not that hard; I'll add something about this to my original answer ...

Sep 11 '10 at 12:43 PM jashan

I'm going to experiment with this for a while. Hopefully it works. But I'll try to get back to you with results!

Sep 15 '10 at 07:21 PM user-2241 (yahoo)

Well, no offense but linking the original page would have been faster. There is no new content on that awnser anyway, except for the related question and awnser.

http://unity3d.com/support/documentation/Manual/Plugins.html

Nov 22 '10 at 07:09 PM ForceMagic

At the time when I posted the answer, that part of the documentation wasn't in the public documentation, yet - that's why I copied the contents here. See also my remark in the beginning of the quote: "it's in the documentation but I only have a local link which wouldn't work for you, so I'm duplicating some of the information here". Had it been available in the public documentation back then, I would have posted just the link, of course (that was during the Unity 3 beta, with the NDA lifted ;-) ). But thanks for the heads up - I've added the link now that it is available.

Nov 29 '10 at 10:06 AM jashan
(comments are locked)
10|3000 characters needed characters left
Your answer
toggle preview:

Up to 2 attachments (including images) can be used with a maximum of 524.3 kB each and 1.0 MB total.

Follow this question

By Email:

Once you sign in you will be able to subscribe for any updates here

By RSS:

Answers

Answers and Comments

Topics:

x3747
x2001
x347
x85
x73

asked: Sep 10 '10 at 02:41 AM

Seen: 5155 times

Last Updated: Nov 19 '12 at 08:47 AM