Communication layer between a Flutter project for Android and IOS and a companion wearable app.

This will send and receive messages and/or data to the platform specific wearable communication method. It uses the wearable data layer and messaging API's on android devices and WCSession on IPhones

• add implementation 'com.google.android.gms:play-services-wearable:17.0.0' to the app level build.gradle

• make sure that the applicationId of your WearOS app is the same as the one on your phone app

• IOS deployment target must be at least 9.3
• enable bitcode in you app to support. just follow these instructions to enable apple watch for your app

• For information on how to access the sent data on wearable devices please see the example project
• It is recommended to not rely on instantaneous transfer of data on IOS as applicationContext waits for a "low intensity situation" to set this value between app and watch

Use the static method WearableCommunicator.sendMessage(Map<String, dynamic> message); to send a single shot message.

• on android the path "/MessageChannel" will be used for all messages

WearableCommunicator.sendMessage({
  "text": "Some text",
  "integerValue": 1
});

Use the static method WearableCommunicator.listenForMessage; to register a message listener function.

• (android specific) if the message data is a string then the library will assume it is JSON and try to convert it. if that operation fails the message data will be sent to the listener unchanged.

// msg is either a Map<String, dynamic> or a string (make sure to check for that when using the library)
WearableListener.listenForMessage((msg) {
  print(msg);
});

Use the static method WearableCommunicator.setData(String path, Map<String, dynamic> message); to set a data item with specified path (use wearOS compatible data layer paths)

• (IOS specific) the path variable is used as a key within the application context dictionary
• (IOS specific) data transfer is not instant and will wait for a "low intensity" moment. use this function only to set permanent low priority information

WearableCommunicator.setData("/actor/cage",{
    "name": "Nicolas Cage",
    "awesomeRating": 100
});

Use the static method WearableCommunicator.listenForDataLayer; to register a data listener function.

• (android specific) if the data is a string then the library will assume it is JSON and try to convert it. if that operation fails the data will be sent to the listener unchanged.

// data should be a Map<String, dynamic> but can also be a string under exceptional circumstances
WearableListener.listenForDataLayer((data) {
  print(data);
});

• currently does not support nested data structures on android. Therefore it is recommended to send complex items as json strings to be parsed on the recieving end
• Supported types in communications are
  • Strings
  • Integers
  • Floats
  • Double
  • Long
  • Boolean
  • Single type lists of strings, floats, ints or longs
  • [TODO] Nested Maps (will be converted to JSON on android)

• Send messages from android though the messageClient
• recieve messages from WearOS
• Send messages from IOS though the messageClient
• recieve messages from watchOS
• set android data layer items
• set IOS application context
• recieve data layer events from wearOS
• recieve data/configuration changes from watchOS (updates are not instant)
• Handle complex/nested data structures (not nececary for initial release)
• fetch data items from permanent storage (data layer/app config) note: low priority
• set up background service to sync data in background

🕴🏻 Dagur Arinbjörn Daníelsson
📩 Email
🔗 LinkedIn