NativeScript Wear Messaging Plugin
Adding support for Wear Messaging using the MessageClient API. This plugin is intended to be used to communicate between a handled app and an Android Wear app.
Only Android Supported
Installation
Install the plugin:
tns plugin add nativescript-wear-messaging
Usage
The idea of this plugin is to communicate between a wear device and a handled device. Both can act as receiver or sender, in fact, that's the most common usage way and the one explained here. You need two apps that will communicate to each other, here is described how you can configure this plugin in both:
In the Wear app
Add the following to your AndroidManifest.xml
inside your <application>
tag. It will create the service listener that will be waiting
for the messages sent by the handled app.
Since multiple wearables can be connected to the handheld device, the wearable app needs to determine that a connected node is capable of launching the activity. In your wearable app, advertise that the node it runs on provides specific capabilities. We will use this later when sending messages from the handled device.
Create a wear.xml
file inside app/App_Resources/Android/values
to advertise the capabilities
name_of_your_capabilty_wear
Sending messages to the handled app:
; ;client.send"/some/path", "some content", "name_of_your_capabilty_handled"; // Last parameter is the capablity name of then handled device
Receiving messages to from the handled app:
; ;client.registerListener;client.startListener;
*Include the following to your references.d.ts
file if you are getting this error: TS2304: Cannot find name 'com'.
/// <reference path="./node_modules/nativescript-wear-messaging/declarations.d.ts" /> Needed for wear-messaging
In the handled app
Add the following to your AndroidManifest.xml
inside your <application>
tag. It will create the service listener that will be waiting
for the messages sent by the wear app.
Since multiple wearables can be connected to the handheld device, the wearable app needs to determine that a connected node is capable of launching the activity. In your wearable app, advertise that the node it runs on provides specific capabilities. We will use this later when sending messages from the handled device.
Create a wear.xml
file inside app/App_Resources/Android/values
to advertise the capabilities
name_of_your_capabilty_handled
Sending messages to the wear app:
; ;client.send"/some/path", "some content", "name_of_your_capabilty_wear"; // Last parameter is the capablity name of then handled device
Receiving messages to from the wear app:
; ;client.registerListener;client.startListener;
*You should read the official Android doc anyway.
License
Apache License Version 2.0, January 2018