一碰即传，重构跨设备文件分享体验

用户在分享图片、文件或热点时，需经历复杂的操作流程（如打开应用、选择文件、搜索设备、确认传输等），步骤繁琐且耗时；或者需要用户打断当前操作（如暂停视频播放、退出游戏界面），导致体验不连贯。
HarmonyOS SDK 分享服务（Share Kit）推出了"碰一碰分享"能力，支持用户通过碰一碰发起跨端分享，可实现传输图片、共享WI-FI等。只需轻轻触碰两台设备，即可完成内容的传递。
功能场景

• 宿主应用进入一个可以分享的界面，比如打开或者选中的一个文件、一条备忘录、一个联系人详情，或个人热点/WIFI等。
  
• 宿主应用可以分享多个内容，如选中的多张图片等。
  

简单触碰：当您想要分享某些内容时，只需将两台设备在亮屏、解锁的状态下并且都已开启华为分享服务（系统默认开启），设备顶部轻碰即可触发。

即时反馈：一旦设备接触成功，"碰一碰分享"会立即给出反馈，告知用户分享是否已经开始以及进度情况，用户可以清楚地知道分享的状态，避免不确定性带来的困扰。
无缝切换：分享完成后，用户可以直接返回到之前的活动或者选择查看已发送/接收的内容。

除了便捷的操作流程外，"碰一碰分享"还支持多种类型的内容分享，涵盖了日常生活中大多需要共享的信息形式，比如文本材料、图片视频和音频文件等。
开发步骤

配置开发环境

支持的设备类型：当前仅支持手机碰手机。
支持的手机系统：双端需HarmonyOS NEXT 5.0.0.102 SP6及以上版本，可使用canIUse进行判断。

1. if (canIUse('SystemCapability.Collaboration.HarmonyShare')) {
2.   // 支持一碰分享的能力.
3. }

复制代码

集成开发环境：DevEco Studio NEXT Beta1及以上版本。
开发流程

开发示例

以分享App Linking直达应用为例，展示如何通过碰一碰分享实现直达应用，应用需接入App Linking以确保端到端完整的体验。操作步骤请参考：使用App Linking实现应用间跳转。

• 导入相关模块
  

1. import { uniformTypeDescriptor as utd } from '@kit.ArkData';
2. import { systemShare, harmonyShare } from '@kit.ShareKit';
3. import { fileUri } from '@kit.CoreFileKit';

复制代码

• 定义碰一碰分享事件监听/取消监听方法（收到碰一碰分享事件回调后，需尽快调用sharableTarget.share()方法发起分享，超过3秒可能会失败）。
  

1. private immersiveCallback(sharableTarget: harmonyShare.SharableTarget) {
2.   const contextFaker: Context = getContext(this);
3.   let filePath = contextFaker.filesDir + '/exampleKnock1.jpg';
4.   let shareData: systemShare.SharedData = new systemShare.SharedData({
5.     utd: utd.UniformDataType.HYPERLINK,
6.     content: 'https://sharekitdemo.drcn.agconnect.link/ZB3p',
7.     // 根据title,description,thumbnailUri会生成不同的卡片模板，具体可参考配套卡片模板章节。
8.     thumbnailUri: fileUri.getUriFromPath(filePath),
9.     title: '碰一碰分享卡片标题',
10.     description: '碰一碰分享卡片描述'
11.   });
12.   sharableTarget.share(shareData);
13. }
15. private immersiveListening() {
16.   harmonyShare.on('knockShare', this.immersiveCallback);
17. }
19. private immersiveDisablingListening() {
20.   harmonyShare.off('knockShare', this.immersiveCallback);
21. }

复制代码

• 进入可分享页面时，注册碰一碰分享监听事件；离开可分享页面（包括应用退至后台等场景）时，取消碰一碰分享监听事件。
  

1. // Entry Component 代码片段
2. onPageHide(): void {
3.   let context = getContext(this);
4.   context.eventHub.emit('onBackGround');
5. }
7. aboutToAppear(): void {
8.   this.immersiveListening();
9.   let context = getContext(this);
10.   context.eventHub.on('onBackGround', this.onBackGround);
11. }
13. aboutToDisappear(): void {
14.   this.immersiveDisablingListening();
15.   let context = getContext(this);
16.   context.eventHub.on('onBackGround', this.onBackGround);
17. }
19. private onBackGround() {
20.   this.immersiveDisablingListening();
21. }

复制代码

完整示例代码请参见：碰一碰分享示例代码。
了解更多详情>>
访问分享服务官网
获取碰一碰分享开发指导文档

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！