Skip to content

@capgo/capacitor-watch

Apple Watch communication plugin for Capacitor. Provides bidirectional messaging between iPhone and Apple Watch using WatchConnectivity.

Apple Watch communication plugin for Capacitor. Provides bidirectional messaging between iPhone and Apple Watch using WatchConnectivity.

  • sendMessage - Send an interactive message to the watch. The watch must be reachable for this to succeed. Use this for time-sensitive, interactive communication.
  • updateApplicationContext - Update the application context shared with the watch. Only the latest context is kept - this overwrites any previous context. Use this for syncing app state that the watch needs to display.
  • transferUserInfo - Transfer user info to the watch. Transfers are queued and delivered in order, even if the watch is not currently reachable. Use this for important data that must be delivered reliably.
  • replyToMessage - Reply to a message from the watch that requested a reply. Use this in response to the messageReceivedWithReply event.
MethodDescription
sendMessageSend an interactive message to the watch. The watch must be reachable for this to succeed. Use this for time-sensitive, interactive communication.
updateApplicationContextUpdate the application context shared with the watch. Only the latest context is kept - this overwrites any previous context. Use this for syncing app state that the watch needs to display.
transferUserInfoTransfer user info to the watch. Transfers are queued and delivered in order, even if the watch is not currently reachable. Use this for important data that must be delivered reliably.
replyToMessageReply to a message from the watch that requested a reply. Use this in response to the messageReceivedWithReply event.
getInfoGet information about the watch connectivity status.
getPluginVersionGet the native Capacitor plugin version.
addListenerListen for messages received from the watch.
addListenerListen for messages from the watch that require a reply.
addListenerListen for application context updates from the watch.
addListenerListen for user info transfers from the watch.
addListenerListen for watch reachability changes.
addListenerListen for session activation state changes.
removeAllListenersRemove all listeners for this plugin.

This reference is synced from src/definitions.ts in capacitor-watch.