Cleaned up and commented version.

This commit is contained in:
Thorbjoern
2025-10-02 00:07:11 +02:00
parent 2b86d9f0a2
commit 4c613c3436
66 changed files with 260 additions and 1020 deletions
@@ -3,6 +3,8 @@ using System.Collections;
using System.Collections.Generic;
using UnityEngine;
// Ein Scriptable Object zum speichern der Raumeigenschaften. Wird jeder Trainings-Szene zugeordnet und beim Hinzuladen einer neuen Szene ausgelesen.
[CreateAssetMenu]
public class RoomPrefs : ScriptableObject
{
@@ -3,6 +3,8 @@ using GhostSystem;
using NUnit.Framework;
using UnityEngine;
// Dieses Script übernimmt die eigentliche Auswertung des Eyetrackings per Raycast.
public class EyeTrackingCollisionPoints : MonoBehaviour
{
[SerializeField]
@@ -25,13 +27,14 @@ public class EyeTrackingCollisionPoints : MonoBehaviour
Vector3 rayCastDirection = transform.TransformDirection(Vector3.forward) * rayDistance;
if ( hitPoint != null && Physics.Raycast(transform.position, rayCastDirection, out hit, rayDistance, gazableLayers))
if ( hitPoint != null && Physics.Raycast(transform.position, rayCastDirection, out hit, rayDistance, gazableLayers)) // Sendet einen Raycast in Blickrichtung aus.
{
hitPoint.transform.position = new Vector3(hit.point.x, hit.point.y, hit.point.z);
if (heatIsActive)
hitPoint.transform.position = new Vector3(hit.point.x, hit.point.y, hit.point.z); // Wenn ein Objekt mit der passenden Layer Mask getroffen wurde, wird der Gazepoint
// in der Visualisierung auf die entsprechende Kollisionsposition gesetzt.
if (heatIsActive) // Ist die Heat-Visualisierung (rote Färbung der Target-Objekte) aktiviert,
{
FindVisibleTargets(hitPoint.transform.position);
}
FindVisibleTargets(hitPoint.transform.position); // wird noch einmal mit einem Radius von 20 cm im Umfeld des Hitpoints nach
} // Objekten gesucht, die gefärbt werden können.
}
}
@@ -50,7 +53,7 @@ public class EyeTrackingCollisionPoints : MonoBehaviour
GameObject hitObject = col.gameObject;
if (hitObject.GetComponent<RecieveHeat>() != null)
{
hitObject.GetComponent<RecieveHeat>().AddHeat(0.02f);
hitObject.GetComponent<RecieveHeat>().AddHeat(0.02f); // Jedes Mal, wenn ein passendes Objekt getroffen wird, wird desen Heat-Wert um 0,02 erhöht.
}
else
{
+14 -12
View File
@@ -1,6 +1,8 @@
using System.Collections.Generic;
using UnityEngine;
// Dieses Script ist für die Darstellung des fovealen und peripheren Sichtfelds im Replay zuständig.
public class FieldOfView : MonoBehaviour
{
public float viewRadius;
@@ -27,7 +29,7 @@ public class FieldOfView : MonoBehaviour
private Mesh periMesh;
private Mesh foveaMesh;
private void Start()
private void Start() // zum Start werden zwei neune Meshes generiert, um die Sichtfelder darstellen zu können.
{
periMesh = new Mesh();
periMesh.name = "View Mesh";
@@ -40,11 +42,11 @@ public class FieldOfView : MonoBehaviour
private void LateUpdate()
{
Vector3 gazeDirection = ((eyeLeft.forward + eyeRight.forward) * 0.5f).normalized;
Vector3 gazeDirection = ((eyeLeft.forward + eyeRight.forward) * 0.5f).normalized; // In jedem Frame wird zuerst die gemeinsame Blickrichtung der beiden Augen ermittelt.
eyeCenter.rotation = Quaternion.LookRotation(gazeDirection);
float gazeAngle = AngleFromDir(gazeDirection, true);
DrawFOV(transform.eulerAngles.y, periMesh, periAngle);
DrawFOV(gazeAngle, foveaMesh, foveaAngle);
DrawFOV(transform.eulerAngles.y, periMesh, periAngle); // Das Mesh für das periphere Sichtfeld wird im angegebenen Winkel um die Vorwärts-Achse generiert.
DrawFOV(gazeAngle, foveaMesh, foveaAngle); // Das Mesh für das foveale Sichtfeld wird im angegebenen Winkel um die Sichtlinie herum generiert.
}
public Vector3 DirFromAngle(float angleDeg, bool angleIsGlobal)
@@ -76,9 +78,9 @@ public class FieldOfView : MonoBehaviour
return (angleDeg + 360f) % 360f;
}
void DrawFOV(float startAngle, Mesh viewMesh, float viewAngle)
void DrawFOV(float startAngle, Mesh viewMesh, float viewAngle) // Die Funktion, die das eigentliche 3D-Objekt/Mesh generiert.
{
int stepCount = Mathf.RoundToInt(viewAngle * meshResolution);
int stepCount = Mathf.RoundToInt(viewAngle * meshResolution); // Es werden mit der angegebenen Auflösung Winkel für die Unterteilungen des Sichtfelds bestimmt.
float stepAngleSize = viewAngle / stepCount;
List<Vector3> viewPoints = new List<Vector3>();
ViewCastInfo oldViewCast = new ViewCastInfo();
@@ -87,12 +89,12 @@ public class FieldOfView : MonoBehaviour
{
float angle = startAngle - viewAngle / 2 + stepAngleSize * i;
Debug.DrawLine(transform.position, transform.position + DirFromAngle(angle, true) * viewRadius, Color.red);
Debug.DrawLine(transform.position, transform.position + DirFromAngle(angle, true) * viewRadius, Color.red); // diese werden zu Debug-Zwecken im Viewport visualisiert.
ViewCastInfo newViewCast = ViewCast(angle);
ViewCastInfo newViewCast = ViewCast(angle); // Nun werden auf diesen Positionen Raycasts ausgesand und geguckt, ob diese ein Hindernis treffen.
if (i > 0)
{
if (i > 0) // Trifft ein Strahl ein Objekt und der nächste nicht, wird der Abstand zum nächsten Strakhl so lange halbiert, bis beide das Objekt treffen.
{ // So kann das Mesh des Sichtfelds so gebaut werden, dass die durch hindernisse nicht sichtbaren Bereiche genau ausgeschnitten werden.
bool edgeDistThresholdExeeded = Mathf.Abs(oldViewCast.distance - newViewCast.distance) > edgeDistanceThreshold;
if (oldViewCast.didHit != newViewCast.didHit || (oldViewCast.didHit && newViewCast.didHit && edgeDistThresholdExeeded))
{
@@ -113,11 +115,11 @@ public class FieldOfView : MonoBehaviour
int vertexcount = viewPoints.Count + 1;
Vector3[] vertices = new Vector3[vertexcount];
int[] triangles = new int[(vertexcount-2) * 3];
int[] triangles = new int[(vertexcount-2) * 3];
vertices[0] = Vector3.zero;
for (int i = 0; i < vertexcount-1; i++)
for (int i = 0; i < vertexcount-1; i++) // Schließlich werden zwischen allen Punkten Dreiecke aufgespannt, sodass ein Mesh/3D-Objekt entsteht.
{
vertices[i+1] = transform.InverseTransformPoint(viewPoints[i]);
@@ -0,0 +1,8 @@
fileFormatVersion: 2
guid: 65730a9e8bad9b840bc940e9491e98b4
folderAsset: yes
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:
@@ -4,6 +4,8 @@ using UnityEngine;
using Newtonsoft.Json;
using System;
// Die Klasse FrameModel stellt das Gerüst für die Daten dar, die über den SupabaseManager an die Datenbank gesenden und von dort empfangen werden.
namespace GhostSystem
{
[Table("object_positions")]
@@ -7,14 +7,16 @@ using System;
using Oculus.Interaction;
using System.IO;
// Dieses Script ist für die Aufnahme des Replays während des Trainingsdurchlaufs zuständig.
namespace GhostSystem
{
public class GhostRecorderBatch : MonoBehaviour
{
public string SceneId;
public float SampleRate = 0.05f;
public int BatchSize = 10;
public float FlushInterval = 2f;
public string SceneId; // SceneID zum Übergeben des Raumnamens an die Datenbank.
public float SampleRate = 0.05f; // Entspricht einer Framerate von 20 FPS.
public int BatchSize = 10; // Anzahl der Frames nach denen ein neuer Batch beginnt. Wird nicht mehr genutzt, da manueller Flush.
public float FlushInterval = 2f; // Länge des Intervalls bis zum nächsten Flush. Wird nicht mehr genutzt, da manueller Flush.
public List<Transform> TrackedObjects;
private int doorCount;
@@ -41,8 +43,8 @@ namespace GhostSystem
private void OnEnable()
{
SupabaseManager.OnSuperbaseReady += HandleSupabaseReady;
RoomManager.OnSceneIdReady += HandleSceneIdReady;
SupabaseManager.OnSuperbaseReady += HandleSupabaseReady; // Das Skript horcht nach den beiden Events, da eine Aufnahme in die Datenbank nur möglich sien soll,
RoomManager.OnSceneIdReady += HandleSceneIdReady; // wenn die Szene komplett geladen und die Verbindung zu Supabase aufgebaut ist.
}
private void OnDisable()
@@ -61,8 +63,8 @@ namespace GhostSystem
supabaseReady = true;
}
private void HandleSceneIdReady(string id, List<GameObject> doors, List<RecieveHeat> targets)
{
private void HandleSceneIdReady(string id, List<GameObject> doors, List<RecieveHeat> targets) // Die Szene muss komplett geladen sein, da mit dem Event die SceneID
{ // übergeben wird.
SceneId = id;
sceneIdReady = true;
if (SceneId == "Base")
@@ -72,8 +74,8 @@ namespace GhostSystem
}
else
{
foreach (GameObject door in doors)
{
foreach (GameObject door in doors) // neben den Tracked Objects, die in jeder Szene gleich sind (Player-Root, Kopf, Hände, Augen), müssen die Türen jedes Raums
{ // zu den Tracked Objects hinzugefügt werden. Nur so wird die Bewegung der Tür auch im Replay wiedergegeben.
var rotator = door.GetComponentInChildren<OneGrabRotateTransformer>();
if (rotator != null)
{
@@ -86,12 +88,12 @@ namespace GhostSystem
private void Update()
{
if (!_isRecording) return;
if (!_isRecording) return; // Code im Update wird nur ausgeführt, während die Aufnahme läuft.
_sampleTimer += Time.deltaTime;
_flushTimer += Time.deltaTime;
if (_sampleTimer >= SampleRate)
if (_sampleTimer >= SampleRate) // Es wird immer die Dauer bis zum nächsten Record-Frame runter gezählt und ein Sample aufgenommen.
{
_sampleTimer = 0f;
RecordSample();
@@ -107,11 +109,11 @@ namespace GhostSystem
private void RecordSample()
{
foreach (var obj in TrackedObjects)
{
foreach (var obj in TrackedObjects) // Ein Sample besteht aus einer Liste von FrameModels, die für den Zustand jedes getrackten Objekts zum aktuellen Zeitpunkt
{ // erstellt werden.
var frame = new GhostFrame(SceneId, obj.name, obj.position, obj.rotation);
_frameBuffer.Add(FrameModel.FromGhostFrame(frame));
}
_frameBuffer.Add(FrameModel.FromGhostFrame(frame)); // Die Frames werden an den Buffer angehängt, um noch während der Aufnahme noch nciht so viele System-
} // Ressourcen zu verbrauchen.
}
private async UniTaskVoid FlushBatchAsync() // Die eigentliche Methode zum Hochladen eines Batches/leeren des Buffers.
@@ -148,7 +150,7 @@ namespace GhostSystem
}
}
private async UniTask FallbackToOfflineAsync(List<FrameModel> batch) // Schreibt den Buffer in eine Datei, falls Upload nicht möglich
private async UniTask FallbackToOfflineAsync(List<FrameModel> batch) // Schreibt den Buffer in eine Datei, falls Upload nicht möglich. Kann zu Rucklern führen.
{
try
{
@@ -165,7 +167,7 @@ namespace GhostSystem
}
}
public void StartRecording()
public void StartRecording() // Wenn die Bedingungen erfüllt sind, startet diese Methode die Aufnahme. Sie kann von anderen Skripten aufgerufen werden.
{
if (!supabaseReady || !sceneIdReady) return;
_isRecording = true;
@@ -173,8 +175,8 @@ namespace GhostSystem
Debug.Log($"Recording {SceneId}");
}
public void StopRecording()
{
public void StopRecording() // Diese Methode stoppt die Aufnahme, löst ein entsprechendes Event aus, das abonniert werden kann und entfernt die Türen des aktuellen
{ // Raums wieder aus der Liste der Tracked Objects.
_isRecording = false;
sceneIdReady = false;
OnStopRecord?.Invoke();
@@ -11,6 +11,9 @@ using System.Globalization;
using Oculus.Interaction;
using System.Reactive;
using Postgrest.Interfaces;
using UnityEngine.InputSystem;
// Dieses Script ist für die Wiedergabe des Replays mit den Daten aus der Datenbank zuständig.
namespace GhostSystem
{
@@ -81,18 +84,18 @@ namespace GhostSystem
RoomManager.OnSceneIdReady -= HandleSceneIdReady;
}
private void HandleSupabaseReady()
private void HandleSupabaseReady() // Wen die Verbindung zu Supabase aufgebaut ist, wird versucht, das Replay der Szene zu initialisieren.
{
supabaseReady = true;
TryInitializeReplay();
}
private void HandleSceneIdReady(string id, List<GameObject> doors, List<RecieveHeat> targets)
{
loadingScreen.SetActive(true);
private void HandleSceneIdReady(string id, List<GameObject> doors, List<RecieveHeat> targets) // Sobald die Szene geladen ist, wird ebenfalls versucht, das Replay zu
{ // initialisieren.
loadingScreen.SetActive(true); // Während der erste Batch an Frames aus der Datenbank geladen wird, wird ein Ladekringel angezeigt.
sceneIdReady = true;
loadedSceneId = id;
foreach (GameObject door in doors)
loadedSceneId = id; // die aktuelle SceneID wird gesetzt.
foreach (GameObject door in doors) // Auch hier müssen die Türen zugeordnet werden.
{
TrackedObjectBinding trackedObjectBinding = new TrackedObjectBinding();
trackedObjectBinding.objectId = "Door";
@@ -104,29 +107,29 @@ namespace GhostSystem
TryInitializeReplay();
}
private async UniTaskVoid TryInitializeReplay()
private async UniTaskVoid TryInitializeReplay() // Das Replay wird aber nur initialisiert, wenn Supabase und die Szene bereit sind.
{
if (!supabaseReady || !sceneIdReady) return;
sceneId = loadedSceneId;
awaitingFrames = true;
await LoadAllFrames();
loadingScreen.SetActive(false);
StartReplay();
_ = PeriodicUpdateFrames();
}
await LoadAllFrames(); // Es wird auf die ersten 1000 Frames (siehe Batchsize) bzw. alle verfügbaren Frames (falls unter 1000) gewartet.
loadingScreen.SetActive(false); // Sind die Frames geladen, wird der Ladescreen wieder deaktiviert
StartReplay(); // und das Replay gestartet.
_ = PeriodicUpdateFrames(); // Zusätzlich wird ein Unitask ausgelöst, der immer wieder Frames nachlädt, solange noch Frames in der Datenbank vorhanden sind, die
} // den Filtern entsprechen und noch nicht geladen wurden.
public async UniTask LoadAllFrames()
{
Debug.Log("SceneId used in query: " + sceneId);
var startTime = dateSelector.selectedDateTime();
var endTime = dateSelector.EndTime();
var startTime = dateSelector.selectedDateTime(); // Erstellt einen Zeitstring aus den im UI eingegebenen Session-Daten
var endTime = dateSelector.EndTime(); // und einen zweiten für den Endpunkt der Trainingssession.
if (dateSelector.startTimeInput.text != "")
{
if (dateSelector.startTimeInput.text != "") // Es wird dabei geprüft, ob ein fertiger Timestring in das vorgesehene Feld kopiert wurde. Dann werden die
{ // Dropdowns ignoriert.
startTimeString = dateSelector.startTimeInput.text;
}
else startTimeString = startTime.ToString("o");
@@ -146,36 +149,35 @@ namespace GhostSystem
bool more = true;
List<FrameModel> allFrames = new();
while (more)
{
List<IPostgrestQueryFilter> timestampFilter = new List<IPostgrestQueryFilter>();
while (more) // Solange Frames mit dem Filter (in chronologischer Reihenfolge) in der Datenbank vorhanden sind, wird immer ein neuer Batch von maximal 1000 Frames
{ // heruntergeladen.
List<IPostgrestQueryFilter> timestampFilter = new List<IPostgrestQueryFilter>(); // Es wird eine Filterverkettung für Startzeit und Endzeit erstellt.
timestampFilter.Add(new QueryFilter("timestamp", Postgrest.Constants.Operator.GreaterThanOrEqual, startTimeString));
timestampFilter.Add(new QueryFilter("timestamp", Postgrest.Constants.Operator.LessThan, endTimeString));
var query = SupabaseManager.instance.supabase
.From<FrameModel>()
.Filter("scene_id", Postgrest.Constants.Operator.Equals, sceneId)
//.Where(x => x.Timestamp >= "timestamp '2025-06-14 10:27:00' and" x => x.Timestamp.timestamp <= "timestamp '2025-06-14 10:29:00'")
//.Filter("timestamp", Postgrest.Constants.Operator.GreaterThanOrEqual, startTime.ToString("o"))
.And(timestampFilter)
//.Filter("timestamp", Postgrest.Constants.Operator.LessThan, endTime.ToString("o"))
.Filter("scene_id", Postgrest.Constants.Operator.Equals, sceneId) // und neben der SceneID...
.And(timestampFilter) // ...dem SQL-Command hinzugefügt.
.Order("timestamp", Postgrest.Constants.Ordering.Ascending)
.Limit(batchSize) // Limit, wie viele Frames in einem Batch geladen werden. (Standardmäßig 1000)
.Offset(offset); // Um zu wissen, wo der nächste Batch anfängt
if (!string.IsNullOrEmpty(UserFilter))
query = query.Filter("user_id", Postgrest.Constants.Operator.Equals, UserFilter);
query = query.Filter("user_id", Postgrest.Constants.Operator.Equals, UserFilter); // Wenn die User ID angegebeen wurde, wird auch danach gefiltert.
var result = await query.Get();
var result = await query.Get(); // Es werden die Frames aus der Datenbank geladen
if (result.Models.Count == 0) break;
if (result.Models[0].SceneId != sceneId) break;
Debug.LogError("Model Count: " + result.Models.Count);
allFrames.AddRange(result.Models);
offset += batchSize;
more = result.Models.Count == batchSize;
more = result.Models.Count == batchSize; // Und in einer lokalen Liste gespeichert. Ähnlich dem Buffer beim Ghost Recorder.
}
foreach (var frame in allFrames)
foreach (var frame in allFrames) // Die Frames werden den Tracked Objects zugeordnet.
{
if (!objectTracks.ContainsKey(frame.ObjectId))
objectTracks[frame.ObjectId] = new List<FrameModel>();
@@ -262,18 +264,18 @@ namespace GhostSystem
playbackTime = Mathf.Clamp(time, 0f, totalDuration);
}
private void Update()
{
private void Update() // Solange das Replay auf "Play" steht, wird durch die Liste der Frames gegangen und die Positions- und Rotationsdaten aus selbigen angewendet,
{ // wenn die Differenz zwischen Startzeit und Timestamp des Frames der bisherigen Playback-Time entspricht.
if (!isPlaying || objectTracks.Count == 0) return;
playbackTime += Time.deltaTime * PlaybackSpeed;
if (playbackTime > totalDuration)
if (playbackTime > totalDuration) // Erreicht das Replay das Ende der Frame-Liste, wird es entwerder gestoppt
{
if (Loop)
{
playbackTime = 0f;
OnRestartLoop?.Invoke();
OnRestartLoop?.Invoke(); // oder neu gestartet, wenn die Loop-Funktion aktiviert ist.
}
else
isPlaying = false;
@@ -326,31 +328,31 @@ namespace GhostSystem
}
}
public void SetSliderScrubValue(float sliderValue)
public void SetSliderScrubValue(float sliderValue) // der aktuelle Playback-Zeitpunkt wird aktualisiert solange gescrubbt wird.
{
if (isScrubbing)
SetPlaybackTime(sliderValue * totalDuration);
}
public void OnSliderStartDrag()
public void OnSliderStartDrag() // Das Scrubbing wird gestartet, sobald der Slider angefasst wird.
{
isScrubbing = true;
}
public void OnSliderEndDrag()
public void OnSliderEndDrag() // Setzt den aktuellen Playback-Zeitpunkt auf den Timestamp, der dem übergebenen Slider-Wert entspricht.
{
isScrubbing = false;
SetPlaybackTime(playbackSlider.value * totalDuration);
}
public void RemoveDoors()
public void RemoveDoors() // Auch hier gibt es wieder eine Funktion, um vor dem Raumwechsel die Türen aus den Tracked Objects zu entfernen.
{
TrackedObjects.RemoveRange(TrackedObjects.Count - doorCount, doorCount);
doorCount = 0;
}
public void StopAwaitingFrames()
public void StopAwaitingFrames() // Kann zum Szenenwechsel aufgerufen werden, um das aktuelle Replay und das Nachladen von Frames abzubrechen.
{
awaitingFrames = false;
}
+29 -26
View File
@@ -8,6 +8,9 @@ using Client = Supabase.Client;
using Cysharp.Threading.Tasks;
using TMPro;
// Dieses Script wickelt die gesamte Kommunikation mit der Datenbank ab. Das Skript enthält noch einige Verbindungstests (z.B. zu Google), die bei Bedarf zum Debuggen verwendet
// werden können.
namespace GhostSystem
{
public class SupabaseManager : MonoBehaviour
@@ -36,7 +39,7 @@ namespace GhostSystem
private async UniTask Initialize()
{
if (instance == null)
if (instance == null) // Zuerst wird sichergestellt, dass nur eine Instanz des Supabase-Managers existiert und beim Szenenwechsel mitgenommen wird.
{
instance = this;
DontDestroyOnLoad(gameObject);
@@ -47,29 +50,29 @@ namespace GhostSystem
return;
}
Debug.Log("🌐 Starting Supabase setup...");
await RunDiagnostics();
Debug.Log("Starting Supabase setup...");
await RunDiagnostics(); // Dann wird geprüft, ob die Supabase-Instanz erreichbar ist.
await InitSupabaseAsync();
OnSuperbaseReady?.Invoke();
await InitSupabaseAsync(); // Eigentlicher Verbindungsaufbau.
OnSuperbaseReady?.Invoke(); // Wenn erfolgreich eine Verbindung zu Supabase aufgebaut wurde, wird das als Event gemeldet.
}
private async UniTask InitSupabaseAsync()
private async UniTask InitSupabaseAsync() // Wird aufgerufen, um die Verbindung zu Supabase zu initialisieren.
{
if (supabase != null)
return;
string path = Path.Combine(Application.persistentDataPath, authFileName);
if (File.Exists(path))
if (File.Exists(path)) // Ist bereits eine Datei mit Email und Passwort auf dem VR-Headset hinterlegt, wird diese ausgelesen.
{
string[] lines = await UniTask.Run(() => File.ReadAllLines(path));
email = lines[0];
password = lines[1];
}
else
{
email = string.IsNullOrEmpty(SystemInfo.deviceUniqueIdentifier)
{ // Falls nicht, werden neue Anmeldedaten erstellt.
email = string.IsNullOrEmpty(SystemInfo.deviceUniqueIdentifier) // Fake-Email-Adresse wird aus der GUID des Gerätes generiert.
? $"{Guid.NewGuid()}@device.local" // Fallback, generiert theoretisch bei jeder Neuinstallation der App einen anderen User.
: $"{SystemInfo.deviceUniqueIdentifier}@device.local";
@@ -78,7 +81,7 @@ namespace GhostSystem
await UniTask.Run(() => File.WriteAllLines(path, new[] { email, password }));
}
Debug.Log($"📧 Using Email: {email}, Password: {password}");
Debug.Log($"Using Email: {email}, Password: {password}");
supabase = new Client(subabaseUrl, supabaseAnonKey);
@@ -86,39 +89,39 @@ namespace GhostSystem
{
await supabase.InitializeAsync();
textbox.text += "\n\rSupabase initialized.";
Debug.Log("Supabase initialized.");
Debug.Log("Supabase initialized.");
}
catch (Exception ex)
{
Debug.LogError($"Initialization failed: {ex}");
Debug.LogError($"Initialization failed: {ex}");
textbox.text += "\n\rInitialization failed";
}
await AuthenticateAsync(email, password);
Debug.Log($"👤 Authenticated user ID: {userId}");
Debug.Log($"Authenticated user ID: {userId}");
}
public async UniTask AuthenticateAsync(string email, string password)
public async UniTask AuthenticateAsync(string email, string password) // Diese Methode übernimmt die Anmeldung als User bei der Supabase-Instanz.
{
try
{
await supabase.Auth.SignIn(email, password);
await supabase.Auth.SignIn(email, password); // Nutzt die übergebene Mail-Adresse und das Passwort, um den Unser anzumelden.
textbox.text += "\n\rSign-in successful";
Debug.Log("🔓 Sign-in successful");
Debug.Log("Sign-in successful");
}
catch (Exception authEx)
{
catch (Exception authEx) // Funktioniert die Anmeldung nicht, wird versucht, einen neuen User mit der übergebenen Mail-Adresse und dem
{ // Passwort zu registrieren.
Debug.LogWarning($"Sign-in failed, trying sign-up: {authEx.Message}");
try
{
await supabase.Auth.SignUp(email, password);
textbox.text += "\n\rSign-up successful";
Debug.Log("🆕 Sign-up successful");
Debug.Log("Sign-up successful");
}
catch (Exception ex)
{
textbox.text += "\n\rAuthentication failed";
Debug.LogError($"Authentication failed: {ex}");
Debug.LogError($"Authentication failed: {ex}");
}
}
}
@@ -128,7 +131,7 @@ namespace GhostSystem
await UniTask.WhenAll(CheckSupabaseHealthAsync(), CheckGoogleConnectionAsync());
}
private async UniTask CheckSupabaseHealthAsync()
private async UniTask CheckSupabaseHealthAsync() // Prüft, ob Supabase erreichbar ist.
{
using var www = UnityWebRequest.Get($"{subabaseUrl}/auth/v1/health");
www.SetRequestHeader("apikey", supabaseAnonKey);
@@ -137,16 +140,16 @@ namespace GhostSystem
if (www.result == UnityWebRequest.Result.Success)
{
//textbox.text += $"\n\rSupabase health: {www.downloadHandler.text}";
Debug.Log($"Supabase health: {www.downloadHandler.text}");
Debug.Log($"Supabase health: {www.downloadHandler.text}");
}
else
{
//textbox.text += $"\n\rSupabase health check failed: {www.error}";
Debug.LogError($"Supabase health check failed: {www.error}");
Debug.LogError($"Supabase health check failed: {www.error}");
}
}
private async UniTask CheckGoogleConnectionAsync()
private async UniTask CheckGoogleConnectionAsync() // Testet, ob grundsätzlich eine Internetverbindung besteht.
{
using var www = UnityWebRequest.Get("https://www.google.com");
await www.SendWebRequest();
@@ -154,12 +157,12 @@ namespace GhostSystem
if (www.result == UnityWebRequest.Result.Success)
{
//textbox.text += "\n\rGoogle request succeeded.";
Debug.Log("Google request succeeded.");
Debug.Log("Google request succeeded.");
}
else
{
textbox.text += $"\n\rGoogle connection failed: {www.error}";
Debug.LogError($"Google connection failed: {www.error}");
Debug.LogError($"Google connection failed: {www.error}");
}
}
+8
View File
@@ -0,0 +1,8 @@
fileFormatVersion: 2
guid: 29dcdaa22183d134b98e466af7f041e8
folderAsset: yes
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:
+3
View File
@@ -1,5 +1,8 @@
using UnityEngine;
// Eine Helfer-Component um das Problem zu umgehen, dass GameObjects unter bestimmten Bedingungnen nciht über das Unity Event System aktiviert oder deaktiviert werden könnnen.
// Dieses Skript kann einfach auf ein Objekt gelegt werden und die öffentliche Methode dann verlinkt werden.
public class ActiveToggle : MonoBehaviour
{
public void ToggleActive(GameObject obj)
+3
View File
@@ -8,6 +8,9 @@ using UnityEngine;
using Newtonsoft.Json;
using System.Threading.Tasks;
// Dieses Script ermöglicht das Einlesen einer Log-Datei, wie sie von der VR-Anwendung im Offline-Modus erstellt wird.
// Der Inhalt der Datei wird als Batch in die Datenbank hochgeladen.
public class BatchUploader : MonoBehaviour
{
public TMP_InputField fileNameInput;
@@ -3,14 +3,16 @@ using Unity.Cinemachine;
using UnityEngine;
using UnityEngine.InputSystem;
// Die Zoom-Funktion per Scrollrad musste erst händisch der Orbit-Kamera hinzugefügt werden. Dafür ist dieses Script zuständig.
public class CinemachinePositionComposerController : MonoBehaviour
{
[Header("Input Actions")]
public InputActionReference zoomAction;
public InputActionReference zoomAction; // Zuweisung einer Unity Input System Action.
public CinemachinePositionComposer positionComposer;
public CinemachinePositionComposer positionComposer; // Zuweisung eines Position Composers der manipuliert werden soll.
private bool zoomBlocked = false;
private bool zoomBlocked = false; // Blocker für Zoom (wie schon in OrbitCameraMouseControl).
private void OnEnable()
{
@@ -22,20 +24,20 @@ public class CinemachinePositionComposerController : MonoBehaviour
void Update()
{
if (zoomAction != null && !zoomBlocked)
{
if (zoomAction != null && !zoomBlocked) // Wenn der Blocker nicht aktiv und die Action zugewiesen ist, wird in jedem Frame der Zustand des Scrollrads abgefragt
{ // und auf dieser Basis die CameraDistance im Position Composer verändert.
Vector2 zoomValue = zoomAction.action.ReadValue<Vector2>();
positionComposer.CameraDistance = positionComposer.CameraDistance - zoomValue.y * 0.25f;
}
}
public void SetBlocker(bool value)
public void SetBlocker(bool value) // mit dieser Funktion kann der Blocker durch andere Skripte gesetzt werden.
{
zoomBlocked = value;
}
public void SetLookahead(bool value)
public void SetLookahead(bool value) // Die Aktivierung und Deaktivierung des in Cinemachine möglichen Lookaheads wurde hier ebenfalls untergebracht.
{
positionComposer.Lookahead.Enabled = value;
}
+2
View File
@@ -4,6 +4,8 @@ using System.Collections.Generic;
using TMPro;
using UnityEngine;
// Dieses Skript stellt die Funktionen für das Datums-Dropdown in der AAR-App bereit.
public class DateSelector : MonoBehaviour
{
public int selectedYear;
@@ -1,6 +1,8 @@
using UnityEngine;
using UnityEngine.Events;
// Eine simple Helfer-Component um Unity events auszulösen, wenn ein GemeObject aktiviert oder deaktiviert wird.
public class EnableDisableActions : MonoBehaviour
{
[SerializeField] UnityEvent onEnable;
@@ -5,6 +5,8 @@ using UnityEngine.SceneManagement;
using UnityEngine.UI;
using TMPro;
// Diese Klasse ist dafür da, die aktuell vorhandenen Szenen der ANwendung rauszusuchen und das Szenen-Dropdown damit zu füllen.
public class FillDopdownWithScenes : MonoBehaviour
{
public TMP_Dropdown dropdown;
@@ -2,6 +2,8 @@ using System.Collections.Generic;
using TMPro;
using UnityEngine;
// Diese Hilfsklasse wird verwendet, um das Dropdown-Menü für den Tag mit der kokkekten Anzahl an Tagen für den ausgewählten Monat zu füllen.
public class FillDropdownWithDays : MonoBehaviour
{
public TMP_Dropdown dropdown;
+16 -20
View File
@@ -7,6 +7,8 @@ using UnityEngine.UI;
using Cysharp.Threading.Tasks;
using System.Threading.Tasks;
// Skript der Basis-Szene, um den Szenenwechsel in der Version ohne Portale zu vollziehen.
public class FlushAndLoad : MonoBehaviour
{
public TMP_Text output;
@@ -20,8 +22,8 @@ public class FlushAndLoad : MonoBehaviour
private void OnEnable()
{
GhostRecorderBatch.OnUploadFinished += HandleUploadFinished;
RoomManager.OnSceneIdReady += HandleSceneIdReady;
GhostRecorderBatch.OnUploadFinished += HandleUploadFinished; // abonniert das Event, das ausgelöst wird, wenn der Upload in die Datenbank erfolgreich war.
RoomManager.OnSceneIdReady += HandleSceneIdReady; // abonniert das Event, das ausgelöst wird, wenn die neue Szene vollständig hinzugeladen wurde.
}
private void OnDisable()
@@ -30,18 +32,12 @@ public class FlushAndLoad : MonoBehaviour
RoomManager.OnSceneIdReady -= HandleSceneIdReady;
}
// Start is called once before the first execution of Update after the MonoBehaviour is created
void Start()
{
}
// Update is called once per frame
void Update()
{
if (OVRInput.GetDown(OVRInput.Button.SecondaryIndexTrigger))
if (OVRInput.GetDown(OVRInput.Button.SecondaryIndexTrigger)) // der rechte Trigger löst den Szenenwechsel aus.
{
if (sceneId == "End") Application.Quit();
if (sceneId == "End") Application.Quit(); // außer nach der letzten Szene. Dort wird die Anwendung beendet.
else
{
output.text = "Flush...";
@@ -56,11 +52,11 @@ public class FlushAndLoad : MonoBehaviour
}
}
private void HandleUploadFinished()
private void HandleUploadFinished() // wenn der Upload in die Datenbank erfolgreich war, wird der Pass-Through-Layer wieder deaktiviert, um entweder die neue Szene zu zeigen
{
loadingScreen.SetActive(false);
output.text = "";
if (sceneId == "End")
if (sceneId == "End") // oder nach der letzten Szene einen Info-Text.
{
output.text = "Durchlauf beendet.";
}
@@ -68,15 +64,15 @@ public class FlushAndLoad : MonoBehaviour
private void HandleSceneIdReady(string id, List<GameObject> doors, List<RecieveHeat> targets)
{
sceneId = id;
sceneId = id; // wenn die neu hinzugeladene Szene bereit ist, wird die sceneID gesetzt.
if (id == "Room1")
{
loadingScreen.SetActive(false);
passthroughLayer.SetActive(false);
loadingScreen.SetActive(false); // Bei Room1 wird zusätzlich der Pass-Through-Layer/Loding Screen deaktiviert, da hier noch keine Daten hochgeladen werden
passthroughLayer.SetActive(false); // und somit das entsprechende Event nicht ausgelöst wird.
}
if (id == "End")
{
instruction.text = "Drücke den rechten Trigger, um die Anwendung zu beenden.";
instruction.text = "Drücke den rechten Trigger, um die Anwendung zu beenden."; // Die zweite Ausnahme bildet die letzte Szene. Hier erscheint nur eine Info-Tafel.
canvas.SetActive(true);
passthroughLayer.SetActive(true);
}
@@ -88,10 +84,10 @@ public class FlushAndLoad : MonoBehaviour
canvas.SetActive(false);
}
private async UniTaskVoid LoadScene()
{
private async UniTaskVoid LoadScene() // Die eigentliche Funktion zum Laden der Szene aktiviert erst den Pass-Through-Layer/Loading Screen um Motion Sickness durch stehendes
{ // Bild zu vermeiden. Dann wird der Flush-Befehl zum Upload der Recording-Daten in die Datenbank gegeben.
await Loadingscreen();
recorder.Flush();
GetComponent<SceneLoader>().NewRoom();
}
GetComponent<SceneLoader>().NewRoom(); // Es wird der nächste Raum geladen. Der Pass-Through-Layer bleibt so lange aktiv, bis er durch die abonnierten Events deaktiviert
} // wird. So kann Motion-Sickness durch stockende Bilder beim Laden vermieden werden.
}
@@ -5,6 +5,8 @@ using System.Collections.Generic;
using Unity.Netcode;
using UnityEngine;
// Zur unterscheideung des localen Player-Rigs von adneren aus dem Multiplayer. Aktuell nicht in Benutzung.
public class LocalPlayerReference : NetworkBehaviour
{
public static LocalPlayerReference Instance { get; private set; }
+8
View File
@@ -0,0 +1,8 @@
fileFormatVersion: 2
guid: f0f419a0b003b0844b74f62b8a92de23
folderAsset: yes
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:
@@ -3,6 +3,8 @@ using System.Collections.Generic;
using UnityEngine;
using UnityEngine.SceneManagement;
// Ehemaliges Skript für die Start-Szene. Nicht mehr in Verwendung
public class GameStarter : MonoBehaviour
{
[SerializeField] int startScene = 1;
@@ -2,6 +2,8 @@ using System.Globalization;
using Unity.Netcode;
using UnityEngine;
// Hilfs-Skript um bestimmte Objekte für den lokalen Spieler unsichtbar zu machen. Findet momentan keine Anwendung.
public class InvisibleForLocalPlayer : NetworkBehaviour
{
// Start is called once before the first execution of Update after the MonoBehaviour is created
@@ -1,6 +1,8 @@
using Unity.Netcode;
using UnityEngine;
// Script zum Spawnen der Spieler im Multiplayer. Aktuell nicht in Benutzung.
public class PlayerSpawner : NetworkBehaviour
{
public override void OnNetworkSpawn()
@@ -3,6 +3,8 @@ using System.Collections.Generic;
using UnityEngine;
using UnityEngine.XR;
// Script zur automatisierten Ausrichtung der Basis-Szene am Spielbereich. Wird in der aktuellen Version nicht verwendet.
public class SpawnAtLongestEdge : MonoBehaviour
{
@@ -1,6 +1,9 @@
using Unity.Netcode;
using UnityEngine;
// Dieses Skript ist notwendig, um zum einen Smooth-Movement per Stick-Bewegung zu ermöglichen und zum anderen, dass der Character-Controller bei der physikalischen
// Roomscale-Bewegung dem/der NutzerIn folgt.
[RequireComponent(typeof(CharacterController))]
public class OVRStickAndRoomscaleMovement : NetworkBehaviour
{
@@ -12,13 +15,13 @@ public class OVRStickAndRoomscaleMovement : NetworkBehaviour
private CharacterController characterController;
private Vector3 velocity;
public float minHeight = 1.0f; // Kleinster Collider
public float maxHeight = 2.2f; // Größter Collider
public float skinWidth = 0.05f; // Charaktercontroller-Skin
public float minHeight = 1.0f; // Minimal mögliche Körpergröße (oder Größe wenn geduckt)
public float maxHeight = 2.2f; // Maximal mögliche Körpergröße
public float skinWidth = 0.05f; // Durchmesser des Kapsel-Colliders für den Körper. Darf nicht zu groß sein, um sich z.B. über Tische beugen zu können, ohne von der ingame-
// Physik weggeschoben zu werden.
void Start()
{
//if (!IsOwner) return;
//if (!IsOwner) return; Wäre nur bei Multiplayer wichtig.
characterController = GetComponent<CharacterController>();
@@ -28,9 +31,9 @@ public class OVRStickAndRoomscaleMovement : NetworkBehaviour
void Update()
{
//if (!IsOwner) return;
//if (!IsOwner) return; Wäre nur bei Multiplayer wichtig.
// 1. Real-World Position des Headsets bestimmen
// 1. Position des Kopfes in der realen Welt bestimmen.
Vector3 headLocalPos = rigRoot.InverseTransformPoint(cameraTransform.position);
// 2. Höhe anpassen (Stehen, Hocken)
@@ -5,12 +5,12 @@ using Unity.Cinemachine;
public class OrbitCameraMouseControl : MonoBehaviour
{
[Header("Input Actions")]
public InputActionReference aimAction; // CM Default / Aim
public InputActionReference aimAction; // erlaubt die Zuweisung einer Unity Input System Action. Der Name AimAction kommt von der Belegung auf der rechten Maustaste.
[Header("Cinemachine Components")]
public CinemachineInputAxisController inputAxisController;
public CinemachineInputAxisController inputAxisController; // hier wird der InputAxisController der Cinemachine Camera verlinkt, der manipuliert werden soll.
private bool aimingBlocked = false;
private bool aimingBlocked = false; // wird verwendet, um die Bewegung der Kamera zu verhindern, während die Maus über einem Menüelement hovert.
private void OnEnable()
{
@@ -30,13 +30,13 @@ public class OrbitCameraMouseControl : MonoBehaviour
if (inputAxisController != null) // aimingBlocked wird durch hover States der Menü-Elemente gesetzt
{
inputAxisController.Controllers[0].Enabled = isAiming;
inputAxisController.Controllers[0].Enabled = isAiming; // Die X und Y-Achse der der Orbit-Funktion werden freigeschaltet, solange die aimAction (hier RMT) gedrückt ist.
inputAxisController.Controllers[1].Enabled = isAiming;
inputAxisController.Controllers[2].Enabled = !aimingBlocked;
inputAxisController.Controllers[2].Enabled = !aimingBlocked; // Die Scroll-Funktion ist freigeschaltet, solange die Maus nicht über einem Menüelement hovert.
}
}
public void SetBlocker(bool value)
public void SetBlocker(bool value) // mit dieser Funktion kann der Blocker durch andere Skripte gesetzt werden.
{
aimingBlocked = value;
}
+14 -12
View File
@@ -1,6 +1,8 @@
using GhostSystem;
using UnityEngine;
// Dieses Script ist für die Färbung erfasster Objekte zuständig.
public class RecieveHeat : MonoBehaviour
{
public Renderer myRenderer;
@@ -10,20 +12,20 @@ public class RecieveHeat : MonoBehaviour
private async void OnEnable()
{
GhostReplayManager.OnRestartLoop += HandleRestartLoop;
}
GhostReplayManager.OnRestartLoop += HandleRestartLoop; // Das Event OnRestartLoop des GhostReplayManagers wird abonniert, um die Färbung der Objekte zurücksetzen zu
} // können, wenn das Replay neu startet.
private void OnDisable()
{
GhostReplayManager.OnRestartLoop -= HandleRestartLoop;
}
private void HandleRestartLoop()
private void HandleRestartLoop() // Stetzt den Heat-Wert und somit die Färbung bei einem Restart des Replays zurück.
{
SetHeat(0);
}
private void Start()
private void Start() // In der Start-Methode wird der Zugriff auf das Material hergestellt.
{
if (myRenderer == null)
{
@@ -33,24 +35,24 @@ public class RecieveHeat : MonoBehaviour
SetHeat(0);
}
public void SetHeat(float heat)
public void SetHeat(float heat) // Diese Funktion kann von anderen Skripten (z.B. dem Raycast-Skript EyeTrackingCollisionPoints) aufgerufen werden, um den Heat-Wert zu setzen.
{
if (heat > 1f) return;
if (heat > 1f) return; // Der Heat-Wert darf 1 nicht übersteigen, da das dem maximalen Rot-Wert von 255 entspricht.
heatLevel = heat;
float redAmount = CalcRedAmount(heatLevel);
myMat.color = new Color(redAmount,0,0);
float redAmount = CalcRedAmount(heatLevel); // der Rot-Wert wird für einen exponentiellen Anstieg innerhalb der Fixationsdauer noch einmal gemappt.
myMat.color = new Color(redAmount,0,0); // Das Material wird entsprechend stark rot gefärbt.
}
public void AddHeat(float heat)
public void AddHeat(float heat) // Diese funktion addiert einen übergebenen Wert zum aktuellen Heat-Wert. Kann ebenfalls durch andere Skripte aufgerufen werden.
{
heatLevel += heat;
if (heatLevel > 1f) return;
if (heatLevel > 1f) return; // Die Funktionsweise entspricht weitesgehend der von SetHeat.
float redAmount = CalcRedAmount(heatLevel);
Debug.Log(gameObject.ToString() + "Heat in: " + heatLevel + "Heat out: " + redAmount);
Debug.Log(gameObject.ToString() + "Heat in: " + heatLevel + "Heat out: " + redAmount); // Ein Debug-Log, um den zeitbasierten Anstieg der Färbung zu prüfen.
myMat.color = new Color(redAmount, 0, 0);
}
private float CalcRedAmount(float xNormalized)
private float CalcRedAmount(float xNormalized) // Hier wird der lineare Anstieg in eine exponentielle Funktion überführt.
{
float y = Mathf.Pow(xNormalized, 0.5f);
return Mathf.Clamp(y, 0f, 1f);
+3 -1
View File
@@ -4,11 +4,13 @@ using System.Collections.Generic;
using UnityEngine;
using UnityEngine.SceneManagement;
// Dieses Skript enthält die Methode, die vom Scene-Dropdown in der Menüleiste der AAR-App bei Auswahl einer Szene ausgeführt wird.
public class ReplaySceneLoader : MonoBehaviour
{
public GhostReplayManager replayManager;
private int currentScene;
public void LoadSceneAdditive(int sceneIndex)
public void LoadSceneAdditive(int sceneIndex) // Lädt die Szene, die im UI ausgewählt wurde.
{
sceneIndex += 1; // Um die Basis-Scene nicht zu laden
if(SceneManager.loadedSceneCount > 1)
+5 -2
View File
@@ -6,6 +6,9 @@ using System.Collections;
using System.Collections.Generic;
using UnityEngine;
// Dieses Script liest die RoomPrefs eines Raums beim Start der Szene aus, aktiviert oder deaktiviert die entsprechenden Objekte und löst das Event aus, dass die Szene vollständig
// geladen wurde.
public class RoomManager : MonoBehaviour
{
public RoomPrefs myRoom;
@@ -49,7 +52,7 @@ public class RoomManager : MonoBehaviour
foreach (GameObject enemy in enemies) enemy.SetActive(true);
}
sceneId = myRoom.sceneId;
OnSceneIdReady?.Invoke(sceneId, doors, targets);
OnSceneIdReady?.Invoke(sceneId, doors, targets); // Mit dem Event werden auch einige Informationen wie die SceneID, die Liste der Türen und die Liste der Target-Objekte
// an Abonnenten übergeben.
}
}
+2
View File
@@ -4,6 +4,8 @@ using System.Collections.Generic;
using UnityEngine;
using UnityEngine.SceneManagement;
// Dieses Skript ist für das Hinzuladen und Entladen der Szenen zuständig.
public class SceneLoader : MonoBehaviour
{
[SerializeField] private int baseSceneIndex;
+2
View File
@@ -3,6 +3,8 @@ using UnityEngine.UI;
using TMPro;
using GhostSystem;
// Dieses Skript wurde nur zu Debug-Zwecken verwendet, um zu sehen, ob auch alle gewünschten Objekte getrackt wurden.
public class VRDebugger : MonoBehaviour
{
public TMP_Text trackedObjects;