startDragAndDrop
最近一直在研究拖拽功能, 想要实现分屏状态下，左右应用的拖拽切换。
android 提供了两种用于实现view拖拽的API。
- ViewDragHelper （需要自定义ViewGroup）
- startDrag / startDragAndDrop （配合 setOnDragListener / onDragEvent）
使用场景：
- ViewDragHelper 适用于 “View本身的拖拽”。
- startDrag / startDragAndDrop 适用于 “View携带的数据的拖拽”。
不同点：
- startDrag / startDragAndDrop 产生的拖拽效果，是拖拽一个半透明的view。该view的绘制内容可以自定义绘制。一般默认和被拖拽view相同。该view位于最顶层。
- startDrag / startDragAndDrop 可以在拖拽时携带数据。该数据可以跨进程传输。
- 使用startDrag / startDragAndDrop时，要响应（监听）该view拖拽事件的view都要设置setOnDragListener。
- ViewDragHelper 拖拽的是ViewGroup的内容，针对直接子View。
- ViewDragHelper 拖拽不携带数据。
因为我这里需要实现携带数据的拖拽，所以需要使用 View#startDragAndDrop
// 首先看看注释怎么说：
1. 拖放操作，调用此方法时，会传递一个{@link android.view.View.DragShadowBuilder} 对象给系统，系统会去调用 {@link DragShadowBuilder#onProvideShadowMetrics(Point, Point)} 来获取拖动阴影的度量，然后再调用 {@link DragShadowBuilder#onDrawShadow(Canvas)}来绘制拖动阴影本身。
2. 一旦下系统有了拖动阴影，会开始拖动操作通过 发送 拖拽事件给你的应用程序中目前可见的所有 View 对象。
3. 这里通过调用 View 的 {@link android.view.View.OnDragListener#onDrag(View,DragEvent) onDrag()} 或者调用 {@link android.view.View#onDragEvent(DragEvent) onDragEvent()} 方法。都是通过 {@link android.view.DragEvent} 对象的{@link android.view.DragEvent#getAction()} {@link android.view.DragEvent#ACTION_DRAG_STARTED}，可以使用在任何的附加的视图对象上。
这里看看参数：
startDragAndDrop(ClipData data, DragShadowBuilder shadowBuilder, Object myLocalState, int flags)
// 1\. ClipData 将该数据对象转换为拖动操作
// 2\. DragShadowBuilder 构造 拖动阴影
// 3\. myLocalState 包含本地的拖动操作数据，当传递拖拽事件给相同 activity 中的 views , 该对象可以通过 @link android.view.DragEvent#getLocalState() 使用。其他activity的 view 不能访问这个数据。是一种轻量型的机制， 从拖动view 和 target view 之间发送信息。 通过 flag 来区分 是拷贝操作还是移动操作。
// 4\. flags 控制拖拽操作类型的标志位 DRAG_FLAG_GLOBAL DRAG_FLAG_GLOBAL_PERSISTABLE_URI_PERMISSION ...
public final boolean startDragAndDrop(ClipData data, DragShadowBuilder shadowBuilder,
27338 Object myLocalState, int flags) {
27339 if (ViewDebug.DEBUG_DRAG) {
27340 Log.d(VIEW_LOG_TAG, "startDragAndDrop: data=" + data + " flags=" + flags);
27341 }
27342 if (mAttachInfo == null) {
27343 Log.w(VIEW_LOG_TAG, "startDragAndDrop called on a detached view.");
27344 return false;
27345 }
27346 if (!mAttachInfo.mViewRootImpl.mSurface.isValid()) {
27347 Log.w(VIEW_LOG_TAG, "startDragAndDrop called with an invalid surface.");
27348 return false;
27349 }
27350
27351 if (data != null) {
// 1\. 离开应用程序，准备工作
27352 data.prepareToLeaveProcess((flags & View.DRAG_FLAG_GLOBAL) != 0);
27353 }
27354
27355 Rect bounds = new Rect();
// 2\. 获取屏幕上的边界大小
27356 getBoundsOnScreen(bounds, true);
27357
27358 Point lastTouchPoint = new Point();
27359 mAttachInfo.mViewRootImpl.getLastTouchPoint(lastTouchPoint); // 最后的触摸点
// 3\. 获取 ViewRoot
27360 final ViewRootImpl root = mAttachInfo.mViewRootImpl;
27361
27362 // Skip surface logic since shadows and animation are not required during the a11y drag
// 4\. AccessibilityManager 是系统级的事件分派服务
27363 final boolean a11yEnabled = AccessibilityManager.getInstance(mContext).isEnabled();
27364 if (a11yEnabled && (flags & View.DRAG_FLAG_ACCESSIBILITY_ACTION) != 0) {
27365 try {
27366 IBinder token = mAttachInfo.mSession.performDrag(
27367 mAttachInfo.mWindow, flags, null,
27368 mAttachInfo.mViewRootImpl.getLastTouchSource(),
27369 0f, 0f, 0f, 0f, data);
27370 if (ViewDebug.DEBUG_DRAG) {
27371 Log.d(VIEW_LOG_TAG, "startDragAndDrop via a11y action returned " + token);
27372 }
27373 if (token != null) {
27374 root.setLocalDragState(myLocalState);
27375 mAttachInfo.mDragToken = token;
27376 mAttachInfo.mViewRootImpl.setDragStartedViewForAccessibility(this);
27377 setAccessibilityDragStarted(true); // 开始拖拽
27378 }
27379 return token != null;
27380 } catch (Exception e) {
27381 Log.e(VIEW_LOG_TAG, "Unable to initiate a11y drag", e);
27382 return false;
27383 }
27384 }
27385
27386 Point shadowSize = new Point();
27387 Point shadowTouchPoint = new Point();
27388 shadowBuilder.onProvideShadowMetrics(shadowSize, shadowTouchPoint);
27389 // 5\. 这里处理一些 shadowSize 为负数或者0 的情况
27390 if ((shadowSize.x < 0) || (shadowSize.y < 0)
27391 || (shadowTouchPoint.x < 0) || (shadowTouchPoint.y < 0)) {
27392 throw new IllegalStateException("Drag shadow dimensions must not be negative");
27393 }
27394
27395 // Create 1x1 surface when zero surface size is specified because SurfaceControl.Builder
27396 // does not accept zero size surface.
27397 if (shadowSize.x == 0 || shadowSize.y == 0) {
27398 if (!sAcceptZeroSizeDragShadow) {
27399 throw new IllegalStateException("Drag shadow dimensions must be positive");
27400 }
// 为 0 时就置为 1 * 1
27401 shadowSize.x = 1;
27402 shadowSize.y = 1;
27403 }
27404
27405 if (ViewDebug.DEBUG_DRAG) {
27406 Log.d(VIEW_LOG_TAG, "drag shadow: width=" + shadowSize.x + " height=" + shadowSize.y
27407 + " shadowX=" + shadowTouchPoint.x + " shadowY=" + shadowTouchPoint.y);
27408 }
27409 // 6\. 建立 surfaceSession
27410 final SurfaceSession session = new SurfaceSession();
27411 final SurfaceControl surfaceControl = new SurfaceControl.Builder(session)
27412 .setName("drag surface")
27413 .setParent(root.getSurfaceControl())
27414 .setBufferSize(shadowSize.x, shadowSize.y)
27415 .setFormat(PixelFormat.TRANSLUCENT)
27416 .setCallsite("View.startDragAndDrop")
27417 .build();
27418 final Surface surface = new Surface();
27419 surface.copyFrom(surfaceControl);
27420 IBinder token = null;
27421 try {
//7\. 真正的拖拽操作
27422 final Canvas canvas = isHardwareAccelerated() // 是否硬件加速？
27423 ? surface.lockHardwareCanvas()
27424 : surface.lockCanvas(null);
27425 try {
27426 canvas.drawColor(0, PorterDuff.Mode.CLEAR);
27427 shadowBuilder.onDrawShadow(canvas);
27428 } finally {
27429 surface.unlockCanvasAndPost(canvas);
27430 }
27431
27432 token = mAttachInfo.mSession.performDrag(mAttachInfo.mWindow, flags, surfaceControl,
27433 root.getLastTouchSource(), lastTouchPoint.x, lastTouchPoint.y,
27434 shadowTouchPoint.x, shadowTouchPoint.y, data);
27435 if (ViewDebug.DEBUG_DRAG) {
27436 Log.d(VIEW_LOG_TAG, "performDrag returned " + token);
27437 }
27438 if (token != null) {
27439 if (mAttachInfo.mDragSurface != null) {
27440 mAttachInfo.mDragSurface.release();
27441 }
27442 mAttachInfo.mDragSurface = surface;
27443 mAttachInfo.mDragToken = token;
27444 // Cache the local state object for delivery with DragEvents
27445 root.setLocalDragState(myLocalState);
27446 if (a11yEnabled) {
27447 // Set for AccessibilityEvents
27448 mAttachInfo.mViewRootImpl.setDragStartedViewForAccessibility(this);
27449 }
27450 }
27451 return token != null;
27452 } catch (Exception e) {
27453 Log.e(VIEW_LOG_TAG, "Unable to initiate drag", e);
27454 return false;
27455 } finally {
27456 if (token == null) {
27457 surface.destroy();
27458 }
27459 session.kill();
27460 }
27461 }
2.实现
使用这个方法，最关键的是 ClipData(剪贴板) 的构造
2.1 ClipData
Clip Object 的三种形式：
- Text
- URI 解析数据资源
- Intent 支持复制应用快捷方式
注意： 剪贴板每次仅仅支持一个 clip 对象。
3. setOnDragListener()
接收拖放事件的View我们暂且称之为目标View，目标View调用setOnDragListener()，并实现其中的方法onDrag()后可以接收拖放事件的回调。
这里设置监听：
4.View.DragShadowBuilder
在拖放操作进行的时候，需要显示正在拖动的图片，View.DragShadowBuilder类提供了可以传入View的构造方法，这个View是被拖放的View，我们将通过DragShadowBuilder创建的拖动图片称为拖动阴影，这个将作为参数传入startDragAndDrop()或startDrag()方法中，如若有需要的话，还可以继承View.DragShadowBuilder类去实现自定义的效果。
参考文献：
- Android 拖拽理解: www.jianshu.com/p/dc90a8543…
- Android为View添加拖放效果：zhuanlan.zhihu.com/p/468692495
- clipdata : blog.csdn.net/jjj11223344…
