Request for coding native plugins guide

Block do act as Lua closure, and everything is still valid in it. Otherwise you wouldn’t be able to access L in it at all. Point here that while Lua is single threaded, Objective C (and Java) isn’t. So you “have to wait” for your turn to access it on “main thread”. This is exactly what dispatch_async(dispatch_get_main_queue(), ^{…}) does. It creates a block on main thread, which would wait for it’s turn to be executed when everything else is done.

Ok - thanks for the update.

I have been able to get it work (in a fashion), what I did was store a local copy of the fListener variable rather than using the value in the userdata and it didn’t crash. 

Obviously this isn’t a viable long term solution and I’d like to understand why I can’t access the correct reference from the userdata but it doesn’t crash (which is a start :wink: )

I’m going to work this week on rebuilding our iOS Enterprise Tutorial so that it’s Corona Native friendly. Stay tuned.

Rob

Hello Rob! Thank you a lot!!! Hope there would be some step by step guide <3
And sorry for off top but just want to ask why native elements are prior in elements hierarchy 

Corona’s display objects (display.newCircle, display.newImageRect etc. and everything based on them like widgets) are done in OpenGL. On all systems, OpenGL is it’s own window or canvas. You cannot mix native objects like native.newTextField() with OpenGL because they don’t generate OpenGL textures that can be pushed through the graphics pipeline. OpenGL is processed mostly by the devices GPU (Graphics Processing Unit) while native objects are exclusively done with the CPU (main computer chip). They just can’t mix.

We have set things up where you can put native.* objects into a display.newGroup() so that when you move the group, the native.* objects move with it, but that’s the only feature you get with grouping.

Rob

Hey Rob, how u doin, any news about this stuff?

I made a blog post on this and send over to corona. Hopefully the blog will be published.

thx mate hope is there any link available to see the post after publish??

Today is Labor Day in the us, which is a work holiday. I don’t think a lot of the corona staff is here today.

Scott is right, we are on a holiday in the US. I’ve glanced over his submission and to set reasonable expectations, it could be a week or more before this gets published.  Let me explain.

We are working on a new public release. All hands will be involved in testing this week. So there is no bandwidth until we complete testing.

Next, we re no longer putting tutorials in our blog. They will be published to our Tutorials section on our Docs site. Why? The blog does a horrible job at formatting code and it’s hard to maintain them. We might publish a referring post on the blog to let people know about the new tutorial.  For this to happen, I have to convert Scott’s post to Markdown and then it will have to go trough editing that will have to be scheduled in with all of our other publishing work.  Depending on my release testing this week, I can probably get it converted to Markdown laster this week, but I can’t see it being published this week.

Scott, what might be more efficient is for you to post this to your website. If you want this up ASAP, that’s going to be your best route. We just need time to get this done.

Rob

I forgot to add, I’ve converted the original iOS Enterprise tutorial to our new system, it’s waiting on editing.

Rob

Thanks Rob. I have never done a guest blog post before so I had no idea. azbik999 I will pm you a link to the google docs file. My site is all html based so creating a new blog section on my site would be tricking. I want it to be seen more so I think would be better on Corona’s site.

thx alot Scott! I will wait for your message <3

Just my quick $0.02 - I’m also really interested to see this tutorial as I’m also struggling to get up to speed with Corona Native.

Many thanks to Rob & Scott for helping out like this, can’t wait for the post.

Also Scott, I’d also love to see the original Google Doc for this if the link is still available :wink:

Our iOS Native tutorial is now live:  https://docs.coronalabs.com/tutorial/native/iosIntro/index.html

