HarmonyOS 鸿蒙Next基于“碰一碰”的社交信息分享功能开发

一、前言

随着HarmonyOS NEXT正式面向开发者开放，鸿蒙原生应用的生态正加速构建。作为新一代全场景操作系统，HarmonyOS NEXT 支持更深度的软硬协同，尤其在近场通信（NFC）、多端流转和原子化服务方面表现突出。本文将通过实战开发的经历，带领大家快速上手“碰一碰”社交信息分享功能的开发，帮助开发者理解其应用场景、实现原理及落地方式。

二、功能简介：什么是“碰一碰”分享？

“碰一碰”是一种基于**近场通信（NFC）和设备唯一标识（UDID）**的鸿蒙特色交互方式。在社交场景中，两台设备在接触后，即可自动完成名片、微信号、邮箱、手机号等信息的共享。

应用场景举例：

• 线下会议、沙龙快速交换联系方式；
• 校园内社交拓展；
• 创业团队展示社交身份页；
• 原子化名片分享。

三、技术方案

1. 核心能力概览

2. 项目结构设计

/entry
├── src
│   ├── main/ets
│   │   ├── pages/SharePage.ets  // 信息展示页面
│   │   ├── pages/WriteNFC.ets  // NFC写入页面
│   │   ├── pages/ReadNFC.ets  // NFC读取页面
│   │   └── common/UserInfoModel.ets // 用户数据结构
│   └── main/resources
│       └── base/profile/abilities.json

四、关键代码解析

1. 设备碰一碰触发逻辑

import nfc from '@ohos.nfc.tag';
import { UserInfo } from '../common/UserInfoModel'

@Component
struct WriteNFC {
  private userInfo: UserInfo = {
    name: '鹏',
    phone: '155****7505',
    email: '64*****02@163.com',
    wechat: 'Peng'
  }

  async writeTag() {
    try {
      const tag = await nfc.connectTag();
      await tag.writeNdefMessage(JSON.stringify(this.userInfo));
      console.info('用户信息写入成功');
    } catch (error) {
      console.error('NFC写入失败:', error);
    }
  }
}

2. 读取并跳转展示页面

async function readTagAndNavigate() {
  try {
    const tag = await nfc.connectTag();
    const ndefMessage = await tag.readNdefMessage();
    const userInfo = JSON.parse(ndefMessage);

    router.pushUrl({
      url: 'pages/SharePage',
      params: {
        name: userInfo.name,
        phone: userInfo.phone,
        email: userInfo.email,
        wechat: userInfo.wechat
      }
    });
  } catch (err) {
    console.error('读取NFC失败:', err);
  }
}

3. 信息展示 UI

@Component
struct SharePage {
  @State name: string = '';
  @State phone: string = '';
  @State email: string = '';
  @State wechat: string = '';

  build() {
    Column() {
      Text(`姓名：${this.name}`)
      Text(`电话：${this.phone}`)
      Text(`邮箱：${this.email}`)
      Text(`微信：${this.wechat}`)
    }
    .padding(20)
  }
}

五、下面是我在开发过程中遇到过的一些问题

1. NFC权限申请与能力声明不规范

问题现象：NFC功能调试无响应，控制台无报错或直接崩溃。

原因分析：

• HarmonyOS NEXT 对硬件能力限制严格，未在配置文件中正确声明 ohos.permission.MANAGE_SECURE_SETTINGS 和 NFC 使用权限。
• 未在 module.json5 中添加 NFC ability。

解决方案：

"reqPermissions": [
  { "name": "ohos.permission.MANAGE_SECURE_SETTINGS" },
  { "name": "ohos.permission.TRANSMIT_SECURE_NFC" }
]

同时在 abilities.json 中声明 NFC 模块能力。

2. 不同设备 NFC 接口响应时间差异

问题现象：某些设备碰一碰后反应时间慢，甚至识别不到。

原因分析：

• 华为不同设备（如Mate 40、Pura 70）NFC硬件响应不同；
• 未添加 onTagDiscovered 的监听优化机制。

优化建议： 使用 nfc.on('tagDiscovered', callback) 替代主动轮询方式，减少等待时间，提高用户体验。

3. NDEF数据格式不统一，跨平台解析失败

问题现象：写入的数据在其他平台（如安卓）读取乱码或读取失败。

原因分析：

• 未使用标准的NDEF格式封装文本；
• JSON写入时未指定MIME类型。

正确写入方式示例：

await tag.writeNdefMessage({
  records: [{
    typeNameFormat: nfc.TypeNameFormat.MIME_MEDIA,
    mediaType: 'application/json',
    payload: JSON.stringify(this.userInfo)
  }]
})

4. 安全问题：被动读取信息风险高

问题描述：未经用户授权即读取名片信息，存在隐私风险。

解决方案：

• 添加读取确认弹窗：

Prompt.showDialog({
  message: "是否允许读取对方名片？",
  buttons: ["允许", "拒绝"]
});

• 或采用加密写入方式，在NFC中仅存储token，社交信息由云端接口拉取。

5. UIAbility页面跳转参数异常

问题现象：读取页面跳转时，接收不到参数或参数为null。

原因分析：

• 在 router.pushUrl() 中未使用正确的 params 结构；
• 页面组件未使用 @State 或 @Prop 绑定参数。

优化建议： 确保传参方式如下：

router.pushUrl({
  url: 'pages/SharePage',
  params: { name, phone, email }
});

目标页面用 @Prop 获取：

@Prop name: string;

六、功能拓展建议

• 接入HarmonyOS的分布式能力，实现碰一碰后直接跳转到好友聊天页面。
• 利用原子服务卡片展示用户名片信息，实现零安装交互。
• 添加扫码功能作为辅助方式，适配没有NFC的设备。

七、结语

“碰一碰”功能体现了鸿蒙在软硬件协同上的领先优势，开发门槛不高，但体验独特。在HarmonyOS NEXT原生应用的生态下，这类创新交互将成为差异化竞争的重要砝码。希望本篇文章能帮助更多开发者快速实现社交信息分享功能，深入理解鸿蒙原生开发的魅力