Differences

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

--- lua [2020/07/24 09:29] – alexcurran1
+++ lua [2024/10/20 20:29] (current) – Added volume controls frutejuise
@@ 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: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 226: / Line 235: @@
     wm_sfx('sfx_file')     -- play MP3 file with name sfx_file.mp3 (needs to be in /BeautifulWatches/sfx) - supported watches with speaker only
     wm_transition('...')   -- run a transition (see Transitions)
+    wm_anim_set('layerName', 'anim_in', 'Typewriter")     -- set animation in for 'layerName' to Typewriter
+    wm_anim_set('layerName', 'dur_in', 1.0)     -- set duration in for 'layerName' to 1.0 (or use -1 for default)
+    wm_anim_start('layerName')    -- start animation on 'layerName'
     wm_tag('...')          -- ONLY use for dynamic variables otherwise will break
                                 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 =====