Skip to main content

Intro

RookMotion Link is a service and set of development resources to help you embed activity tracking into Mobile, WEB, or Wear Apps for fitness, health, gaming, move-to-earn, rehabilitation, and more. Our technology saves you tons of effort, time, and failures on the following tasks: acquisition, storage, and processing for activities based on heart rate. Additionally, with us, you can stream the data for remote Real Time monitoring and create challenges to keep your audience active and engaged. Finally, we have a module for you to challenge your users based on activity goals.

With RookMotion, you can build Apps for different functionalities:

  1. Real-time Measurements

    • HR
    • Effort (%)
    • Intensity Zone
    • Calories
    • Steps/Jumps

  2. Individual or Group

    • Real-time Measurements
    • Real-time Measurements + Real-time data transmission
    • Challenges based on activities measurements

  3. User-based or Branch/Location/Department/Group-based

  4. Others:

    • Dashboards
    • Activity log
    • Leaderboards
💡Find here a demo app that provides a good reference: Android, iOS, Youtube

Resources

RookMotion's available resources are:

  • APIs: Set of endpoints to manage the business logic of centers, users, sensors, and trainings.
  • SDKs: Encapsulated features for fast and easy implementation on Mobile and wearables Apps to handle Bluetooth connections with standard heart rate devices*, trainings storage, and connection to RookMotion APIs.
  • Extras: Code Snippets, recipes, and design references to help you create your app saving you a lot of time for thinking and research.
💡Current available SDKs are for Java/Kotlin, Swift, and React Native. If your App uses another platform, don’t worry, you can use RookMotion APIs with your framework, you just have to handle the hardware and storage functionalities.
💡*Standard Heart Rate Devices, refers to devices with Heart Rate Measurement capability and Bluetooth exposure of the measurements according to Heart Rate profile specification. These devices can be SmartWatches, sensors, and fitness equipment if they can expose the Heart Rate Measurement via Bluetooth. A list of already tested devices can be found here.

Modules

RookMotion consists of a Core module (RookMotion Core) and optional modules with the following capabilities:

  • RookMotion Core will help you to store and manage:

    • Users
      • Personal and physical information.
      • Tracking devices.
      • Training summaries and related statistics.
    • Centers
      • Chains, branches, training/activity rooms.
      • Associated users:
        • Enrolment, activities, attendance, statistics

  • RookMotion Data Streaming: Stream activity measurements and data (user info, heart rate, effort, calories, steps) to create a remote monitoring real-time app.

  • RookMotion Challenges: allows you to create and design challenges for your users:

    • You can define different activity objectives like:
      • Calories burnt
      • Activities count
      • Time spent on each effort zone effort level
      • And a lot more
    • You can create a different types of challenges:
      • Per individuals or teams
      • Per training/activity room or individual training session.
      • Per pre-defined or open goals within an established period.
💡Find here a product that provides a good reference RookLeague SaaS.)

Getting Started​

To get your app tracking your User's activity using RookMotion, follow the next steps:

  1. Contact us to get a walk through the product and modules:
    1. Book a demo or
    2. Email us
  2. Our team will analyze your needs and suggest the modules and plans that best suit you.
  3. Sign an agreement with the established features and plan.
  4. We will create a new tenancy for your project.
    1. Sandbox and production environments will be created.
  5. You will receive the following resources:
    1. The RookMotion SDKs and example apps (Android/iOS) using the SDKs
      1. You can build your app on top of the demo Apps or just use them as a reference.
    2. AUTH tokens for API requests.
      1. Tokens will be required to identify your tenancy and give you access to the APIs requests.
    3. APIs endpoints collections and environments config files (SandBox, Production) files to be used in Postman.
      1. With the endpoints' collection, environment file, and your tokens, you can start using the APIs in just seconds and generate code for different platforms using postman.
💡You can explore the API’s endpoints to discover the capabilities based on examples, but valid headers if you want to test them, otherwise every request will return an AUTH error.
💡AUTH tokens will be provided once the agreement is signed, as new tenancy resources are allocated for each client.
💡Additionally to AUTH Tokens, you need to provide level tokens for the API requests; these are intended to identify to which level (chain/branch/room) you are pointing your query. Read the Terms and definitions.

Functionalities

RookMotion is composed of an API and an SDK:

API functionalities​

  • Users
    • Create/edit/list/delete users
    • User Status
    • User information
      • Add/Show
    • User Physiological variables
      • Add/Show
    • User External id
      • Add/Show/Update/Delete
    • Sensors
      • Add/Show/Update/Delete
    • Trainings
      • Add/Show/Delete
      • Training info includes
        • Start time
        • End time
        • Type
        • Device id
        • Records
          • Heart Rate
          • Calories
          • Heart Rate Effort
          • Steps
          • Cycling
        • Summaries
          • Heart Rate (min, avg, max)
          • Heart Rate Effort (min, avg, max)
          • Heart Rate Effort Zoned (On each zone of effort)
          • Calories (min, avg, max)
          • Calories Zoned (On each zone of effort)
        • Statistics
          • Get summaries over a period
    • Business Logic
      • Handle Levels: Chains/Branches/Training Rooms
        • Create/edit levels
        • Set level information
          • Name
          • Logo
          • Address
    • Storage
      • Training, users, and devices on Rook Cloud Database

API comprises the following functionalities

SDK functionalities​

  • Communication with Bluetooth LE Heart Rate sensors.
    • Bluetooth
      • Start/stop discovery of nearby sensors.
      • Connect / Disconnect to Sensor.
      • Listen/Callback for Sensor connection/disconnection.
      • Get heart rate measurement notifications.
      • Get steps notifications (only for Rook sensors).
      • Get Battery level
    • Local storage (on the app)
      • User information
      • User sensors
      • Trainings
        • Records
        • Summaries
    • Training
      • Start/Pause/Resume/Stop/Finish
        • Sensor connection and Heart Rate measurements reception
        • Storage of records
        • Calculation of summaries
      • Set training type.
      • Set Sensor
    • RookMotion API communication
      • Add/edit/delete User
      • Add/edit user information.
      • Add User physiological variables.
      • Add/Show/Delete User Sensor.
      • Add/Show/Delete user Training.
      • Show user Training statistics.
      • Business Levels
        • Link/Unlink User/Sensor to level (Chains/Branches/Training Rooms).
        • Show level information.