Skip to content

SomaticLabs/HaptiHunt

Repository files navigation

HaptiHunt

A simple game to demonstrate haptic guidance in VR, using Zorb Touch.

license Twitter

About

Made for any Google Cardboard or Google Daydream headset, this demo is a treasure hunt where the user is guided with haptic effects to look for randomly generated cubes in their 3D environment.

This demo is an extension of a Google Cardboard demo provided by Google, using their SDK licensed under the Apache License 2.0.

This demo also makes use of SwitfyZorb, which is licensed under the GNU General Public License v3.0.

Requirements

  • iOS 10.0+
  • Xcode 8.1+
  • Swift 4.0+

Troubleshooting & Contributions

  • If you need help, send us an email.
  • If you'd like to ask a general question, send us an email.
  • If you found a bug, open an issue.
  • If you have a feature request, open an issue.
  • If you want to contribute, submit a pull request.

Installation

  1. Clone this repository:
$ git clone git@github.com:SomaticLabs/HaptiHunt.git
$ cd HaptiHunt
  1. Ensure that you have both CocoaPods and Carthage installed:
$ sudo gem install cocoapods
$ brew update
$ brew install carthage
  1. Install dependencies:
pod update
carthage update --platform iOS
  1. Open workspace (not project) in XCode:
open HaptiHunt.xcworkspace
  1. Set your code signing preferences.

  2. Connect your iOS device, select as build target, and run app (CMD + R).

Usage

After launching the HaptiHunt app, the application will try to establish a connection to a Zorb Touch hardware device almost immediately.

To ensure that a connection is made, reset your hardware device or put it into pairing mode immediately before launching the HaptiHunt demo. You can do this by connecting your Zorb Touch hardware to power via microUSB, pressing its button, and disconnecting power. If you are having trouble, please send us an email.

After the HaptiHunt app has connected to your Zorb Touch hardware, you may be presented with a pairing request in the app—if so, press "Accept".

Once connected to your Zorb Touch hardware, you can press the Google Cardboard icon and will be prompted to rotate your device and insert it into your Google Daydream or Google Cardboard supported headset.

From here, place your VR headset and haptic display on your head enjoy the demo!

Icon Attribution

"Tweemoji" by Twitter / CC-BY 4.0

License

This project is licensed under the Apache License 2.0.