From 98b383ea87deafd005e04123a51176d864b216e6 Mon Sep 17 00:00:00 2001
From: Jonah Bonner <47046556+jwbonner@users.noreply.github.com>
Date: Tue, 31 Dec 2024 18:01:16 +0000
Subject: [PATCH] AdvantageScope XR (#295)
* Initial XR development
* Improvements
* Build 3D workers for XR client
* Add Xcode project
* Clean up temperature RGB calculation
* Fix status bar
* Hide web overlay when scanning QR code
* Add support for scanning multiple IP addresses
* Add compatibility check for XR
* Add more XR server controls
* Add active effect for XR button
* Exclude native app from prettier
* Rename file
* Finish majority of desktop XR implementation
* Add recording feature
* Read server compatibility from QR code
* Enable remote inspection for debug builds
* Set up basic calibration code
* Improve field sizing reference definition
* Nominally working XR rendering
* Add function to toggle carpet and field elements
* Make web overlay message handler private
* Delete worker before resolving promise
* Load field without mesh merging
* Use constant for HTTP port
* Make robots work!
* Allow hiding robot models
* Fix crash when disposing robot manager
* Fix carpet separation
* Remove XR workers
* Add warning about experimental status
* Add App Clip
* Update iOS icons
* Use correct field size for calibration
* Link marked points to plane anchors
* Add separate request for hiding and showing controls from JS
* Optimize for smoother streaming
* Remove comment
* Rename camera state to render state
* Reset tracking when calibrating
* Render virtual content at full resolution
* Improve lighting
* Add encryption information to plist
* Add CI build for iOS
* Add initial docs
* Disable heatmaps in XR
* Add message about future availability of XR object types
* Add swerve states to XR
* Enable heatmap in XR
* Add warning about firewall
* Add XR to changelog
* Add redirect for XR
* Improve reliability of QR code
* Disable heatmap and swerve states in XR
* Fix frame dropping logic
* Stop XR server when 3D tab closed
Pop up a warning so the user can confirm
* Fix AprilTag textures in XR
* Update XR docs
* Link to feature overview video from docs
* Add XR to full changelog
* Add reference to headsets in docs
* Minor fixes to docs
* Add XR video to 2025 page
* Remove placeholder XR page
---
.github/workflows/build.yml | 12 +
.gitignore | 6 +
.prettierignore | 3 +-
.../docs/more-features/advantagescope-xr.md | 88 +
docsSite/docs/more-features/custom-assets.md | 2 +-
docsSite/docs/more-features/gltf-convert.md | 2 +-
docsSite/docs/more-features/img/app-store.svg | 46 +
docsSite/docs/more-features/img/xr-1.png | Bin 0 -> 774981 bytes
docsSite/docs/more-features/img/xr-2.png | Bin 0 -> 366055 bytes
docsSite/docs/more-features/nt-publishing.md | 2 +-
docsSite/docs/more-features/zebra.md | 2 +-
docsSite/docs/tab-reference/3d-field.md | 2 +-
docsSite/docs/whats-new/full-changelog.md | 1 +
docsSite/docs/whats-new/index.md | 6 +
docsSite/docs/xr.md | 9 -
docsSite/docusaurus.config.ts | 14 +
package-lock.json | 20461 +++++++++++++---
package.json | 11 +-
rollup.config.mjs | 65 +-
src/hub/Tabs.ts | 37 +-
src/hub/WorkerManager.ts | 19 +-
.../controllers/ThreeDimensionController.ts | 11 +-
src/hub/hub.ts | 6 +-
src/main/Constants.ts | 9 +
src/main/XRControls.ts | 116 +
src/main/XRServer.ts | 188 +
src/main/main.ts | 117 +-
src/preferences.ts | 1 +
src/shared/Preferences.ts | 1 +
src/shared/XRTypes.ts | 45 +
.../renderers/ThreeDimensionRendererImpl.ts | 1 +
.../renderers/threeDimension/ObjectManager.ts | 3 +
.../threeDimension/OptimizeGeometries.ts | 11 +-
.../objectManagers/AprilTagManager.ts | 14 +-
.../objectManagers/AxesManager.ts | 3 +-
.../objectManagers/ConeManager.ts | 3 +-
.../objectManagers/GamePieceManager.ts | 3 +-
.../objectManagers/HeatmapManager.ts | 7 +-
.../objectManagers/RobotManager.ts | 395 +-
.../objectManagers/TrajectoryManager.ts | 3 +-
.../objectManagers/ZebraManager.ts | 3 +-
.../threeDimension/workers/loadField.ts | 3 +
src/xrClient/XRCamera.ts | 26 +
src/xrClient/XRRenderer.ts | 792 +
src/xrClient/xrClient.ts | 84 +
src/xrControls.ts | 107 +
www/hub.css | 27 +
www/hub.html | 4 +-
www/satellite.html | 2 +-
...g => sparkles.square.filled.on.square.svg} | 4 +-
www/xr.css | 16 -
www/xr.html | 17 -
www/xr.webp | Bin 257542 -> 0 bytes
www/xrClient.css | 107 +
www/xrClient.html | 27 +
www/xrControls.css | 77 +
www/xrControls.html | 56 +
xr/AdvantageScopeXR.xcodeproj/project.pbxproj | 700 +
.../contents.xcworkspacedata | 7 +
.../xcshareddata/IDEWorkspaceChecks.plist | 8 +
.../xcshareddata/WorkspaceSettings.xcsettings | 5 +
.../xcshareddata/swiftpm/Package.resolved | 15 +
.../xcschemes/AdvantageScopeXR.xcscheme | 78 +
.../xcschemes/AdvantageScopeXRClip.xcscheme | 78 +
xr/AdvantageScopeXR/ARManager.swift | 204 +
xr/AdvantageScopeXR/ARRenderer.swift | 298 +
xr/AdvantageScopeXR/ARShaderTypes.h | 48 +
xr/AdvantageScopeXR/ARShaders.metal | 71 +
.../AdvantageScopeXR-Bridging-Header.h | 1 +
xr/AdvantageScopeXR/AdvantageScopeXR.swift | 10 +
.../AccentColor.colorset/Contents.json | 20 +
.../AppIcon.appiconset/AdvantageScope-ios.png | Bin 0 -> 174905 bytes
.../AppIcon.appiconset/Contents.json | 36 +
.../Assets.xcassets/Contents.json | 6 +
xr/AdvantageScopeXR/Banner.swift | 38 +
xr/AdvantageScopeXR/Constants.swift | 5 +
xr/AdvantageScopeXR/ContentView.swift | 100 +
xr/AdvantageScopeXR/ControlsMenu.swift | 46 +
xr/AdvantageScopeXR/Info.plist | 15 +
xr/AdvantageScopeXR/Networking.swift | 91 +
xr/AdvantageScopeXR/QRScanner.swift | 82 +
xr/AdvantageScopeXR/RecordButton.swift | 92 +
xr/AdvantageScopeXR/WebOverlay.swift | 99 +
.../AdvantageScopeXRClip.entitlements | 10 +
xr/AdvantageScopeXRClip/Info.plist | 29 +
85 files changed, 22236 insertions(+), 3033 deletions(-)
create mode 100644 docsSite/docs/more-features/advantagescope-xr.md
create mode 100755 docsSite/docs/more-features/img/app-store.svg
create mode 100644 docsSite/docs/more-features/img/xr-1.png
create mode 100644 docsSite/docs/more-features/img/xr-2.png
delete mode 100644 docsSite/docs/xr.md
create mode 100644 src/main/XRControls.ts
create mode 100644 src/main/XRServer.ts
create mode 100644 src/shared/XRTypes.ts
create mode 100644 src/xrClient/XRCamera.ts
create mode 100644 src/xrClient/XRRenderer.ts
create mode 100644 src/xrClient/xrClient.ts
create mode 100644 src/xrControls.ts
rename www/symbols/{sparkles.square.filled.on.square.purple.svg => sparkles.square.filled.on.square.svg} (94%)
delete mode 100644 www/xr.css
delete mode 100644 www/xr.html
delete mode 100644 www/xr.webp
create mode 100644 www/xrClient.css
create mode 100644 www/xrClient.html
create mode 100644 www/xrControls.css
create mode 100644 www/xrControls.html
create mode 100644 xr/AdvantageScopeXR.xcodeproj/project.pbxproj
create mode 100644 xr/AdvantageScopeXR.xcodeproj/project.xcworkspace/contents.xcworkspacedata
create mode 100644 xr/AdvantageScopeXR.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist
create mode 100644 xr/AdvantageScopeXR.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings
create mode 100644 xr/AdvantageScopeXR.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved
create mode 100644 xr/AdvantageScopeXR.xcodeproj/xcshareddata/xcschemes/AdvantageScopeXR.xcscheme
create mode 100644 xr/AdvantageScopeXR.xcodeproj/xcshareddata/xcschemes/AdvantageScopeXRClip.xcscheme
create mode 100644 xr/AdvantageScopeXR/ARManager.swift
create mode 100644 xr/AdvantageScopeXR/ARRenderer.swift
create mode 100644 xr/AdvantageScopeXR/ARShaderTypes.h
create mode 100644 xr/AdvantageScopeXR/ARShaders.metal
create mode 100644 xr/AdvantageScopeXR/AdvantageScopeXR-Bridging-Header.h
create mode 100644 xr/AdvantageScopeXR/AdvantageScopeXR.swift
create mode 100644 xr/AdvantageScopeXR/Assets.xcassets/AccentColor.colorset/Contents.json
create mode 100644 xr/AdvantageScopeXR/Assets.xcassets/AppIcon.appiconset/AdvantageScope-ios.png
create mode 100644 xr/AdvantageScopeXR/Assets.xcassets/AppIcon.appiconset/Contents.json
create mode 100644 xr/AdvantageScopeXR/Assets.xcassets/Contents.json
create mode 100644 xr/AdvantageScopeXR/Banner.swift
create mode 100644 xr/AdvantageScopeXR/Constants.swift
create mode 100644 xr/AdvantageScopeXR/ContentView.swift
create mode 100644 xr/AdvantageScopeXR/ControlsMenu.swift
create mode 100644 xr/AdvantageScopeXR/Info.plist
create mode 100644 xr/AdvantageScopeXR/Networking.swift
create mode 100644 xr/AdvantageScopeXR/QRScanner.swift
create mode 100644 xr/AdvantageScopeXR/RecordButton.swift
create mode 100644 xr/AdvantageScopeXR/WebOverlay.swift
create mode 100644 xr/AdvantageScopeXRClip/AdvantageScopeXRClip.entitlements
create mode 100644 xr/AdvantageScopeXRClip/Info.plist
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index dae80e63..edc864be 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -54,6 +54,18 @@ jobs:
bundles/*.js
bundles/*.wasm
+ build-ios:
+ name: Build for iOS
+ runs-on: macos-15
+
+ steps:
+ - name: Checkout repository
+ uses: actions/checkout@v4
+ - name: Build AdvantageScopeXR
+ run: xcodebuild -project xr/AdvantageScopeXR.xcodeproj -scheme AdvantageScopeXR -sdk iphonesimulator build
+ - name: Build AdvantageScopeXRClip
+ run: xcodebuild -project xr/AdvantageScopeXR.xcodeproj -scheme AdvantageScopeXRClip -sdk iphonesimulator build
+
build-win:
name: Build for Windows (${{ matrix.arch }})
needs: compile
diff --git a/.gitignore b/.gitignore
index 8a8bb759..14248631 100644
--- a/.gitignore
+++ b/.gitignore
@@ -111,3 +111,9 @@ $RECYCLE.BIN/
# IDE Specific Files
.idea
+
+# Xcode
+build/*
+*.pbxuser
+*.mode1v3
+xcuserdata
\ No newline at end of file
diff --git a/.prettierignore b/.prettierignore
index b64913e9..80df1c8f 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -2,4 +2,5 @@ node_modules
dist
bundles
src/licenses.json
-docsSite/build
\ No newline at end of file
+docsSite/build
+xr
\ No newline at end of file
diff --git a/docsSite/docs/more-features/advantagescope-xr.md b/docsSite/docs/more-features/advantagescope-xr.md
new file mode 100644
index 00000000..4512e9c6
--- /dev/null
+++ b/docsSite/docs/more-features/advantagescope-xr.md
@@ -0,0 +1,88 @@
+---
+sidebar_position: 1
+---
+
+import Image1 from "./img/xr-1.png";
+import Image2 from "./img/xr-2.png";
+
+# AdvantageScope XR
+
+:::warning
+AdvantageScope XR is an experimental feature, and may not function properly on all devices. Please report any problems via the [GitHub issues page](https://github.com/Mechanical-Advantage/AdvantageScope/issues), though note that during the season we always prioritize bug fixes that affect non-experimental features.
+:::
+
+AdvantageScope XR brings the 👀 [3D Field](/tab-reference/3d-field) view to life in augmented reality, enabling you to visualize data in all new ways. See a simulated auto in life size, review match strategy with a tabletop field model, overlay diagnostic information on a real robot, and so much more! The video below demonstrates several use cases for this feature:
+
+
+
+## Requirements
+
+- **Host:** The AdvantageScope desktop application on Windows, macOS, or Linux (v4.1.0 or later). Any firewalls on the device should be [disabled](https://docs.wpilib.org/en/stable/docs/networking/networking-introduction/windows-firewall-configuration.html#disabling-windows-firewall).
+- **Client:** An iPhone or iPad running iOS/iPadOS 16 or later. No app installation is required.
+- **Network:** Both devices must be connected to the same network (Wi-Fi, USB tethering, etc). Subject to the requirement below, this network does not need to be connected to the internet.
+- **Internet:** If AdvantageScope XR has not been used recently, the mobile device must have an internet connection (e.g. cellular data). To eliminate this requirement, check the [offline usage](#offline-usage) section below.
+
+:::tip
+AdvantageScope XR is supported on many iPhone and iPad models, but is more stable for devices with a **LiDAR sensor**. This includes the iPhone Pro (starting with the iPhone 12 Pro) and iPad Pro (spring 2020 or later).
+:::
+
+
+What about other platforms?
+
+AdvantageScope XR is only supported on iOS and iPadOS. We do not have any immediate plans to support alternative platforms. The client application requires tight integration with native APIs for augmented reality, video recording, web rendering, and more. We chose to prioritize iOS and iPadOS development and support for several reasons:
+
+- **Consistency:** AdvantageScope XR is a demanding application. While Android devices vary widely in processing power and features, the iPhone and iPad provide a consistent development experience across generations. All recent iOS and iPadOS devices are powerful enough to run AdvantageScope XR, and newer devices support additional features AdvantageScope can utilize (such as LiDAR).
+
+- **Availability:** The iPhone remains the most common smartphone that students in the United States are likely to own or have easily accessible from peers, and is more widely available than any model of VR or mixed reality headset. Supporting iOS maximizes the number of users who have easy access to AdvantageScope XR.
+
+- **Tablet Support:** We think many users will want to take advantage of running AdvantageScope XR on a tablet, since tablets provide a larger display that is easier for multiple people to see at once. iPad is the most commonly used tablet worldwide, so supporting iPadOS makes the tablet experience as accessible as possible.
+
+
+
+## Setup
+
+1. On the host system, **click the "XR" button** on any 3D field tab. Only one XR host session may be active at the same time, so clicking this button will interrupt any other active sessions.
+
+
+
+2. The **XR controls window** will open, with a QR code and [options](#options) to customize the AR experience. To cancel the XR session and disconnect any clients, close the controls window.
+
+
+
+3. Scan the QR code using the **built-in camera app** on the client device. No app installation is required.
+4. Tap "AdvantageScope XR" and then "Open" to **start the experience** and connect to the host. If prompted, allow AdvantageScope XR to access the **camera and local network**.
+5. Follow the instructions on the device to **calibrate and position the field model**.
+6. Control the field model as normal using the host device, including **log playback and live streaming**. The state of the field model is displayed live on the client device.
+7. To quickly **record a video**, tap the "Record" icon at the top of the screen. Tap it again to stop recording, then edit and save the clip.
+
+:::warning
+Heatmaps, swerve states, and Zebra labels are not available yet in XR. All other object types are supported.
+:::
+
+:::tip
+AdvantageScope XR is a demanding application, and may experience performance issues depending on the complexity of the 3D scene. Consider using simpler robot models or fewer objects if necessary.
+:::
+
+## Options
+
+The XR controls window presents several options that control how the model is displayed in augmented reality:
+
+- **Calibration:**
+ - Choose _Miniature_ to visualize a scaled-down version of the field, suitable for tabletop use.
+ - Choose _Full-Size_ to visualize the field with accurate scaling, positioned based on a real field barrier. Switching between _Blue Alliance_ and _Red Alliance_ controls which side of the field is used for calibration, but the full field is visualized in all cases.
+- **Streaming:**
+ - Choose _Smooth_ for applications where some latency is acceptable in exchange for more reliable streaming, such as simulating auto routines or playing back log files.
+ - Choose _Low-Latency_ for real-time applications where some jitter is acceptable, such as overlaying data on a real robot or driving a simulated robot in teleop.
+- **Show Carpet:** Display the flat carpet model under the field instead of overlaying on a real surface.
+- **Show Field:** Display the field model, including the field barrier and game-specific elements. Custom [game piece objects](/tab-reference/3d-field#game-piece-objects) are always displayed.
+- **Show Robots:** Display the robot models, can be disabled when overlaying data on a real robot (such as vision targets or 2D mechanisms).
+
+## Offline Usage
+
+AdvantageScope XR does not require an internet connection. To ensure that the app is available offline, download AdvantageScope XR from the App Store using the link below. To connect to the AdvantageScope desktop application, scan the QR code using the iOS camera app or tap the "Scan" button in the AdvantageScope XR app.
+
+[](https://apps.apple.com/us/app/advantagescope-xr/id6739718081)
+
+:::note
+Even when running without an internet connection, the host and client devices **must be connected to the same network** (such as a robot, custom Wi-Fi network, or via USB tethering).
+:::
diff --git a/docsSite/docs/more-features/custom-assets.md b/docsSite/docs/more-features/custom-assets.md
index 04f6e8f9..eeddffa0 100644
--- a/docsSite/docs/more-features/custom-assets.md
+++ b/docsSite/docs/more-features/custom-assets.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 5
+sidebar_position: 4
---
# Custom Assets
diff --git a/docsSite/docs/more-features/gltf-convert.md b/docsSite/docs/more-features/gltf-convert.md
index 59e191c7..b91db20e 100644
--- a/docsSite/docs/more-features/gltf-convert.md
+++ b/docsSite/docs/more-features/gltf-convert.md
@@ -1,5 +1,5 @@
---
-sidebar_position: 6
+sidebar_position: 5
---
# Converting Onshape & STEP Files to glTF
diff --git a/docsSite/docs/more-features/img/app-store.svg b/docsSite/docs/more-features/img/app-store.svg
new file mode 100755
index 00000000..072b425a
--- /dev/null
+++ b/docsSite/docs/more-features/img/app-store.svg
@@ -0,0 +1,46 @@
+
diff --git a/docsSite/docs/more-features/img/xr-1.png b/docsSite/docs/more-features/img/xr-1.png
new file mode 100644
index 0000000000000000000000000000000000000000..7a884dee1460a5e236bb54e858bca953d13f639b
GIT binary patch
literal 774981
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