WearableButtons

const val LOCATION_BOTTOM_CENTER = 107: Int

Represents the center third of the bottom side on a square device.

const val LOCATION_BOTTOM_LEFT = 106: Int

Represents the left third of the bottom side on a square device.

const val LOCATION_BOTTOM_RIGHT = 108: Int

Represents the right third of the bottom side on a square device.

const val LOCATION_EAST = 0: Int

Represents the east position on a round device.

const val LOCATION_ENE = 1: Int

Represents the east-northeast position on a round device.

const val LOCATION_ESE = 15: Int

Represents the east-southeast position on a round device.

const val LOCATION_LEFT_BOTTOM = 105: Int

Represents the bottom third of the left side on a square device.

const val LOCATION_LEFT_CENTER = 104: Int

Represents the center third of the left side on a square device.

const val LOCATION_LEFT_TOP = 103: Int

Represents the top third of the left side on a square device.

const val LOCATION_NE = 2: Int

Represents the northeast position on a round device.

const val LOCATION_NNE = 3: Int

Represents the north-northeast position on a round device.

const val LOCATION_NNW = 5: Int

Represents the north-northwest position on a round device.

const val LOCATION_NORTH = 4: Int

Represents the north position on a round device.

const val LOCATION_NW = 6: Int

Represents the northwest position on a round device.

const val LOCATION_RIGHT_BOTTOM = 109: Int

Represents the bottom third of the right side on a square device.

const val LOCATION_RIGHT_CENTER = 110: Int

Represents the center third of the right side on a square device.

const val LOCATION_RIGHT_TOP = 111: Int

Represents the top third of the right side on a square device.

const val LOCATION_SE = 14: Int

Represents the southeast position on a round device.

const val LOCATION_SOUTH = 12: Int

Represents the south position on a round device.

const val LOCATION_SSE = 13: Int

Represents the south-southeast position on a round device.

const val LOCATION_SSW = 11: Int

Represents the south-southwest position on a round device.

const val LOCATION_SW = 10: Int

Represents the southwest position on a round device.

const val LOCATION_TOP_CENTER = 101: Int

Represents the center third of the top side on a square device.

const val LOCATION_TOP_LEFT = 102: Int

Represents the left third of the top side on a square device.

const val LOCATION_TOP_RIGHT = 100: Int

Represents the right third of the top side on a square device.

const val LOCATION_UNKNOWN = -1: Int

Represents that the location zone is unknown.

const val LOCATION_WEST = 8: Int

Represents the west position on a round device.

const val LOCATION_WNW = 7: Int

Represents the west-northwest position on a round device.

const val LOCATION_WSW = 9: Int

Represents the west-southwest position on a round device.

java-static fun getButtonCount(context: Context): Int

Get the number of hardware buttons available. This count includes the primary stem key as well as any secondary stem keys available.

java-static fun getButtonIcon(context: Context, keycode: Int): Drawable?

Returns an icon that can be used to represent the location of a button.

java-static fun getButtonInfo(context: Context, keycode: Int): WearableButtons.ButtonInfo?

Returns a ButtonInfo containing the metadata for a specific button.

The location will be populated in the following manner:

• The provided point will be on the screen, or more typically, on the edge of the screen.
• The point won't be off the edge of the screen.
• The location returned is a screen coordinate. The unit of measurement is in pixels. The coordinates do not take rotation into account and assume that the device is in the standard upright position.

Additionally, a location zone will be provided for the button, which will be one of the LOCATION_* constants. This defines the general area of the button on the device, and can be passed to getButtonLabel to provide a human-understandable name for the location. There are two sets of locations for a device, depending on whether it is a circular or rectilinear device.

The "compass" locations (e.g. LOCATION_ENE) are used on a circular device. The locations for each are shown in the following image:

The other locations (e.g. LOCATION_BOTTOM_CENTER) are used on a rectilinear device. The locations for each are shown in the following image:

Common keycodes to use are KEYCODE_STEM_PRIMARY, KEYCODE_STEM_1, KEYCODE_STEM_2, and KEYCODE_STEM_3.

java-static fun getButtonLabel(context: Context, keycode: Int): CharSequence?

Returns a CharSequence that describes the placement location of a button. An example might be "Top right" or "Bottom".

@VisibleForTesting
java-static fun setWearableButtonsProvider(provider: WearableButtonsProvider): Unit

Testing call to allow the underlying WearableButtonsProvider to be substituted in test code.