Module: Toybox.UserProfile

Overview

The UserProfile module will allow apps to access user information.

The module contains the GENDER_* enum to retrieve gender information from the user profile. The HR_ZONE_SPORT_* enum also provides constants for defining different sport type. This is used to retrieve Heart Rate Zones specific to that sport.

Example:

Simple UserProfile module use

using Toybox.UserProfile;

var profile = UserProfile.getProfile();
System.out.println("The user was born in " + profile.birthYear);

Since:

API Level 1.0.0

Requires Permission:

  • UserProfile

Classes Under Namespace

Classes: Profile

Constant Summary

Gender

Name Value Since Description
GENDER_FEMALE 0

API Level 1.0.0

GENDER_MALE 1

API Level 1.0.0

SportHrZone

Name Value Since Description
HR_ZONE_SPORT_GENERIC 0

API Level 1.2.6

HR_ZONE_SPORT_RUNNING 1

API Level 1.2.6

HR_ZONE_SPORT_BIKING 2

API Level 1.2.6

HR_ZONE_SPORT_SWIMMING 3

API Level 1.2.6

Instance Method Summary collapse

Instance Method Details

getCurrentSport() as SportHrZone

Return the sport for which the current activity retrieves heart rate zone thresholds.

If the active sport does not have sport specific zones, it will return HR_ZONE_SPORT_GENERIC.

Example:

using Toybox.UserProfile;
var profile = UserProfile.getCurrentSport();

Returns:

  • Number

    The current HR zone sport from the HR_ZONE_SPORT_* enum.

Since:

API Level 1.2.6

getHeartRateZones(sport as SportHrZone) as Array<Number>

Retrieve an Array of the current heart rate zone threshold values in beats per minute (bpm)

The returned Array contains zone values as follows:

  • min zone 1 - The minimum heart rate threshold for zone 1

  • max zone 1 - The maximum heart rate threshold for zone 1

  • max zone 2 - The maximum heart rate threshold for zone 2

  • max zone 3 - The maximum heart rate threshold for zone 3

  • max zone 4 - The maximum heart rate threshold for zone 4

  • max zone 5 - The maximum heart rate threshold for zone 5

Parameters:

  • sport(Number)

    The sport that zones are being requested from. Should be a HR_ZONE_SPORT_* value.

Example:

Use the HR_ZONE_SPORT_* enum to get the zone for that specific sport

using Toybox.UserProfile;
var genericZoneInfo = UserProfile.getHeartRateZones(UserProfile.HR_ZONE_SPORT_GENERIC);

Returns:

  • Array

    An Array of zone thresholds for the requested sport.

Since:

API Level 1.2.6

getProfile() as Profile

Retrieve the current UserProfile.Profile object.

Example:

using Toybox.UserProfile;
var profile = UserProfile.getProfile();

Returns:

  • Profile

    The Profile object for the current user

Since:

API Level 1.0.0


Generated Apr 22, 2021 10:10:32 AM