You need to enable JavaScript to run this app. 使用agora.io开发时如何向房间内远程用户发送用户信息元数据
优惠活动
大模型
产品
解决方案
定价
更多

使用agora.io开发时如何向房间内远程用户发送用户信息元数据

解决方案

声网的音视频回调仅返回音视频通道内的唯一标识uid,不会携带业务侧的自定义用户信息,你可以通过以下两种成熟方案实现自定义用户信息同步:

方案1:使用Agora RTM 实时消息通道同步

  • 加入音视频房间的同时,加入同ID对应的RTM消息频道
  • 本地用户进房成功后,将自身的Firebase uid、头像、昵称等信息打包为JSON,通过RTM频道广播给所有在房用户
  • 房间内用户收到广播消息后,建立「声网uid - 业务用户信息」的本地映射表,后续收到userJoined回调时直接拿uid从映射表中取对应信息渲染即可
  • 优化点:新用户进房后可主动发送一次全量信息拉取请求,已在房用户收到后各自上报自身信息,避免新用户无法获取进房前的用户数据

示例代码:

// 本地进房成功后广播自身信息
Future<void> broadcastUserInfo() async {
  final info = jsonEncode({
    "agoraUid": localAgoraUid,
    "firebaseUid": currentUser.uid,
    "avatar": currentUser.photoURL,
    "nickname": currentUser.displayName
  });
  await rtmChannel.sendMessage(RtmMessage.fromText(info));
}

// 监听频道消息更新本地映射
rtmChannel.onMessageReceived = (RtmMessage msg, RtmMember sender) {
  final userInfo = jsonDecode(msg.text);
  int agoraUid = userInfo["agoraUid"];
  userInfoCache[agoraUid] = userInfo;
  setState(() {});
};

方案2:通过Firebase Firestore/实时数据库同步

  • 每个声网房间对应Firestore里的一个房间文档,新增room_members子集合存储当前在房成员信息,文档ID用声网uid
  • 本地用户进房成功后,往对应房间的room_members集合写入自身的业务信息
  • 监听该子集合的实时变更,自动同步成员信息到本地,用户退房时自动删除对应文档即可
  • 可配合Firebase安全规则限制只有在房用户可读写对应集合数据,无需额外开发后端接口

示例代码:

// 进房后写入自身信息到Firestore
Future<void> addSelfToRoom(String roomId) async {
  final memberRef = FirebaseFirestore.instance
      .collection("rooms")
      .doc(roomId)
      .collection("members")
      .doc(localAgoraUid.toString());
  await memberRef.set({
    "firebaseUid": currentUser.uid,
    "avatar": currentUser.photoURL,
    "nickname": currentUser.displayName,
    "isMuted": false,
    "joinTime": FieldValue.serverTimestamp()
  });
}

// 监听房间成员变化
Stream<QuerySnapshot> watchRoomMembers(String roomId) {
  return FirebaseFirestore.instance
      .collection("rooms")
      .doc(roomId)
      .collection("members")
      .snapshots();
}

方案选型建议

  • 用户进出频繁、对信息同步延迟要求高的场景选RTM方案
  • 需要持久化房间数据、配合实现麦位管理/举手统计等复杂业务逻辑的场景选Firestore方案,开发成本更低

内容的提问来源于stack exchange,提问作者Saurabh

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.17 11:54:05