QuickContact分析及其弹出窗口实现

 

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

 

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

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

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

 
 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
              android:orientation="vertical" 
              android:layout_width="fill_parent" 
              android:layout_height="fill_parent" 
        > 
    <QuickContactBadge 
            android:id="@+id/badge_small" 
            android:layout_width="wrap_content" 
            android:layout_height="wrap_content" 
            android:src="@drawable/icon"> 
    </QuickContactBadge> 
</LinearLayout> 

    Activity的onCreate代码如下：

 
 
QuickContactBadge smallBadge = (QuickContactBadge) findViewById(R.id.badge_small); 
smallBadge.assignContactFromEmail("winuxxan@gmail.com", true); 
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这个组件。通过这个组件我们可以将我们的窗口显示在顶层，并且可以通过坐标来决定它的位置。如下面的代码：

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

    显示效果如下：

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

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

 
 
public class MyActivity extends Activity { 
 
    @Override 
    public void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.main); 
        //在指定位置显示对话框 
showDialog(100, 100, 200, 200); 
    } 
     
    @Override 
    protected Dialog onCreateDialog(int id, Bundle args) { 
        return new AlertDialog.Builder(this) 
            .setTitle("Hello Dialog!") 
            .setMessage("Hello Dialog") 
            .create(); 
    } 
     
    @Override 
    protected void onPrepareDialog(int id, Dialog dialog, Bundle args) { 
        switch (id) { 
        case 1: { 
//设置对话框的属性 
            Window window = dialog.getWindow(); 
            WindowManager.LayoutParams lp = window.getAttributes(); 
            lp.x = args.getInt("x"); 
            lp.y = args.getInt("y"); 
            lp.width = args.getInt("width"); 
            lp.height = args.getInt("height"); 
             
            lp.flags &= ~WindowManager.LayoutParams.FLAG_DIM_BEHIND; 
 
            dialog.getWindow().setBackgroundDrawable(new ColorDrawable(Color.argb(0, 0, 0, 0))); 
        } 
            break; 
 
        default: 
            break; 
        } 
 
        super.onPrepareDialog(id, dialog, args); 
    } 
 
    private void showDialog(int x, int y, int width, int height) { 
        Bundle bundle = new Bundle(); 
        bundle.putInt("x", x); 
        bundle.putInt("y", y); 
        bundle.putInt("width", width); 
        bundle.putInt("height", height); 
         
        showDialog(1, bundle); 
    } 
} 

    在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之中。见如下代码：

 
 
public class PopupActivity extends Activity { 
    private WindowManager mWindowManager; 
    private View mAddedView; 
     
    @Override 
    protected void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
         
        setContentView(R.layout.main); 
 
        int x = getIntent().getIntExtra("x", 0); 
        int y = getIntent().getIntExtra("y", 0); 
        int width = getIntent().getIntExtra("width", 200); 
        int height = getIntent().getIntExtra("height", 200); 
 
        //该TextView要贴到透明的Activity上 
        TextView textView = new TextView(this); 
        textView.setBackgroundColor(Color.CYAN); 
        textView.setWidth(width); 
        textView.setHeight(height); 
        mAddedView = textView; 
         
        textView.setOnKeyListener(new OnKeyListener() { 
             
            public boolean onKey(View v, int keyCode, KeyEvent event) { 
                mWindowManager.removeView(mAddedView); 
                finish(); 
                return false; 
            } 
        }); 
         
        WindowManager.LayoutParams params = new WindowManager.LayoutParams(); 
        params.x = x; 
        params.y = y; 
        params.width = width; 
        params.height = height; 
        params.flags &= ~WindowManager.LayoutParams.FLAG_DIM_BEHIND; 
        params.packageName = this.getPackageName(); 
 
//贴到透明Activity上 
        mWindowManager = (WindowManager)getSystemService(Context.WINDOW_SERVICE); 
        mWindowManager.addView(textView, params); 
    } 
} 

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

 
 
private void showPopupActivity(int x, int y, int width, int height) { 
        Intent intent = new Intent(); 
        intent.setClass(this, DialogActivity.class); 
        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK  
                | Intent.FLAG_ACTIVITY_CLEAR_TOP  
                | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED); 
        intent.putExtra("x", x); 
        intent.putExtra("y", y); 
        intent.putExtra("width", width); 
        intent.putExtra("height", height); 
        startActivity(intent); 
    } 

    最终效果如下：

 

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

 
 
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK  
    | Intent.FLAG_ACTIVITY_CLEAR_TOP  
    | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED); 

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