最佳特性碰一碰| 手机碰一下PC1秒建立跨设备连接甲方直接给500块奖金开篇我差点因为造轮子被开除去年刚进公司帮甲方做跨设备文档编辑器甲方要求手机写文档平板秒更我当时脑子抽了自己用WebSocket写个软总线不就行结果上线第3天客服被骂炸了“我在手机上打了100字平板上半天才显示50字”“我换了个WiFi直接断连了”“华为手机连小米平板根本搜不到设备”甲方老板当天就找我谈话“小张你要是不会用鸿蒙的软总线我找别人做了啊”我当时差点哭出来——原来鸿蒙早就把跨设备通信的坑踩完了我自己造轮子纯纯是没事找事。软总线到底是啥人话版解释官方说软总线是分布式设备的通信基础设施我给你翻译软总线 自动找设备 稳定连设备 快速传数据 绝对防偷看就这4个功能你自己造轮子造到死也造不完直接用就行。我把它拆成4个步骤每个步骤都给你我踩过的坑能用的代码1. 自动找设备你得先知道对象在哪手机上的APP想跟平板通信第一步得找到平板。鸿蒙的软总线会自动帮你扫附近的设备但是我第一次写的时候设备列表全是空的查了3小时才知道两个坑俩设备必须登同一个华为账号别问问就是我登了俩不同的账号傻了俩设备必须开多设备协同设置→更多连接→多设备协同默认是关的能用的代码别抄错// 1. 引入依赖别漏漏了直接报错import{deviceManager}fromohos.distributedDeviceManager;// 2. 创建设备管理器参数是你的应用包名比如com.example.myappletdmInstancedeviceManager.createDeviceManager(com.example.myapp);// 3. 监听设备发现别用Promise用Event不然会漏设备dmInstance.on(deviceFound,(deviceList){deviceList.forEach(device{// 打印设备名比如老张的MatePad Proconsole.log(找到设备${device.deviceName}ID是${device.deviceId});// 存到全局变量后面连的时候要用deviceIdglobalThis.targetDeviceIddevice.deviceId;});});// 4. 开始扫描参数是扫描时长10秒就行别太长费电dmInstance.discoverDevices(10000,{// 扫描类型0是所有设备1是仅可信设备建议用1安全scanType:1,// 过滤条件比如只扫平板filter:{deviceType:2}// 1是手机2是平板3是PC});2. 稳定连设备找到对象后得谈恋爱找到设备后要建立连接。鸿蒙的软总线有2种连接方式我第一次全用错了连接类型适用场景我踩的坑会话连接Session实时通信比如文档协作、语音通话我第一次用了字节流传实时数据延迟300ms甲方说卡得像PPT字节流连接Stream大文件传输比如视频、压缩包我第一次用了会话传1G视频直接崩了内存爆了能用的代码会话连接适合跨设备文档// 1. 引入依赖import{session}fromohos.distributedSession;// 2. 创建会话参数是会话名必须唯一比如docEditSession_张三的文档letsessionInstancesession.createSession(docEditSession_zhangsan);// 3. 监听连接状态必须加不然断连了都不知道sessionInstance.on(sessionDisconnected,(){console.log(连接断了开始重连...);// 重连逻辑后面讲});// 4. 连接到目标设备参数是设备ID会话名sessionInstance.connect({deviceId:globalThis.targetDeviceId,// 从第一步存的sessionName:docEditSession_zhangsan// 和创建时的会话名一致}).then((){console.log(连接成功甲方不会骂我了);// 开始传数据sessionInstance.sendData(newUint8Array([1,2,3]));}).catch(err{console.error(连接失败,err.message);// 我第一次报错权限不足要在module.json5里加权限后面讲});必加的权限module.json5里加别漏requestPermissions: [ { name: ohos.permission.DISTRIBUTED_DATASYNC, reason: 用于跨设备同步文档数据, usedScene: { abilities: [EntryAbility], when: inuse // 仅在前台用的时候申请别用always会被拒审 } } ]我第一次没加这个权限连接一直报Permission denied查了2小时才找到原因纯纯是被官方文档坑了——文档没说要加这个权限3. 快速传数据别用快递用闪送鸿蒙软总线的传输速度是真的快我实测同一WiFi下1G视频12秒传完USB是10秒差不离跨路由1G视频25秒传完比蓝牙快10倍碰一碰NFC触发软总线1G视频10秒传完和USB一样快碰一碰的实现代码核心卖点别漏碰一碰是鸿蒙的黑科技手机碰一下PC或者平板NFC触发软总线自动连接不用输密码不用开蓝牙1秒连好。实现步骤手机APP注册NFC标签监听手机碰PC的NFC标签PC背面有个NFC贴纸淘宝10块钱10张NFC标签里存的是PC的设备ID手机拿到后自动用软总线连接// 1. 引入NFC依赖import{nfcController}fromohos.nfcController;// 2. 注册NFC监听在EntryAbility的onCreate里加nfcController.on(nfcTagDiscovered,(tag){console.log(发现NFC标签);// 读取标签里的PC设备ID标签里存的是JSON比如{deviceId:123456}lettagDatatag.ndefMessage.getRecords()[0].payload.toString();letpcDeviceIdJSON.parse(tagData).deviceId;// 直接用软总线连接跳过了扫描设备的步骤sessionInstance.connect({deviceId:pcDeviceId,sessionName:docEditSession_zhangsan}).then((){console.log(碰一碰连接成功甲方给我发500块奖金了);});});我帮甲方实现这个功能后甲方直接给我发了500块红包——说这个功能是卖点能吸引企业客户。4. 安全防偷看别给绿帽留机会鸿蒙软总线默认用AES-256加密而且是双向认证你传的数据只有目标设备能看别人就算抓包也只能看到乱码不用你写加密代码鸿蒙帮你搞定我测过的安全场景用Charles抓包软总线的数据全是乱码根本看不懂用另一个手机伪造设备ID连接失败提示设备不被信任用黑客工具暴力破解破解100年也破不开AES-256软总线 vs 其他跨设备通信方式别再瞎用了我做了个对比表你直接看特性鸿蒙软总线蓝牙WiFi DirectNFC我自己造的轮子废了自动找设备✅❌要手动配对✅❌要碰❌要扫IP自动连设备✅❌要输密码❌✅❌要握手传输速度高1G/s低10M/s中100M/s极低1M/s低我写的烂传输距离远50米近5米远50米极近1厘米远但卡安全加密✅AES-256❌❌❌❌跨设备类型所有鸿蒙设备所有蓝牙设备所有WiFi设备所有NFC设备所有有网的设备开发成本低直接用中要调协议高要写驱动低极高我花了2周甲方满意指数⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐被骂结论只要你做的是鸿蒙应用直接用软总线别瞎折腾其他的不然像我一样差点被开除。我踩的3个大坑帮你省3天时间坑1设备列表空原因俩设备没登同一个华为账号或者没开多设备协同解决让用户登同一个账号开多设备协同设置里搜多设备协同坑2连接报权限不足原因没加ohos.permission.DISTRIBUTED_DATASYNC权限解决在module.json5里加这个权限并且在代码里动态申请用abilityAccessCtrl坑3传大文件崩了原因用会话传大文件内存爆了解决用字节流传大文件并且分片比如100M一片别全读进内存分片传文件的代码别抄错// 1. 引入文件依赖import{fileIo}fromohos.file.fs;// 2. 打开文件letfilefileIo.openSync(/data/local/tmp/bigVideo.mp4,fileIo.OpenMode.READ_ONLY);letfileSizefileIo.statSync(file.fd).size;// 3. 分片每片10MconstCHUNK_SIZE10*1024*1024;letoffset0;while(offsetfileSize){// 读一片数据letchunknewUint8Array(CHUNK_SIZE);fileIo.readSync(file.fd,chunk,{offset:offset});// 发送一片sessionInstance.sendData(chunk);// 移动偏移量offsetchunk.length;console.log(已传${offset/1024/1024}M /${fileSize/1024/1024}M);}// 4. 传完关文件fileIo.closeSync(file);console.log(传完了甲方不会骂我了);总结一下给你画个思维导图是否跨设备通信需求是鸿蒙应用直接用软总线找设备deviceManager连设备session传数据sendData/sendStream加权限DISTRIBUTED_DATASYNC用蓝牙/WiFi Direct自己造轮子别最后说句掏心窝子的我之前总觉得自己造轮子牛逼结果差点被开除——鸿蒙已经把跨设备的坑踩完了你直接用就行别没事找事。软总线是鸿蒙的核心后面做跨设备应用比如跨设备文档、跨设备游戏、跨设备智能家居全要用到它。你要是这篇有疑问评论区问我我看到了就回虽然我经常加班但摸鱼的时候还是会看的。下一篇讲ArkTS语言——别把它当TS用我之前因为用TS的语法写ArkTS编译报错报了2天纯纯是被坑了。我是老张被甲方虐了5年的架构师。点个关注少踩点坑。