Skip to content

Most visited

Recently visited

navigation

SystemProviders

public class SystemProviders
extends Object

java.lang.Object
   ↳ android.support.wearable.complications.SystemProviders


Methods to retrieve the component names for system complication providers. This will allow these providers to be used as defaults by watch faces.

Summary

Nested classes

@interface SystemProviders.ProviderId

System provider id as defined in SystemProviders

Constants

int ANDROID_PAY

Id for the Android Pay complication provider.

int APP_SHORTCUT

Id for the 'app shortcut' complication provider.

int DATE

Id for the 'date' complication provider.

int DAY_OF_WEEK

Id for the 'day of week' complication provider.

int FAVORITE_CONTACT

Id for the 'favorite contact' complication provider.

int NEXT_EVENT

Id for the 'next event' complication provider.

int RETAIL_CHAT

Id for the 'retail mode chat' complication provider.

int RETAIL_STEP_COUNT

Id for the 'retail mode step count' complication provider.

int STEP_COUNT

Id for the 'step count' complication provider.

int SUNRISE_SUNSET

Id for the 'sunrise sunset' complication provider.

int TIME_AND_DATE

Id for the 'time and date' complication provider.

int UNREAD_NOTIFICATION_COUNT

Id for the 'unread notification count' complication provider.

int WATCH_BATTERY

Id for the 'watch battery' complication provider.

int WORLD_CLOCK

Id for the 'world clock' complication provider.

Public constructors

SystemProviders()

Inherited methods

From class java.lang.Object

Constants

ANDROID_PAY

int ANDROID_PAY

Id for the Android Pay complication provider. For use with #setDefaultSystemComplicationProvider.

This is a safe provider (because it only launches the Android Pay app), so if a watch face uses this as a default it will be able to receive data from it even before the RECEIVE_COMPLICATION_DATA permission has been granted.

This provider supports only TYPE_SMALL_IMAGE.

Constant Value: 8 (0x00000008)

APP_SHORTCUT

int APP_SHORTCUT

Id for the 'app shortcut' complication provider. For use with #setDefaultSystemComplicationProvider.

This is a safe provider, so if a watch face uses this as a default it will be able to receive data from it even before the RECEIVE_COMPLICATION_DATA permission has been granted.

This provider supports the following types: TYPE_SMALL_IMAGE, TYPE_LONG_TEXT.

Constant Value: 6 (0x00000006)

DATE

int DATE

Id for the 'date' complication provider. For use with #setDefaultSystemComplicationProvider.

This is a safe provider, so if a watch face uses this as a default it will be able to receive data from it even before the RECEIVE_COMPLICATION_DATA permission has been granted.

This provider supports only TYPE_SHORT_TEXT.

Constant Value: 2 (0x00000002)

DAY_OF_WEEK

int DAY_OF_WEEK

Id for the 'day of week' complication provider. For use with #setDefaultSystemComplicationProvider.

This is a safe provider, so if a watch face uses this as a default it will be able to receive data from it even before the RECEIVE_COMPLICATION_DATA permission has been granted.

This provider supports only TYPE_SHORT_TEXT.

Constant Value: 13 (0x0000000d)

FAVORITE_CONTACT

int FAVORITE_CONTACT

Id for the 'favorite contact' complication provider. For use with #setDefaultSystemComplicationProvider.

This is not a safe provider, so if a watch face uses this as a default it will receive data of TYPE_NO_PERMISSION until the user has granted the RECEIVE_COMPLICATION_DATA.

This provider supports only TYPE_SMALL_IMAGE.

Constant Value: 14 (0x0000000e)

NEXT_EVENT

int NEXT_EVENT

Id for the 'next event' complication provider. For use with #setDefaultSystemComplicationProvider.

This is not a safe provider, so if a watch face uses this as a default it will receive data of TYPE_NO_PERMISSION until the user has granted the RECEIVE_COMPLICATION_DATA.

This provider supports the following types: TYPE_SHORT_TEXT, TYPE_LONG_TEXT.

Constant Value: 9 (0x00000009)

RETAIL_CHAT

int RETAIL_CHAT

Id for the 'retail mode chat' complication provider. For use with #setDefaultSystemComplicationProvider.

This provider shows fake 'unread chat messages' data, and the tap action launches the retail mode chat app. This provider should only be set as a default if the device is in retail mode.

This provider supports only TYPE_SHORT_TEXT.

Constant Value: 11 (0x0000000b)

RETAIL_STEP_COUNT

int RETAIL_STEP_COUNT

Id for the 'retail mode step count' complication provider. For use with #setDefaultSystemComplicationProvider.

This provider shows fake step count data, and the tap action launches the retail mode health app. This provider should only be set as a default if the device is in retail mode.

This provider supports only TYPE_SHORT_TEXT.

Constant Value: 10 (0x0000000a)

STEP_COUNT

int STEP_COUNT

Id for the 'step count' complication provider. For use with #setDefaultSystemComplicationProvider.

This is a safe provider (because it only shows a daily total), so if a watch face uses this as a default it will be able to receive data from it even before the RECEIVE_COMPLICATION_DATA permission has been granted.

This provider supports only TYPE_SHORT_TEXT.

Constant Value: 4 (0x00000004)

SUNRISE_SUNSET

int SUNRISE_SUNSET

Id for the 'sunrise sunset' complication provider.

This provider shows next sunrise or sunset time according to current timezone and location.

This provider supports only TYPE_SHORT_TEXT.

Constant Value: 12 (0x0000000c)

TIME_AND_DATE

int TIME_AND_DATE

Id for the 'time and date' complication provider. For use with #setDefaultSystemComplicationProvider.

This is a safe provider, so if a watch face uses this as a default it will be able to receive data from it even before the RECEIVE_COMPLICATION_DATA permission has been granted.

This provider supports only TYPE_SHORT_TEXT.

Constant Value: 3 (0x00000003)

UNREAD_NOTIFICATION_COUNT

int UNREAD_NOTIFICATION_COUNT

Id for the 'unread notification count' complication provider. For use with #setDefaultSystemComplicationProvider.

This is a safe provider, so if a watch face uses this as a default it will be able to receive data from it even before the RECEIVE_COMPLICATION_DATA permission has been granted.

This provider supports the following types: TYPE_ICON, TYPE_SHORT_TEXT.

Constant Value: 7 (0x00000007)

WATCH_BATTERY

int WATCH_BATTERY

Id for the 'watch battery' complication provider. For use with #setDefaultSystemComplicationProvider.

This is a safe provider, so if a watch face uses this as a default it will be able to receive data from it even before the RECEIVE_COMPLICATION_DATA permission has been granted.

This provider supports the following types: TYPE_ICON, TYPE_SHORT_TEXT, TYPE_LONG_TEXT, TYPE_RANGED_VALUE.

Constant Value: 1 (0x00000001)

WORLD_CLOCK

int WORLD_CLOCK

Id for the 'world clock' complication provider. For use with #setDefaultSystemComplicationProvider.

This is a safe provider, so if a watch face uses this as a default it will be able to receive data from it even before the RECEIVE_COMPLICATION_DATA permission has been granted.

This provider supports only TYPE_SHORT_TEXT.

Constant Value: 5 (0x00000005)

Public constructors

SystemProviders

SystemProviders ()

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (Dec 2017 Android Platform & Tools Survey)