拖放 Codelab

1. 开始之前

此 Codelab 提供有关实现视图拖放功能基础知识的实用说明。您将学习如何启用视图在应用内以及跨不同应用进行拖放。您将学习如何在应用内甚至跨不同应用实现拖放交互。此 Codelab 将指导您使用 DropHelper 启用拖放、使用 ShadowBuilder 自定义拖动期间的视觉反馈、添加跨应用拖动的权限以及实现普遍适用的内容接收器。

先决条件

要完成此 Codelab，您需要

构建 Android 应用的经验。
了解 Activity、Fragment、视图绑定和 xml 布局。

您将执行的操作

创建一个简单的应用，该应用可以

使用 DragStartHelper 和 DropHelper 实现拖放功能
更改 ShadowBuilder
添加跨应用拖动的权限
实现 Reach Content Receiver 以进行通用实现。

您需要什么

Android Studio Jellyfish 或更高版本
Android 设备或模拟器

2. 拖放事件

拖放过程可以视为 4 个阶段的事件，这些阶段分别是

开始：系统响应用户的拖动手势开始拖放操作。
继续：用户继续拖动，当进入目标视图时，拖动阴影构建器开始工作。
结束：用户在放置目标区域的边界框内释放拖动。
退出：系统发送信号以结束拖放操作。

系统在 DragEvent 对象中发送拖放事件。DragEvent 对象可以包含以下数据

ActionType：基于拖放事件生命周期事件的事件操作值。例如，ACTION_DRAG_STARTED、ACTION_DROP 等。
ClipData：正在拖动的数据，封装在 ClipData 对象中。
ClipDescription：有关 ClipData 对象的元信息。
Result：拖放操作的结果。
X：拖动对象的当前位置的 x 坐标。
Y：拖动对象的当前位置的 y 坐标。

3. 设置

创建一个新项目并选择“空视图 Activity”模板

将所有参数保留为默认值。让项目同步和索引。您将看到已创建 MainActivity.kt 以及视图 activity_main.xml

4. 使用视图进行拖放

在 string.xml 中，让我们添加一些字符串值

<resources>
    <string name="app_name">DragAndDropCodelab</string>
    <string name="drag_image">Drag Image</string>
    <string name="drop_image">drop image</string>
 </resources>

打开 activity_main.xml 源文件，并修改布局以包含两个 ImageView，一个充当拖动源，另一个充当放置目标。

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/tv_greeting"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:layout_constraintBottom_toTopOf="@id/iv_source"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <ImageView
        android:id="@+id/iv_source"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:contentDescription="@string/drag_image"
        app:layout_constraintBottom_toTopOf="@id/iv_target"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toBottomOf="@id/tv_greeting" />

    <ImageView
        android:id="@+id/iv_target"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:contentDescription="@string/drop_image"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toBottomOf="@id/iv_source" />
</androidx.constraintlayout.widget.ConstraintLayout>

在 build.gradle.kts 中，启用视图绑定

buildFeatures{
   viewBinding = true
}

在 build.gradle.kts 中，添加 Glide 的依赖项

dependencies {
    implementation("com.github.bumptech.glide:glide:4.16.0")
    annotationProcessor("com.github.bumptech.glide:compiler:4.16.0")
    
    //other dependencies
}

在 string.xml 中添加图像网址和问候语文本

<string name="greeting">Drag and Drop</string>
<string name="target_url">https://services.google.com/fh/files/misc/qq2.jpeg</string>
<string name="source_url">https://services.google.com/fh/files/misc/qq10.jpeg</string>

在 MainActivity.kt 中，让我们初始化视图。

class MainActivity : AppCompatActivity() {
   val binding by lazy(LazyThreadSafetyMode.NONE) {
       ActivityMainBinding.inflate(layoutInflater)
   }

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       setContentView(binding.root)
       binding.tvGreeting.text = getString(R.string.greeting)
       Glide.with(this).asBitmap()
           .load(getString(R.string.source_url))
           .into(binding.ivSource)
       Glide.with(this).asBitmap()
           .load(getString(R.string.target_url))
           .into(binding.ivTarget)
   }
}

此时，您的应用应显示问候语文本和两个垂直方向的图像。

