HarmonyOS7 碰一碰为什么顺手？跨设备内容流转实战-洪萨配资

文章目录

- 前言
- 碰一碰到底干了什么
- 普通分享 vs 精准分享
- 在智能助手里接入精准分享
- - 配置权限
  - 发起分享
  - 平板端接收与窗口识别
  - UI 层响应插入
- 踩坑记录
- 一些感想

前言

上篇咱们聊了分布式数据同步，有朋友问：用户想主动把内容"甩"到另一台设备上怎么办？HarmonyOS 7 给了一个特别直觉的方案——碰一碰·精准分享。今天就在智能生活助手里把它跑通。

碰一碰到底干了什么

你可能用过华为分享，两台设备碰一下就能传文件。但"精准分享"比普通分享多了一个关键能力：它知道你要往哪个窗口的哪个位置插入内容。

原理其实不复杂。设备 A 通过 NFC 触碰设备 B，系统同时拿到两个信息：

NFC 建立的连接通道（用于传输）

设备 B 触碰点的屏幕坐标（用于定位目标窗口）

系统根据这个坐标，自动识别出用户触碰的是哪个应用窗口、窗口里的哪个区域，然后把素材精准地"塞"进去。

普通分享 vs 精准分享

普通分享就像发邮件——你选好内容，选一个目标应用，发过去，对方应用自己决定怎么处理。

精准分享更像"拖拽"——你碰一下对方的屏幕，内容直接出现在你碰的那个位置。用户不需要在目标设备上做任何操作，体验上跟隔空投送完全不是一个量级。

从开发者角度看，两者的区别也很明显。普通分享走的是系统分享面板，你得处理Want里的各种 mimeType，对方应用还得实现ShareExtension。精准分享则简单很多，系统帮你把窗口匹配和内容定位都做了，你只需要处理"收到了什么内容"和"插到哪个位置"这两件事。

还有一点容易被忽略：精准分享支持"多窗口精准投递"。如果你的平板上同时开了两个笔记窗口，用户碰哪个窗口，内容就进哪个窗口。普通分享做不到这种粒度，它只能选一个应用，没法选到具体窗口。

在智能助手里接入精准分享

我们的场景是这样的：用户在手机上编辑了一条购物清单笔记，走到平板前面碰一下，笔记内容直接出现在平板上正在打开的笔记编辑区域。

配置权限

先在 module.json5 里声明碰一碰需要的权限：

{"module":{"requestPermissions":[{"name":"ohos.permission.NEARBY_SERVICE","reason":"$string:nearby_reason"},{"name":"ohos.permission.DISTRIBUTED_DATASYNC"}]}}

发起分享

手机端这边，核心是调用ShareKit发起一个精准分享请求。用户点击"碰一碰分享"按钮时触发：

import{shareKit}from'@kit.ShareKit';import{common}from'@kit.AbilityKit';asyncfunctionshareNoteToTablet(context:common.UIAbilityContext,noteContent:string){// 构造分享内容constshareData:shareKit.SharedData=newshareKit.SharedData();awaitshareData.addRecord({contentType:'text/plain',uri:'',extraData:{'content':noteContent,'source':'smart_life_assistant'}});// 配置精准分享参数constshareOptions:shareKit.ShareOptions={shareMode:shareKit.ShareMode.PRECISE,// 精准分享模式previewMode:shareKit.PreviewMode.DEFAULT,};// 创建分享控制器并发起constcontroller=newshareKit.ShareController(context,shareData);try{awaitcontroller.share(shareOptions);console.info('精准分享发起成功');}catch(err){console.error('分享失败:',JSON.stringify(err));}}

这里关键是ShareMode.PRECISE，告诉系统我们要走精准分享通道，不是普通的系统分享面板。

平板端接收与窗口识别

平板端需要注册为精准分享的接收方。在EntryAbility里处理接收回调：

import{shareKit}from'@kit.ShareKit';import{window}from'@kit.ArkUI';exportdefaultclassEntryAbilityextendsUIAbility{onCreate(want:Want,launchParam:AbilityConstant.LaunchParam):void{// 注册精准分享接收回调this.registerPreciseShareReceiver();}privateregisterPreciseShareReceiver():void{shareKit.on('preciseShareReceive',async(event:shareKit.PreciseShareEvent)=>{// 系统已经通过触碰坐标识别出目标窗口consttargetWindow=event.targetWindow;consttouchPoint=event.touchPoint;console.info(`目标窗口ID:${targetWindow.windowId}`);console.info(`触碰坐标: (${touchPoint.x},${touchPoint.y})`);// 获取分享内容constsharedData=event.sharedData;constrecords=sharedData.getRecords();for(constrecordofrecords){constcontent=record.extraData?.['content']asstring;if(content){// 将内容插入到目标窗口的光标位置awaitthis.insertContentAtPosition(content,touchPoint);}}});}privateasyncinsertContentAtPosition(content:string,point:shareKit.TouchPoint){// 通过 AppStorage 通知 UI 层插入内容AppStorage.setOrCreate('insertedNote',content);AppStorage.setOrCreate('insertPosition',{x:point.x,y:point.y});}}

系统自动根据触碰坐标算出了targetWindow和touchPoint，我们拿到后直接处理就行，不用自己去算坐标映射。

UI 层响应插入

平板端的笔记编辑页面，监听 AppStorage 的变化来完成内容插入：

@Componentstruct NoteEditorPage{@StorageLink('insertedNote')insertedNote:string='';@StorageLink('insertPosition')insertPos:Record<string,number>={};@StateeditorContent:string='';privatecontroller:TextInputController=newTextInputController();build(){Column(){TextArea({text:this.editorContent,placeholder:'在这里编辑笔记...'}).controller(this.controller).width('100%').height('80%').onChange((value:string)=>{this.editorContent=value;}).fontSize(16)if(this.insertedNote!==''){Text('来自手机的笔记已插入').fontSize(12).fontColor('#666').margin({top:8})}}.width('100%').height('100%').onAppear(()=>{// 监听精准分享插入的内容this.watchInsertedNote();})}privatewatchInsertedNote():void{// 当 insertedNote 有值时，追加到编辑器setInterval(()=>{if(this.insertedNote&&this.insertedNote!==''){this.editorContent+='\n'+this.insertedNote;this.insertedNote='';// 清空，避免重复插入}},200);}}