43 lines
1.6 KiB
Markdown
43 lines
1.6 KiB
Markdown
XION Arcade Control Panel
|
|
================================================================================
|
|
|
|
This is an iOS control panel for the XION/Xaibatsu arcade. It connects to Home
|
|
Assistant's websocket API, displays entities with the `control_panel` label, and
|
|
renders entities with the additional `control_panel_light` label in the lights
|
|
section.
|
|
|
|
Configuration
|
|
--------------------------------------------------------------------------------
|
|
|
|
The Home Assistant access token is intentionally not stored in source control.
|
|
Provide it either through the `HOME_ASSISTANT_ACCESS_TOKEN` process environment
|
|
variable or as the `HOME_ASSISTANT_ACCESS_TOKEN` Xcode build setting. The latter
|
|
is expanded into the app's `HomeAssistantAccessToken` Info.plist entry.
|
|
|
|
For a Simulator launch from the command line:
|
|
|
|
```sh
|
|
SIMCTL_CHILD_HOME_ASSISTANT_ACCESS_TOKEN='token' \
|
|
xcrun simctl launch booted com.zanneth.XIONControlPanel
|
|
```
|
|
|
|
The client disconnects cleanly when the app resigns active, reconnects and
|
|
refreshes immediately when it returns, and uses Home Assistant `ping`/`pong`
|
|
messages as a heartbeat while active.
|
|
|
|
Testing
|
|
--------------------------------------------------------------------------------
|
|
|
|
The live integration test is opt-in because it briefly changes the `Asteroids`
|
|
switch and restores its original state:
|
|
|
|
```sh
|
|
HOME_ASSISTANT_ACCESS_TOKEN='token' \
|
|
RUN_LIVE_HOME_ASSISTANT_TESTS=1 \
|
|
xcodebuild -project XIONControlPanel.xcodeproj \
|
|
-scheme XIONControlPanel \
|
|
-destination 'platform=iOS Simulator,name=iPhone 17' \
|
|
-only-testing:XIONControlPanelTests/HomeAssistantIntegrationTests \
|
|
test
|
|
```
|