373      阿里云  技术社区[云栖]

QuickContact分析及其弹出窗口实现

https://winuxxan.blog.51cto.com/2779763/518044

一、简介
QuickContact是为了应用程序能够快速方便的访问联系人，并且快速的运用联系人的信息执行相应操作而设计的。最常见的在Contacts应用程序中如下图所示：

在Activity中存在一个图标，点击该图标后弹出一个窗口，窗口中会有几个图标，不同的图标表示针对该联系人进行的不同操作，比如打电话，发短信，发送邮件，进入主页等等。图标的显示和不显示取决于该联系人是否存在该种操作相关的信息。比如，如果该联系人中如果存在邮箱的话，就可以出现发送邮件的图标，否则就不会出现。

二、在自己的应用程序中应用QuickContact
在自己的程序中加入QuickContact十分方便，可以用Framework中的组件QuickContactBadge。
比如，我们创建一个Activity，设置它的layout如下：

1. <LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
2. android:orientation="vertical"
3. android:layout_width="fill_parent"
4. android:layout_height="fill_parent"
5. >
6. <QuickContactBadge
7. android:id="@+id/badge_small"
8. android:layout_width="wrap_content"
9. android:layout_height="wrap_content"
10. android:src="@drawable/icon">
11. </QuickContactBadge>
12. </LinearLayout>

Activity的onCreate代码如下：

1. QuickContactBadge smallBadge = (QuickContactBadge) findViewById(R.id.badge_small);
2. smallBadge.assignContactFromEmail("winuxxan@gmail.com", true);
3. smallBadge.setMode(ContactsContract.QuickContact.MODE_LARGE);

主要还有一点，要在AndroidManifest中设置android.permission.READ_CONTACTS的权限，否则，不会弹出窗口，而是直接进入Contacts中的联系人详情界面。
运行效果如图：

由于本文不是针对QuickContactBadge的详细讲解，而是讲解它的实现方法，从而能够见贤思齐，设计出类似的功能。要了解QuickContactBadge的详细用法可以看Android文档，和google。

三、结构
系统在实现QuickContact包含三部分：
1、弹出界面。
2、ContactContract中的调用接口
3、组件QuickContactBadge。
弹出界面在应用程序Contacts中编写，这也是QuickContact的主要部分。
ContactContract为方便使用QuickContact定义了几个函数，可以在不同的情形下显示出QuickContact。
QuickContactBadge是为了方便开发者使用QuickContact，设计的一个组件，开发者只需要在自己的Layout中加入该组件，便可以方便的使用。而且该组件还支持根据邮箱、电话号码等指定某个联系人。实际上，QuickContactBadge在单击的时候调用了ContactContract中的函数来显示QuickContact。因此，实际上，ContactContract中的QuickContact可以完成更多情况下QuickContact的显示。

框图待补充

四、QuickContactActivity和QuickContactWindow
为了使弹出窗口可以跨进程共享，弹出界面的实现实际上是采用了透明Activity贴上一层View的方式。透明的Activity无疑就是QuickContactActivity了，在该Activity中含有一个QuickContactWindow的成员，通过QuickContactWindow将一个View贴到该Activity上。
那么，QuickContactWindow是如何将View贴到Activity上的呢？大家需要了解Activity，View，Window和WindowManager之间的关系，不明白的赶紧查下资料。
QuickContactWindow在创建时就会创建一个PhoneWindow，然后设置它的布局，进行一系列的初始化，在显示的时候，会查询该联系人的信息，查询完毕后生成该联系人的视图，之后获得PhoneWindow的根节点，将该根节点加到WindowManager中，该View就会被贴到Activity中去了。

五、ContactContract中的QuickContact
ContactContract中的QuickContact的显示函数，实际上就是用Intent开启了QuickContactActivity。

六、QuickContactBadge
QuickContactBadge继承自ImageView，所以所有ImageView的函数都可以用来设置QuickContactBadge。当点击QuickContactBadge时，它调用了ContactContract中的QuickContact显示函数。
为了为开发者提供方便，QuickContactBadge可以根据开发者提供的邮箱或电话号码等信息找到该联系人。

七、见贤思齐
1、PopupWindow弹出窗口实现
其实，单纯实现弹出窗口是很简单的，Android为我们提供了PopupWindow这个组件。通过这个组件我们可以将我们的窗口显示在顶层，并且可以通过坐标来决定它的位置。如下面的代码：

1. private void showPopupWindow(int x, int y, int width, int height) {
2. TextView textView = new TextView(this);
3. textView.setText("Hello popupWindow");
4. textView.setBackgroundColor(Color.CYAN);
5. PopupWindow popupWindow = new PopupWindow(textView, width, height);
6. popupWindow.showAtLocation(getWindow().getDecorView(), Gravity.NO_GRAVITY, x, y);
7. }

显示效果如下：

需要注意的一点就是，PopupWindow在Activity的onCreate函数中显示是会出现错误的，用户可以自行验证。解决方法不是本文暂不研究。

2、Dialog的弹出窗口实现
我们常见的Dialog都是居中显示的，而且背景会变暗，因此要Dialog实现弹出窗口的效果，就要解决任意位置显示和背景不变暗的问题。
在Activity中写如下代码：

