Tizen Native API  7.0
Watchface complication

The watchface complication provides feature to receive and request watchface complication data. It also provides editable management feature to request edit for complication and design elements to editor.

Required Header

#include <watchface-complication.h>
#include <watchface-editable.h>

Overview

The watch applications can request data shared by other watchface complication provider applications using watchface complication. And the watchface complication provider application can share data with watchface application using watchface complication. However, only service applications can provide their own data to the watch application. The watch application also can request editing about their resources like complication and design elements to editor using watchface complication. *

Related Features

This API is related with the following features:

  • http://tizen.org/feature/watch_app
    You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application. To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK. More details on featuring your application can be found from Feature Element.

Typedefs

typedef enum _complication_error watchface_complication_error_e
 Enumeration for Complication Error.
typedef enum _complication_type watchface_complication_type_e
 Enumeration for Complication Type.
typedef enum
_complication_event_type 
watchface_complication_event_type_e
 Enumeration for Complication event type.
typedef struct
complication_time_info_s * 
complication_time_info_h
 The complication time information handle.

Typedef Documentation

typedef struct complication_time_info_s* complication_time_info_h

The complication time information handle.

Since :
5.5

Enumeration for Complication Error.

Since :
5.0

Enumeration for Complication event type.

Watchface should transfer the touch event to complication provider to trigger the complication tap action. WATCHFACE_COMPLICATION_EVENT_NONE is transferred to the complication provider when the complication is launched without tap event.

Since :
5.0

Enumeration for Complication Type.

Since :
5.0

Enumeration Type Documentation

Enumeration for Complication Error.

Since :
5.0
Enumerator:
WATCHFACE_COMPLICATION_ERROR_NONE 

Success

WATCHFACE_COMPLICATION_ERROR_OUT_OF_MEMORY 

Out of memory

WATCHFACE_COMPLICATION_ERROR_INVALID_PARAMETER 

Invalid parameter

WATCHFACE_COMPLICATION_ERROR_IO_ERROR 

I/O error

WATCHFACE_COMPLICATION_ERROR_NO_DATA 

No data available

WATCHFACE_COMPLICATION_ERROR_PERMISSION_DENIED 

Permission denied

WATCHFACE_COMPLICATION_ERROR_NOT_SUPPORTED 

Not supported

WATCHFACE_COMPLICATION_ERROR_DB 

Database error

WATCHFACE_COMPLICATION_ERROR_DBUS 

DBUS error

WATCHFACE_COMPLICATION_ERROR_EDIT_NOT_READY 

Edit not ready

WATCHFACE_COMPLICATION_ERROR_EXIST_ID 

ID already exist

WATCHFACE_COMPLICATION_ERROR_NOT_EXIST 

Not exist

WATCHFACE_COMPLICATION_ERROR_PROVIDER_NOT_AVAILABLE 

Provider is not available, it could be uninstalled or disabled

Enumeration for Complication event type.

Watchface should transfer the touch event to complication provider to trigger the complication tap action. WATCHFACE_COMPLICATION_EVENT_NONE is transferred to the complication provider when the complication is launched without tap event.

Since :
5.0
Enumerator:
WATCHFACE_COMPLICATION_EVENT_NONE 

Complication is not tapped

WATCHFACE_COMPLICATION_EVENT_TAP 

Tap

WATCHFACE_COMPLICATION_EVENT_DOUBLE_TAP 

Double Tap

Enumeration for Complication Type.

Since :
5.0
Enumerator:
WATCHFACE_COMPLICATION_TYPE_NO_DATA 

No Data

WATCHFACE_COMPLICATION_TYPE_SHORT_TEXT 

Short Text

WATCHFACE_COMPLICATION_TYPE_LONG_TEXT 

Long Text

WATCHFACE_COMPLICATION_TYPE_RANGED_VALUE 

Ranged Value

WATCHFACE_COMPLICATION_TYPE_TIME 

Time

WATCHFACE_COMPLICATION_TYPE_ICON 

Icon

WATCHFACE_COMPLICATION_TYPE_IMAGE 

Image