5. 使视图可拖动

要使特定视图可拖动，该视图必须在拖动手势上实现 startDragAndDrop() 方法。

让我们为 onLongClickListener 实现一个回调，因为用户在视图上启动了拖动。

draggableView.setOnLongClickListener{ v ->
   //drag logic here
   true
}

即使视图不可长时间点击，此回调也会使其可长时间点击。返回值为布尔值。True 表示拖动被回调消耗。

准备 ClipData：要拖动的数据

让我们定义我们想要放置的数据。数据可以是任何类型，从简单的文本到视频。此数据封装在 ClipData 对象中。ClipData 对象保存一个或多个复杂的 ClipItem

在 ClipDescription 中定义了不同的 MIME 类型。

我们正在拖动源视图的图像网址。ClipData 有三个主要组件

标签：向用户显示正在拖动内容的简单文本
MIME 类型：正在拖动的项目的 MIME 类型。
ClipItem：要拖动的项目，封装在 ClipData.Item 对象中

让我们创建 ClipData。

val label = "Dragged Image Url"
val clipItem = ClipData.Item(v.tag as? CharSequence)
val mimeTypes = arrayOf(ClipDescription.MIMETYPE_TEXT_PLAIN)
val draggedData = ClipData(
   label, mimeTypes, clipItem
)

开始拖放

现在我们已准备好要拖动的数据，让我们启动拖动。为此，我们将使用 startDragAndDrop

startDragAndDrop 方法接受 4 个参数

数据：以 ClipData 形式拖动的数据。
shadowBuilder：DragShadowBuilder 用于构建视图的阴影。
myLocalState：一个包含有关拖放操作的本地数据的对象。当向同一 Activity 中的视图分派拖放事件时，可以通过 DragEvent.getLocalState() 获取此对象。
标志：控制拖放操作的标志。

调用此函数后，基于 View.DragShadowBuilder 类绘制拖动阴影。一旦系统拥有拖动阴影，就会通过向已实现 OnDragListener 接口的可见视图发送事件来启动拖放操作。

v.startDragAndDrop(
   draggedData,
   View.DragShadowBuilder(v),
   null,
   0
)

这样，我们就配置了视图以进行拖动，并设置了要拖动的数据。最终实现如下所示。

fun setupDrag(draggableView: View) {
   draggableView.setOnLongClickListener { v ->
       val label = "Dragged Image Url"
       val clipItem = ClipData.Item(v.tag as? CharSequence)
       val mimeTypes = arrayOf(ClipDescription.MIMETYPE_TEXT_PLAIN)
       val draggedData = ClipData(
           label, mimeTypes, clipItem
       )
       v.startDragAndDrop(
           draggedData,
           View.DragShadowBuilder(v),
           null,
           0
       )
   }
}

在此阶段，您应该能够长按拖动视图。

让我们继续配置放置的视图。

6. 配置放置目标视图

如果视图已实现 OnDragListener 接口，则它可以充当放置目标。

让我们配置第二个 ImageView 以使其成为放置目标。

private fun setupDrop(dropTarget: View) {
   dropTarget.setOnDragListener { v, event ->
       // handle drag events here
       true
   }
}

我们正在覆盖 onDrag 方法（OnDragListener 接口）。onDrag 方法有两个参数。

接收拖放事件的视图
拖放事件的事件对象

如果拖放事件成功处理，此方法返回 true，否则返回 false。

DragEvent

它表示系统在拖放操作的不同阶段传输的数据包。此数据包封装了有关操作本身以及所涉及数据的重要信息。

DragEvent 根据拖放操作的阶段具有不同的拖放操作

ACTION_DRAG_STARTED：它表示拖放操作的开始。
ACTION _DRAG_LOCATION：它表示用户已在进入状态下释放拖动，即不在目标放置区域的范围内。
ACTION_DRAG_ENTERED：它表示拖动的视图在目标放置视图的范围内。
ACTION_DROP：它表示用户已在目标放置区域内释放拖动。
ACTION_DRAG_ENDED：它表示拖放操作已结束。
ACTION_DRAG_EXITED：它表示拖放操作的结束。

验证 DragEvent

