Android如何实现图文复制到Clipboard及键盘粘贴响应处理

你要实现的键盘候选区显示复制图片的效果参考：

两个问题的具体实现方案分端说明如下：

一、复制图片后无法在键盘候选区显示的解决方法 #

核心原因是写入剪贴板的图片格式不符合系统/输入法的通用识别规范，导致输入法读不到可展示的图片资源，按平台适配即可：

• 安卓端
  写入剪贴板时不要直接存私有Bitmap对象或应用私有路径的文件，必须通过ClipData.newUri()传入公开可访问的Content URI，MIME类型指定为image/*；如果用FileProvider生成URI，要给剪贴板内容授予临时全局读权限，否则第三方输入法无权限读取图片。
  参考写入代码：

  val clipboard = getSystemService(CLIPBOARD_SERVICE) as ClipboardManager
  // imageUri 是通过FileProvider生成、带临时读权限的公开URI
  val clipData = ClipData.newUri(contentResolver, "copy_image", imageUri)
  clipboard.setPrimaryClip(clipData)
  

  注意：部分定制系统输入法需要收到剪贴板变更广播才会刷新候选内容，只要写入格式符合规范，输入法会自动识别展示，不需要额外做特殊调用。
• iOS端
  写入UIPasteboard时不要只存自定义封装的图片对象，必须写入符合系统UTI规范的图片数据，用public.png/public.jpeg作为类型标识，确保第三方键盘拿到读取权限后能识别到图片资源。
  参考写入代码：

  guard let pngData = copiedImage.pngData() else { return }
  UIPasteboard.general.setData(pngData, forPasteboardType: kUTTypePNG as String)
  

二、点击键盘候选区图片的粘贴逻辑处理 #

用户点击键盘候选区的剪贴板图片时，系统会自动触发输入控件的粘贴回调，不需要额外监听键盘的点击事件，只要给输入控件实现对应类型的内容接收逻辑即可：

• 安卓端
  给编辑区域对应的EditText控件设置OnReceiveContentListener，同时监听文本和图片类型的内容，在回调里判断传入内容的类型，图片类型就走图片插入逻辑，文本类型走原有文本粘贴逻辑。
  参考实现代码：

  editText.setOnReceiveContentListener(arrayOf("text/*", "image/*")) { _, payload ->
      val item = payload.clip.getItemAt(0)
      when {
          item.uri != null && contentResolver.getType(item.uri)?.startsWith("image/") == true -> {
              // 解析URI为Bitmap/文件路径，插入到编辑区指定位置
              insertImageToEditor(item.uri)
              null
          }
          item.text != null -> {
              // 复用已有的文本粘贴逻辑
              insertTextToEditor(item.text)
              null
          }
          else -> payload // 不处理的内容交回系统默认逻辑
      }
  }
  

• iOS端
  重写UITextView/UITextField的粘贴相关方法，先判断剪贴板是否包含图片类型内容，有就走自定义图片插入逻辑，没有就走默认的文本粘贴逻辑。用户点击键盘候选区图片时，系统会自动触发控件的paste方法。
  参考实现代码：

  override func canPaste(_ itemProviders: [NSItemProvider]) -> Bool {
      let hasImage = itemProviders.contains { $0.hasItemConformingToTypeIdentifier(kUTTypeImage as String) }
      return hasImage || super.canPaste(itemProviders)
  }
  
  override func paste(_ sender: Any?) {
      if UIPasteboard.general.hasImages, let image = UIPasteboard.general.image {
          // 把图片插入到编辑区当前光标位置
          insertImageToEditor(image)
          return
      }
      super.paste(sender)
  }
  

如果是Flutter、React Native这类跨平台框架开发，框架默认输入控件没有内置图片粘贴接收能力，需要按上述逻辑写原生桥接代码实现，或使用支持富媒体粘贴的第三方输入组件。

内容的提问来源于stack exchange，提问作者BasitAli Writes