目录
真诚发问
唠唠嗑
引言
一、技术背景与发行时间
二、技术底层原理
三、相关 Android 知识
四、技术实现
五、总结
六、最后再插一嘴
真诚发问
你是否曾为手机上图片不能像文字一样随意复制粘贴而感到烦恼？当和别人分享美照的时候，频繁地下载图片找图片发图片，是否影响了你的分享passion？？
你是否也曾愤怒发问过：“为什么图片就不能像文字一样轻松一键复制一键粘贴呢？”
恭喜你，现在，上天听到你的发问了！（谢谢程序员大佬，科技改变人生）
唠唠嗑
2024年11月23日，Android官方更新了一条技术《接收富媒体内容》，我心想单纯接收富媒体不是早就实现了吗？好家伙，点开有惊喜啊！虽然官方发的那篇文章内容看着不多，但是带给我的激动确实大大的！！！！
接下来这个是官方发布的视频，让我们再来感受一下技术带来的热血吧！！
Android技术-接收富媒体
看完之后，是不是突然感觉很感动，再一次梦想照进现实的感觉。
接下来，让我们一起来深入看看这个技术是怎么实现的吧！
引言
随着移动应用的普及，用户对应用的交互体验要求越来越高。富媒体内容（如图片、视频、音频等）已经成为现代应用中不可或缺的一部分。然而，在 Android 应用中插入和移动这些内容并非易事。为了解决这一问题，Android 12（API 级别 31）引入了统一 API，使得应用能够更轻松地接收来自任何来源（如剪贴板粘贴、键盘输入或拖放操作）的富媒体内容。本文将详细介绍这一技术的来源、底层原理、相关 Android 知识，并通过代码示例展示如何在 Android 应用中实现富媒体内容的接收。
一、技术背景与发行时间
1.1 富媒体内容的挑战
在 Android 应用中，用户经常需要插入图片、视频或其他富媒体内容。然而，传统的处理方式存在以下问题：
不同来源的处理方式不一致：例如，剪贴板粘贴、拖放操作和键盘输入的处理逻辑各自独立，开发者需要为每种方式编写不同的代码。
内容类型多样性：除了纯文本，用户还可能插入图片、视频、音频、HTML 内容等，这些内容的处理逻辑复杂。
兼容性问题：在不同 Android 版本中，处理富媒体内容的方式可能不同，导致代码难以维护。
1.2 Android 12 的统一 API
为了解决上述问题，Android 12 引入了统一 API，提供了一个统一的接口来处理所有来源的富媒体内容。这一 API 的核心是 OnReceiveContentListener 接口，它允许开发者在内容插入时获得回调，从而在一个位置处理所有内容。
1.3 AndroidX 的向后兼容
为了支持旧版本的 Android 系统，Google 在 AndroidX 中提供了对统一 API 的向后兼容支持。从 Core 1.7 和 Appcompat 1.4 开始，开发者可以在 Android 12 之前的版本中使用这一功能。
1.4 界面机制变化说明
使用其他现有 API 时，每个界面机制（例如轻触并按住菜单或拖动）都有各自对应的 API。这意味着您必须单独与每个 API 集成，并为每种插入内容的机制添加类似的代码：
图 1. 以前，应用需要为每个界面机制实现不同的 API 来插入内容。
OnReceiveContentListener API 会通过创建一个要实现的单一 API 来整合这些不同的代码路径，这样您就可以专注于应用特定的逻辑，而让平台处理其余的工作：
图 2. 统一 API 可让您实现支持所有界面机制的单一 API。
这种方法还意味着，当平台添加新的内容插入方式时，您无需进行额外的代码更改即可在应用中启用支持。如果您的应用需要针对特定用例实现完全自定义，您仍然可以使用现有 API，这些 API 将继续以相同的方式运行。
二、技术底层原理
2.1 统一 API 的设计目标
统一 API 的设计目标是通过一个统一的接口简化富媒体内容的处理，具体包括：
统一回调机制：无论内容来自剪贴板、拖放操作还是键盘输入，开发者都可以通过 OnReceiveContentListener 接口获得回调。
内容类型识别：API 能够自动识别插入的内容类型（如图片、视频、音频、HTML 等），并将其传递给开发者。
简化代码逻辑：开发者无需为每种内容来源编写独立的处理逻辑，从而减少代码复杂度。
2.2 底层实现原理
2.2.1 内容插入的触发机制
在 Android 中，内容插入的触发机制主要包括以下几种：
剪贴板粘贴：用户通过长按菜单选择“粘贴”操作。
拖放操作：用户通过拖放手势将内容插入到应用中。
键盘输入：某些输入法（如 Gboard）支持直接插入图片或其他富媒体内容。
统一 API 的核心是捕获这些操作，并将插入的内容传递给 OnReceiveContentListener。
2.2.2 内容解析与分发
当用户插入内容时，系统会执行以下步骤：
捕获插入事件：系统检测到用户执行了粘贴、拖放或键盘输入操作。
解析内容类型：系统根据插入的内容类型（如图片、视频、音频等），将其封装为 ContentInfo 对象。
调用回调接口：系统将 ContentInfo 对象传递给 OnReceiveContentListener，开发者可以在回调中处理内容。
2.2.3 内容处理流程
以下是统一 API 的内容处理流程：
用户插入内容：例如，用户从剪贴板粘贴了一张图片。
系统捕获事件：系统检测到粘贴操作，并创建一个 ContentInfo 对象。
回调接口触发：系统调用 OnReceiveContentListener 的 onReceiveContent 方法，并将 ContentInfo 作为参数传递。
开发者处理内容：在回调中，开发者可以解析 ContentInfo 中的内容，并将其插入到应用中。
2.3 为什么可以直接粘贴图片到输入框？
在 Android 12 之前，粘贴图片到输入框需要复杂的逻辑，例如手动处理剪贴板数据或使用第三方库。统一 API 的出现解决了这一问题，具体原因如下：
统一的内容处理机制：无论内容来自剪贴板、拖放操作还是键盘输入，系统都会将其封装为 ContentInfo 对象，并通过 OnReceiveContentListener 传递给开发者。
自动识别内容类型：系统能够自动识别插入的内容类型（如图片、视频、音频等），并将其传递给开发者，开发者无需手动解析。
简化开发流程：开发者只需实现 OnReceiveContentListener 接口，即可处理所有类型的内容，无需为每种来源编写独立的代码。
三、相关 Android 知识
3.1 OnReceiveContentListener 接口
OnReceiveContentListener 是统一 API 的核心接口，用于处理插入的内容。其定义如下：
public interface OnReceiveContentListener {
ContentInfo onReceiveContent(View view, ContentInfo payload);
}
View view：触发内容插入的视图（如 EditText 或 ImageView）。
ContentInfo payload：插入的内容，包含内容类型、数据源等信息。
3.2 ContentInfo 类
ContentInfo 是统一 API 中用于封装插入内容的类，其主要属性包括：
Uri：内容的数据源（如图片的 URI）。
String：内容的 MIME 类型（如 image/png 或 video/mp4）。
ClipData：包含实际内容的剪辑数据。
3.3 剪贴板与拖放操作
3.3.1 剪贴板
剪贴板是 Android 系统中用于存储临时数据的组件。用户可以通过长按菜单选择“复制”或“粘贴”操作。统一 API 能够自动处理剪贴板中的内容。
3.3.2 拖放操作
拖放操作是 Android 系统中用于移动内容的一种交互方式。用户可以通过长按并拖动内容到目标位置。统一 API 能够自动处理拖放操作中的内容。现在拖动可以在单个应用中也可以在应用之间进行拖动（想象下平板分屏的时候，两个应用，你可以将图片直接拖动而跳过下载-发送的过程）
拖动文本
拖动月亮图片
拖动相关的知识可以查看官方文档：https://developer.android.com/develop/ui/views/touch-and-input/drag-drop?hl=zh-cn
相关github代码：
platform-samples/samples/user-interface/draganddrop at main · android/platform-samples · GitHub
3.3.3 再次详解
在富媒体内容的复制过程中，系统会将富媒体数据封装成特定的 ClipData 对象，并存储在剪贴板中。ClipData 对象包含了富媒体内容的数据本身（如通过 Uri 指向存储在设备存储或其他数据源中的图片、视频文件）以及相关的元数据（如内容类型、标签等）。应用通过与剪贴板交互，可以获取到 ClipData 对象，并从中提取出富媒体内容进行后续处理。
例如，当用户在相册应用中复制一张图片时:
相册应用会将该图片的相关信息封装成 ClipData 对象，其中包含图片的 Uri、类型为 “image/jpeg”（假设图片为 JPEG 格式）以及可能的自定义标签（如图片的名称或描述）等信息。存储到剪贴板中。然后，当用户切换到其他支持富媒体粘贴的应用（如文本编辑应用或社交分享应用）并执行粘贴操作时，目标应用通过统一 API 向剪贴板请求数据，获取到 ClipData 对象后，再根据其中的信息对富媒体内容进行处理，如将图片显示在界面上或上传到服务器等。
3.4 AndroidX 的兼容支持
为了支持旧版本的 Android 系统，Google 在 AndroidX 中提供了对统一 API 的兼容支持。开发者可以通过以下依赖使用这一功能：
implementation "androidx.core:core-ktx:1.7.0"
implementation "androidx.appcompat:appcompat:1.4.0"
3.5 权限管理
3.5.1 权限管理的重要性
在 Android 应用中处理富媒体内容时，权限管理是确保应用合法使用和用户数据安全的关键环节。富媒体内容可能涉及以下敏感资源：
存储设备：如图片、视频文件。
网络：如上传富媒体内容到服务器。
摄像头和麦克风：如拍摄照片或录制音频。
为了确保应用能够正常访问这些资源，开发者需要在 AndroidManifest.xml 中声明相关权限，并在运行时动态请求用户授权。
3.5.2 声明权限
在 AndroidManifest.xml 文件中声明应用所需的权限。例如：
package="com.example.myapp"> ... > ...
3.5.3 动态请求权限
从 Android 6.0（API 级别 23）开始，系统引入了运行时权限机制。应用需要在运行时动态请求用户授权，而不是在安装时一次性授予所有权限。
检查权限
在访问敏感资源之前，首先需要检查应用是否已经获得了相关权限。
import android.content.pm.PackageManager;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
public boolean checkPermission(String permission, int requestCode) {
// 检查是否已授予权限
if (ContextCompat.checkSelfPermission(this, permission)
!= PackageManager.PERMISSION_GRANTED) {
// 如果未授予权限，请求权限
ActivityCompat.requestPermissions(this, new String[]{permission}, requestCode);
return false;
}
return true;
}
请求权限
当应用需要访问敏感资源时，调用 requestPermissions 方法请求权限。
// 请求存储权限
if (!checkPermission(Manifest.permission.READ_EXTERNAL_STORAGE, REQUEST_STORAGE_PERMISSION)) {
// 如果未授权，提示用户
Toast.makeText(this, "需要存储权限才能访问图片和视频", Toast.LENGTH_SHORT).show();
}
处理权限请求结果
在 onRequestPermissionsResult 方法中处理用户对权限请求的响应。
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
if (requestCode == REQUEST_STORAGE_PERMISSION) {
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
// 用户授予权限，继续处理富媒体内容
handleMediaContent();
} else {
// 用户拒绝权限，提示用户
Toast.makeText(this, "权限被拒绝，无法访问富媒体内容", Toast.LENGTH_SHORT).show();
}
}
}
权限分组与级别
Android 系统将权限分为不同的分组和级别，开发者需要根据实际需求选择合适的权限。
权限分组
普通权限：如 INTERNET，安装时自动授予。
危险权限：如 READ_EXTERNAL_STORAGE，需要运行时请求用户授权。
权限级别
普通权限：对用户隐私影响较小，如网络访问权限。
危险权限：对用户隐私影响较大，如存储、摄像头、麦克风权限。
运行时权限的最佳实践
仅请求必要的权限：避免请求不必要的权限，以减少用户对隐私的担忧。提供清晰的权限说明：在请求权限时，向用户解释为什么需要该权限。优雅处理权限拒绝：如果用户拒绝权限，提供友好的提示，而不是强制退出应用。
四、技术实现代码
4.1 实现 OnReceiveContentListener
以下是一个简单的示例，展示如何实现 OnReceiveContentListener 接口来处理插入的内容。
import android.content.ClipData;
import android.content.ContentInfo;
import android.net.Uri;
import android.view.View;
import androidx.core.view.OnReceiveContentListener;
public class MyContentListener implements OnReceiveContentListener {
@Override
public ContentInfo onReceiveContent(View view, ContentInfo payload) {
// 获取插入的内容
ClipData clipData = payload.getClip();
for (int i = 0; i < clipData.getItemCount(); i++) {
ClipData.Item item = clipData.getItemAt(i);
Uri uri = item.getUri();
String mimeType = payload.getDescription().getMimeType(i);
// 处理内容
if (mimeType.startsWith("image/")) {
handleImage(uri);
} else if (mimeType.startsWith("video/")) {
handleVideo(uri);
} else {
handleText(item.getText());
}
}
return null;
}
private void handleImage(Uri uri) {
// 处理图片
}
private void handleVideo(Uri uri) {
// 处理视频
}
private void handleText(CharSequence text) {
// 处理文本
}
}
4.2 注册 OnReceiveContentListener
在 Activity 或 Fragment 中，将 OnReceiveContentListener 注册到目标视图。
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.view.ViewCompat;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 获取目标视图
View targetView = findViewById(R.id.target_view);
// 注册 OnReceiveContentListener
ViewCompat.setOnReceiveContentListener(targetView, new String[]{"image/*", "video/*", "text/*"}, new MyContentListener());
}
}
4.3 处理不同类型的内容
在 onReceiveContent 方法中，可以根据内容类型（如图片、视频、文本）执行不同的处理逻辑。例如：
图片：将图片插入到 ImageView 中。
视频：将视频插入到 VideoView 中。
文本：将文本插入到 EditText 中。
五、总结
Android 12 引入的统一 API 为开发者提供了一种简单、高效的方式来处理富媒体内容。通过 OnReceiveContentListener 接口，开发者可以在一个位置处理所有来源的内容，从而简化代码逻辑并提升用户体验。本文详细介绍了这一技术的背景、底层原理、相关 Android 知识，并通过代码示例展示了如何在 Android 应用中实现富媒体内容的接收。
通过本文的学习，开发者可以掌握如何在 Android 应用中接收和处理富媒体内容，并根据实际需求选择合适的实现方式。希望本文能够对您的 Android 开发工作有所帮助！
六、最后再插一嘴
看完上面的介绍，是不是感觉技术并没有那么复杂，那为什么最开始的时候却没有实现呢？
好问题，让我们再来一起回顾一下android的发展吧！
6.1 早期 Android 版本中的富文本处理
6.1.1 Android 1.x 和 2.x 时代
在 Android 1.x 和 2.x 时代（API 级别 1-10），Android 系统的设计目标是提供一个轻量级的移动操作系统，主要支持基本的文本和简单的图片处理。富文本内容的处理并不是系统设计的重点，原因如下：
系统资源有限：早期的 Android 设备硬件性能较低，内存和存储空间有限，无法高效处理复杂的富媒体内容。
应用生态不成熟：早期的 Android 应用生态以简单的工具类应用为主，富文本内容的需求较少。
API 支持不足：Android 1.x 和 2.x 的 API 主要集中在基本的 UI 控件和简单的数据处理，缺乏对富文本内容的统一支持。
6.1.2 富文本处理的碎片化问题
在 Android 3.x 和 4.x 时代（API 级别 11-19），随着平板电脑和智能手机的普及，富文本内容的需求逐渐增加。然而，这一时期的富文本处理存在以下问题：
不同来源的处理方式不一致：例如，剪贴板粘贴、拖放操作和键盘输入的处理逻辑各自独立，开发者需要为每种方式编写不同的代码。
内容类型多样性：除了纯文本，用户还可能插入图片、视频、音频、HTML 内容等，这些内容的处理逻辑复杂。
兼容性问题：在不同 Android 版本中，处理富文本内容的方式可能不同，导致代码难以维护。
6.2 Android 5.x 到 Android 11 的过渡
6.2.1 Android 5.x 和 6.x 时代
在 Android 5.x 和 6.x 时代（API 级别 21-23），Android 系统开始引入一些改进，以支持富文本内容的处理：
运行时权限机制：从 Android 6.0（API 级别 23）开始，系统引入了运行时权限机制，开发者需要在运行时动态请求用户授权，以访问敏感资源（如存储、摄像头等）。
剪贴板增强：Android 5.0 引入了 ClipboardManager 的改进，支持更复杂的剪贴板数据（如 ClipData 对象），但仍然缺乏统一的 API 来处理富文本内容。
6.2.2 Android 7.x 到 Android 11 时代
在 Android 7.x 到 Android 11 时代（API 级别 24-30），Android 系统逐步完善了对富文本内容的支持：
拖放 API：Android 7.0（API 级别 24）引入了拖放 API，允许用户通过拖放手势在应用之间传递富文本内容。
剪贴板增强：Android 10（API 级别 29）进一步增强了剪贴板功能，支持更复杂的富文本内容（如图片、视频等）。
统一 API 的雏形：虽然 Android 11 之前没有统一的 API 来处理富文本内容，但系统逐步引入了一些基础功能，为后续的统一 API 奠定了基础。
6.3 Android 12 的统一 API
6.3.1 统一 API 的诞生
Android 12（API 级别 31）引入了统一 API，提供了一个统一的接口来处理所有来源的富文本内容。这一功能的实现解决了以下问题：
统一回调机制：无论内容来自剪贴板、拖放操作还是键盘输入，开发者都可以通过 OnReceiveContentListener 接口获得回调。
内容类型识别：API 能够自动识别插入的内容类型（如图片、视频、音频、HTML 等），并将其传递给开发者。
简化代码逻辑：开发者无需为每种内容来源编写独立的处理逻辑，从而减少代码复杂度。
6.3.2 为什么现在才实现？
统一 API 的实现并不是一蹴而就的，而是经过了多年的技术积累和用户需求驱动。以下是主要原因：
（1）技术积累
剪贴板和拖放功能的完善：Android 系统逐步增强了剪贴板和拖放功能，为统一 API 的实现奠定了基础。
运行时权限机制的成熟：运行时权限机制的引入使得系统能够更安全地处理敏感资源（如存储、摄像头等），为富文本内容的处理提供了保障。
（2）用户需求驱动
富文本内容的普及：随着社交媒体、短视频和在线文档的普及，用户对富文本内容的需求越来越高。
应用生态的成熟：Android 应用生态逐渐成熟，开发者需要更高效的方式来处理富文本内容。
（3）系统设计的复杂性
不同来源的兼容性：统一 API 需要兼容剪贴板、拖放操作和键盘输入等多种来源，设计难度较大。
内容类型的多样性：富文本内容可能包含图片、视频、音频、HTML 等多种类型，需要系统提供灵活的处理机制。
6.4 统一 API 的优势
6.4.1 简化开发流程
统一 API 提供了一个统一的接口来处理所有来源的富文本内容，开发者无需为每种来源编写独立的代码，从而简化了开发流程。
6.4.2 提升用户体验
统一 API 使得应用能够更轻松地接收和处理富文本内容，提升了用户的交互体验。例如，用户可以更方便地将图片、视频等内容插入到应用中。
6.4.3 增强安全性
统一 API 结合了运行时权限机制，确保应用在访问敏感资源时能够获得用户的明确授权，从而增强了应用的安全性。
虽然现在看起来实现富文本内容的接收和处理并不复杂，但这一功能的实现是建立在多年的技术积累和用户需求驱动的基础之上的。
期待指尖轻松传图片的那一天
相信技术愉悦生活
感谢您观看到这里，祝您生活愉快ღ( ´･ᴗ･` )