WearSocket

A wrapper for socket communication between Android Wear and Android Mobile. There is a lot of boiler plate to send data between Android Wear and Android Mobile devices. This library (inspired by Socket.IO), aims to streamline both message sending and synching data updates.

Installation

Use JitPack

allprojects {
 repositories {
  maven { url "https://jitpack.io" }
 }
}

dependencies {
     compile 'com.github.jrejaud:WearSocket:1.0.+'
}

Setup

First, get an instance of the WearSocket and set it up by passing Context and the wear app capabilities

WearSocket wearSocket = WearSocket.getInstance();
String androidWearCapability = ...;
wearSocket.setupAndConnect(context, androidWearCapability, new onErrorListener() {
        @Override
        public void onError(Throwable throwable) {
         //Throws an error here if there is a problem connecting to the other device.
        }
});

Advertising Capabilities (copied from official Google documentation)

Create an XML configuration file in the res/values/ directory of your project and name it wear.xml. Add a resource named android_wear_capabilities to wear.xml. Define capabilities that the device provides. Note: Capabilities are custom strings that you define and must be unique within your app.

The following example shows how to add a capability named voice_transcription to wear.xml:

<resources>
    <string-array name="android_wear_capabilities">
        <item>voice_transcription</item>
    </string-array>
</resources>

Sending and Receiving Messages between Wear and Mobile

Sending Message

Pick a path (think of it like a subject) for your message.

wearSocket.sendMessage("myPath","myMessage");

Receiving a Message

Start your message listener and listen for the path that you are associating with your messages.

wearSocket.startMessageListener(context,"myPath");

Implement WearSocket.MessageListener and override messageReceived to start listening for messages

public class MyActivity implements WearSocket.MessageListener

    @Override
    public void messageReceived(String path, String message) {
        //Do things here!
    }

Synching Data Updates between Wear and Mobile

Updating a data item

Note: Data Path should begin with /, thus I recommend using one different from message sending. dataItem is an object (or collection of objects).

wearSocket.updateDataItem("myDataPath","myKey",dataItem);

Receiving a data item update

Start your data change listener and listen for the path that you are associating with your data changes.

wearSocket.startDataListener(context,"myDataPath");

Additionally, you need to associate a Type with a specific Key. For example, if the key "myKey" is associated with a List<String> object, set that Type accordingly:

wearSocket.setKeyDataType("myKey",new TypeToken<List<String>>() {}.getType());

Change List<String> to whatever class (or collection of classes) that dataItem is.

Implement WearSocket.MessageListener and override messageReceived to start listening for messages

public class MyActivity implements WearSocket.MessageListener

    @Override
    public void dataChanged(String key, Object data) {
        //Cast "data" as whatever class you sent it as
        ArrayList<String> dataItem = (ArrayList<String>) data;
        //Do things here!
    }

License and Attribution

MIT License

WearSocket uses: Gson, Android Wearable APIs, Google Play Services