Differences

This shows you the differences between two versions of the page.

--- lua [2024/08/10 12:30] – document wm_action w_app korkman
+++ lua [2025/04/12 07:47] (current) – old revision restored (2024/10/20 20:29) splitbrain
@@ Line 207: / Line 207: @@
 ===== WatchMaker Lua API =====
-WatchMaker extends the Lua commandset. Just use the wm_action() or other functions anywhere in your script or tap actions :
+WatchMaker extends the Lua commandset. Just use the wm_action() or other functions anywhere in your script or tap actions:
     wm_action('sw_start_stop')          -- start or stop the stopwatch
     wm_action('sw_reset')               -- reset stopwatch
+    wm_action('media_next')             -- next track
+    wm_action('media_prev')             -- previous track
+    wm_action('media_play')             -- play media
+    wm_action('media_pause')            -- pause media
+    wm_action('media_play_pause')       -- play paused media or pause playing media
+    wm_action('vol_up')                 -- increase the volume on the connected phone
+    wm_action('vol_down')               -- decrease the volume on the connected phone
     wm_action('m_update_weather')       -- update weather
     wm_action('m_task:MyTask')          -- run Tasker task 'MyTask'
@@ Line 220: / Line 227: @@
     wm_action('widget_health')          -- Launch Health Widget
     wm_action('widget_calendar')        -- Launch Calendar Widget
-    wm_action('w_app:Calendar`com.samsung.android.calendar') -- Launch Wear OS app by ID
+    wm_action('w_app:App Name`com.app.package.name') -- Launch Wear OS app*
+    wm_action('w_app:App Name`com.app.package.name`com.app.package.name.activityName') -- Launch specific activity
     wm_schedule('...')     -- schedule an animation or event (see Scheduling Animations / Functions)
@@ Line 233: / Line 241: @@
                                 return a value of a WatchMaker tag, e.g. wm_tag("{c"..var_myvar.."bp}")
     is_bright              -- return true if watch is bright, else false
+*About wm_action w_app
+The delimiter for the app link is a backtick ''`'' and it consists of two or three parts:
+  * App name (may be empty)
+  * Package name
+  * Activity name (optional)
+The app name is optional. If it is empty, the app main activity is launched. Example: ''wm_action('w_app:`com.samsung.android.watch.weather')''
+The easiest way to find the package name (example ''com.samsung.android.calendar'') is to search for the app on https://www.apkmirror.com/ or https://apkpure.net/. The package names are listed on the download pages. A more precise approach is to create a tap action first, select the app via "Watch: Select Application", export the watch, unzip the .watch file and search for ''tap_action="w_app:'' in watch.xml. It uses the same app link format.
+Available activities of apps can be obtained by downloading the APK file and uploading it to https://www.virustotal.com/. The "details" tab will list all activity names. Though at the time of writing, no activity could be launched successfully, so this may be broken (Wear OS 4).
 ===== Tweening Functions =====