logo
积分中心
手机碰一下电脑屏幕,内容直接进入指定窗口:HarmonyOS跨设备精准分享实践 原创
头像 sgdo:gogo 2026-11-12 11:43:12    发布
31 浏览 5 收藏

手机和电脑之间的内容传递,是办公类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,这是一种值得深入探索的功能方向。

©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255