如果在 ACTION_DRAG_STARTED 事件中满足所有约束条件，则可以选择继续进行拖放操作。例如，在本例中，我们可以检查传入的数据类型是否正确。

DragEvent.ACTION_DRAG_STARTED -> {
   Log.d(TAG, "ON DRAG STARTED")
   if (event.clipDescription.hasMimeType(ClipDescription.MIMETYPE_TEXT_PLAIN)) {
       (v as? ImageView)?.alpha = 0.5F
       v.invalidate()
       true
   } else {
       false
   }
}

在本例中，我们检查了事件中的 ClipDescription 是否具有可接受的 MIME 类型。如果是，我们将提供视觉信号以表示相同内容并返回 true，表示正在处理拖动的数据。否则，我们将返回 false 以表示放置目标视图已放弃拖动。

处理放置数据

在 ACTION_DROP 事件中，我们可以选择对放置的数据执行什么操作。在本例中，我们提取了已添加到 ClipData 作为文本的网址。我们将此图像从网址放到目标 ImageView 中

DragEvent.ACTION_DROP -> {
   Log.d(TAG, "On DROP")
   val item: ClipData.Item = event.clipData.getItemAt(0)
   val dragData = item.text
   Glide.with(this).load(item.text).into(v as ImageView)
   (v as? ImageView)?.alpha = 1.0F
   true
}

除了处理放下操作，我们还可以配置当用户在目标放下视图的边界框内拖动视图时会发生什么，以及当用户将视图拖出目标区域时会发生什么。

让我们在拖动项进入目标区域时添加一些视觉提示。

DragEvent.ACTION_DRAG_ENTERED -> {
   Log.d(TAG, "ON DRAG ENTERED")
   (v as? ImageView)?.alpha = 0.3F
   v.invalidate()
   true
}

此外，当用户将视图拖出目标放下视图的边界框时，添加更多视觉提示。

DragEvent.ACTION_DRAG_EXITED -> {
   Log.d(TAG, "ON DRAG EXISTED")
   (v as? ImageView)?.alpha = 0.5F
   v.invalidate()
   true
}

添加更多视觉提示来表示拖放操作的结束。

DragEvent.ACTION_DRAG_ENDED -> {
   Log.d(TAG, "ON DRAG ENDED")
   (v as? ImageView)?.alpha = 1.0F
   true
}

在此阶段，您应该能够将图像拖动到目标图像视图，一旦放下，目标 ImageView 的图像将反映更改。

7. 多窗口模式下的拖放

如果应用通过多窗口模式共享屏幕，则可以在一个应用中拖动项目到另一个应用。跨应用启用拖放的实现方式相同，只是我们需要在拖动期间添加标志并在放下期间添加权限。

在拖动期间配置标志

我们还记得，startDragAndDrop 有一个参数用于指定标志，该标志依次控制拖放操作。

v.startDragAndDrop(
   draggedData,
   View.DragShadowBuilder(v),
   null,
   View.DRAG_FLAG_GLOBAL or View.DRAG_FLAG_GLOBAL_URI_READ
)

View.DRAG_FLAG_GLOBAL 表示拖动可以跨越窗口边界，而 View.DRAG_FLAG_GLOBAL_URI_READ 表示拖动接收者能够读取内容 URI。

为了让放下目标读取来自其他应用的拖动数据，放下目标视图必须声明读取权限。

val dropPermission = requestDragAndDropPermissions(event)

并在处理完拖动数据后释放权限。

dropPermission.release()

拖动项目的最终处理如下所示

DragEvent.ACTION_DROP -> {
   Log.d(TAG, "On DROP")
   val dropPermission = requestDragAndDropPermissions(event)
   val item: ClipData.Item = event.clipData.getItemAt(0)
   val dragData = item.text
   Glide.with(this).load(item.text).into(v as ImageView)
   (v as? ImageView)?.alpha = 1.0F
   dropPermission.release()
   true
}

在此阶段，您应该能够将此图像拖动到另一个应用，并且可以正确处理从另一个应用拖动的数据。

8. 拖放库

Jetpack 提供了一个 DragAndDrop 库来简化拖放操作的实现。

让我们在 build.gradle.kts 中添加依赖项以使用 DragAndDrop 库。

