// Package grpc 将 room-service 领域服务适配成 protobuf gRPC 接口。 package grpc import ( "context" roomv1 "hyapp.local/api/proto/room/v1" "hyapp/pkg/appcode" "hyapp/pkg/xerr" roomservice "hyapp/services/room-service/internal/room/service" ) // Server 把 room-service 领域实现挂到 gRPC 接口上。 type Server struct { // UnimplementedRoomCommandServiceServer 提供未实现 RPC 的标准 gRPC 返回。 roomv1.UnimplementedRoomCommandServiceServer // UnimplementedRoomGuardServiceServer 提供守卫服务未实现 RPC 的标准 gRPC 返回。 roomv1.UnimplementedRoomGuardServiceServer // UnimplementedRoomQueryServiceServer 提供查询服务未实现 RPC 的标准 gRPC 返回。 roomv1.UnimplementedRoomQueryServiceServer // svc 是领域服务入口,gRPC 层不保存任何房间状态。 svc *roomservice.Service } // NewServer 创建一个可注册到 gRPC 的 room server。 func NewServer(svc *roomservice.Service) *Server { return &Server{svc: svc} } // mapServiceResult 把领域错误固定转换为 gRPC status + ErrorInfo.reason。 // gateway 只认识传输层 gRPC 错误;如果这里直接透传 *xerr.Error,grpc-go 会降级成 Unknown, // gateway 就无法恢复 INVALID_ARGUMENT/NOT_FOUND 等业务 reason,最终只能错误地返回 INTERNAL_ERROR。 func mapServiceResult[T any](result T, err error) (T, error) { if err != nil { var zero T return zero, xerr.ToGRPCError(err) } return result, nil } // CreateRoom 代理到领域服务。 func (s *Server) CreateRoom(ctx context.Context, req *roomv1.CreateRoomRequest) (*roomv1.CreateRoomResponse, error) { // 创建房间会获取 Redis lease、写 MySQL meta/command/outbox/snapshot,并安装本地 Cell。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.CreateRoom(ctx, req)) } // JoinRoom 代理到领域服务。 func (s *Server) JoinRoom(ctx context.Context, req *roomv1.JoinRoomRequest) (*roomv1.JoinRoomResponse, error) { // JoinRoom 只维护 room-service presence,真实消息连接由腾讯云 IM SDK 处理。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.JoinRoom(ctx, req)) } // RoomHeartbeat 代理到领域服务。 func (s *Server) RoomHeartbeat(ctx context.Context, req *roomv1.RoomHeartbeatRequest) (*roomv1.RoomHeartbeatResponse, error) { // 心跳只刷新已有业务 presence,不能隐式创建进房状态。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.RoomHeartbeat(ctx, req)) } // LeaveRoom 代理到领域服务。 func (s *Server) LeaveRoom(ctx context.Context, req *roomv1.LeaveRoomRequest) (*roomv1.LeaveRoomResponse, error) { // LeaveRoom 不直接操作腾讯云 IM 连接,只修改房间业务态。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.LeaveRoom(ctx, req)) } // CloseRoom 代理到领域服务。 func (s *Server) CloseRoom(ctx context.Context, req *roomv1.CloseRoomRequest) (*roomv1.CloseRoomResponse, error) { // CloseRoom 统一关闭房间生命周期、清理 presence/麦位并写出系统事件。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.CloseRoom(ctx, req)) } // MicUp 代理到领域服务。 func (s *Server) MicUp(ctx context.Context, req *roomv1.MicUpRequest) (*roomv1.MicUpResponse, error) { // 麦位修改由 Room Cell 串行执行,gRPC 层不做状态判断。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.MicUp(ctx, req)) } // MicDown 代理到领域服务。 func (s *Server) MicDown(ctx context.Context, req *roomv1.MicDownRequest) (*roomv1.MicDownResponse, error) { // 下麦结果会进入 command log 和 outbox,失败不产生部分状态。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.MicDown(ctx, req)) } // ChangeMicSeat 代理到领域服务。 func (s *Server) ChangeMicSeat(ctx context.Context, req *roomv1.ChangeMicSeatRequest) (*roomv1.ChangeMicSeatResponse, error) { // 换位在领域层原子修改源麦位和目标麦位。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.ChangeMicSeat(ctx, req)) } // ConfirmMicPublishing 代理到领域服务。 func (s *Server) ConfirmMicPublishing(ctx context.Context, req *roomv1.ConfirmMicPublishingRequest) (*roomv1.ConfirmMicPublishingResponse, error) { // 发流确认必须进入 Room Cell 串行状态机,避免旧 RTC 事件覆盖新 mic_session。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.ConfirmMicPublishing(ctx, req)) } // ApplyRTCEvent 代理到领域服务。 func (s *Server) ApplyRTCEvent(ctx context.Context, req *roomv1.ApplyRTCEventRequest) (*roomv1.ApplyRTCEventResponse, error) { // 腾讯 RTC 回调已在 gateway 验签;房间状态变化仍必须由 Room Cell 串行提交。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.ApplyRTCEvent(ctx, req)) } // SetMicSeatLock 代理到领域服务。 func (s *Server) SetMicSeatLock(ctx context.Context, req *roomv1.SetMicSeatLockRequest) (*roomv1.SetMicSeatLockResponse, error) { // 锁麦权限和目标麦位状态由 Room Cell 判定。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.SetMicSeatLock(ctx, req)) } // SetChatEnabled 代理到领域服务。 func (s *Server) SetChatEnabled(ctx context.Context, req *roomv1.SetChatEnabledRequest) (*roomv1.SetChatEnabledResponse, error) { // 公屏开关是 room-service 发言守卫的权威状态。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.SetChatEnabled(ctx, req)) } // SetRoomAdmin 代理到领域服务。 func (s *Server) SetRoomAdmin(ctx context.Context, req *roomv1.SetRoomAdminRequest) (*roomv1.SetRoomAdminResponse, error) { // 管理员集合只能由 room-service 权限矩阵修改。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.SetRoomAdmin(ctx, req)) } // TransferRoomHost 代理到领域服务。 func (s *Server) TransferRoomHost(ctx context.Context, req *roomv1.TransferRoomHostRequest) (*roomv1.TransferRoomHostResponse, error) { // 主持人转移由 Room Cell 串行提交,并进入 command log/outbox。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.TransferRoomHost(ctx, req)) } // MuteUser 代理到领域服务。 func (s *Server) MuteUser(ctx context.Context, req *roomv1.MuteUserRequest) (*roomv1.MuteUserResponse, error) { // 禁言状态是腾讯云 IM 发言回调的权威来源。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.MuteUser(ctx, req)) } // KickUser 代理到领域服务。 func (s *Server) KickUser(ctx context.Context, req *roomv1.KickUserRequest) (*roomv1.KickUserResponse, error) { // 踢人会修改 presence、ban 集合和麦位占用。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.KickUser(ctx, req)) } // UnbanUser 代理到领域服务。 func (s *Server) UnbanUser(ctx context.Context, req *roomv1.UnbanUserRequest) (*roomv1.UnbanUserResponse, error) { // 解封只解除 ban,不恢复 presence、管理员身份或麦位。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.UnbanUser(ctx, req)) } // SendGift 代理到领域服务。 func (s *Server) SendGift(ctx context.Context, req *roomv1.SendGiftRequest) (*roomv1.SendGiftResponse, error) { // SendGift 先同步扣费,成功后才更新房间热度和本地榜。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.SendGift(ctx, req)) } // CheckSpeakPermission 代理到领域服务。 func (s *Server) CheckSpeakPermission(ctx context.Context, req *roomv1.CheckSpeakPermissionRequest) (*roomv1.CheckSpeakPermissionResponse, error) { // 外部 IM 发公屏前调用该守卫,避免复制禁言和房间状态规则。 ctx = appcode.WithContext(ctx, req.GetAppCode()) return mapServiceResult(s.svc.CheckSpeakPermission(ctx, req)) } // VerifyRoomPresence 代理到领域服务。 func (s *Server) VerifyRoomPresence(ctx context.Context, req *roomv1.VerifyRoomPresenceRequest) (*roomv1.VerifyRoomPresenceResponse, error) { // 外部 IM 进群前调用该守卫,防止未进房或被踢用户收消息。 ctx = appcode.WithContext(ctx, req.GetAppCode()) return mapServiceResult(s.svc.VerifyRoomPresence(ctx, req)) } // ListRooms 代理到 room-service 列表读模型。 func (s *Server) ListRooms(ctx context.Context, req *roomv1.ListRoomsRequest) (*roomv1.ListRoomsResponse, error) { // 列表查询只读 MySQL 投影,不扫描 Room Cell 内存集合。 ctx = contextWithMetaApp(ctx, req.GetMeta()) return mapServiceResult(s.svc.ListRooms(ctx, req)) } func contextWithMetaApp(ctx context.Context, meta *roomv1.RequestMeta) context.Context { if meta == nil { return appcode.WithContext(ctx, "") } return appcode.WithContext(ctx, meta.GetAppCode()) }