文章目录前言碰一碰到底干了什么普通分享 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}fromkit.ShareKit;import{common}fromkit.AbilityKit;asyncfunctionshareNoteToTablet(context:common.UIAbilityContext,noteContent:string){// 构造分享内容constshareData:shareKit.SharedDatanewshareKit.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,};// 创建分享控制器并发起constcontrollernewshareKit.ShareController(context,shareData);try{awaitcontroller.share(shareOptions);console.info(精准分享发起成功);}catch(err){console.error(分享失败:,JSON.stringify(err));}}这里关键是ShareMode.PRECISE告诉系统我们要走精准分享通道不是普通的系统分享面板。平板端接收与窗口识别平板端需要注册为精准分享的接收方。在EntryAbility里处理接收回调import{shareKit}fromkit.ShareKit;import{window}fromkit.ArkUI;exportdefaultclassEntryAbilityextendsUIAbility{onCreate(want:Want,launchParam:AbilityConstant.LaunchParam):void{// 注册精准分享接收回调this.registerPreciseShareReceiver();}privateregisterPreciseShareReceiver():void{shareKit.on(preciseShareReceive,async(event:shareKit.PreciseShareEvent){// 系统已经通过触碰坐标识别出目标窗口consttargetWindowevent.targetWindow;consttouchPointevent.touchPoint;console.info(目标窗口ID:${targetWindow.windowId});console.info(触碰坐标: (${touchPoint.x},${touchPoint.y}));// 获取分享内容constsharedDataevent.sharedData;constrecordssharedData.getRecords();for(constrecordofrecords){constcontentrecord.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:Recordstring,number{};StateeditorContent:string;privatecontroller:TextInputControllernewTextInputController();build(){Column(){TextArea({text:this.editorContent,placeholder:在这里编辑笔记...}).controller(this.controller).width(100%).height(80%).onChange((value:string){this.editorContentvalue;}).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.insertedNotethis.insertedNote!){this.editorContent\nthis.insertedNote;this.insertedNote;// 清空避免重复插入}},200);}}实际项目中建议用Watch装饰器代替setInterval这里为了演示简单直接。踩坑记录碰一碰分享有几个容易忽略的点NFC 权限弹窗。第一次触发时系统会弹 NFC 权限请求如果用户在弹窗期间就拿开了设备分享会直接失败。建议在 UI 上给用户一个请将设备靠近的提示别让用户一脸懵。窗口坐标在多窗口场景下会飘。如果你的应用支持分屏或自由窗口触碰坐标映射可能不准。最好在preciseShareReceive回调里先校验targetWindow是不是你期望的那个页面。大内容走 NFC 很慢。NFC 本身带宽很小实际传输走的是 Wi-Fi 直连。但如果你的分享内容超过 10MB建议只传引用比如文件 URI让接收端自己去拉文件。一些感想精准分享的用户体验确实惊艳碰一下内容就飞过去了。但这个功能对硬件有要求——两台设备都得有 NFC而且得是 HarmonyOS 7 及以上版本。如果你的应用目标用户不一定都有最新的鸿蒙设备建议同时保留普通分享的降级方案。在我们的智能助手里如果检测到对端不支持精准分享会自动 fallback 到华为分享的传统模式。下篇咱们聊聊星盾安全体系给智能助手接入机密风控引擎。