1. public class MyActivity extends Activity {
3. @Override
4. public void onCreate(Bundle savedInstanceState) {
5. super.onCreate(savedInstanceState);
6. setContentView(R.layout.main);
7. //在指定位置显示对话框
8. showDialog(100, 100, 200, 200);
9. }
11. @Override
12. protected Dialog onCreateDialog(int id, Bundle args) {
13. return new AlertDialog.Builder(this)
14. .setTitle("Hello Dialog!")
15. .setMessage("Hello Dialog")
16. .create();
17. }
19. @Override
20. protected void onPrepareDialog(int id, Dialog dialog, Bundle args) {
21. switch (id) {
22. case 1: {
23. //设置对话框的属性
24. Window window = dialog.getWindow();
25. WindowManager.LayoutParams lp = window.getAttributes();
26. lp.x = args.getInt("x");
27. lp.y = args.getInt("y");
28. lp.width = args.getInt("width");
29. lp.height = args.getInt("height");
31. lp.flags &= ~WindowManager.LayoutParams.FLAG_DIM_BEHIND;
33. dialog.getWindow().setBackgroundDrawable(new ColorDrawable(Color.argb(0, 0, 0, 0)));
34. }
35. break;
37. default:
38. break;
39. }
41. super.onPrepareDialog(id, dialog, args);
42. }
44. private void showDialog(int x, int y, int width, int height) {
45. Bundle bundle = new Bundle();
46. bundle.putInt("x", x);
47. bundle.putInt("y", y);
48. bundle.putInt("width", width);
49. bundle.putInt("height", height);
51. showDialog(1, bundle);
52. }
53. }

在onPrepareDialog函数中，我们获得了Dialog的Window，然后对位置和宽度进行了设置，并且通过Flag取消了背景变暗的效果，最后我们得到的结果如下图：

其实，带有Dialog主题的Activity也可以实现该效果，不过本人没有实现背景不变暗，故不将代码贴上了。

3、跨进程共享弹出窗口设计
我们能不能实现类似于QuickContact那样的弹出窗口跨进程共享呢？当然是可以的。
可能我们会想到用一个透明的Activity，然后显示一个PopupWindow来实现，但是PopupWindow我们之前说过，在Activity的onCreate函数中显示时会有问题。
我们也可能还会想到一个透明的Activity加一个Dialog来显示，但是我们也知道，Dialog并不是像PopupWindow那样是轻量级的，仅仅一个Activity的显示就够耗费了，再显示一个Dialog，那么耗费就更大了。
我们可能还会想到用QuickContact的方式，创建一个Window，然后将该Window的根View贴到透明Activity上，然而，不幸的是，创建Window的函数是非公开的。
其实，我们不需要创建一个Window，也能将View贴到Activity之中。见如下代码：

1. public class PopupActivity extends Activity {
2. private WindowManager mWindowManager;
3. private View mAddedView;
5. @Override
6. protected void onCreate(Bundle savedInstanceState) {
7. super.onCreate(savedInstanceState);
9. setContentView(R.layout.main);
11. int x = getIntent().getIntExtra("x", 0);
12. int y = getIntent().getIntExtra("y", 0);
13. int width = getIntent().getIntExtra("width", 200);
14. int height = getIntent().getIntExtra("height", 200);
16. //该TextView要贴到透明的Activity上
17. TextView textView = new TextView(this);
18. textView.setBackgroundColor(Color.CYAN);
19. textView.setWidth(width);
20. textView.setHeight(height);
21. mAddedView = textView;
23. textView.setOnKeyListener(new OnKeyListener() {
25. public boolean onKey(View v, int keyCode, KeyEvent event) {
26. mWindowManager.removeView(mAddedView);
27. finish();
28. return false;
29. }
30. });
32. WindowManager.LayoutParams params = new WindowManager.LayoutParams();
33. params.x = x;
34. params.y = y;
35. params.width = width;
36. params.height = height;
37. params.flags &= ~WindowManager.LayoutParams.FLAG_DIM_BEHIND;
38. params.packageName = this.getPackageName();
40. //贴到透明Activity上
41. mWindowManager = (WindowManager)getSystemService(Context.WINDOW_SERVICE);
42. mWindowManager.addView(textView, params);
43. }
44. }

该Activity要设置成透明，可以在AndroidManifest中加入android:theme = "@android:style/Theme.Translucent"。
调用的代码如下：

1. private void showPopupActivity(int x, int y, int width, int height) {
2. Intent intent = new Intent();
3. intent.setClass(this, DialogActivity.class);
4. intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK
5. | Intent.FLAG_ACTIVITY_CLEAR_TOP
6. | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
7. intent.putExtra("x", x);
8. intent.putExtra("y", y);
9. intent.putExtra("width", width);
10. intent.putExtra("height", height);
11. startActivity(intent);
12. }

最终效果如下：

4、跨进程共享弹出窗口的优化
由于跨进程共享的弹出窗口是重启的一个新的Activity，因此花销是比较大的，为了提高效率，我们需要做一些工作。
首先，设置Activity的launchMode为singleTop，通过该设置，当该Activity已经在栈顶时，可以直接调用onNewIntent函数而不是重新创建。
其次，设置Activity的taskAffinity为其他值，如：android:taskAffinity = "com.winuxxan.dialogactivity"，并且开启Activity时，设置flag：

1. intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK
2. | Intent.FLAG_ACTIVITY_CLEAR_TOP
3. | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);

这样，该Activity在一个单独的Task中，并且只要该Task堆栈中存在该Activity，那么就不会重新创建，而是调用onNewIntent。
再次，当隐藏该窗口时，不是销毁掉，而是moveTaskToBack，这样再次显示时就不是重新创建，而是将后台Task放到前台。
通过这些手段就可以显着的提高该弹出窗口的效率。

最后更新：2017-04-02 22:16:32

  上一篇： [笔记]Python对象基础

  下一篇： Ubuntu Linux 上交叉编译FFmpeg Windows SDK