SnowShoe Android Library

This Android library makes it easy to add SnowShoe stamp functionality to an app.

There are two main ways to use the library, depending on whether you use a SnowShoe SDK on your own server or whether you want the Android app to talk directly to SnowShoe's servers.

Installation

1. Clone the repo

2. Import the snowshoe library project into Android Studio.

3. In your app project, add a dependency on the library project:

   dependencies {
       compile project(':snowshoe')
   }

4. Subclass either abstract activity class.

Using your own server to verify stamps

If you want to send the stamp coordinates to your own server for verification, subclass AbstractStampSensingActivity and override the onStampTouch(StampTouch stamp) method, and then use stamp.getPoints() to retrieve the list of points. Points are stored as a Pair<Float,Float>, so access the fields first and second for X and Y coordinates, respectively.

Talking directly to SnowShoe's servers from the app

If you prefer to do stamp verification within the Android app, then subclass AbstractStampVerifyingActivity, call setSnowShoeKeys(appKey, appSecret) within onCreate(), and override onStampVerified(SnowShoeResponse response) to handle the data returned from SnowShoe's API. Note that the response is deserialized using Gson, and you can check for errors returned by the API with response.getError() and retrieve the stamp serial number with response.getStamp().getSerial().

Permissions

Note that including the library causes your app to include the android.permission.INTERNET permission, as it is necessary for validating stamps.

Device Support

SnowShoe says that stamps work on 90% of devices sold today. If you want to detect if the device running your app supports 5 finger touch events, you can override the onJazzHandsNotSupported() method that's part of the abstract activities. If it's critical for your app that stamps be supported, you can add <uses-feature> elements to your app manifest for android.hardware.touchscreen.multitouch.jazzhand and android.hardware.touchscreen.multitouch.distinct.