It takes you through the process of making a plugin, then integrating it into a native built Corona app. We are going to begin working on re-imagining the old Android Enterprise tutorial. It’s going to take a little longer for a couple of reasons. First, it’s ANT based not Android Studio based, so we are going to have to get all those instructions re-captured with screen shots, etc. that we didn’t have before (command line is your friend :slight_smile:    Secondly, that tutorial didn’t make a plugin. It just let you call native code from Corona. If we want to have it support making a plugin, we need to come up with a simple plugin to do.

Rob

Just working through the tutorial now - looks like an excellent reference, awesome job Scott (& Rob).

Can’t wait for the Android one as well :slight_smile:

Hi Rob / Scott,

Sorry to hijack the thread but I’ve worked through the tutorial and got a test plugin working for simple cases - ie I can register a function, call it from my Lua code and have it generate an event which get’s picked up by the listener function registered when I call the plugin .init function.

However when I want to take it to the next level I’m hitting an issue.  I’m developing a plugin with a simple interface.

plugin.init( listener ) -- initialise the plugin and register the event listener plugin.start() -- start a monitoring process that continually sends events back to the listener plugin.stop() -- stop the monitoring process

To implement the monitoring / recording process in my Objective C code in the start function I use an NSTimer scheduledTimerWithTimeInterval : block to basically create a closure and this appears to work fine - the block repeats fine and will happily NSLog() until I call the stop() function which calls the invalidate method on the above NSTimer instance.

However when I attempt to create a new event from within the block the code stops at the following line 

Self \*library = (Self \*)CoronaLuaToUserdata( L, lua\_upvalueindex( 1 ) );

With an EXC_BAD_ACCESS (code=1, address=0x0b) error - as far as I can tell it’s getting a null reference from somewhere but I can’t work out why.

Here’s the code from my plugin

class PluginLibrary { protected: PluginLibrary(); static int Finalizer( lua\_State \*L ); public: typedef PluginLibrary Self; &nbsp;&nbsp;&nbsp;&nbsp;static const char kName[]; &nbsp;&nbsp;&nbsp;&nbsp;static const char kEvent[]; &nbsp;&nbsp;&nbsp;&nbsp;bool Initialize( CoronaLuaRef listener ); &nbsp;&nbsp;&nbsp;&nbsp;CoronaLuaRef GetListener() const { return fListener; } static int Open( lua\_State \*L ); static Self \*ToLibrary( lua\_State \*L ); static int init( lua\_State \*L ); static int start( lua\_State \*L ); static int stop( lua\_State \*L ); static int trigger( lua\_State \*L ); private: static void sendMessage( lua\_State \*L, NSString \*message ); static void sendFrequency( lua\_State \*L, double frequency ); static int updateCounter(); &nbsp;&nbsp;&nbsp;&nbsp;CoronaLuaRef fListener; }; // ---------------------------------------------------------------------------- int fakeFreqValue; bool recording; NSTimer \*heartbeat; // ---------------------------------------------------------------------------- const char PluginLibrary::kName[] = "plugin.tuner"; // This corresponds to the name of the library, e.g. [Lua] require "plugin.library" const char PluginLibrary::kEvent[] = "Tuner"; // This corresponds to the event name, e.g. [Lua] event.name PluginLibrary::PluginLibrary() : fListener( NULL ) { fakeFreqValue = 0; recording = NO; heartbeat = nil; } bool PluginLibrary::Initialize( CoronaLuaRef listener ) { &nbsp;&nbsp;&nbsp;&nbsp;// Can only initialize listener once &nbsp;&nbsp;&nbsp;&nbsp;bool result = ( NULL == fListener ); &nbsp;&nbsp;&nbsp;&nbsp;if ( result ) { fListener = listener; } &nbsp;&nbsp;&nbsp;&nbsp;return result; } int PluginLibrary::Open( lua\_State \*L ) { &nbsp;&nbsp;&nbsp;&nbsp;// Register \_\_gc callback &nbsp;&nbsp;&nbsp;&nbsp;const char kMetatableName[] = \_\_FILE\_\_; // Globally unique string to prevent collision &nbsp;&nbsp;&nbsp;&nbsp;CoronaLuaInitializeGCMetatable( L, kMetatableName, Finalizer ); &nbsp;&nbsp;&nbsp;&nbsp;// Functions in library &nbsp;&nbsp;&nbsp;&nbsp;const luaL\_Reg kVTable[] = &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;{ "init", init }, &nbsp;&nbsp;&nbsp;&nbsp;{ "start", start }, { "stop", stop }, { "trigger", trigger }, &nbsp;&nbsp;&nbsp;&nbsp;{ NULL, NULL } &nbsp;&nbsp;&nbsp;&nbsp;}; &nbsp;&nbsp;&nbsp;&nbsp;// Set library as upvalue for each library function &nbsp;&nbsp;&nbsp;&nbsp;Self \*library = new Self; &nbsp;&nbsp;&nbsp;&nbsp;CoronaLuaPushUserdata( L, library, kMetatableName ); &nbsp;&nbsp;&nbsp;&nbsp;luaL\_openlib( L, kName, kVTable, 1 ); // leave "library" on top of stack &nbsp;&nbsp;&nbsp;&nbsp;return 1; } int PluginLibrary::Finalizer( lua\_State \*L ) { &nbsp;&nbsp;&nbsp;&nbsp;Self \*library = (Self \*)CoronaLuaToUserdata( L, 1 ); &nbsp;&nbsp;&nbsp;&nbsp;CoronaLuaDeleteRef( L, library-\>GetListener() ); &nbsp;&nbsp;&nbsp;&nbsp;delete library; &nbsp;&nbsp;&nbsp;&nbsp;return 0; } PluginLibrary \*PluginLibrary::ToLibrary( lua\_State \*L ) { &nbsp;&nbsp;&nbsp;&nbsp;// library is pushed as part of the closure &nbsp;&nbsp;&nbsp;&nbsp;Self \*library = (Self \*)CoronaLuaToUserdata( L, lua\_upvalueindex( 1 ) ); &nbsp;&nbsp;&nbsp;&nbsp;return library; } // [Lua] library.init( listener ) int PluginLibrary::init( lua\_State \*L ) { &nbsp;&nbsp;&nbsp;&nbsp;int listenerIndex = 1; // TODO - Request permission to use the microphone... &nbsp;&nbsp;&nbsp;&nbsp;if ( CoronaLuaIsListener( L, listenerIndex, kEvent ) ) &nbsp;&nbsp;&nbsp;&nbsp;{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Self \*library = ToLibrary( L ); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;CoronaLuaRef listener = CoronaLuaNewRef( L, listenerIndex ); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;library-\>Initialize( listener ); &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;return 0; } int PluginLibrary::updateCounter() { fakeFreqValue += 1; return fakeFreqValue; } // [Lua] library.start( word ) - start sampling int PluginLibrary::start( lua\_State \*L ) { if (!recording) { // Start sampling the mic and set up a regular heartbeat to send the calculated frequency value via the registered listener... NSString \*message = @"Recording..."; // Fake with a simple counter for now... heartbeat = [NSTimer scheduledTimerWithTimeInterval:1.0 repeats:YES block:^(NSTimer \* \_Nonnull timer) { // NSLog(@"Bing %i",updateCounter()); sendFrequency(L, updateCounter()); }]; recording = YES; sendMessage(L, message); } return 0; } // [Lua] library.off( word ) - stop sampling int PluginLibrary::stop( lua\_State \*L ) { if (recording) { // Stop sampling the mic and stop the heartbeat function... NSString \*message = @"Stopped"; [heartbeat invalidate]; heartbeat = nil; recording = NO; fakeFreqValue = 0; sendMessage(L, message); } return 0; } // [Lua] library.trigger( word ) - force a read and transmit via a despatched event... int PluginLibrary::trigger( lua\_State \*L ) { fakeFreqValue += 1; sendFrequency(L, (double)fakeFreqValue); return 0; } // ---------------------------------------------------------------------------- void PluginLibrary::sendMessage( lua\_State \*L, NSString \*message ) { // Create event and add the data to it Self \*library = ToLibrary(L); CoronaLuaNewEvent(L, kEvent); lua\_pushstring(L, [message UTF8String]); lua\_setfield(L,-2,"message"); CoronaLuaDispatchEvent(L, library-\>GetListener(), 0); } void PluginLibrary::sendFrequency( lua\_State \*L, double value ) { NSLog(@"sendFrequency %f",value); lua\_Number frequency = value; // Create event and add the data to it Self \*library = ToLibrary(L); // \<\<-- This is where it blows up when called from within a block CoronaLuaNewEvent(L, kEvent); lua\_pushnumber(L, frequency); lua\_setfield(L,-2,"frequency"); CoronaLuaDispatchEvent(L, library-\>GetListener(), 0); }

Any help or pointers in the right direction would be gratefully appreciated.

I’ll see if I can get an engineer to look into this.  FWIW, it would have been better to start a new thread.

Rob

Thanks Rob,

I’m happy to open a new thread and repost my question there.

Hello! Think about this from following perspective:

When timer is called, where is you Lua state? It is probably in the middle of some other function, doing it’s own stuff. Trying to send things to it is rather dangerous, because it is not prepared. I answered to similar issue/question on this thread:

https://forums.coronalabs.com/topic/69480-sample-code-that-says-warning-this-method-is-not-called-on-the-main-ui-thread/?hl=dispatch_get_main_queue#entry363153

You can fix your code with something like this:

void PluginLibrary::sendFrequency( lua\_State \*L, double value ) { NSLog(@"sendFrequency %f",value); lua\_Number frequency = value; dispatch\_async(dispatch\_get\_main\_queue(), ^{ Self \*library = ToLibrary(L); CoronaLuaNewEvent(L, kEvent); lua\_pushnumber(L, frequency); lua\_setfield(L,-2,"frequency"); CoronaLuaDispatchEvent(L, library-\>GetListener(), 0); }); }

But it is important to understand what is going on here.