Initial

Author: Android-for-Python

README.md

@@ -0,0 +1,20 @@
+Speech Recognizer Example
+=========================
+
+*Transcribe and copy to clipboard.*
+
+Uses Android [SpeechRecognizer](https://developer.android.com/reference/android/speech/SpeechRecognizer) to transcribe.
+
+Key `buildozer.spec` changes:
+
+```
+requirements = python3,kivy, gestures4kivy
+
+android.permissions = INTERNET, RECORD_AUDIO
+
+# android.api MUST BE >= 33
+android.api = 33
+
+# the java directory tree and files MUST EXIST 
+android.add_src = java
+```

android_permissions.py

@@ -0,0 +1,78 @@
+from kivy.utils import platform
+from kivy.clock import mainthread
+
+if platform == 'android':
+    from kivy.uix.button import Button
+    from kivy.uix.modalview import ModalView
+    from kivy.clock import Clock
+    from android import api_version, mActivity
+    from android.permissions import request_permissions, check_permission, \
+        Permission
+
+
+#########################################################################
+#
+# The start_app callback may occur up to two timesteps after this class
+# is instantiated. So the class must exist for two time steps, if not the
+# callback will not be called.
+#
+# To defer garbage collection, instantiate this class with a class variable:
+#
+#  def on_start(self):
+#     self.dont_gc = AndroidPermissions(self.start_app)
+#
+#  def start_app(self):
+#     self.dont_gc = None
+#
+###########################################################################
+#
+# Android Behavior:
+#
+#  If the user selects "Don't Allow", the ONLY way to enable
+#  the disallowed permission is with App Settings.
+#  This class give the user an additional chance if "Don't Allow" is
+#  selected once.
+#
+###########################################################################
+
+class AndroidPermissions:
+    def __init__(self, start_app = None):
+        self.permission_dialog_count = 0
+        self.start_app = start_app
+        if platform == 'android':
+            #################################################
+            # Customize run time permissions for the app here
+            #################################################
+            self.permissions = [Permission.RECORD_AUDIO]
+            self.permission_status([],[])
+        elif self.start_app:
+            self.start_app()
+
+    def permission_status(self, permissions, grants):
+        granted = True
+        for p in self.permissions:
+            granted = granted and check_permission(p)
+        if granted:
+            if self.start_app:
+                self.start_app()
+        elif self.permission_dialog_count < 2:
+            Clock.schedule_once(self.permission_dialog)  
+        else:
+            self.no_permission_view()
+        
+    def permission_dialog(self, dt):
+        self.permission_dialog_count += 1
+        request_permissions(self.permissions, self.permission_status)
+
+    @mainthread
+    def no_permission_view(self):
+        view = ModalView()
+        view.add_widget(Button(text='Permission NOT granted.\n\n' +\
+                               'Tap to quit app.\n\n\n' +\
+                               'If you selected "Don\'t Allow",\n' +\
+                               'enable permission with App Settings.',
+                               on_press=self.bye))
+        view.open()
+
+    def bye(self, instance):
+        mActivity.finishAndRemoveTask()