implementation("androidx.draganddrop:draganddrop:1.0.0")

对于此练习，创建一个名为 DndHelperActivity.kt 的单独 Activity，其中包含两个垂直排列的 ImageView，其中一个充当拖动源，另一个充当放下目标。

修改 strings.xml 以添加字符串资源。

<string name="greeting_1">DragStartHelper and DropHelper</string>
<string name="target_url_1">https://services.google.com/fh/files/misc/qq9.jpeg</string>
<string name="source_url_1">https://services.google.com/fh/files/misc/qq8.jpeg</string>

更新 activity_dnd_helper.xml 以包含 ImageView。

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:app="http://schemas.android.com/apk/res-auto"
   xmlns:tools="http://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   android:padding="24dp"
   tools:context=".DnDHelperActivity">

   <TextView
       android:id="@+id/tv_greeting"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       app:layout_constraintBottom_toTopOf="@id/iv_source"
       app:layout_constraintLeft_toLeftOf="parent"
       app:layout_constraintRight_toRightOf="parent"
       app:layout_constraintTop_toTopOf="parent" />

   <ImageView
       android:id="@+id/iv_source"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:contentDescription="@string/drag_image"
       app:layout_constraintBottom_toTopOf="@id/iv_target"
       app:layout_constraintLeft_toLeftOf="parent"
       app:layout_constraintRight_toRightOf="parent"
       app:layout_constraintTop_toBottomOf="@id/tv_greeting" />

   <ImageView
       android:id="@+id/iv_target"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:contentDescription="@string/drop_image"
       app:layout_constraintBottom_toBottomOf="parent"
       app:layout_constraintLeft_toLeftOf="parent"
       app:layout_constraintRight_toRightOf="parent"
       app:layout_constraintTop_toBottomOf="@id/iv_source" />
</androidx.constraintlayout.widget.ConstraintLayout>

最后在 DnDHelperActivity.kt 中初始化视图。

class DnDHelperActivity : AppCompatActivity() {
   private val binding by lazy(LazyThreadSafetyMode.NONE) {
       ActivityMainBinding.inflate(layoutInflater)
   }

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       setContentView(binding.root)
       binding.tvGreeting.text = getString(R.string.greeting)
       Glide.with(this).asBitmap()
           .load(getString(R.string.source_url_1))
           .into(binding.ivSource)
       Glide.with(this).asBitmap()
           .load(getString(R.string.target_url_1))
           .into(binding.ivTarget)
       binding.ivSource.tag = getString(R.string.source_url_1)
   }
}

确保更新 AndroidManifest.xml 以将 DndHelperActivity 设置为启动 Activity。

<activity
   android:name=".DnDHelperActivity"
   android:exported="true">
   <intent-filter>
       <action android:name="android.intent.action.MAIN" />
       <category android:name="android.intent.category.LAUNCHER" />
   </intent-filter>
</activity>

DragStartHelper

之前，我们通过实现 onLongClickListener 并调用 startDragAndDrop 来配置视图使其可拖动。DragStartHelper 通过提供实用程序方法简化了实现。

DragStartHelper(draggableView)
{ view: View, _: DragStartHelper ->
   // prepare clipData
   
   // startDrag and Drop
}.attach()

DragStartHelper 以要拖动的视图作为参数。在这里，我们实现了 OnDragStartListener 方法，在其中我们将准备剪贴板数据并启动拖放操作。

最终实现如下所示。

DragStartHelper(draggableView)
{ view: View, _: DragStartHelper ->
   val item = ClipData.Item(view.tag as? CharSequence)
   val dragData = ClipData(
       view.tag as? CharSequence,
       arrayOf(ClipDescription.MIMETYPE_TEXT_PLAIN),
       item
   )
   view.startDragAndDrop(
       dragData,
       View.DragShadowBuilder(view),
       null,
       0
   )
}.attach()

DropHelper

DropHelper 通过提供名为 configureView 的实用程序方法简化了目标放下视图的配置。

configureView 接受 4 个参数

Activity：当前 Activity
dropTarget：正在配置的视图
mimeTypes：放下数据项的 mimeTypes
OnReceiveContentListener 接口用于处理放下的数据

