pebble
  • Tutorials
  • Get the SDK
  • Guides
  • Documentation
  • Examples
  • Community
  • Blog
  • More
Privacy
Cookies
Publish

Guides

  • Table of Contents
  • App Resources
  • Appstore Publishing
  • Best Practices
  • Communication
  • Debugging
  • Design and Interaction
  • Events and Services
    • Accelerometer
    • Background Worker
    • Buttons
    • Compass
    • Dictation
    • Event Services
    • Heart Rate Monitor
    • Pebble Health
    • Persistent Storage
    • Wakeups
  • Graphics and Animations
  • Migrating Older Apps
  • Pebble Packages
  • Pebble Timeline
  • Rocky.js
  • Smartstraps
  • Tools and Resources
  • User Interfaces

Events and Services

All Pebble watches contain a collection of sensors than can be used as input devices for apps. Available sensors include four buttons, an accelerometer, and a magnetometer (accessible via the CompassService API). In addition, the Basalt and Chalk platforms also include a microphone (accessible via the Dictation API) and access to Pebble Health data sets. Read Hardware Information for more information on sensor availability per platform.

While providing more interactivity, excessive regular use of these sensors will stop the watch's CPU from sleeping and result in faster battery drain, so use them sparingly. An alternative to constantly reading accelerometer data is to obtain data in batches, allowing sleeping periods in between. Read Conserving Battery Life for more information.

Contents

  • Accelerometer - How to use data and simple tap gestures from the onboard accelerometer.

  • Background Worker - Using the Background Worker to do work in the background, such as activity tracking.

  • Buttons - How to react to button presses in your app.

  • Compass - How to use data from the Compass API to determine direction.

  • Dictation - How to use the Dictation API to get voice-to-text input in watchapps.

  • Event Services - How to use the various asynchronous event services to power app features.

  • Heart Rate Monitor - Information on using the HealthService API to obtain information from the Heart Rate Monitor.

  • Pebble Health - Information on using the HealthService API to incorporate multiple types of health data into your apps.

  • Persistent Storage - Using persistent storage to improve your app's UX.

  • Wakeups - Using the Wakeup API to launch an app at some future time.