logo
积分中心
不用扫码、不用发链接,给HarmonyOS APP接入手机碰一碰分享 原创
头像 hot moon 2026-11-12 11:39:27    发布
24 浏览 4 收藏

在APP中,分享是一个非常常见的操作。看到一篇有价值的文章,想推荐给朋友;发现一张好看的图片,想立即传给身边的人;浏览到一个商品,希望同事也能快速查看。传统分享通常需要点击分享按钮,再选择应用或者联系人。对于面对面交流的场景,这套操作流程还有进一步简化的空间。
HarmonyOS Share Kit提供的手机与手机碰一碰分享能力,让用户可以通过设备轻碰发起内容传递。对于开发者来说,接入这项能力并不意味着需要重新开发一套设备发现和连接流程,而是通过Share Kit注册碰一碰分享事件,在系统触发回调后准备分享数据,再交给系统完成后续交互。
这次以资讯类APP为例,为文章详情页增加碰一碰分享。用户打开一篇文章,与朋友手机顶部轻碰,就可以将当前文章分享出去。首先需要明确的是,应用必须知道当前页面正在展示什么内容。不能在碰一碰回调中始终发送固定链接,而应该根据当前页面状态动态构造分享数据。
HarmonyOS提供的核心接口来自Share Kit。下面是注册碰一碰事件并构造链接分享数据的基本代码:


import { uniformTypeDescriptor as utd } from '@kit.ArkData';
import { harmonyShare, systemShare } from '@kit.ShareKit';

aboutToAppear(): void {
  harmonyShare.on('knockShare', this.onKnockShare);
}

private onKnockShare =
  (target: harmonyShare.SharableTarget): void => {
    const shareData: systemShare.SharedData =
      new systemShare.SharedData({
        utd: utd.UniformDataType.HYPERLINK,
        content: 'https://example.com/article/1001',
        title: 'HarmonyOS开发实践',
        description: '一篇关于跨设备分享的技术文章'
      });

    target.share(shareData);
  };


这里使用了knockShare事件监听系统触发的碰一碰分享。回调参数SharableTarget代表本次分享的目标对象,应用通过share()方法提交准备好的数据。示例中的链接、标题和描述都是演示内容,实际开发时应该替换成当前文章的数据。
如果分享的是文章链接,建议同时提供标题、描述和预览图。这样系统可以根据分享数据生成更合适的卡片,而不是只展示一段普通链接。预览图可以通过本地文件URI传入,开发者需要确保文件已经准备完成并且能够正常读取。


import { fileUri } from '@kit.CoreFileKit';
const shareData: systemShare.SharedData =
  new systemShare.SharedData({
    utd: utd.UniformDataType.HYPERLINK,
    content: article.shareUrl,
    title: article.title,
    description: article.summary,
    thumbnailUri: fileUri.getUriFromPath(
      article.coverLocalPath
    )
  });
target.share(shareData);


需要注意,coverLocalPath必须是已经准备好的本地图片路径。如果封面图片还在云端下载,不建议在碰一碰回调中等待较长时间。可以先发送核心分享数据,待预览图下载完成后,再使用updateShareData()更新卡片内容。这样可以降低分享回调超时的风险。
碰一碰分享事件也不是注册之后就不再管理。用户离开文章详情页后,应用应该及时解除监听,避免其他页面仍然响应之前的分享逻辑。


aboutToDisappear(): void {
  harmonyShare.off('knockShare', this.onKnockShare);
}


接收端同样需要考虑。对于链接分享,建议使用App Linking实现内容直达。应用已经安装时,可以进入对应文章详情页;没有安装时,则可以根据链接服务的配置进入网页或者应用市场。这样分享不仅完成了设备间的数据传递,还能将用户直接带到目标内容。
还有一个容易忽略的地方:如果当前界面没有可以分享的内容,就应该及时终止本次分享。HarmonyOS提供了clarifyNonShare()用于向用户说明当前页面不支持分享,避免用户一直等待。


target.clarifyNonShare({
  message: '请进入文章详情页后再进行分享'
});


在实际项目中,我建议将碰一碰分享封装为独立的业务模块,文章页只负责提供标题、摘要、链接和封面等数据,分享模块负责构造SharedData并提交给Share Kit。这样以后增加商品、课程、活动等分享类型时,就不需要在每个页面重复编写系统交互逻辑。
碰一碰分享真正值得关注的地方,是它让APP中的内容能够以更自然的方式进入用户之间的交流。对于资讯、阅读、教育和社交类应用,可以先从内容详情页接入,再逐步扩展到更多高频业务入口。

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

暂无评论数据

加载中...

发布

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

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255