lbehm/workadventure
1
0
Fork 0
Code Issues Pull requests Releases Activity

Updates documentation

Browse source
This commit is contained in:
Benedicte Quimbert 2021-10-29 18:56:04 +02:00
parent cbf7cdfe29
commit c93b9bc7ae
1 changed files with 21 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
docs/maps/api-player.md
View file

@ -86,6 +86,22 @@ WA.onInit().then(() => {
}) })
``` ```
### Get the position of the player
```
WA.player.getPosition(): Promise<Position>
```
The player's current position is available using the `WA.player.getPosition()` function.
{.alert.alert-info}
You need to wait for the end of the initialization before calling `WA.player.getPosition()`
```typescript
WA.onInit().then(() => {
console.log('Tags: ', WA.player.getPosition());
})
```
### Listen to player movement ### Listen to player movement
``` ```
WA.player.onPlayerMove(callback: HasPlayerMovedEventCallback): void; WA.player.onPlayerMove(callback: HasPlayerMovedEventCallback): void;
@ -107,8 +123,8 @@ Example :
WA.player.onPlayerMove(console.log); WA.player.onPlayerMove(console.log);
``` ```
## Player specific properties ## Player specific variables
Similarly to maps (see [API state related functions](api-state.md)), it is possible to store data **related to a specific player** in a "state". Such data will be stored using the local storage from the user's browser. Similarly to maps (see [API state related functions](api-state.md)), it is possible to store data **related to a specific player** in a "state". Such data will be stored using the local storage from the user's browser. Any value that is serializable in JSON can be stored.
{.alert.alert-info} {.alert.alert-info}
In the future, player-related variables will be stored on the WorkAdventure server if the current player is logged. In the future, player-related variables will be stored on the WorkAdventure server if the current player is logged.
@ -123,12 +139,12 @@ Example:
WA.player.state.toto = "value" //will set the "toto" key to "value" WA.player.state.toto = "value" //will set the "toto" key to "value"
``` ```
### Reading a property ### Reading a variable
A player property can be read by calling its key from the player's state. A player variable can be read by calling its key from the player's state.
Example: Example:
```javascript ```javascript
WA.player.state.toto //will retrieve the property WA.player.state.toto //will retrieve the variable
``` ```
### Set the outline color of the player ### Set the outline color of the player