DEPRECATED this is an outdated starter-kit that targets MMIR version 4.x - for current starter-kit go to mmir-starter-kit
- DEPRECATED this is an outdated starter-kit that targets MMIR version 4.x
- for current starter-kit go to https://github.com/mmig/mmir-starter-kitThe MMIR v4 Starter Kit is a small example application for the MMIR framework that can run locally in an (HTML5 capable) internet browser, and using the Cordova framework, it can also be run as an Android app.
There is also a special branch that includes a graphical Grammar Editor (see branch new-grammar-editor's www/appTestSemantic directory).
For a quick look, try the online demos (links below).
For more detailed information on the MMIR framework see documentation at the MMIR repository
WARINING: this project includes resources from MMIR-lib at www/mmirf/ and
resources from MMIR-tooling at build/. Beware, that the files used in this
example project may not be the most current version of these resources.
For your own MMIR-based applications you should use the resources from
MMIR-lib and MMIR-tooling directly.
This is an example application that uses the MMIR framework (included as GIT subtree reference in /www/mmirf).
Basic integration into the Cordova 3 build process is done by including the MMIR tools
(as GIT subtree reference in /build; note: running the default ant task in within the build/tool directory will
copy the build-resources into the projects root directory).
Activated platforms (for Cordova 5.x or later):
android
Try the online demo for the "browser environment" at the demo page.
NOTE: At the moment, speech input in the "browser environment" only works for current versions of Chrome (> v25).
There is also a demo page for the grammar editor / tester (for testing the grammar that is used for evaluating speech input).
Installed Cordova 5.x - 7.x environment (see Cordova documentation on CLI based development for more details).
The StarerKit includes android as target platform for Cordova. However, you need to have the the
development tools for Android installed, if you want to build and run the application on Android.
See the Cordova documentation for the Android platorm for more details.
After checking out the the project, you need to run cordova build within the project directory.
NOTE since Cordova 5, platform specific development for Android in Eclipse is not fully supported any more!
(you may use Android Studio instead)
For platform-specific development, the Android projects can be imported into Android Studio (see
Cordova's platform guides for Android for prerequisites etc.):
- select
Open ... - then select the sub-directory
/platforms/android
This will import 2 modules: the Cordova-library project and the project for the MMIR StarterKit.
The imported StarterKit project contains a reference to assets/www, which corresponds
to the /platform/android/assets/www project directory; this directory contains copied
resources from the project directory /www.
If you want to make platform-independent changes, you should use the directory /www
in the project's root; beware that cordova prepare (and build, run) will overwrite the
contents of /platform/android/assets/www with the contents of /www.
After changing files in /www, you need to run cordova build in order to propagate the changes
from the /www directory to the /platform/android/assets/www directory.
- install platform
browser(no additional setup required):
cordova platform add browser
[EXPERIMENTAL]
- install platform
ios:
cordova platform add ios - needs Nuance plugin for enabling speech recognition / synthesis:
cordova plugin add https://github.com/mmig/mmir-plugin-speech-nuance - modify
config.xmlwith your Nuance credentials (see mmir-plugin-speech-nuance for more details)
If not stated otherwise, the code, resource files etc. is provided under the MIT license (see license file).