Mirrors
/
Hauk
mirror of https://github.com/bilde2910/Hauk.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update Tasker integration to reflect v1.4

Marius Lindvall 2019-11-14 23:27:51 +01:00
parent e28eefbe35
commit 0d0c3d9a54
1 changed files with 38 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
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 used<sup>1)</sup> | The Hauk backend to connect to
password | String | Last used<sup>1)</sup> | The password for the Hauk backend
duration | Integer | Last used<sup>2)</sup> | Duration of the sharing session, in seconds
interval | Integer | Last used<sup>3)</sup> | Interval between each submitted location update, in seconds
adoptable | Boolean | Last used<sup>4)</sup> | `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 used<sup>1)</sup> | The Hauk backend to connect to
username | String | Last used<sup>1)</sup> | The username for the Hauk backend, if applicable
password | String | Last used<sup>1)</sup> | The password for the Hauk backend
duration | Integer | Last used<sup>2)</sup> | Duration of the sharing session, in seconds
interval | Integer | Last used<sup>3)</sup> | Interval between each submitted location update, in seconds
requestLink | String | Last used<sup>1)</sup> | 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 used<sup>4)</sup> | `true` if the share should be adoptable by others, `false` otherwise
<sup>1)</sup> Uses the setting that was last used when starting a share from within the Hauk UI.
<sup>2)</sup> See 1). Default if never used is 30 seconds.
<sup>3)</sup> See 1). Default if never used is 1 second.
<sup>4)</sup> 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 used<sup>1)</sup> | The Hauk backend to connect to
username | String | Last used<sup>1)</sup> | The username for the Hauk backend, if applicable
password | String | Last used<sup>1)</sup> | The password for the Hauk backend
duration | Integer | Last used<sup>2)</sup> | Duration of the sharing session, in seconds
interval | Integer | Last used<sup>3)</sup> | Interval between each submitted location update, in seconds
adoptable | Boolean | Last used<sup>4)</sup> | `true` if the share should be adoptable by others, `false` otherwise
<sup>1)</sup> Uses the setting that was last used when starting a share from within the Hauk UI.
<sup>2)</sup> See 1). Default if never used is 30 seconds.