Merge branch 'develop'

Author: hty527

README.md

@@ -9,6 +9,7 @@
 * 支持重力感应横竖屏旋转及开关设置</br>
 * 支持任意位置启动Activity级别悬浮窗口播放</br>
 * 支持任意位置启动全局悬浮窗口播放</br>
+* 窗口播放器支持自动吸附悬停</br>
 * 支持任意位置直接启动全屏播放</br>
 * 支持连续播放视频列表</br>
 * Demo：列表或组件之间无缝转场播放</br>
@@ -24,7 +25,7 @@
 #### 三、SDK集成
 * 建议集成前先[下载apk][2]体验，找到自己想要实现的功能模块，后续集成可参考demo源码。
 
-[2]:https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/apk/iPlayer-2.1.0.apk?version=2.1.0 "下载apk"
+[2]:https://amuse-1259486925.cos.ap-hongkong.myqcloud.com/apk/iPlayer-2.1.1.apk?version=2.1.1 "下载apk"
 
 ##### 1、项目根build.gradle配置</br>
 ```
@@ -38,16 +39,16 @@
 ```
     dependencies {
         //播放器(无UI交互)
-        implementation 'com.github.hty527.iPlayer:iplayer:2.1.0'
+        implementation 'com.github.hty527.iPlayer:iplayer:2.1.1'
         //UI交互组件,可根据需要使用
-        implementation 'com.github.hty527.iPlayer:widget:2.1.0'
+        implementation 'com.github.hty527.iPlayer:widget:2.1.1'
 
         //ijk音视频解码器,根据需要使用
-        //implementation 'com.github.hty527.iPlayer:ijk:2.1.0'
+        //implementation 'com.github.hty527.iPlayer:ijk:2.1.1'
         //exo音视频解码器,根据需要使用
-        //implementation 'com.github.hty527.iPlayer:exo:2.1.0'
+        //implementation 'com.github.hty527.iPlayer:exo:2.1.1'
         //音视频预缓存+边播边存,根据需要使用
-        //implementation 'com.github.hty527.iPlayer:cache:2.1.0'
+        //implementation 'com.github.hty527.iPlayer:cache:2.1.1'
     }
 ```
 ##### 3、在需要播放视频的xml中添加如下代码,或在适合的位置new VideoPlayer()</br>

app/build.gradle

@@ -77,24 +77,24 @@ dependencies {
     implementation 'com.squareup.okhttp3:okhttp:3.11.0'
     implementation 'com.google.code.gson:gson:2.8.5'
     //播放器SDK
-//    implementation project(':iplayer')
+    implementation project(':iplayer')
     //UI交互组件
-//    implementation project(':widget')
+    implementation project(':widget')
     //ijk音视频解码器
-//    implementation project(':ijk')
+    implementation project(':ijk')
     //exo音视频解码器
-//    implementation project(':exo')
+    implementation project(':exo')
     //音视频缓存
-//    implementation project(':cache')
+    implementation project(':cache')
 
     //播放器SDK
-    implementation 'com.github.hty527.iPlayer:iplayer:2.1.0'
+//    implementation 'com.github.hty527.iPlayer:iplayer:2.1.1'
     //UI交互组件,可根据需要使用
-    implementation 'com.github.hty527.iPlayer:widget:2.1.0'
+//    implementation 'com.github.hty527.iPlayer:widget:2.1.1'
     //音视频预缓存+边播边存,根据需要使用
-    implementation 'com.github.hty527.iPlayer:cache:2.1.0'
+//    implementation 'com.github.hty527.iPlayer:cache:2.1.1'
     //ijk音视频解码器,根据自己需要实现
-    implementation 'com.github.hty527.iPlayer:ijk:2.1.0'
+//    implementation 'com.github.hty527.iPlayer:ijk:2.1.1'
     //exo音视频解码器,根据自己需要实现
-    implementation 'com.github.hty527.iPlayer:exo:2.1.0'
+//    implementation 'com.github.hty527.iPlayer:exo:2.1.1'
 }

app/src/main/java/com/android/videoplayer/ui/activity/MainActivity.java

@@ -189,6 +189,7 @@ private void startGlobalWindowPlayer() {
         VideoController controller = videoPlayer.createController();//初始化一个默认的控制器(内部适用默认的一套交互UI控制器组件)
         WidgetFactory.bindDefaultControls(controller,false,true);
         controller.setTitle("任意界面开启一个悬浮窗窗口播放器");//视频标题(默认视图控制器横屏可见)
+        //悬浮窗口播放默认开启自动吸附悬停，如需禁用请阅读多参方法参数说明
         boolean globalWindow = videoPlayer.startGlobalWindow(ScreenUtils.getInstance().dpToPxInt(3), Color.parseColor("#99000000"));
         Logger.d(TAG,"startGoableWindow-->globalWindow:"+globalWindow);
         if(globalWindow) {
@@ -233,16 +234,18 @@ public void onPlayerState(PlayerState state, String message) {
             mVideoPlayer.setProgressCallBackSpaceMilliss(300);
             mVideoPlayer.getController().setTitle("测试播放地址");//视频标题(默认视图控制器横屏可见)
             mVideoPlayer.setDataSource(MP4_URL2);//播放地址设置
-            //自定义窗口播放的宽,高,起始X轴,起始Y轴属性,这里示例将播放器添加到标题栏下方右侧
+            //自定义窗口播放的宽,高,起始X轴,起始Y轴属性,这里示例将播放器添加到标题栏下方右侧，距离顶部及右侧编剧12dp
 //            mVideoPlayer.startWindow();
             int[] screenLocation=new int[2];
             TitleView titleView = findViewById(R.id.title_view);
             titleView.getLocationInWindow(screenLocation);
             int width = (PlayerUtils.getInstance().getScreenWidth(MainActivity.this)/2)+ScreenUtils.getInstance().dpToPxInt(30f);
             int height = width*9/16;
-            float startX=PlayerUtils.getInstance().getScreenWidth(MainActivity.this)/2-PlayerUtils.getInstance().dpToPxInt(45f);//开始位置
+            float startX=PlayerUtils.getInstance().getScreenWidth(MainActivity.this)/2-PlayerUtils.getInstance().dpToPxInt(42f);//开始位置
             float startY=screenLocation[1]+titleView.getHeight()+PlayerUtils.getInstance().dpToPxInt(15f);
             //启动窗口播放
+//            mVideoPlayer.startWindow(PlayerUtils.getInstance().dpToPxInt(3f),Color.parseColor("#80000000"),true);
+            //悬浮窗口播放默认开启自动吸附悬停，如需禁用请阅读多参方法参数说明
             mVideoPlayer.startWindow(width,height,startX,startY,ScreenUtils.getInstance().dpToPxInt(3f),Color.parseColor("#99000000"));//初始显示的位置并添加窗口颜色和圆角大小
             mVideoPlayer.prepareAsync();//开始异步准备播放
         }

app/src/main/java/com/android/videoplayer/video/ui/activity/VideoDetailsActivity.java

@@ -311,7 +311,7 @@ public void onPlayerState(PlayerState state, String message) {
                 IControllerView controllerView = controller.findControlWidgetByTag(IVideoController.TARGET_CONTROL_TOOL);
                 if(null!=controllerView&&controllerView instanceof ControlToolBarView){
                     ControlToolBarView controlToolBarView= (ControlToolBarView) controllerView;
-                    controlToolBarView.showMenus(true,true,true);
+                    controlToolBarView.showMenus(false,true,true);
                     controlToolBarView.setOnToolBarActionListener(new ControlToolBarView.OnToolBarActionListener() {
                         @Override
                         public void onWindow() {

app/src/main/java/com/android/videoplayer/video/ui/fragment/ListPlayerFragment.java

@@ -282,7 +282,6 @@ protected void startPlayer(ViewGroup playerContainer,int position) {
             String[] videoPath = PlayerManager.getInstance().getVideoPath(itemData);
             mVideoPlayer.getController().setTitle(videoPath[1]);//视频标题(默认视图控制器横屏可见)
             mVideoPlayer.setDataSource(videoPath[0]);//播放地址设置
-            mVideoPlayer.setAutoChangeOrientation(true);
             mVideoPlayer.prepareAsync();//开始异步准备播放
         }
     }

config.gradle

@@ -1,6 +1,6 @@
 ext {
     sdk=[
-         versionCode    : 20100,
-         versionName    : "2.1.0"//SDK版本号
+         versionCode    : 20101,
+         versionName    : "2.1.1"//SDK版本号
     ]
 }

doc/apk/iPlayer-2.1.0.apk doc/apk/iPlayer-2.1.1.apk

@@ -311,7 +311,10 @@
 ##### 8.1、Activity级别悬浮窗
 * 8.1.1、Activity级别悬浮窗无需悬浮窗权限直接开启：
 ```
