mediaplayer v6.0.0

Author: marchbold

docs/mediaplayer/_includes/add-manual-appdescriptor.mdx

@@ -25,22 +25,74 @@ The following should be added to your `extensions` node in your application desc
 Displaying video on Android requires that we enable hardware acceleration on most devices. 
 You can check whether this is required for your supported device list however generally we advise you enable acceleration.
 
-You also need to add a service. This service is only required if you are using background audio playback on Android, however it doesn't hurt to add the service either way.
+You also need to add a service and a receiver. These are only required if you are using background audio playback or the remote command center on Android, however it doesn't hurt to add them either way.
 
 ```xml
-<manifest android:installLocation="auto">
+<manifest android:installLocation="auto" >
+	<uses-sdk android:minSdkVersion="21" android:targetSdkVersion="35" />
+
 	<uses-permission android:name="android.permission.INTERNET"/>
 	<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
-	
+	<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"/>
+
 	<application android:hardwareAccelerated="true">
 
-		<service android:name="com.distriqt.extension.mediaplayer.audio.AudioPlayerService" android:enabled="true" android:exported="true" />
+		<service android:name="com.distriqt.extension.mediaplayer.audio.AudioPlayerService"
+			android:enabled="true"
+			android:exported="true"
+			android:permission="android.permission.FOREGROUND_SERVICE"
+			android:foregroundServiceType="mediaPlayback" />
+
+		<receiver android:name="com.distriqt.extension.mediaplayer.remotecommandcenter.RemoteCommandCenterReceiver" android:exported="true">
+			<intent-filter>
+				<action android:name="com.distriqt.mediaplayer.next.custom"/>
+				<action android:name="com.distriqt.mediaplayer.prev.custom"/>
+				<action android:name="com.distriqt.mediaplayer.skip_forward"/>
+				<action android:name="com.distriqt.mediaplayer.skip_backward"/>
+				<action android:name="androidx.media3.ui.notification.play"/>
+				<action android:name="androidx.media3.ui.notification.pause"/>
+				<action android:name="androidx.media3.ui.notification.prev"/>
+				<action android:name="androidx.media3.ui.notification.next"/>
+				<action android:name="androidx.media3.ui.notification.ffwd"/>
+				<action android:name="androidx.media3.ui.notification.rewind"/>
+				<action android:name="androidx.media3.ui.notification.stop"/>
+				<action android:name="androidx.media3.ui.notification.dismiss"/>
+			</intent-filter>
+		</receiver>
+
+		<activity android:name="com.distriqt.core.auth.AuthorisationActivity" android:exported="false" android:theme="@android:style/Theme.Translucent.NoTitleBar"/>
 
 	</application>
 
 </manifest>
 ```
 
+#### Android Gradle Version 
+
+We have updated the required gradle version used to build your application to be higher than the default AIR currently uses (April 2025). 
+
+To specify a higher version add the following to your android node in your application descriptor:
+
+```xml
+<android>
+    <gradleVersion>8.9</gradleVersion>
+    <androidGradlePluginVersion>8.7.3</androidGradlePluginVersion>
+
+  ...
+</android>
+```
+
+If you don't do this you will see the following error when building your application:
+
+```
+Unexpected failure: Unable to run java: com.adobe.air.ADTException: gradle tool failed: 
+FAILURE: Build failed with an exception.
+
+...
+
+   > BUG! exception in phase 'semantic analysis' in source unit '_BuildScript_' Unsupported class file major version 65
+```
+
 
 ### iOS
 

docs/mediaplayer/changelog.md

