48 lines
3.7 KiB
Go
48 lines
3.7 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)
|
||
GetGroupCall(ctx context.Context, callID int64) (domain.GroupCall, bool, error)
|
||
// JoinGroupCall 加入/重进（同主键 upsert 换新 ssrc）；ssrc 与他人撞活跃唯一
|
||
// 约束返回 domain.ErrGroupCallSSRCDuplicate；version++。
|
||
JoinGroupCall(ctx context.Context, req domain.JoinGroupCallRequest) (domain.GroupCallMutation, error)
|
||
// LeaveGroupCall 置 left+version++；未在会返回 domain.ErrGroupCallNotJoined。
|
||
LeaveGroupCall(ctx context.Context, callID, userID int64, now int) (domain.GroupCallMutation, 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++），返回受影响的通话。
|
||
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)
|
||
}
|