app.hypergames.hypersdk 1.8.20 → 1.8.21

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [1.8.21](https://github.com/mvmhyper/hyper-sdk/compare/v1.8.20...v1.8.21) (2026-07-08)
+
+
+### Bug Fixes
+
+* smooth tutorial loader and media switching ([b4cfbef](https://github.com/mvmhyper/hyper-sdk/commit/b4cfbef45d5544e7c5dfa37f702acb9f7be67548))
+
 ## [1.8.20](https://github.com/mvmhyper/hyper-sdk/compare/v1.8.19...v1.8.20) (2026-07-07)
 
 

package/Runtime/Internal/UI/Modals/TutorialLoaderModal.cs

@@ -36,10 +36,10 @@ namespace Hyper.Internal
             KillTweens();
             tutorialLoaderModalCG.alpha = 0f;
 
-            // Fade in and enable
-            tutorialLoaderModalCG.DOFade(1, 0.3f).SetUpdate(true);
-
             HandleLoadingTutorial();
+
+            // Fade in after loading state has reset its own tweens.
+            tutorialLoaderModalCG.DOFade(1, 0.3f).SetUpdate(true);
         }
 
         void OnDestroy()
@@ -124,6 +124,7 @@ namespace Hyper.Internal
         void HandleTutorialFailed()
         {
             KillTweens();
+            tutorialLoaderModalCG.alpha = 1f;
 
             loaderTextTween.SetActive(false);
             loaderText.SetActive(true);

package/Runtime/Internal/UI/Modals/TutorialModal.cs

@@ -21,6 +21,8 @@ namespace Hyper.Internal
         private const float SlideInDuration = 0.33f;
         private const float ContentFadeInDuration = 0.28f;
         private const float ContentFadeOutDuration = 0.18f;
+        private const float MediaFadeInDuration = 0.18f;
+        private const float VideoRevealDelay = 0.05f;
         private const float HiddenPreloadPlayDuration = 0.75f;
 
 #if UNITY_WEBGL && !UNITY_EDITOR
@@ -69,6 +71,7 @@ namespace Hyper.Internal
         private Coroutine updateVideoTimeCo = null;
         private Coroutine editorTutorialLoadCo = null;
         private Coroutine hiddenPreloadCloseCo = null;
+        private Coroutine mediaDisplayFadeCo = null;
         private TutorialData tutorialData;
         private bool isClosing;
         private bool hasInvokedTutorialLoadComplete;
@@ -621,6 +624,90 @@ namespace Hyper.Internal
             }
         }
 
+        private void ResetCardMediaState()
+        {
+            StopMediaDisplayFade();
+            ResetVideoProgressState();
+            HideMediaDisplay(tutorialDisplayP);
+            HideMediaDisplay(tutorialDisplayL);
+            HideMediaDisplay(tutorialImageDisplay);
+        }
+
+        private void ResetVideoProgressState()
+        {
+            cachedVideoLength = 0f;
+            isDraggingSlider = false;
+
+            if (timeSlider == null) return;
+
+            timeSlider.minValue = 0f;
+            timeSlider.maxValue = 1f;
+            timeSlider.value = 0f;
+        }
+
+        private void HideMediaDisplay(RawImage display)
+        {
+            if (display == null) return;
+
+            SetMediaDisplayAlpha(display, 0f);
+            display.gameObject.SetActive(false);
+        }
+
+        private void SetMediaDisplayAlpha(RawImage display, float alpha)
+        {
+            if (display == null) return;
+
+            Color color = display.color;
+            color.a = alpha;
+            display.color = color;
+        }
+
+        private void StopMediaDisplayFade()
+        {
+            if (mediaDisplayFadeCo == null) return;
+
+            StopCoroutine(mediaDisplayFadeCo);
+            mediaDisplayFadeCo = null;
+        }
+
+        private void FadeInMediaDisplay(RawImage display, float delay = 0f)
+        {
+            if (display == null) return;
+
+            StopMediaDisplayFade();
+            mediaDisplayFadeCo = StartCoroutine(FadeInMediaDisplayCoroutine(display, delay));
+        }
+
+        private IEnumerator FadeInMediaDisplayCoroutine(RawImage display, float delay)
+        {
+            display.gameObject.SetActive(true);
+            SetMediaDisplayAlpha(display, 0f);
+
+            if (delay > 0f)
+            {
+                yield return new WaitForSecondsRealtime(delay);
+            }
+
+            float elapsed = 0f;
+
+            while (elapsed < MediaFadeInDuration)
+            {
+                if (display == null) yield break;
+
+                elapsed += Time.unscaledDeltaTime;
+                float t = Mathf.Clamp01(elapsed / MediaFadeInDuration);
+                SetMediaDisplayAlpha(display, Mathf.SmoothStep(0f, 1f, t));
+                yield return null;
+            }
+
+            if (display != null)
+            {
+                SetMediaDisplayAlpha(display, 1f);
+            }
+
+            mediaDisplayFadeCo = null;
+        }
+
 
 
         private void DisplayCurrentCard(bool isInitialDisplay)
@@ -628,6 +715,7 @@ namespace Hyper.Internal
             if (currentCardIndex < 0 || currentCardIndex >= tutorialCards.Count) return;
 
             StopVideoPlayback();
+            ResetCardMediaState();
             TutorialCardData card = tutorialCards[currentCardIndex];
 
             if (descriptionText != null)
@@ -656,12 +744,7 @@ namespace Hyper.Internal
                 return;
             }
 
