feat(android): videoPlayer autoHide (#13725)

* feat(android): videoPlayer autoHide * brackes, link in docs * docs
tidev · Feb 7, 2023 · 8b37384 · 8b37384
1 parent 66d46dd
commit 8b37384
Show file tree

Hide file tree

Showing 3 changed files with 32 additions and 0 deletions.
diff --git a/android/modules/media/src/java/android/widget/TiVideoView8.java b/android/modules/media/src/java/android/widget/TiVideoView8.java
@@ -107,6 +107,7 @@ public class TiVideoView8 extends SurfaceView implements MediaPlayerControl
 								   // preparing
 	@SuppressWarnings("unused")
 	private int mStateWhenSuspended; // state before calling suspend()
+	private boolean autoHide = false;
 
 	// TITANIUM
 	private TiPlaybackListener mPlaybackListener;
@@ -492,6 +493,9 @@ public void onPrepared(MediaPlayer mp)
 					// so
 					// start the video here instead of in the callback.
 					if (mTargetState == STATE_PLAYING) {
+						if (autoHide) {
+							setAlpha(1);
+						}
 						start();
 						if (mMediaController != null) {
 							mMediaController.show();
@@ -636,6 +640,9 @@ public void surfaceDestroyed(SurfaceHolder holder)
 			if (mCurrentState != STATE_SUSPEND) {
 				release(true);
 			}
+			if (autoHide) {
+				setAlpha(0);
+			}
 		}
 	};
 
@@ -884,4 +891,12 @@ public int getAudioSessionId()
 		// TODO Auto-generated method stub
 		return 0;
 	}
+
+	public void setAutoHide(boolean value)
+	{
+		if (value) {
+			setAlpha(0);
+		}
+		autoHide = value;
+	}
 }
diff --git a/android/modules/media/src/java/ti/modules/titanium/media/TiUIVideoView.java b/android/modules/media/src/java/ti/modules/titanium/media/TiUIVideoView.java
@@ -135,6 +135,9 @@ public void processProperties(KrollDict d)
 		if (d.containsKey(TiC.PROPERTY_REPEAT_MODE)) {
 			videoView.setRepeatMode(TiConvert.toInt(d, TiC.PROPERTY_REPEAT_MODE));
 		}
+		if (d.containsKey("autoHide")) {
+			videoView.setAutoHide(TiConvert.toBoolean(d, "autoHide"));
+		}
 	}
 
 	@Override
@@ -161,6 +164,8 @@ public void propertyChanged(String key, Object oldValue, Object newValue, KrollP
 			videoView.setRepeatMode(TiConvert.toInt(newValue));
 		} else if (key.equals(TiC.PROPERTY_SHOWS_CONTROLS)) {
 			setMediaControlStyle(getPlayerProxy().getMediaControlStyle());
+		} else if (key.equals("autoHide")) {
+			videoView.setAutoHide(TiConvert.toBoolean(newValue));
 		} else {
 			super.propertyChanged(key, oldValue, newValue, proxy);
 		}

diff --git a/apidoc/Titanium/Media/VideoPlayer.yml b/apidoc/Titanium/Media/VideoPlayer.yml
@@ -408,6 +408,18 @@ properties:
     type: Boolean
     default: true
 
+  - name: autoHide
+    summary: Indicates if player is hidden by default and shown when its ready.
+    description: |
+        On Android the background of the video player is set to the primary background color.
+        When switching on `autoHide` it will hide the player until the video is loaded.
+        Then it will automatically show the player. In a <Titanium.UI.ListView> it will hide
+        it again when it is outside the viewport.
+    type: Boolean
+    platforms: [android]
+    since: 12.1.0
+    default: false
+
   - name: backgroundView
     deprecated:
         since: "7.0.0"