手机和电脑之间的内容传递,是办公类APP非常值得优化的场景。手机拍摄的照片需要插入电脑文档,手机中的资料需要在电脑上继续编辑,电脑上的内容也可能需要快速发送到手机。传统操作通常要经过文件传输、查找文件和再次打开等步骤。
HarmonyOS Share Kit支持手机与PC/2in1之间的碰一碰分享。从26.0.0版本开始,在手机与PC/2in1、手机与Tablet设备触发轻碰事件时,接收侧可以从回调事件中获取轻碰位置坐标。这样,开发者就有机会根据用户触碰的位置设计更精准的内容处理逻辑。
这次以一个办公文档APP为例,模拟用户将手机中的图片发送到电脑,并根据电脑屏幕上的触碰位置决定后续处理方式。
首先,需要在电脑侧注册碰一碰监听事件,并配置接收端支持的数据类型。下面是核心结构:
import { uniformTypeDescriptor as utd } from '@kit.ArkData';
import { harmonyShare } from '@kit.ShareKit';
private registerReceive(): void {
const capabilityRegistry:
harmonyShare.RecvCapabilityRegistry = {
windowId: this.getWindowId(),
capabilities: [{
utd: utd.UniformDataType.IMAGE,
maxSupportedCount: 1
}]
};
harmonyShare.on(
'dataReceive',
capabilityRegistry,
this.onDataReceive
);
}这里的windowId需要替换为应用实际窗口ID,不能直接使用示例中的固定数字。capabilities用于声明接收端支持的数据类型和数量。如果当前窗口只需要接收图片,就没有必要声明大量暂时不支持的内容类型。
手机与电脑碰一碰的一个重要变化是可以获得屏幕坐标。系统提供的回调对象可以通过getInfo()获取触碰位置信息。
private onKnockShare =
(target: harmonyShare.SharableTarget): void => {
const info = target.getInfo();
const x = info.coordinate?.screenX;
const y = info.coordinate?.screenY;
if (x === undefined || y === undefined) {
target.reject(
harmonyShare.ShareResultCode.SHARE_FAILED
);
return;
}
// 根据坐标确定目标业务区域
target.share(this.buildShareData());
};坐标的原点是屏幕左上角。开发者可以根据窗口布局,将坐标转换成应用内部的目标区域。例如,电脑文档编辑界面可以划分为正文区域、图片素材区域和文件附件区域。用户触碰不同位置,应用就可以执行不同的业务操作。
需要注意,坐标只是系统提供的触碰位置信息,具体业务区域的命中判断仍然需要应用自己完成。不能直接将屏幕坐标当作ArkUI组件的局部坐标使用。如果窗口存在缩放、分屏或者多窗口布局,还需要根据窗口的位置和尺寸进行转换。
接收数据时,可以通过ReceivableTarget.receive()指定保存位置,并在回调中处理收到的数据。
private onDataReceive =
(target: harmonyShare.ReceivableTarget): void => {
const context = this.getUIContext()
.getHostContext() as common.UIAbilityContext;
const saveUri = fileUri.getUriFromPath(
context.filesDir
);
target.receive(saveUri, {
onDataReceived: (data: systemShare.SharedData) => {
// 根据实际收到的数据进行业务处理
},
onResult: (resultCode: harmonyShare.ShareResultCode) => {
if (resultCode ===
harmonyShare.ShareResultCode.SHARE_SUCCESS) {
// 更新接收状态
}
}
});
};实际项目中,收到图片后还需要将其与用户触碰的位置关联。例如,触碰位置落在文档正文区域,就可以进入图片插入流程;落在素材面板区域,则可以将图片加入素材库。这里的文档编辑和素材管理属于APP自身功能,并不是Share Kit自动完成的操作。
此外,必须考虑目标窗口状态。如果用户触碰时电脑端打开的是文档A,但接收完成前已经切换到文档B,应用不应该不加判断地把图片插入B。可以在分享开始时记录目标文档ID,接收完成后重新检查目标上下文是否仍然有效。
手机与PC/2in1的碰一碰分享,让设备之间的文件传递从简单的发送和接收,进一步延伸到结合屏幕位置的业务交互。对于办公、设计、教育和内容创作类APP,这是一种值得深入探索的功能方向。
暂无评论数据
发布
相关推荐
16
0
27
0
24
0
22
0
34
0sgdo:gogo
我还没有写个人简介......
帖子
提问
粉丝
鸿蒙智选新品齐发,以智能、品质、全场景定义高阶家电品牌新标准
2026-08-27 11:33:15 发布迭代速度太顶了!全新鸿蒙7.0已在路上,华为Mate 90首发
2026-03-27 17:06:31 发布



京公网安备:11010502051901号