JarCasting
JarCasting JarCasting

Snowshoe Android Library

SnowShoe Stamp library for Android

License

License
GroupId

GroupId

com.harlap
ArtifactId

ArtifactId

snowshoe-android
Last Version

Last Version

1.1.0
Release Date

Release Date
Type

Type

aar
Description

Description

Snowshoe Android Library
SnowShoe Stamp library for Android

Download snowshoe-android

Filename Size
snowshoe-android-1.1.0.pom
snowshoe-android-1.1.0.aar 16 KB
snowshoe-android-1.1.0-sources.jar 6 KB
snowshoe-android-1.1.0-javadoc.jar 49 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.harlap/snowshoe-android/ -->
<dependency>
    <groupId>com.harlap</groupId>
    <artifactId>snowshoe-android</artifactId>
    <version>1.1.0</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/com.harlap/snowshoe-android/
implementation 'com.harlap:snowshoe-android:1.1.0'
// https://jarcasting.com/artifacts/com.harlap/snowshoe-android/
implementation ("com.harlap:snowshoe-android:1.1.0")
'com.harlap:snowshoe-android:aar:1.1.0'
<dependency org="com.harlap" name="snowshoe-android" rev="1.1.0">
  <artifact name="snowshoe-android" type="aar" />
</dependency>
@Grapes(
@Grab(group='com.harlap', module='snowshoe-android', version='1.1.0')
)
libraryDependencies += "com.harlap" % "snowshoe-android" % "1.1.0"
[com.harlap/snowshoe-android "1.1.0"]

Dependencies

compile (3)

Group / Artifact Type Version
oauth.signpost : signpost-commonshttp4 jar 1.2.1.2
com.android.support » appcompat-v7 jar 20.0.0
com.google.code.gson : gson jar 2.2.4

Project Modules

There are no modules declared in this project.

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.

Versions

Version
1.1.0
1.0.0