-            if (tutorialImageDisplay != null)
-                tutorialImageDisplay.gameObject.SetActive(false);
-
-            // Start with portrait display as default; will switch to landscape in OnCardVideoPrepared if needed
-            tutorialDisplayP.gameObject.SetActive(true);
-            tutorialDisplayL.gameObject.SetActive(false);
+            // Keep the media surface hidden while VideoPlayer prepares the next source.
             currentDisplay = tutorialDisplayP;
 
             videoPlayer.enabled = true;
@@ -714,6 +797,7 @@ namespace Hyper.Internal
             tutorialDisplayP.gameObject.SetActive(targetDisplay == tutorialDisplayP);
             tutorialDisplayL.gameObject.SetActive(targetDisplay == tutorialDisplayL);
             currentDisplay = targetDisplay;
+            SetMediaDisplayAlpha(currentDisplay, 0f);
 
             if (targetTexture != null)
             {
@@ -733,7 +817,9 @@ namespace Hyper.Internal
             updateVideoTimeCo = StartCoroutine(UpdateVideoTime());
 
             InvokeTutorialLoadingCompleteOnce();
+            videoPlayer.time = 0;
             videoPlayer.Play();
+            FadeInMediaDisplay(currentDisplay, VideoRevealDelay);
         }
 
         private void DisplayImageCard(TutorialCardData card, bool isInitialDisplay)
@@ -754,6 +840,7 @@ namespace Hyper.Internal
 
             tutorialImageDisplay.gameObject.SetActive(true);
             tutorialImageDisplay.texture = card.image.texture;
+            FadeInMediaDisplay(tutorialImageDisplay);
 
             if (isInitialDisplay)
             {
@@ -781,6 +868,11 @@ namespace Hyper.Internal
             if (videoPlayer == null) return;
 
             videoPlayer.prepareCompleted -= OnCardVideoPrepared;
+            videoPlayer.loopPointReached -= OnLoopPointReached;
+            if (videoPlayer.isPrepared)
+            {
+                videoPlayer.time = 0;
+            }
             videoPlayer.Stop();
             videoPlayer.targetTexture = null;
         }
@@ -1023,6 +1115,7 @@ namespace Hyper.Internal
             contentRevealScheduled = false;
             isClosing = false;
             CancelHiddenPreloadClose();
+            StopMediaDisplayFade();
             HideTutorialContent();
 
 #if UNITY_EDITOR

package/Runtime/Resources/Materials/RoundedRawImage.mat

@@ -32,7 +32,7 @@ Material:
     m_Floats:
     - _ColorMask: 15
     - _InvertedRadius: 0
-    - _Radius: 60
+    - _Radius: 75
     - _Softness: 1.75
     - _Stencil: 0
     - _StencilComp: 8
@@ -44,10 +44,10 @@ Material:
     m_Colors:
     - _ClipRect: {r: -32767, g: -32767, b: 32767, a: 32767}
     - _Color: {r: 1, g: 1, b: 1, a: 1}
-    - _CornerRadii: {r: 60, g: 60, b: 0, a: 0}
+    - _CornerRadii: {r: 75, g: 75, b: 0, a: 0}
     - _InvertedCornerRadii: {r: 0, g: 0, b: 962.5, a: 1481.2}
     - _Pivot: {r: 0.5, g: 0.556, b: 0, a: 0}
-    - _RectSize: {r: 998, g: 2160, b: 0, a: 0}
+    - _RectSize: {r: 2532, g: 1216, b: 0, a: 0}
   m_BuildTextureStacks: []
   m_AllowLocking: 1
 --- !u!114 &4644396538228076653

package/Runtime/Resources/UIPrefabs/GameOverModal_Battle.prefab

@@ -184,7 +184,7 @@ RectTransform:
   m_GameObject: {fileID: 1641685960017025922}
   m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
   m_LocalPosition: {x: 0, y: 0, z: 0}
-  m_LocalScale: {x: 1.25, y: 1.25, z: 1.25}
+  m_LocalScale: {x: 1.15, y: 1.15, z: 1.15}
   m_ConstrainProportionsScale: 1
   m_Children:
   - {fileID: 6118213081617822483}

package/Runtime/Resources/UIPrefabs/GameOverModal_Practice.prefab

@@ -125,7 +125,7 @@ RectTransform:
   m_GameObject: {fileID: 936452418214250672}
   m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
   m_LocalPosition: {x: 0, y: 0, z: 0}
-  m_LocalScale: {x: 1.25, y: 1.25, z: 1.25}
+  m_LocalScale: {x: 1.15, y: 1.15, z: 1.15}
   m_ConstrainProportionsScale: 1
   m_Children:
   - {fileID: 943448477169687493}

package/Runtime/Resources/UIPrefabs/GamePausedModal_Battle.prefab

@@ -257,7 +257,7 @@ RectTransform:
   m_GameObject: {fileID: 936452418214250672}
   m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
   m_LocalPosition: {x: 0, y: 0, z: 0}
-  m_LocalScale: {x: 1.22, y: 1.22, z: 1.22}
+  m_LocalScale: {x: 1.15, y: 1.15, z: 1.15}
   m_ConstrainProportionsScale: 1
   m_Children:
   - {fileID: 943448477169687493}