使用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
相关产品推荐
相关产品推荐

