menuPujie BlackPujie Black logo

Complications

A complication is any feature in a watch face that is displayed in addition to time. For example, a battery indicator is a complication.

Wear OS has a specific API for creating complications, Pujie Black adds to that by allowing the user to design the drawing style of a complication.

Content
What are they?

A custom complication in Pujie Black is a drawing style for a certain type of data. The complication you create, defines how it looks. Afterwards you can assign data from different sources to you complication drawing style.

The image below, from the Wear OS developer pages, shows the 6 different complication types available.

The complication types section describes these types in detail.

To illustrate, your drawing style is never specifically a battery complication for instance, it could be used to show battery data, but it should also work for any other data which has the same type.

This might sound complicated, and initially it probably will be complicated, but once you understand it, it is very powerfull. You define your drawing style once and later you can assign any data source to it which fits the profile.

Below you can find some links to more documentation about the Wear OS complication system.

Documentation about the complication API in Wear OS
Creating a complication

When you create a new complication, you will first have to choose it's type. You can choose from the 6 options as shown in the image above. Each complication has a set of required fields and a set of optional fields.

Complications are designed in the Watch Part Designer. For each of the required and optional fields a locked layer will be added to your complication by default. For instance, this is shown in the image below for a ranged value complication.

These locked layers have to be incorporated in your design (or you can choose to make them invisible, if your drawing style works better without). But the field connected to these locked layers might not contain a value for each data provider. The goal is to make your design work with each data provider.

Data Providers

Tap the following button to see what your complication looks like with a different data provider.

Pick complication data
This button is used throughout the application to pick you complication data provider.

Each complication type has several data providers build in Pujie Black. For instance a ranged value complication has data providers for the phone battery, watch battery and more.

The image below shows the dialog used to pick your data provider

Note that the complication shown in the dialog above uses the same style but is taylored to the data. Ideally your drawing style should work well with all the data providers in this dialog.

To achieve this you can make use of Automation. This is discussed in the automation section of the Watch Part Designer manual.

Using automation you can for example rotate a layer, based on the value supplied with a ranged value complication. And using visibility automation you can hide layers if they should not be shown in a certain configuration.

Please have a look at some of our video tutorials to better understand how to create your complication.

Test data providers

Each of the complication types has a set of test data providers. These don't supply a meaningfull value and are not meant to use on your wrist, but are very helpfull in testing your complication.

Tapping and outlines

Some complications have tap actions assigned to them. So when you tap the watch face a ripple will be shown to indicate it's tap area. You can customize the shape of this ripple by adding a shape layer with the name Outline to your custom element.

External Data Providers

Because this system matches the official Wear OS Complication system, you can assign external data providers to your complication as well.

This can only be done from the Pujie Black configuration menu on your watch. Follow these steps to assign your external data provider.

1
Long press your watch screen, to open the Pujie Black configuration menu.
2
Go to Customize .. Interactive or Ambient .. Custom complications
3
Tap the complication you want to change
2
Go to External data provider and choose your provider
Complication Types

Below you can find a description of each of the 6 complication types.

Short text complication

A short text complication may be just a single piece of text, or a title and text, or an icon and text. Examples include weather or calendar information.

Required fields
  • Small Text
Optional fields
  • Icon
  • Short Title
Icon complication

An icon complication can be used when text is not needed. The icon is expected to be single-color, and can be tinted. It could for instance be an icon depicting the current weather status, or just a button to start an action.

Required fields
  • Icon
Optional fields
  • -
Ranged value complication

A ranged value complication can display data which includes a numeric value. The numeric value comes with a maximum and minimum value, so that it can be displayed relative to these bounds. It could for instance be a gauge which shows your daily steps or your battery levels.

Required fields
    Value
    • Max Value
      • Min Value
Optional fields
      Icon
      • Short Text
        • Short Title
Long text complication

A long text complication is used when you would like to show more text. It could for instance be your upcoming calendar items, or a description of the current weather.

Required fields
    Long Text
Optional fields
      Long Title
      • Icon
        • Small Image (Image)
          • Small Image (Icon)
Small image complication

A small image complication has one of two styles: photo style or icon style. Photo style means it should fill the space and can be cropped.

Required fields
    Small Image (Image)
    • Small Image (Icon)
Optional fields
  • -
Large image complication

A large image complication can be used to fill the watch face with an image. It could be the cover art of your current media, or just a nice background image.

Required fields
    Large Image
Optional fields
  • -