new android.activity module, that provide bind/unbind() method for on_new_intent / on_activity_result events.

tito · tito · commit 646bd83babd1 · 2013-06-24T14:21:46.000+02:00
diff --git a/docs/source/android.rst b/docs/source/android.rst
@@ -32,6 +32,50 @@ Android (``android``)
     keycodes are available as constants in the android module.
 
 
+Activity (``android.activity``)
+-------------------------------
+
+.. module:: android.activity
+
+The default PythonActivity have a observer pattern for `onActivityResult <http://developer.android.com/reference/android/app/Activity.html#onActivityResult(int, int, android.content.Intent)>`_ and `onNewIntent <http://developer.android.com/reference/android/app/Activity.html#onNewIntent(android.content.Intent)>`_.
+
+.. function:: bind(eventname=callback, ...)
+
+    This allows you to bind a callback to an Android event:
+    - ``on_new_intent`` is the event associated to the onNewIntent java call
+    - ``on_activity_result`` is the event associated to the onActivityResult java call
+
+.. function:: unbind(eventname=callback, ...)
+
+    Unregister a previously registered callback with :func:`bind`.
+
+Example::
+
+    # this example is a snippet from an NFC p2p app, and are located into a
+    # kivy App class implementation
+
+    from android import activity
+
+    def on_new_intent(self, intent):
+        if intent.getAction() != NfcAdapter.ACTION_NDEF_DISCOVERED:
+            return
+        rawmsgs = intent.getParcelableArrayExtra(NfcAdapter.EXTRA_NDEF_MESSAGES)
+        if not rawmsgs:
+            return
+        for message in rawmsgs:
+            message = cast(NdefMessage, message)
+            payload = message.getRecords()[0].getPayload()
+            print 'payload: {}'.format(''.join(map(chr, payload)))
+
+    def nfc_enable(self):
+        activity.bind(on_new_intent=self.on_new_intent)
+        # ...
+
+    def nfc_disable(self):
+        activity.unbind(on_new_intent=self.on_new_intent)
+        # ...
+
+
 Billing (``android.billing``)
 -----------------------------
 
diff --git a/recipes/android/src/android/activity.py b/recipes/android/src/android/activity.py
@@ -0,0 +1,52 @@
+from jnius import PythonJavaClass, java_method
+
+_callbacks = {
+    'on_new_intent': [],
+    'on_activity_result': [] }
+
+class NewIntentListener(PythonJavaClass):
+    __javainterfaces__ = ['org/renpy/android/PythonActivity$NewIntentListener']
+    __javacontext__ = 'app'
+
+    def __init__(self, callback):
+        super(NewIntentListener, self).__init__()
+        self.callback = callback
+
+    @java_method('(Landroid/content/Intent;)V')
+    def onNewIntent(self, intent):
+        self.callback(intent)
+
+
+class ActivityResultListener(PythonJavaClass):
+    __javainterfaces__ = ['org/renpy/android/PythonActivity$ActivityResultListener']
+    __javacontext__ = 'app'
+
+    def __init__(self, callback):
+        super(ActivityResultListener, self).__init__()
+        self.callback = callback
+
+    @java_method('(IILandroid/content/Intent;)V')
+    def onActivityResult(self, requestCode, resultCode, intent):
+        self.callback(requestCode, resultCode, intent)
+
+
+def bind(**kwargs):
+    for event, callback in kwargs.items():
+        if event not in _callbacks:
+            raise Exception('Unknown {!r} event'.format(event))
+        elif event == 'on_new_intent':
+            listener = NewIntentListener(callback)
+            _callbacks[event].append(listener)
+        elif event == 'on_activity_result':
+            listener = ActivityResultListener(callback)
+            _callbacks[event].append(callback)
+
+def unbind(**kwargs):
+    for event, callback in kwargs.items():
+        if event not in _callbacks:
+            raise Exception('Unknown {!r} event'.format(event))
+        else:
+            for listener in _callbacks[event][:]:
+                if listener.callback is callback:
+                    _callbacks[event].remove(listener)
+
