fodawim / androidwearwatchface

The official Android Wear WatchFace API docs can be found here. This repository serves mostly as an archive of things from the past and should not be used as a guideline.

Custom watch-faces for Android Wear

Notes

This project is just a very bare-bones example of a custom watchface running on Android wear. I have not tested this on a device, only in the emulator. This should be enough to get you off the ground for now, I will be updating in the future with more examples hopefully.

• This is not perfect.
• This is completely un-official.
• I am not responsible for any damage this may cause to your device.

What do you have to do?

To get an Android Activity running as a watch-face is VERY simple. Simply add some extra meta-data as well as intents to your Manifest.

The Activity Tag

This is simple enough, in the activity tag you just need to make sure you add

android:allowEmbedded="true" 

This allows the main "launcher" to embed your activity as a background.

The meta-data

<meta-data android:name="com.google.android.clockwork.home.preview" android:resource="@drawable/preview" />

The resource points to a drawable that is the preview image for your watch-face. This image should be 320x320px or 120x120dp.

Add this inside your activity tag. Example Here

The Intent Flags

<intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="com.google.android.clockwork.home.category.HOME_BACKGROUND" />
</intent-filter>

These allow the system to know that your application will be capable of displaying an activity as a background. Simply add that code snippet inside of your Activity tag and the system will know. Example Here

androidwearwatchface's Issues

Odd Background on Watchface

Any idea why I might be getting this background? It looks like what might show if the background is completely transparent, but I haven't messed with the layouts background ImageView at all.

Also maybe more related to the emulator than this code, but might as well mention it:

I wasn't able to get any watch faces to show up other than the default ("Simple"), it would just show a black screen. I fixed it by enabling using host GPU.

Enhancement idea analog version

This is very useful, an enhancement idea to have an analog version as well as the digital~?

(I'm trying to achieve this at the moment, but not really know how to achieve this, anyone got any ideas?)

to detact screen off or dim

it allows completely stop the watch if screen is off ?
to detect screen on:off:dim, using DisplayManager.registerDisplayListener is more better.
( https://gist.github.com/kentarosu/52fb21eb92181716b0ce# )