From 0d0c3d9a54a4ed2f7313cec03af235266b177d3d Mon Sep 17 00:00:00 2001 From: Marius Lindvall Date: Thu, 14 Nov 2019 23:27:51 +0100 Subject: [PATCH] Update Tasker integration to reflect v1.4 --- Tasker-integration.md | 47 ++++++++++++++++++++++++++++++++++--------- 1 file changed, 38 insertions(+), 9 deletions(-) diff --git a/Tasker-integration.md b/Tasker-integration.md index c999db3..502a2f1 100644 --- a/Tasker-integration.md +++ b/Tasker-integration.md @@ -2,7 +2,7 @@ It is possible to start shares in Hauk via Tasker, starting from v1.3. To create a Hauk task, create a task and add a new action. Choose "System" > "Send Intent". -## Starting a single-user share +## Start a single-user share, then open a "share via" dialog This action will start a single user share and then immediately open a share UI prompting the user to share the resulting tracking link. @@ -13,14 +13,43 @@ Target: `Broadcast Receiver` ### Extras -Extra | Type | Default | Value ---------- | ------- | ---------------------- | -------------------- -source | String | *Required* | A human readable ID that identifies the source of the broadcast. The first time you use this broadcast, the attempt will be blocked and the user is prompted to authorize shares to be started from broadcast intents identified by the source you specify here. Subsequent broadcasts with the same ID will either start a sharing session or be silently ignored depending on the user's response to the authorization prompt. -server | String | Last used1) | The Hauk backend to connect to -password | String | Last used1) | The password for the Hauk backend -duration | Integer | Last used2) | Duration of the sharing session, in seconds -interval | Integer | Last used3) | Interval between each submitted location update, in seconds -adoptable | Boolean | Last used4) | `true` if the share should be adoptable by others, `false` otherwise +Extra | Type | Default | Value +----------- | ------- | ---------------------- | -------------------- +source | String | *Required* | A human readable ID that identifies the source of the broadcast. The first time you use this broadcast, the attempt will be blocked and the user is prompted to authorize shares to be started from broadcast intents identified by the source you specify here. Subsequent broadcasts with the same ID will either start a sharing session or be silently ignored depending on the user's response to the authorization prompt. +server | String | Last used1) | The Hauk backend to connect to +username | String | Last used1) | The username for the Hauk backend, if applicable +password | String | Last used1) | The password for the Hauk backend +duration | Integer | Last used2) | Duration of the sharing session, in seconds +interval | Integer | Last used3) | Interval between each submitted location update, in seconds +requestLink | String | Last used1) | A named location link ID that should be used instead of one randomly generated by the server. This field should not include the server URL. Set to empty string to force a random link. +adoptable | Boolean | Last used4) | `true` if the share should be adoptable by others, `false` otherwise + +1) Uses the setting that was last used when starting a share from within the Hauk UI. +2) See 1). Default if never used is 30 seconds. +3) See 1). Default if never used is 1 second. +4) See 1). Default if never used is `true` to allow adoption. + +## Start a single-user share, then display the link on screen + +This action will start a single user share and then show a toast notification showing the tracking link that is being shared to. + +Action: `info.varden.hauk.START_ALONE_THEN_MAKE_TOAST` +Package: `info.varden.hauk` +Class: `info.varden.hauk.global.Receiver` +Target: `Broadcast Receiver` + +### Extras + +Extra | Type | Default | Value +----------- | ------- | ---------------------- | -------------------- +source | String | *Required* | A human readable ID that identifies the source of the broadcast. The first time you use this broadcast, the attempt will be blocked and the user is prompted to authorize shares to be started from broadcast intents identified by the source you specify here. Subsequent broadcasts with the same ID will either start a sharing session or be silently ignored depending on the user's response to the authorization prompt. +requestLink | String | *Required* | A named location link ID to attach to on the server. This field should not include the server URL. Set to empty string to force a random link. +server | String | Last used1) | The Hauk backend to connect to +username | String | Last used1) | The username for the Hauk backend, if applicable +password | String | Last used1) | The password for the Hauk backend +duration | Integer | Last used2) | Duration of the sharing session, in seconds +interval | Integer | Last used3) | Interval between each submitted location update, in seconds +adoptable | Boolean | Last used4) | `true` if the share should be adoptable by others, `false` otherwise 1) Uses the setting that was last used when starting a share from within the Hauk UI. 2) See 1). Default if never used is 30 seconds.