android 画中画功能总结

首先,Google官方给的画中画api比较简单,想要实现一个画中画需要很多其他交互,本文就以画中画涉及到的具体操作来总结如何实现画中画

官方文档: https://developer.android.google.cn/guide/topics/ui/picture-in-picture

简单实现

修改清单文件,让activity支持画中画

<activity
android:name="xxx.VideoActivity"
android:configChanges="orientation|keyboardHidden|screenSize|keyboard|screenLayout|smallestScreenSize"
android:launchMode="singleTop"
android:taskAffinity=".VideoActivity"
android:supportsPictureInPicture="true"
android:stateNotNeeded="false"
android:autoRemoveFromRecents="true"
android:excludeFromRecents="true" />
  • 1.设置 android:supportsPictureInPicture 属性为 true
  • 2.configChanges 添加 smallestScreenSize,避免进入画中画导致Activity重建
  • 3.指定新的taskAffinity,可以在小窗模式下打开新的页面,而不是在小窗中打开新页面
  • 4.可以添加stateNotNeeded、autoRemoveFromRecents、excludeFromRecents等,使画中画页面不显示在最近的应用列表中

taskAffinity 需要配合singleTask或singleInstance使用。这里指定为singleTop是有一个小技巧,即可以通过是否添加 intent.addFlags(FLAG_ACTIVITY_NEW_TASK) 标记动态控制是否在新任务栈中打开VideoActivity

进入画中画

  • 1.主动触发

    getActivity().enterPictureInPictureMode();
  • 2.离开页面

    @Override
    public void onUserLeaveHint () {
    if (iWantToBeInPipModeNow()) {
    enterPictureInPictureMode();
    }
    }

官方只有这两步,但是使用中还会有其他要求,继续往下看:

其他交互操作

进入画中画的同时,打开另一个页面

// 需要延时,因为画中画只能打开在前台的Activity,不加延时则画中画最上层页面是 VideoDescActivity

 new Handler().postDelayed(new Runnable() {
@Override
public void run() {
if (null == mActivity) {
return;
}
Intent intent = new Intent(mActivity, VideoDescActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
mActivity.startActivity(intent);
}
}, 300);

点击画中画回到VideoActivity:不用特别处理

点击VideoDescActivity上元素,回到VideoActivity

重新启动VideoActivity即可

Intent intent = new Intent(mActivity, VideoActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
mActivity.startActivity(intent);

点击VideoDescActivity上元素,关闭画中画

// 使用本地广播,通知 VideoActivity 收到广播后直接 finish
Intent intent = new Intent();
intent.setAction(PIP_ACTION_FILTER_ENTER); // 需要 VideoActivity 注册这个action
intent.putExtra("closeOrReopen", true);
LocalBroadcastManager.getInstance(CartoonGlobalContext.getAppContext()).sendBroadcast(intent);

监听系统关闭画中画

重写Activity onPictureInPictureModeChanged:

onPictureInPictureModeChanged(boolean isInPictureInPictureMode, Configuration newConfig) {
if (!isInPictureInPictureMode) {
// 这里是关闭
}
}

VideoActivity打开新的页面,比如TimerActivity

Intent intent = new Intent(mActivity, TimerActivity.class);
mActivity.startActivity(intent);

这里必须使用mActivity,不能是Application,否则 TimerActivity 会显示在默认taskAffinity属性的 activity 上。

关闭TimerActivity后,回到VideoActivity

// 重新启动 VideoActivity,并且设置 intent 属性如下:
Intent intent1 = new Intent(this, VideoActivity.class);
intent1.setAction(Intent.ACTION_MAIN);
intent1.addCategory(Intent.CATEGORY_LAUNCHER);
startActivity(intent1);

REF

https://developer.android.google.cn/guide/topics/ui/picture-in-picture



本文采用知识共享署名 2.5 中国大陆许可协议进行许可,欢迎转载,但转载请注明来自Agehua’s Blog,并保持转载后文章内容的完整。本人保留所有版权相关权利。

本文链接:http://agehua.github.io/2021/04/19/Android-PIP-Hack-summary/

Share Comments