自定义放下目标高亮显示。

DropHelper.configureView(
   This, // Current Activity
   dropTarget,
   arrayOf("text/*"),
   DropHelper.Options.Builder().build()
) {
   // handle the dropped data
}

OnRecieveContentListener 接收放下的内容。它有两个参数

View：放下内容的位置
Payload：要放下的实际内容

private fun setupDrop(dropTarget: View) {
   DropHelper.configureView(
       this,
       dropTarget,
       arrayOf("text/*"),
   ) { _, payload: ContentInfoCompat ->
       // TODO: step through clips if one cannot be loaded
       val item = payload.clip.getItemAt(0)
       val dragData = item.text
       Glide.with(this)
           .load(dragData)
           .centerCrop().into(dropTarget as ImageView)
       // Consume payload by only returning remaining items
       val (_, remaining) = payload.partition { it == item }
       remaining
   }
}

在此阶段，您应该能够使用 DragStartHelper 和 DropHelper 拖放数据。

配置放下区域高亮显示

如您所见，当拖动项进入放下区域时，放下区域会高亮显示。使用 DropHelper.Options，我们可以自定义拖动项进入视图边界时放下区域的高亮显示方式。

DropHelper.Options 可用于配置放下目标区域的高亮颜色和高亮角半径。

DropHelper.Options.Builder()
   .setHighlightColor(getColor(R.color.green))
   .setHighlightCornerRadiusPx(16)
   .build()

这些选项应作为参数传递给 DropHelper 中的 configureView 方法。

private fun setupDrop(dropTarget: View) {
   DropHelper.configureView(
       this,
       dropTarget,
       arrayOf("text/*"),
       DropHelper.Options.Builder()
           .setHighlightColor(getColor(R.color.green))
           .setHighlightCornerRadiusPx(16)
           .build(),
   ) { _, payload: ContentInfoCompat ->
       // TODO: step through clips if one cannot be loaded
       val item = payload.clip.getItemAt(0)
       val dragData = item.text
       Glide.with(this)
           .load(dragData)
           .centerCrop().into(dropTarget as ImageView)
       // Consume payload by only returning remaining items
       val (_, remaining) = payload.partition { it == item }
       remaining
   }
}

您应该能够在拖放时看到高亮颜色和半径。

9. 接收富内容

OnReceiveContentListener 是接收富内容（包括文本、html、图像、视频等）的统一 API。内容可以从键盘、拖动或剪贴板插入到视图中。维护每个输入机制的回调可能很麻烦。OnReceiveContentListener 可用于接收文本、标记、音频、视频、图像和其他内容，使用单个 API。 OnReceiveContentListener API 通过创建一个单一的 API 来实现来整合这些不同的代码路径，因此您可以专注于您应用特定的逻辑，并让平台处理其余部分。

对于此练习，创建一个名为 ReceiveRichContentActivity.kt 的单独 Activity，其中包含两个垂直排列的 ImageView，其中一个充当拖动源，另一个充当放下目标。

修改 strings.xml 以添加字符串资源。

<string name="greeting_2">Rich Content Receiver</string>
<string name="target_url_2">https://services.google.com/fh/files/misc/qq1.jpeg</string>
<string name="source_url_2">https://services.google.com/fh/files/misc/qq3.jpeg</string>

更新 activity_receive_rich_content.xml 以包含 ImageView。

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:app="http://schemas.android.com/apk/res-auto"
   xmlns:tools="http://schemas.android.com/tools"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   tools:context=".ReceiveRichContentActivity">

   <TextView
       android:id="@+id/tv_greeting"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       app:layout_constraintBottom_toTopOf="@id/iv_source"
       app:layout_constraintLeft_toLeftOf="parent"
       app:layout_constraintRight_toRightOf="parent"
       app:layout_constraintTop_toTopOf="parent" />

   <ImageView
       android:id="@+id/iv_source"
       android:layout_width="320dp"
       android:layout_height="wrap_content"
       android:contentDescription="@string/drag_image"
       app:layout_constraintBottom_toTopOf="@id/iv_target"
       app:layout_constraintLeft_toLeftOf="parent"
       app:layout_constraintRight_toRightOf="parent"
       app:layout_constraintTop_toBottomOf="@id/tv_greeting" />

   <ImageView
       android:id="@+id/iv_target"
       android:layout_width="320dp"
       android:layout_height="wrap_content"
       android:contentDescription="@string/drop_image"
       app:layout_constraintBottom_toBottomOf="parent"
       app:layout_constraintLeft_toLeftOf="parent"
       app:layout_constraintRight_toRightOf="parent"
       app:layout_constraintTop_toBottomOf="@id/iv_source" />