-    //startWindow支持多参传入，请阅读api。参数1：给窗口设置一个圆角，参数2：给窗口设置一个背景色
+    //开启Activity级别窗口播放并启用拖拽窗口松手后自动吸附至屏幕边缘
+    mVideoPlayer.startWindow(true);
+
+    //startWindow支持多参传入，示例参数1：给窗口设置一个圆角，参数2：给窗口设置一个背景色，其它更多参数请阅读api。
     mVideoPlayer.startWindow(ScreenUtils.getInstance().dpToPxInt(3f), Color.parseColor("#99000000"));
 ```
 * 8.1.2、SDK支持在任意位置直接启动Activity级别悬浮窗播放：
@@ -357,6 +360,7 @@
         }
     }
 ```
+* 8.1.3、Activity级别悬浮窗默认是开启松手后自定吸附悬停至最近的X轴方向的屏幕边缘功能的，如需关闭，请查阅：startWindow()多参方法参数说明。
 
 ##### 8.2、全局悬浮窗
 ###### 8.2.1、悬浮窗开启
@@ -366,7 +370,10 @@
     <!--如您的播放器需要支持全局悬浮窗窗口播放请申明此权限-->
     <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
 
-    //2、开启全局悬浮窗窗口播放，startGlobalWindow支持多参传入，请阅读api。参数1：给窗口设置一个圆角，参数2：给窗口设置一个背景色
+    //2、开启全局悬浮窗窗口播放并启用拖拽窗口松手后自动吸附至屏幕边缘
+    boolean globalWindow = mVideoPlayer.startGlobalWindow(true);
+
+    //startGlobalWindow支持多参传入，示例参数1：给窗口设置一个圆角，参数2：给窗口设置一个背景色，其它更多参数请阅读api。
     boolean globalWindow = mVideoPlayer.startGlobalWindow(ScreenUtils.getInstance().dpToPxInt(3), Color.parseColor("#99000000"));
 ```
 * 8.2.1.2、SDK支持在任意位置直接启动全局悬浮窗窗口播放：
@@ -386,6 +393,7 @@
         videoPlayer.prepareAsync();//开始异步准备播放,注意界面关闭不要销毁播放器实例
     }
 ```
+* 8.2.1.3、全局悬浮窗默认是开启松手后自定吸附悬停至最近的X轴方向的屏幕边缘功能的，如需关闭，请查阅：startGlobalWindow()多参方法参数说明。
 
 ###### 8.2.2、悬浮窗点击
 * 8.2.2.1、SDK内部提供了监听悬浮窗窗口播放器的关闭、点击回调监听器

doc/update/api.md

@@ -1,5 +1,12 @@
 历史版本
 
+###  2.1.1
+**更新日期：** 2022-9-20<br/>
+**更新内容：**<br/>
+>1. 窗口播放器新增自动吸附悬停功能<br/>
+>2. 组件库优化<br/>
+>3. 修复已知问题<br/>
+___
 ###  2.1.0
 **更新日期：** 2022-9-16<br/>
 **更新内容：**<br/>