2022-02-20 20:30:53 +01:00
|
|
|
# Desktop app
|
2022-02-17 18:09:57 +01:00
|
|
|
|
2022-02-20 20:30:53 +01:00
|
|
|
The desktop component is an electron app. It uses a hybrid setup based of two main components:
|
|
|
|
- A `local-app` bundled into the electron app. It has two main parts:
|
|
|
|
- A sidebar to show the server list, with the currently selected server
|
|
|
|
- A main page which is used to manage servers and to show other "local" pages like the options
|
|
|
|
- A BrowserView (often called `appView` or `app`) showing the actual frontend of an external WorkAdventure deployment.
|
|
|
|
If a server is selected the BrowserView / `appView` is overlaying the main part right to the sidebar.
|
|
|
|
|
|
|
|
## Development
|
|
|
|
|
|
|
|
```bash
|
|
|
|
# start local-app
|
2022-02-20 21:06:27 +01:00
|
|
|
yarn dev:local-app
|
2022-02-20 20:30:53 +01:00
|
|
|
|
|
|
|
# start electron app
|
|
|
|
LOCAL_APP_URL=http://localhost:3000 yarn dev
|
|
|
|
|
|
|
|
# or create an executable by running:
|
|
|
|
yarn bundle
|
2022-02-20 21:06:27 +01:00
|
|
|
```
|
|
|
|
|
|
|
|
## API for front
|
|
|
|
|
|
|
|
TODO:
|
|
|
|
|
|
|
|
```ts
|
|
|
|
if (window?.WorkAdventureDesktopApi?.desktop) {
|
|
|
|
alert('Yeah you are using the desktop app ;)');
|
|
|
|
}
|
|
|
|
|
|
|
|
let muted = false;
|
|
|
|
|
|
|
|
window?.WorkAdventureDesktopApi?.onMutedKeyPress((event) => {
|
|
|
|
if (muted) {
|
|
|
|
document.getElementById("info-box").innerHTML =
|
|
|
|
"Ready to speak! Press ctrl-alt-m to mute.";
|
|
|
|
} else {
|
|
|
|
document.getElementById("info-box").innerHTML =
|
|
|
|
"Muted! Press ctrl-alt-m to unmute again.";
|
|
|
|
}
|
|
|
|
muted = !muted;
|
|
|
|
});
|
|
|
|
|
|
|
|
window.WorkAdventureDesktopApi.notify("Hello from front");
|
2022-02-20 20:30:53 +01:00
|
|
|
```
|