</androidx.constraintlayout.widget.ConstraintLayout>

最后在 ReceiveRichContentActivity.kt 中初始化视图。

class ReceiveRichContentActivity : AppCompatActivity() {
   private val binding by lazy(LazyThreadSafetyMode.NONE) {
       ActivityReceiveRichContentBinding.inflate(layoutInflater)
   }
   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       setContentView(binding.root)
       binding.tvGreeting.text = getString(R.string.greeting_2)
       Glide.with(this).asBitmap()
           .load(getString(R.string.source_url_2))
           .into(binding.ivSource)
       Glide.with(this).asBitmap()
           .load(getString(R.string.target_url_2))
           .into(binding.ivTarget)
       binding.ivSource.tag = getString(R.string.source_url_2)
   }
}

确保更新 AndroidManifest.xml 以将 DndHelperActivity 设置为启动 Activity。

<activity
   android:name=".ReceiveRichContentActivity"
   android:exported="true">
   <intent-filter>
       <action android:name="android.intent.action.MAIN" />
       <category android:name="android.intent.category.LAUNCHER" />
   </intent-filter>
</activity>

让我们首先创建一个实现 OnReceiveContentListener 的回调。

val listener = OnReceiveContentListener { view, payload ->
   val (textContent, remaining) =
       payload.partition { item: ClipData.Item -> item.text != null }
   if (textContent != null) {
       val clip = textContent.clip
       for (i in 0 until clip.itemCount) {
           val currentText = clip.getItemAt(i).text
           Glide.with(this)
               .load(currentText)
               .centerCrop().into(view as ImageView)
       }
   }
   remaining
}

在这里，我们实现了接口 OnRecieveContentListener。方法 onRecieveContent 有 2 个参数

正在接收数据的当前视图
来自键盘、拖动或剪贴板的数据有效负载，以 ContentInfoCompat 的形式

此方法返回未处理的有效负载。

在这里，我们使用 Partition 方法将有效负载分隔为文本内容和其他内容。我们根据需要处理文本数据并返回其余有效负载。

让我们处理我们想要对拖动数据执行的操作。

val listener = OnReceiveContentListener { view, payload ->
   val (textContent, remaining) =
       payload.partition { item: ClipData.Item -> item.text != null }
   if (textContent != null) {
       val clip = textContent.clip
       for (i in 0 until clip.itemCount) {
           val currentText = clip.getItemAt(i).text
           Glide.with(this)
               .load(currentText)
               .centerCrop().into(view as ImageView)
       }
   }
   remaining
}

现在我们的侦听器已准备就绪。让我们将此侦听器添加到目标视图。

ViewCompat.setOnReceiveContentListener(
   binding.ivTarget,
   arrayOf("text/*"),
   listener
)

在此阶段，您应该能够拖动图像并将其放到目标区域。一旦放下，拖动的图像应该替换放下目标视图中的原始图像。

10. 恭喜！

现在您已经熟练掌握了如何为您的 Android 应用实现拖放。通过遵循此代码实验室，您学习了如何在您的 Android 应用内和不同应用之间创建交互式拖放交互，从而增强用户体验和功能。您已经学习了

拖放基础知识：了解拖放事件的 4 个阶段（开始、继续、结束、退出）以及 DragEvent 对象中的关键数据。
启用拖放：通过处理 DragEvent 使视图可拖动并在目标视图中处理放下操作。
多窗口模式下的拖放：通过设置适当的标志和权限来启用跨应用拖放。
使用 DragAndDrop 库：使用 Jetpack 库简化拖放实现。
接收富内容：实现使用统一 API 处理来自各种输入方法的不同内容类型（文本、图像、视频等）。