77 lines
6.5 KiB
Go
77 lines
6.5 KiB
Go
package store
|
||
|
||
import (
|
||
"context"
|
||
|
||
"telesrv/internal/domain"
|
||
)
|
||
|
||
// GroupCallStore 持久化群通话信令真值（memory/postgres 双实现，行为契约由
|
||
// 共享 contract test 钉死；version 单调性见 domain/groupcall.go 注释）。
|
||
type GroupCallStore interface {
|
||
// CreateGroupCall 建会；同频道已有活跃通话返回 domain.ErrGroupCallAlreadyStarted。
|
||
CreateGroupCall(ctx context.Context, call domain.GroupCall) (domain.GroupCall, error)
|
||
// CreateConferenceCall 建 ad-hoc conference；同一 creator+random_id 幂等返回既有活跃会。
|
||
CreateConferenceCall(ctx context.Context, call domain.GroupCall) (domain.GroupCall, error)
|
||
GetGroupCall(ctx context.Context, callID int64) (domain.GroupCall, bool, error)
|
||
GetGroupCallBySlug(ctx context.Context, slug string) (domain.GroupCall, bool, error)
|
||
GetGroupCallByInviteMessage(ctx context.Context, userID int64, msgID int) (domain.GroupCall, domain.GroupCallInvite, bool, error)
|
||
// JoinGroupCall 加入/重进（同主键 upsert 换新 ssrc）；ssrc 与他人撞活跃唯一
|
||
// 约束返回 domain.ErrGroupCallSSRCDuplicate；version++。
|
||
JoinGroupCall(ctx context.Context, req domain.JoinGroupCallRequest) (domain.GroupCallMutation, error)
|
||
// LeaveGroupCall 置 left+version++；conference 最后一名活跃参与者离开时同步转
|
||
// discarded，普通 channel group call 允许空房间继续 active；未在会返回
|
||
// domain.ErrGroupCallNotJoined。
|
||
LeaveGroupCall(ctx context.Context, callID, userID int64, now int) (domain.GroupCallMutation, error)
|
||
// RemoveConferenceCallParticipants 在同一事务内接受 conference E2E remove block、
|
||
// 清理目标的 E2E 成员标记，并在 kick 时把活跃参与者置 left。
|
||
RemoveConferenceCallParticipants(ctx context.Context, req domain.RemoveConferenceCallParticipantsRequest) (domain.RemoveConferenceCallParticipantsResult, error)
|
||
// DiscardGroupCall 终结通话并清空参与者，返回终态 call 与此前活跃的参与者。
|
||
DiscardGroupCall(ctx context.Context, callID int64, now int) (domain.GroupCall, []domain.GroupCallParticipant, error)
|
||
// TouchParticipant 刷新 checkGroupCall 保活水位，返回该用户当前活跃 ssrc 集合
|
||
//（joined=false 表示未在会，客户端据空集自动 rejoin）。
|
||
TouchParticipant(ctx context.Context, callID, userID int64, now int) (activeSSRCs []int64, joined bool, err error)
|
||
GetParticipant(ctx context.Context, callID, userID int64) (domain.GroupCallParticipant, bool, error)
|
||
// ListParticipants 按 (join_date, user_id) 游标分页；offset 为上次返回的
|
||
// NextOffset（空=从头）。响应携带当前 version（客户端跳号全量 reload 依赖）。
|
||
ListParticipants(ctx context.Context, callID int64, offset string, limit int) (domain.GroupCallParticipantPage, error)
|
||
// UpdateParticipant 应用字段级更新；changed=false 表示无有效变化（version 不动）。
|
||
UpdateParticipant(ctx context.Context, callID, userID int64, update domain.GroupCallParticipantUpdate) (domain.GroupCallMutation, bool, error)
|
||
// SetGroupCallTitle / SetGroupCallJoinMuted 只动 call 行，不动参与者 version。
|
||
SetGroupCallTitle(ctx context.Context, callID int64, title string) (domain.GroupCall, bool, error)
|
||
SetGroupCallJoinMuted(ctx context.Context, callID int64, joinMuted bool) (domain.GroupCall, bool, error)
|
||
SetStartedMessageID(ctx context.Context, callID int64, msgID int) error
|
||
// SweepStaleParticipants 清理保活水位早于 checkOlderThan 的活跃参与者
|
||
//（每清一人 version++）。注意调用方必须叠加 SFU 媒体面活性做双过期判定。
|
||
SweepStaleParticipants(ctx context.Context, checkOlderThan, now int, limit int) ([]domain.GroupCallMutation, error)
|
||
// ResetAllParticipants 服务端重启恢复：把全部活跃通话的参与者批量置 left
|
||
//（每通话 version++），conference 若因此变空则同步转 discarded，返回受影响的通话。
|
||
ResetAllParticipants(ctx context.Context, now int) ([]domain.GroupCall, error)
|
||
// NextRaiseHandRating 分配全局单调递增的举手序号（举手排序用）。
|
||
NextRaiseHandRating(ctx context.Context, callID int64) (int64, error)
|
||
// SetParticipantOverride 写入 setter 对 target 的 per-viewer 覆盖（本地静音/音量），
|
||
// 仅影响 setter 自己的视图。clear=true 删除覆盖。
|
||
SetParticipantOverride(ctx context.Context, callID, setterUserID, targetUserID int64, override domain.GroupCallParticipantOverride, clear bool) error
|
||
// GetParticipantOverride 取某 setter 对某 target 的覆盖。
|
||
GetParticipantOverride(ctx context.Context, callID, setterUserID, targetUserID int64) (domain.GroupCallParticipantOverride, bool, error)
|
||
// CreateConferenceInvite 记录一条 conference 私聊邀请与其 message box id。
|
||
CreateConferenceInvite(ctx context.Context, invite domain.GroupCallInvite) (domain.GroupCallInvite, error)
|
||
SetConferenceInviteStatus(ctx context.Context, callID int64, inviteeUserID int64, msgID int, status domain.GroupCallInviteStatus, now int) (domain.GroupCallInvite, bool, error)
|
||
// ListConferenceRecipientUserIDs 返回 conference 在线推送/访问候选人。
|
||
// active 态只包含 creator、当前活跃参与者、pending/accepted invite 相关人；
|
||
// discarded 态包含所有历史参与者与 invite 相关人，允许客户端收尾轮询读取终态。
|
||
ListConferenceRecipientUserIDs(ctx context.Context, callID int64) ([]int64, error)
|
||
AppendGroupCallChainBlock(ctx context.Context, block domain.GroupCallChainBlock) (domain.GroupCallChainBlock, error)
|
||
ListGroupCallChainBlocks(ctx context.Context, callID int64, subChainID, offset, limit int) (domain.GroupCallChainBlockPage, error)
|
||
// GetRtmpStreamKey / SetRtmpStreamKey 维护 per-channel 的持久 RTMP 推流密钥。
|
||
// revoke 语义由上层实现：Set 覆盖旧 key，旧 key 推流即刻失效。
|
||
GetRtmpStreamKey(ctx context.Context, channelID int64) (string, bool, error)
|
||
SetRtmpStreamKey(ctx context.Context, channelID int64, key string, now int) error
|
||
// StartScheduledGroupCall 清零 schedule_date（定时通话正式开始）。
|
||
// changed=false 表示本来就已开始（幂等）；discarded 返回 ErrGroupCallDiscarded。
|
||
StartScheduledGroupCall(ctx context.Context, callID int64) (domain.GroupCall, bool, error)
|
||
// SetScheduleStartSubscription 写入/清除 userID 的开播提醒订阅。
|
||
SetScheduleStartSubscription(ctx context.Context, callID, userID int64, subscribed bool) error
|
||
// ListScheduleSubscriberIDs 返回订阅了开播提醒的 userID（升序）。
|
||
ListScheduleSubscriberIDs(ctx context.Context, callID int64) ([]int64, error)
|
||
}
|