跨应用拖拽同时传完整图片、结构化元数据和预览文本，会让拖拽开始阶段承担过多序列化与内存成本。API 23开始支持配置自定义数据类型列表，接收端可以先完成类型协商，再按业务需要取得合适的数据样式。

方案面向HarmonyOS 6.1.1 Release SDK（API 24），系统Kit调用进入适配层，命令约束、状态归并和恢复策略进入可测试的业务层。范围包含状态与资源生命周期设计、失败恢复和验收合同，不包含业务内容生产、服务端协议改造以及特定厂商网页或媒体源的兼容承诺。

拖拽合同从类型协商开始

方案把一张业务卡片描述为DragManifest，包含recordId、customTypes、previewText、estimatedBytes和expiresAt。拖拽开始只构造轻量清单与预览，较大的二进制内容由providerToken指向受控提供器；接收端根据支持的类型选择JSON、纯文本或图片样式。

状态数量不是越多越好。每个状态必须回答三个问题：当前允许哪些命令、收到迟到事件怎样处理、页面退出后是否还可以更新UI。下面的状态对象携带operationId，新的操作开始后，旧操作回调会被拒绝。

export enum DragTransferState {
  PREPARING = 'preparing',
  NEGOTIATING = 'negotiating',
  PREVIEWING = 'previewing',
  FETCHING = 'fetching',
  ACCEPTED = 'accepted',
  EXPIRED = 'expired'
}

export interface DragTransferSnapshot {
  state: DragTransferState;
  progress: number;
  message: string;
  operationId: number;
  updatedAt: number;
}

export type DragTransferEvent =
  | { type: 'START'; operationId: number }
  | { type: 'PROGRESS'; operationId: number; progress: number }
  | { type: 'SUCCESS'; operationId: number }
  | { type: 'FAIL'; operationId: number; message: string };

export function acceptEvent(
  snapshot: DragTransferSnapshot,
  event: DragTransferEvent
): boolean {
  return event.type === 'START' || event.operationId === snapshot.operationId;
}

同一记录为什么需要多种样式

自定义类型采用应用命名空间前缀，并与标准UniformDataType分开，避免名称碰撞。providerToken只在一次dragSessionId内有效，设置过期时间和最大读取次数。接收端即使匹配到类型，仍要检查字段长度、schemaVersion、资源大小和来源策略，不能把类型匹配当成信任。

这套分层把系统事实和产品行为分开：Kit适配器负责获得事实，领域对象决定是否接受事件，页面只渲染快照。更换API版本或加入真机能力时，只需要替换适配器；状态归并和异常策略仍可在模拟器中重复验证。

延迟取数令牌如何限制生命周期

下面是主题专属的接入或核心算法代码。示例刻意保留资源创建、前置条件和清理逻辑，因为高频故障往往出现在成功调用之外。

export interface DragManifest {
  dragSessionId: string;
  recordId: string;
  customTypes: string[];
  previewText: string;
  estimatedBytes: number;
  providerToken?: string;
  expiresAt: number;
}

export class DragContract {
  private readonly supported: Set<string> = new Set([
    'com.example.feature-card+json',
    'general.plain-text',
    'general.jpeg'
  ]);

  negotiate(offered: string[]): string | undefined {
    const preferred = [
      'com.example.feature-card+json',
      'general.jpeg',
      'general.plain-text'
    ];
    return preferred.find(type => offered.includes(type) && this.supported.has(type));
  }

  validate(manifest: DragManifest, now: number): void {
    if (!/^[a-zA-Z0-9_-]{8,64}$/.test(manifest.dragSessionId)) {
      throw new Error('SESSION_ID_INVALID');
    }
    if (manifest.expiresAt <= now) throw new Error('DRAG_DATA_EXPIRED');
    if (manifest.estimatedBytes > 20 * 1024 * 1024) {
      throw new Error('DRAG_DATA_TOO_LARGE');
    }
    if (!this.negotiate(manifest.customTypes)) {
      throw new Error('NO_SUPPORTED_TYPE');
    }
  }
}

代码迁入业务工程时，应把错误码转换为稳定的领域错误，不让页面直接判断系统错误字符串。对于异步回调，还要在写入状态前比较operationId或资源版本；仅检查组件是否存在，无法阻止旧任务污染新页面。

接收端必须再次校验业务字段

异常注入按钮用于稳定复现应用侧恢复路径。真实错误发生时，诊断记录同时保存错误码、权限结果、设备能力和用户可见状态；敏感原始数据不进入日志，截图只呈现与问题直接相关的结果。

取消拖拽后怎样回收临时资源

页面层不直接调用Kit，而是通过动作按钮驱动同一份状态模型。这样既能在系统能力可用时接真实适配器，也能在模拟器缺少硬件时验证错误页面、幂等逻辑和资源清理。

@Component
struct DragTransferPanel {
  @State stateText: string = 'PREPARING';
  @State progress: number = 0;
  @State logs: string[] = [];

  private append(message: string): void {
    const time = new Date().toLocaleTimeString();
    this.logs = [`${time}  ${message}`, ...this.logs].slice(0, 8);
  }

  private startDemo(): void {
    this.stateText = 'NEGOTIATING';
    this.progress = 20;
    this.append('开始：UDMF拖拽自定义类型与延迟取数');
  }

  private injectFailure(): void {
    this.stateText = 'EXPIRED';
    this.append('已注入可恢复故障');
  }

  build() {
    Column({ space: 12 }) {
      Text('UDMF拖拽自定义类型与延迟取数').fontSize(24).fontWeight(FontWeight.Bold)
      Text(this.stateText).fontSize(18).fontColor('#2563EB')
      Progress({ value: this.progress, total: 100 }).width('100%')
      Row({ space: 12 }) {
        Button('开始实验').onClick(() => this.startDemo())
        Button('注入故障').onClick(() => this.injectFailure())
      }
      ForEach(this.logs, (item: string) => Text(item).fontSize(13))
    }.padding(20).width('100%')
  }
}

验收准备自定义JSON优先、只有纯文本、图片延迟取数、未知类型、令牌过期和中途取消六组组合。每次记录提供类型、最终选择、读取字节数、会话结束原因与临时资源数量；取消或过期后再次读取必须被拒绝，活动provider计数回到零。

多样式数据的目的在于让接收端按能力选择表达形式，不应把同一份大内容复制成多个完整副本。预览图控制尺寸和质量，原始资源只在对方明确请求后读取。拖入本应用的数据可能来自外部进程，文件名、MIME、扩展名和声明类型需要交叉检查；检测结果冲突时按更严格策略处理。拖拽悬停期间不执行不可撤销写入，只有drop确认且数据校验完成后才创建业务记录。页面销毁、应用退后台和系统取消都汇入同一会话终止函数。审计日志只保存类型、大小、结果和匿名会话摘要，不记录用户拖拽的原始文本与图片内容。

验收记录至少包括SDK版本、模拟器系统版本、操作顺序、预期状态、实际状态和截图编号。快速点击、返回再进入、故障后重试和页面销毁是必测项；涉及资源的主题还要显示活动对象计数，涉及异步任务的主题要验证迟到结果不会改变当前页面。

跨应用六组数据组合验收

这套方案的技术闭环由“输入约束—状态模型—Kit适配—异常恢复—可观察验收”组成。业务状态不持有系统对象，适配器不直接操作页面，异常路径有明确的恢复动作，后续SDK升级时可以分别回归每一层。

官方资料：UDMF相关开发文档