search

microsoft / ProjectOxford-Apps-MimickerAlarm

Project Oxford Mimicker Alarm
Other
349 stars 89 forks source link

readme

Mimicker Alarm, a Microsoft Garage Project

Mimicker Alarm is a morning alarm clock app for Android that helps you wake up and stay up by playing a simple game, called a "Mimic". To dismiss your alarm, you must mimic the action given, lest your alarm ring again. Each game is powered by Microsoft Project Oxford, a set of machine learning APIs aimed at helping developers understand and act on the data around them.

Manage your alarms Express yourself with Emotion API Color capture with Vision API Tongue twister with Speech API
Manage your alarms Express yourself Color capture Tongue twister

You can install Mimicker Alarm in the Google Play Store for free. All of the source code for Mimicker Alarm is available on GitHub for developers to browse and reference how to use Microsoft Project Oxford. We welcome your comments, feedback, and contributions.

Contributing

We welcome contributions and are always looking for new ideas, input, and suggestions. Feel free to file issues on the repo and we'll address them as we can. You can also learn more about how you can help on the Contribution Rules & Guidelines.

Getting started

Build the app

  1. Get a subscription key for Face, Vision, and Speech API by following instructions in Project Oxford.

  2. Start Android Studio and open project.

  3. In Android Studio -> "Project" panel -> "Android" view, open file "gradle.properties", provide the keys

  4. In Android Studio, select menu "Build -> Make Project" to build the app

PS: if you have a Mixpanel account or HockeyApp account you can put in those keys to get event logging, update notifications and crash reports.

Run the sample

In Android Studio, select menu "Run", and "Run app" to launch this app.

Microsoft will receive the images you upload and may use them to improve Face API and related services. By submitting an image, you confirm you have consent from everyone in it. This is outlined in the in-app Terms of Use.

Creating new mimics

You can create new mimics really easily! Inherit from the MimicWithCameraFragment class and implement the verify function that takes in a Bitmap. You can readily use the Emotion API and Vision API!

For more Project Oxford APIs just include their maven packages.

For the new Mimic to show up, include it in pref_mimics so users can enable/disable it. Finally add the class into the MimicFactory class.

License

All Project Oxford SDKs and samples are licensed with the MIT License. For more details, see LICENSE.

Sample images are licensed separately, please refer to LICENSE-IMAGE.

Contact Us

Reach out to us by posting issues here in GitHub, visiting our UserVoice forum, or emailing us directly at project-oxford-apps@microsoft.com.