Skip to content
App to be used in the Cognitive Services Face and Emotion API workshop by the Cambridge MSPs
Java
Branch: master
Clone or download
Pull request Compare This branch is 1 commit behind henry-thompson:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea
app
gradle/wrapper
.gitignore
README.md
build.gradle
gradle.properties
gradlew
gradlew.bat
settings.gradle

README.md

Face and Emotion API Workshop

This is a simple app designed to showcase the capabilities of the Microsoft Cognitive Services Face and Emotion APIs. It is being used as part of the Cambridge University Microsoft Student Partners' workshop on the Cognitive Services Face APIs.

Prerequisites

If you just want to watch how to build an app with Cognitive Services just come along! If you want to follow along with the coding then make sure you have the following.

  1. Proficiency in Java. Understanding of the Observer deisgn pattern desirable.
  2. A working installation of Android Studio.
  3. Make sure you have Git installed. If not, follow instructions here.
  4. Some way to run Android apps. A physical Android device connected over USB is desirable (don't forget your USB cable!), otherwise an emulator will do.

Windows, Mac OS and Linux are all acceptable.

Preparing for the Workshop

If you just want to watch how to build an app with Cognitive Services just come along!

If you want to follow along with the coding then make sure you have the following. It is highly recommended you do this before coming along.

  1. Clone this repository by typing this command: git clone https://github.com/cambridge-msp/face-emotion-api-workshop.git.
  2. Navigate to the project directory: cd face-emotion-api-workshop.
  3. Open Android Studio. Open this project - it is in the directory mentioned in point 2. It is likely that Android Studio will complain that the correct SDK version is not installed: install the SDK by following the instructions if so.
  4. It is likely Android Studio will say the project requires a Gradle Sync. Follow the instructions to sync the project.
  5. Checkout the workshop branch: git checkout workshop.

If you don't want the "workshop version" but would rather see the complete version, do git checkout master at any point. To return to the workshop version, do git checkout workshop. (See below for details on the "workshop version").

Workshop Version

This repository contains two branches.

master

This branch contains a fully working implementation of the app. This is a very thoroughly documented and stable version of the app following Android good programming practices. It is good for looking over to see how a complete implementation works.

workshop

This branch contains gaps in the code which are suitable for being filled in during a workshop to demonstrate how easy it is to integrate Emotion API into apps. It is deliberately designed to ensure that it requires no knowledge of Android specific APIs by ensuring the Android specific parts are already implemented.

Note that it does not build!

Slides

You can find the slide show we used here on Google Slides

Recording

A recording of the workshop is available on YouTube

About the Presentation

The original presentation is being given by Henry Thompson and David Adeboye on Friday February 24th 2017.

You can’t perform that action at this time.