@@ -1,3 +1,13 @@
+### 2025.08.26 [v6.0.0]
+
+```
+feat(android): migrate from exoplayer to androidx.media3 v1.8.0 (resolves https://github.com/distriqt/ANE-MediaPlayer/issues/242)
+feat(ios,android): add video scale modes - fit, fill, zoom (resolves https://github.com/distriqt/ANE-MediaPlayer/issues/231)
+fix(android): resolve issues with background audio and remote command center (resolves https://github.com/distriqt/ANE-MediaPlayer/issues/247)
+feat(android,ios): player view will dispatch mouse up and down with local x,y coords (resolves https://github.com/distriqt/ANE-MediaPlayer/issues/186) 
+feat(android): support runtimeInBackgroundThread operation (resolves https://github.com/distriqt/ANE-MediaPlayer/issues/240)
+```
+
 ### 2024.12.19 [v5.0.0]
 
 ```

static/asdocs/mediaplayer/all-classes.html

@@ -1,7 +1,7 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!-- saved from url=(0014)about:internet --><html>
    <head>
       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-      <title>All Classes - distriqt // MediaPlayer</title>
+      <title>All Classes - MediaPlayer</title>
       <base target="classFrame">
       <link rel="stylesheet" href="style.css" type="text/css" media="screen">
       <link rel="stylesheet" href="print.css" type="text/css" media="print">
@@ -55,6 +55,9 @@ <h3><a href="class-summary.html" target="classFrame" style="color:black">All Cla
          <tr>
             <td><a href="com/distriqt/extension/mediaplayer/events/RemoteCommandCenterEvent.html" title="com.distriqt.extension.mediaplayer.events.RemoteCommandCenterEvent">RemoteCommandCenterEvent</a></td>
          </tr>
+         <tr>
+            <td><a href="com/distriqt/extension/mediaplayer/ResizeMode.html" title="com.distriqt.extension.mediaplayer.ResizeMode">ResizeMode</a></td>
+         </tr>
          <tr>
             <td><a href="com/distriqt/extension/mediaplayer/sound/Sound.html" title="com.distriqt.extension.mediaplayer.sound.Sound"><i>Sound</i></a></td>
          </tr>
@@ -70,4 +73,4 @@ <h3><a href="class-summary.html" target="classFrame" style="color:black">All Cla
       </table>
    </body>
 </html>
-<!--Copyright distriqt 2016<br/>Thu Dec 19 2024, 11:44 AM +10:00  -->
+<!--Copyright Michael Archbold 2025<br/>Tue Aug 26 2025, 08:27 PM +10:00  -->

static/asdocs/mediaplayer/all-index-A.html

@@ -1,11 +1,11 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!-- saved from url=(0014)about:internet --><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>A </title><link rel="stylesheet" href="style.css" type="text/css" media="screen"><link rel="stylesheet" href="print.css" type="text/css" media="print"><link rel="stylesheet" href="override.css" type="text/css"></head><body><script language="javascript" type="text/javascript" src="asdoc.js"></script><script language="javascript" type="text/javascript" src="help.js"></script><script language="javascript" type="text/javascript" src="cookies.js"></script><script language="javascript" type="text/javascript"><!--
-				asdocTitle = 'A Index - distriqt // MediaPlayer';
+				asdocTitle = 'A Index - MediaPlayer';
 				var baseRef = '';
 				window.onload = configPage;
 			--></script>
 <script type="text/javascript">
 			scrollToNameAnchor();
-		</script><table class="titleTable" cellpadding="0" cellspacing="0" id="titleTable" style="display:none"><tr><td class="titleTableTitle" align="left">distriqt // MediaPlayer Native Extension Documentation</td><td class="titleTableTopNav" align="right"><a href="package-summary.html" onclick="loadClassListFrame('all-classes.html')">All Packages</a>&nbsp;|&nbsp;<a href="class-summary.html" onclick="loadClassListFrame('all-classes.html')">All Classes</a>&nbsp;|&nbsp;<a id="framesLink1" href="index.html?all-index-A.html&amp;index-list.html">Frames</a><a id="noFramesLink1" style="display:none" href="" onclick="parent.location=document.location"> No Frames </a></td><td class="titleTableLogo" align="right" rowspan="3"><img src="images/logo.jpg" class="logoImage" alt=" Adobe Logo " title=" Adobe Logo "></td></tr><tr class="titleTableRow2"><td class="titleTableSubTitle" id="subTitle" align="left">A&nbsp;Index</td><td class="titleTableSubNav" id="subNav" align="right"></td></tr><tr class="titleTableRow3"><td colspan="3">&nbsp;</td></tr></table><script language="javascript" type="text/javascript" xml:space="preserve">
+		</script><table class="titleTable" cellpadding="0" cellspacing="0" id="titleTable" style="display:none"><tr><td class="titleTableTitle" align="left">MediaPlayer Native Extension Documentation</td><td class="titleTableTopNav" align="right"><a href="package-summary.html" onclick="loadClassListFrame('all-classes.html')">All Packages</a>&nbsp;|&nbsp;<a href="class-summary.html" onclick="loadClassListFrame('all-classes.html')">All Classes</a>&nbsp;|&nbsp;<a id="framesLink1" href="index.html?all-index-A.html&amp;index-list.html">Frames</a><a id="noFramesLink1" style="display:none" href="" onclick="parent.location=document.location"> No Frames </a></td><td class="titleTableLogo" align="right" rowspan="3"><img src="images/logo.jpg" class="logoImage" alt=" Adobe Logo " title=" Adobe Logo "></td></tr><tr class="titleTableRow2"><td class="titleTableSubTitle" id="subTitle" align="left">A&nbsp;Index</td><td class="titleTableSubNav" id="subNav" align="right"></td></tr><tr class="titleTableRow3"><td colspan="3">&nbsp;</td></tr></table><script language="javascript" type="text/javascript" xml:space="preserve">
 				<!--
 
 					if (!isEclipse() || window.name != ECLIPSE_FRAME_NAME) {titleBar_setSubTitle("A Index"); titleBar_setSubNav(false,false,false,false,false,false,false,false,false,false,false	,false,false,false,false,false);}	
@@ -20,4 +20,4 @@
 	 Options when creating an AudioPlayer
 	 </td></tr><tr><td class="idxrow" colspan="2"><a href="com/distriqt/extension/mediaplayer/audio/AudioPlayerOptions.html#AudioPlayerOptions()" onclick="javascript:loadClassListFrame('com/distriqt/extension/mediaplayer/audio/class-list.html');">AudioPlayerOptions</a>() &mdash; Constructor, class com.distriqt.extension.mediaplayer.audio.<a href="com/distriqt/extension/mediaplayer/audio/AudioPlayerOptions.html" onclick="javascript:loadClassListFrame('com/distriqt/extension/mediaplayer/audio/class-list.html');">AudioPlayerOptions</a></td></tr><tr><td width="20"></td><td></td></tr><tr><td class="idxrow" colspan="2"><a href="com/distriqt/extension/mediaplayer/MediaPlayerOptions.html#autoPlay" onclick="javascript:loadClassListFrame('com/distriqt/extension/mediaplayer/class-list.html');">autoPlay</a> &mdash; Property, class com.distriqt.extension.mediaplayer.<a href="com/distriqt/extension/mediaplayer/MediaPlayerOptions.html" onclick="javascript:loadClassListFrame('com/distriqt/extension/mediaplayer/class-list.html');">MediaPlayerOptions</a></td></tr><tr><td width="20"></td><td>
 		 Whether the player should start playing the media as soon as the media is ready (default: false)
-		 </td></tr><tr><td colspan="2" style="padding-bottom:20px"></td></tr><tr><td colspan="2"><font color="black" size="10px" style="bold">A</font>&nbsp;&nbsp;<a href="all-index-B.html" onclick="javascript:loadClassListFrame('index-list.html');">B</a>&nbsp;&nbsp;<a href="all-index-C.html" onclick="javascript:loadClassListFrame('index-list.html');">C</a>&nbsp;&nbsp;<a href="all-index-D.html" onclick="javascript:loadClassListFrame('index-list.html');">D</a>&nbsp;&nbsp;<a href="all-index-E.html" onclick="javascript:loadClassListFrame('index-list.html');">E</a>&nbsp;&nbsp;<a href="all-index-F.html" onclick="javascript:loadClassListFrame('index-list.html');">F</a>&nbsp;&nbsp;<a href="all-index-G.html" onclick="javascript:loadClassListFrame('index-list.html');">G</a>&nbsp;&nbsp;<a href="all-index-H.html" onclick="javascript:loadClassListFrame('index-list.html');">H</a>&nbsp;&nbsp;<a href="all-index-I.html" onclick="javascript:loadClassListFrame('index-list.html');">I</a>&nbsp;&nbsp;<a href="all-index-J.html" onclick="javascript:loadClassListFrame('index-list.html');">J</a>&nbsp;&nbsp;<a href="all-index-K.html" onclick="javascript:loadClassListFrame('index-list.html');">K</a>&nbsp;&nbsp;<a href="all-index-L.html" onclick="javascript:loadClassListFrame('index-list.html');">L</a>&nbsp;&nbsp;<a href="all-index-M.html" onclick="javascript:loadClassListFrame('index-list.html');">M</a>&nbsp;&nbsp;<a href="all-index-N.html" onclick="javascript:loadClassListFrame('index-list.html');">N</a>&nbsp;&nbsp;<a href="all-index-O.html" onclick="javascript:loadClassListFrame('index-list.html');">O</a>&nbsp;&nbsp;<a href="all-index-P.html" onclick="javascript:loadClassListFrame('index-list.html');">P</a>&nbsp;&nbsp;<a href="all-index-Q.html" onclick="javascript:loadClassListFrame('index-list.html');">Q</a>&nbsp;&nbsp;<a href="all-index-R.html" onclick="javascript:loadClassListFrame('index-list.html');">R</a>&nbsp;&nbsp;<a href="all-index-S.html" onclick="javascript:loadClassListFrame('index-list.html');">S</a>&nbsp;&nbsp;<a href="all-index-T.html" onclick="javascript:loadClassListFrame('index-list.html');">T</a>&nbsp;&nbsp;<a href="all-index-U.html" onclick="javascript:loadClassListFrame('index-list.html');">U</a>&nbsp;&nbsp;<a href="all-index-V.html" onclick="javascript:loadClassListFrame('index-list.html');">V</a>&nbsp;&nbsp;<a href="all-index-W.html" onclick="javascript:loadClassListFrame('index-list.html');">W</a>&nbsp;&nbsp;<a href="all-index-X.html" onclick="javascript:loadClassListFrame('index-list.html');">X</a>&nbsp;&nbsp;<a href="all-index-Y.html" onclick="javascript:loadClassListFrame('index-list.html');">Y</a>&nbsp;&nbsp;<a href="all-index-Z.html" onclick="javascript:loadClassListFrame('index-list.html');">Z</a>&nbsp;&nbsp;</td></tr></table><p></p><center class="copyright"><footer>Copyright <a href="https://distriqt.com" target="_top">distriqt</a> 2016</footer><br/>Thu Dec 19 2024, 11:44 AM +10:00  </center></div></body></html><!--Copyright distriqt 2016<br/>Thu Dec 19 2024, 11:44 AM +10:00  -->
+		 </td></tr><tr><td colspan="2" style="padding-bottom:20px"></td></tr><tr><td colspan="2"><font color="black" size="10px" style="bold">A</font>&nbsp;&nbsp;<a href="all-index-B.html" onclick="javascript:loadClassListFrame('index-list.html');">B</a>&nbsp;&nbsp;<a href="all-index-C.html" onclick="javascript:loadClassListFrame('index-list.html');">C</a>&nbsp;&nbsp;<a href="all-index-D.html" onclick="javascript:loadClassListFrame('index-list.html');">D</a>&nbsp;&nbsp;<a href="all-index-E.html" onclick="javascript:loadClassListFrame('index-list.html');">E</a>&nbsp;&nbsp;<a href="all-index-F.html" onclick="javascript:loadClassListFrame('index-list.html');">F</a>&nbsp;&nbsp;<a href="all-index-G.html" onclick="javascript:loadClassListFrame('index-list.html');">G</a>&nbsp;&nbsp;<a href="all-index-H.html" onclick="javascript:loadClassListFrame('index-list.html');">H</a>&nbsp;&nbsp;<a href="all-index-I.html" onclick="javascript:loadClassListFrame('index-list.html');">I</a>&nbsp;&nbsp;<a href="all-index-J.html" onclick="javascript:loadClassListFrame('index-list.html');">J</a>&nbsp;&nbsp;<a href="all-index-K.html" onclick="javascript:loadClassListFrame('index-list.html');">K</a>&nbsp;&nbsp;<a href="all-index-L.html" onclick="javascript:loadClassListFrame('index-list.html');">L</a>&nbsp;&nbsp;<a href="all-index-M.html" onclick="javascript:loadClassListFrame('index-list.html');">M</a>&nbsp;&nbsp;<a href="all-index-N.html" onclick="javascript:loadClassListFrame('index-list.html');">N</a>&nbsp;&nbsp;<a href="all-index-O.html" onclick="javascript:loadClassListFrame('index-list.html');">O</a>&nbsp;&nbsp;<a href="all-index-P.html" onclick="javascript:loadClassListFrame('index-list.html');">P</a>&nbsp;&nbsp;<a href="all-index-Q.html" onclick="javascript:loadClassListFrame('index-list.html');">Q</a>&nbsp;&nbsp;<a href="all-index-R.html" onclick="javascript:loadClassListFrame('index-list.html');">R</a>&nbsp;&nbsp;<a href="all-index-S.html" onclick="javascript:loadClassListFrame('index-list.html');">S</a>&nbsp;&nbsp;<a href="all-index-T.html" onclick="javascript:loadClassListFrame('index-list.html');">T</a>&nbsp;&nbsp;<a href="all-index-U.html" onclick="javascript:loadClassListFrame('index-list.html');">U</a>&nbsp;&nbsp;<a href="all-index-V.html" onclick="javascript:loadClassListFrame('index-list.html');">V</a>&nbsp;&nbsp;<a href="all-index-W.html" onclick="javascript:loadClassListFrame('index-list.html');">W</a>&nbsp;&nbsp;<a href="all-index-X.html" onclick="javascript:loadClassListFrame('index-list.html');">X</a>&nbsp;&nbsp;<a href="all-index-Y.html" onclick="javascript:loadClassListFrame('index-list.html');">Y</a>&nbsp;&nbsp;<a href="all-index-Z.html" onclick="javascript:loadClassListFrame('index-list.html');">Z</a>&nbsp;&nbsp;</td></tr></table><p></p><center class="copyright"><footer>Copyright <a href="https://michaelarchbold.com" target="_top">Michael Archbold</a> 2025</footer><br/>Tue Aug 26 2025, 08:27 PM +10:00  </center></div></body></html><!--Copyright Michael Archbold 2025<br/>Tue Aug 26 2025, 08:27 PM +10:00  -->