585 lines
27 KiB
Go
585 lines
27 KiB
Go
// Copyright © 2023 OpenIM. All rights reserved.
|
||
//
|
||
// Licensed under the Apache License, Version 2.0 (the "License");
|
||
// you may not use this file except in compliance with the License.
|
||
// You may obtain a copy of the License at
|
||
//
|
||
// http://www.apache.org/licenses/LICENSE-2.0
|
||
//
|
||
// Unless required by applicable law or agreed to in writing, software
|
||
// distributed under the License is distributed on an "AS IS" BASIS,
|
||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
// See the License for the specific language governing permissions and
|
||
// limitations under the License.
|
||
|
||
package apistruct
|
||
|
||
import (
|
||
"encoding/json"
|
||
"fmt"
|
||
"strconv"
|
||
|
||
pbmsg "git.imall.cloud/openim/protocol/msg"
|
||
"git.imall.cloud/openim/protocol/sdkws"
|
||
)
|
||
|
||
// SendMsg defines the structure for sending messages with various metadata.
|
||
type SendMsg struct {
|
||
// SendID uniquely identifies the sender.
|
||
SendID string `json:"sendID" binding:"required"`
|
||
|
||
// GroupID is the identifier for the group, required if SessionType is 2 or 3.
|
||
GroupID string `json:"groupID" binding:"required_if=SessionType 2|required_if=SessionType 3"`
|
||
|
||
// SenderNickname is the nickname of the sender.
|
||
SenderNickname string `json:"senderNickname"`
|
||
|
||
// SenderFaceURL is the URL to the sender's avatar.
|
||
SenderFaceURL string `json:"senderFaceURL"`
|
||
|
||
// SenderPlatformID is an integer identifier for the sender's platform.
|
||
SenderPlatformID int32 `json:"senderPlatformID"`
|
||
|
||
// Content is the actual content of the message, required and excluded from Swagger documentation.
|
||
Content map[string]any `json:"content" binding:"required" swaggerignore:"true"`
|
||
|
||
// ContentType is an integer that represents the type of the content.
|
||
ContentType int32 `json:"contentType" binding:"required"`
|
||
|
||
// SessionType is an integer that represents the type of session for the message.
|
||
SessionType int32 `json:"sessionType" binding:"required"`
|
||
|
||
// IsOnlineOnly specifies if the message is only sent when the receiver is online.
|
||
IsOnlineOnly bool `json:"isOnlineOnly"`
|
||
|
||
// NotOfflinePush specifies if the message should not trigger offline push notifications.
|
||
NotOfflinePush bool `json:"notOfflinePush"`
|
||
|
||
// SendTime is a timestamp indicating when the message was sent.
|
||
SendTime int64 `json:"sendTime"`
|
||
|
||
// OfflinePushInfo contains information for offline push notifications.
|
||
OfflinePushInfo *sdkws.OfflinePushInfo `json:"offlinePushInfo"`
|
||
|
||
// Ex stores extended fields
|
||
Ex string `json:"ex"`
|
||
}
|
||
|
||
// SendMsgReq extends SendMsg with the requirement of RecvID when SessionType indicates a one-on-one or notification chat.
|
||
type SendMsgReq struct {
|
||
// RecvID uniquely identifies the receiver and is required for one-on-one or notification chat types.
|
||
RecvID string `json:"recvID" binding:"required_if" message:"recvID is required if sessionType is SingleChatType or NotificationChatType"`
|
||
SendMsg
|
||
}
|
||
|
||
type GetConversationListReq struct {
|
||
// userID uniquely identifies the user.
|
||
UserID string `protobuf:"bytes,1,opt,name=userID,proto3" json:"userID,omitempty" binding:"required"`
|
||
|
||
// ConversationIDs contains a list of unique identifiers for conversations.
|
||
ConversationIDs []string `protobuf:"bytes,2,rep,name=conversationIDs,proto3" json:"conversationIDs,omitempty"`
|
||
}
|
||
|
||
type GetConversationListResp struct {
|
||
// ConversationElems is a map that associates conversation IDs with their respective details.
|
||
ConversationElems map[string]*ConversationElem `protobuf:"bytes,1,rep,name=conversationElems,proto3" json:"conversationElems,omitempty" protobuf_key:"bytes,1,opt,name=key,proto3" protobuf_val:"bytes,2,opt,name=value,proto3"`
|
||
}
|
||
|
||
type ConversationElem struct {
|
||
// MaxSeq represents the maximum sequence number within the conversation.
|
||
MaxSeq int64 `protobuf:"varint,1,opt,name=maxSeq,proto3" json:"maxSeq,omitempty"`
|
||
|
||
// UnreadSeq represents the number of unread messages in the conversation.
|
||
UnreadSeq int64 `protobuf:"varint,2,opt,name=unreadSeq,proto3" json:"unreadSeq,omitempty"`
|
||
|
||
// LastSeqTime represents the timestamp of the last sequence in the conversation.
|
||
LastSeqTime int64 `protobuf:"varint,3,opt,name=LastSeqTime,proto3" json:"LastSeqTime,omitempty"`
|
||
}
|
||
|
||
// BatchSendMsgReq defines the structure for sending a message to multiple recipients.
|
||
type BatchSendMsgReq struct {
|
||
SendMsg
|
||
|
||
// IsSendAll indicates whether the message should be sent to all users.
|
||
IsSendAll bool `json:"isSendAll"`
|
||
|
||
// RecvIDs is a slice of receiver identifiers to whom the message will be sent, required field.
|
||
RecvIDs []string `json:"recvIDs" binding:"required"`
|
||
}
|
||
|
||
// BatchSendMsgResp contains the results of a batch message send operation.
|
||
type BatchSendMsgResp struct {
|
||
// Results is a slice of SingleReturnResult, representing the outcome of each message sent.
|
||
Results []*SingleReturnResult `json:"results"`
|
||
|
||
// FailedIDs is a slice of user IDs for whom the message send failed.
|
||
FailedIDs []string `json:"failedUserIDs"`
|
||
}
|
||
|
||
// SendRedPacketReq 发送红包请求
|
||
type SendRedPacketReq struct {
|
||
GroupID string `json:"groupID" binding:"required"` // 群ID
|
||
RedPacketType int32 `json:"redPacketType" binding:"required"` // 红包类型：1-普通红包，2-拼手气红包
|
||
TotalAmount int64 `json:"totalAmount" binding:"required"` // 总金额（分）
|
||
TotalCount int32 `json:"totalCount" binding:"required"` // 总个数
|
||
Blessing string `json:"blessing"` // 祝福语
|
||
}
|
||
|
||
// SendRedPacketResp 发送红包响应
|
||
type SendRedPacketResp struct {
|
||
RedPacketID string `json:"redPacketID"` // 红包ID
|
||
ServerMsgID string `json:"serverMsgID"` // 消息ID
|
||
ClientMsgID string `json:"clientMsgID"` // 客户端消息ID
|
||
SendTime int64 `json:"sendTime"` // 发送时间
|
||
}
|
||
|
||
// ReceiveRedPacketReq 领取红包请求
|
||
type ReceiveRedPacketReq struct {
|
||
RedPacketID string `json:"redPacketID" binding:"required"` // 红包ID
|
||
}
|
||
|
||
// ReceiveRedPacketResp 领取红包响应
|
||
type ReceiveRedPacketResp struct {
|
||
RedPacketID string `json:"redPacketID"` // 红包ID
|
||
Amount int64 `json:"amount"` // 领取金额（分）
|
||
IsLucky bool `json:"isLucky"` // 是否为手气最佳（仅拼手气红包有效）
|
||
}
|
||
|
||
// GetRedPacketsByGroupReq 根据群ID查询红包列表请求（群ID为选填，不填则查询所有红包）
|
||
type GetRedPacketsByGroupReq struct {
|
||
GroupID string `json:"groupID"` // 群ID（选填，不填则查询所有红包）
|
||
Pagination Pagination `json:"pagination"` // 分页参数
|
||
}
|
||
|
||
// Pagination 分页参数
|
||
type Pagination struct {
|
||
PageNumber int32 `json:"pageNumber"` // 页码，从1开始
|
||
ShowNumber int32 `json:"showNumber"` // 每页数量
|
||
}
|
||
|
||
// GetRedPacketsByGroupResp 根据群ID查询红包列表响应
|
||
type GetRedPacketsByGroupResp struct {
|
||
Total int64 `json:"total"` // 总数
|
||
RedPackets []*RedPacketInfo `json:"redPackets"` // 红包列表
|
||
}
|
||
|
||
// RedPacketInfo 红包信息
|
||
type RedPacketInfo struct {
|
||
RedPacketID string `json:"redPacketID"` // 红包ID
|
||
SendUserID string `json:"sendUserID"` // 发送者ID
|
||
GroupID string `json:"groupID"` // 群ID
|
||
GroupName string `json:"groupName"` // 群名称
|
||
RedPacketType int32 `json:"redPacketType"` // 红包类型：1-普通红包，2-拼手气红包
|
||
TotalAmount int64 `json:"totalAmount"` // 总金额（分）
|
||
TotalCount int32 `json:"totalCount"` // 总个数
|
||
RemainAmount int64 `json:"remainAmount"` // 剩余金额（分）
|
||
RemainCount int32 `json:"remainCount"` // 剩余个数
|
||
Blessing string `json:"blessing"` // 祝福语
|
||
Status int32 `json:"status"` // 状态：0-进行中，1-已领完，2-已过期
|
||
ExpireTime int64 `json:"expireTime"` // 过期时间戳（毫秒）
|
||
CreateTime int64 `json:"createTime"` // 创建时间戳（毫秒）
|
||
}
|
||
|
||
// GetRedPacketReceiveInfoReq 查询红包领取情况请求
|
||
type GetRedPacketReceiveInfoReq struct {
|
||
RedPacketID string `json:"redPacketID" binding:"required"` // 红包ID
|
||
}
|
||
|
||
// GetRedPacketReceiveInfoResp 查询红包领取情况响应
|
||
type GetRedPacketReceiveInfoResp struct {
|
||
RedPacketID string `json:"redPacketID"` // 红包ID
|
||
TotalAmount int64 `json:"totalAmount"` // 总金额（分）
|
||
TotalCount int32 `json:"totalCount"` // 总个数
|
||
RemainAmount int64 `json:"remainAmount"` // 剩余金额（分）
|
||
RemainCount int32 `json:"remainCount"` // 剩余个数
|
||
Status int32 `json:"status"` // 状态：0-进行中，1-已领完，2-已过期
|
||
Receives []*RedPacketReceiveDetail `json:"receives"` // 领取记录列表
|
||
}
|
||
|
||
// RedPacketReceiveDetail 红包领取详情（后台管理接口使用）
|
||
type RedPacketReceiveDetail struct {
|
||
ReceiveID string `json:"receiveID"` // 领取记录ID
|
||
ReceiveUserID string `json:"receiveUserID"` // 领取者ID
|
||
Amount int64 `json:"amount"` // 领取金额（分）
|
||
ReceiveTime int64 `json:"receiveTime"` // 领取时间戳（毫秒）
|
||
IsLucky bool `json:"isLucky"` // 是否为手气最佳（仅拼手气红包有效）
|
||
}
|
||
|
||
// PauseRedPacketReq 暂停红包请求
|
||
type PauseRedPacketReq struct {
|
||
RedPacketID string `json:"redPacketID" binding:"required"` // 红包ID
|
||
}
|
||
|
||
// PauseRedPacketResp 暂停红包响应
|
||
type PauseRedPacketResp struct {
|
||
RedPacketID string `json:"redPacketID"` // 红包ID
|
||
}
|
||
|
||
// GetRedPacketDetailReq 查询红包详情请求（用户端）
|
||
type GetRedPacketDetailReq struct {
|
||
RedPacketID string `json:"redPacketID" binding:"required"` // 红包ID（必填）
|
||
}
|
||
|
||
// GetRedPacketDetailResp 查询红包详情响应（用户端）
|
||
type GetRedPacketDetailResp struct {
|
||
RedPacketID string `json:"redPacketID"` // 红包ID
|
||
GroupID string `json:"groupID"` // 群ID
|
||
RedPacketType int32 `json:"redPacketType"` // 红包类型：1-普通红包，2-拼手气红包
|
||
TotalAmount int64 `json:"totalAmount"` // 总金额（分）
|
||
TotalCount int32 `json:"totalCount"` // 总个数
|
||
RemainAmount int64 `json:"remainAmount"` // 剩余金额（分）
|
||
RemainCount int32 `json:"remainCount"` // 剩余个数
|
||
Blessing string `json:"blessing"` // 祝福语
|
||
Status int32 `json:"status"` // 状态：0-进行中，1-已领完，2-已过期
|
||
IsExpired bool `json:"isExpired"` // 是否过期（超过一周）
|
||
MyReceive *RedPacketMyReceiveDetail `json:"myReceive"` // 当前用户的领取信息（如果已领取）
|
||
Receives []*RedPacketUserReceiveDetail `json:"receives"` // 领取记录列表（仅群主/管理员可见）
|
||
}
|
||
|
||
// RedPacketMyReceiveDetail 当前用户自己的领取详情（不包含用户ID、昵称、头像）
|
||
type RedPacketMyReceiveDetail struct {
|
||
ReceiveID string `json:"receiveID"` // 领取记录ID
|
||
Amount int64 `json:"amount"` // 领取金额（分）
|
||
ReceiveTime int64 `json:"receiveTime"` // 领取时间戳（毫秒）
|
||
IsLucky bool `json:"isLucky"` // 是否为手气最佳（仅拼手气红包有效）
|
||
}
|
||
|
||
// RedPacketUserReceiveDetail 红包用户领取详情（用户端，包含用户信息）
|
||
type RedPacketUserReceiveDetail struct {
|
||
ReceiveID string `json:"receiveID"` // 领取记录ID
|
||
ReceiveUserID string `json:"receiveUserID"` // 领取者ID
|
||
Nickname string `json:"nickname"` // 领取者昵称
|
||
FaceURL string `json:"faceURL"` // 领取者头像
|
||
Amount int64 `json:"amount"` // 领取金额（分）
|
||
ReceiveTime int64 `json:"receiveTime"` // 领取时间戳（毫秒）
|
||
IsLucky bool `json:"isLucky"` // 是否为手气最佳（仅拼手气红包有效）
|
||
}
|
||
|
||
// GetWalletsReq 查询用户钱包列表请求（后台管理接口）
|
||
type GetWalletsReq struct {
|
||
UserID string `json:"userID"` // 用户ID（选填，支持通过ID、手机号、账号查询）
|
||
PhoneNumber string `json:"phoneNumber"` // 手机号（选填，支持通过ID、手机号、账号查询）
|
||
Account string `json:"account"` // 账号（选填，支持通过ID、手机号、账号查询）
|
||
Pagination Pagination `json:"pagination"` // 分页参数
|
||
}
|
||
|
||
// GetWalletsResp 查询用户钱包列表响应
|
||
type GetWalletsResp struct {
|
||
Total int64 `json:"total"` // 总数
|
||
Wallets []*WalletInfo `json:"wallets"` // 钱包列表
|
||
}
|
||
|
||
// WalletInfo 钱包信息
|
||
type WalletInfo struct {
|
||
UserID string `json:"userID"` // 用户ID
|
||
Nickname string `json:"nickname"` // 用户昵称
|
||
FaceURL string `json:"faceURL"` // 用户头像
|
||
Balance int64 `json:"balance"` // 余额（分）
|
||
CreateTime int64 `json:"createTime"` // 创建时间戳（毫秒）
|
||
UpdateTime int64 `json:"updateTime"` // 更新时间戳（毫秒）
|
||
}
|
||
|
||
// BatchUpdateWalletBalanceReq 批量修改用户余额请求（后台管理接口）
|
||
type BatchUpdateWalletBalanceReq struct {
|
||
Users []WalletUserIdentifier `json:"users" binding:"required"` // 用户标识列表（支持用户ID、手机号、账号）
|
||
Amount int64 `json:"amount"` // 默认金额（分），如果用户没有指定金额则使用此值
|
||
Operation string `json:"operation"` // 默认操作类型：set（设置为指定金额）、add（增加金额）、subtract（减少金额），默认为add
|
||
}
|
||
|
||
// WalletUserIdentifier 钱包用户标识（支持用户ID、手机号、账号）
|
||
type WalletUserIdentifier struct {
|
||
UserID FlexibleString `json:"userID"` // 用户ID（选填，支持数字和字符串）
|
||
PhoneNumber string `json:"phoneNumber"` // 手机号（选填）
|
||
Account string `json:"account"` // 账号（选填）
|
||
Amount int64 `json:"amount"` // 金额（分），如果未指定则使用请求中的默认金额
|
||
Operation string `json:"operation"` // 操作类型：set（设置为指定金额）、add（增加金额）、subtract（减少金额），如果未指定则使用请求中的默认操作类型
|
||
Remark string `json:"remark"` // 备注（选填），每条修改记录对应的备注信息
|
||
}
|
||
|
||
// FlexibleString 灵活的字符串类型，可以接受数字和字符串
|
||
type FlexibleString string
|
||
|
||
// UnmarshalJSON 自定义JSON反序列化，支持数字和字符串
|
||
func (f *FlexibleString) UnmarshalJSON(data []byte) error {
|
||
// 尝试解析为字符串
|
||
var s string
|
||
if err := json.Unmarshal(data, &s); err == nil {
|
||
*f = FlexibleString(s)
|
||
return nil
|
||
}
|
||
// 尝试解析为数字
|
||
var num json.Number
|
||
if err := json.Unmarshal(data, &num); err == nil {
|
||
*f = FlexibleString(num.String())
|
||
return nil
|
||
}
|
||
// 尝试解析为整数
|
||
var i int64
|
||
if err := json.Unmarshal(data, &i); err == nil {
|
||
*f = FlexibleString(strconv.FormatInt(i, 10))
|
||
return nil
|
||
}
|
||
// 尝试解析为浮点数
|
||
var f64 float64
|
||
if err := json.Unmarshal(data, &f64); err == nil {
|
||
*f = FlexibleString(strconv.FormatFloat(f64, 'f', -1, 64))
|
||
return nil
|
||
}
|
||
return fmt.Errorf("cannot unmarshal %s into FlexibleString", string(data))
|
||
}
|
||
|
||
// String 返回字符串值
|
||
func (f FlexibleString) String() string {
|
||
return string(f)
|
||
}
|
||
|
||
// BatchUpdateWalletBalanceResp 批量修改用户余额响应
|
||
type BatchUpdateWalletBalanceResp struct {
|
||
Total int32 `json:"total"` // 总处理数量
|
||
Success int32 `json:"success"` // 成功数量
|
||
Failed int32 `json:"failed"` // 失败数量
|
||
Results []WalletUpdateResult `json:"results"` // 处理结果列表
|
||
}
|
||
|
||
// WalletUpdateResult 钱包更新结果
|
||
type WalletUpdateResult struct {
|
||
UserID string `json:"userID"` // 用户ID
|
||
PhoneNumber string `json:"phoneNumber"` // 手机号
|
||
Account string `json:"account"` // 账号
|
||
Success bool `json:"success"` // 是否成功
|
||
Message string `json:"message"` // 结果消息
|
||
OldBalance int64 `json:"oldBalance"` // 修改前余额
|
||
NewBalance int64 `json:"newBalance"` // 修改后余额
|
||
Remark string `json:"remark"` // 备注信息
|
||
}
|
||
|
||
// SendSingleMsgReq defines the structure for sending a message to multiple recipients.
|
||
type SendSingleMsgReq struct {
|
||
// groupMsg should appoint sendID
|
||
SendID string `json:"sendID"`
|
||
Content string `json:"content" binding:"required"`
|
||
OfflinePushInfo *sdkws.OfflinePushInfo `json:"offlinePushInfo"`
|
||
Ex string `json:"ex"`
|
||
}
|
||
|
||
type KeyMsgData struct {
|
||
SendID string `json:"sendID"`
|
||
RecvID string `json:"recvID"`
|
||
GroupID string `json:"groupID"`
|
||
}
|
||
|
||
// SingleReturnResult encapsulates the result of a single message send attempt.
|
||
type SingleReturnResult struct {
|
||
// ServerMsgID is the message identifier on the server-side.
|
||
ServerMsgID string `json:"serverMsgID"`
|
||
|
||
// ClientMsgID is the message identifier on the client-side.
|
||
ClientMsgID string `json:"clientMsgID"`
|
||
|
||
// SendTime is the timestamp of when the message was sent.
|
||
SendTime int64 `json:"sendTime"`
|
||
|
||
// RecvID uniquely identifies the receiver of the message.
|
||
RecvID string `json:"recvID"`
|
||
|
||
// Modify fields modified via webhook.
|
||
Modify map[string]any `json:"modify,omitempty"`
|
||
}
|
||
|
||
type SendMsgResp struct {
|
||
// SendMsgResp original response.
|
||
*pbmsg.SendMsgResp
|
||
|
||
// Modify fields modified via webhook.
|
||
Modify map[string]any `json:"modify,omitempty"`
|
||
}
|
||
|
||
// CreateMeetingReq 创建会议请求
|
||
type CreateMeetingReq struct {
|
||
MeetingID string `json:"meetingID"` // 会议ID（选填，不填则自动生成）
|
||
Subject string `json:"subject" binding:"required"` // 会议主题（必填）
|
||
CoverURL string `json:"coverURL"` // 封面URL
|
||
ScheduledTime int64 `json:"scheduledTime" binding:"required"` // 预约时间戳（毫秒，必填）
|
||
Description string `json:"description"` // 会议描述
|
||
Duration int32 `json:"duration"` // 会议时长（分钟）
|
||
EstimatedCount int32 `json:"estimatedCount"` // 会议预估人数
|
||
EnableMic bool `json:"enableMic"` // 是否开启连麦
|
||
EnableComment bool `json:"enableComment"` // 是否开启评论
|
||
AnchorUserIDs []string `json:"anchorUserIDs"` // 主播用户ID列表（多选）
|
||
Password string `json:"password"` // 会议密码（6位数字，选填，不填则自动生成）
|
||
Ex string `json:"ex"` // 扩展字段
|
||
}
|
||
|
||
// CreateMeetingResp 创建会议响应
|
||
type CreateMeetingResp struct {
|
||
MeetingInfo *MeetingInfo `json:"meetingInfo"` // 会议信息
|
||
GroupID string `json:"groupID"` // 创建的群聊ID
|
||
}
|
||
|
||
// UpdateMeetingReq 更新会议请求
|
||
type UpdateMeetingReq struct {
|
||
MeetingID string `json:"meetingID" binding:"required"` // 会议ID（必填）
|
||
Subject string `json:"subject"` // 会议主题
|
||
CoverURL string `json:"coverURL"` // 封面URL
|
||
ScheduledTime int64 `json:"scheduledTime"` // 预约时间戳（毫秒）
|
||
Status int32 `json:"status"` // 会议状态：1-已预约，2-进行中，3-已结束，4-已取消
|
||
Description string `json:"description"` // 会议描述
|
||
Duration int32 `json:"duration"` // 会议时长（分钟）
|
||
EstimatedCount int32 `json:"estimatedCount"` // 会议预估人数
|
||
EnableMic *bool `json:"enableMic"` // 是否开启连麦（使用指针以区分是否设置）
|
||
EnableComment *bool `json:"enableComment"` // 是否开启评论（使用指针以区分是否设置）
|
||
AnchorUserIDs []string `json:"anchorUserIDs"` // 主播用户ID列表（多选）
|
||
Password *string `json:"password"` // 会议密码（6位数字，使用指针以区分是否设置）
|
||
Ex string `json:"ex"` // 扩展字段
|
||
}
|
||
|
||
// UpdateMeetingResp 更新会议响应
|
||
type UpdateMeetingResp struct {
|
||
MeetingInfo *MeetingInfo `json:"meetingInfo"` // 会议信息
|
||
}
|
||
|
||
// GetMeetingsReq 获取会议列表请求
|
||
type GetMeetingsReq struct {
|
||
CreatorUserID string `json:"creatorUserID"` // 创建者用户ID（选填）
|
||
Status int32 `json:"status"` // 会议状态（选填）：1-已预约，2-进行中，3-已结束，4-已取消
|
||
Keyword string `json:"keyword"` // 搜索关键词（选填，搜索主题和描述）
|
||
StartTime int64 `json:"startTime"` // 开始时间戳（毫秒，选填）
|
||
EndTime int64 `json:"endTime"` // 结束时间戳（毫秒，选填）
|
||
Pagination Pagination `json:"pagination"` // 分页参数
|
||
}
|
||
|
||
// GetMeetingsResp 获取会议列表响应
|
||
type GetMeetingsResp struct {
|
||
Total int64 `json:"total"` // 总数
|
||
Meetings []*MeetingInfo `json:"meetings"` // 会议列表
|
||
}
|
||
|
||
// DeleteMeetingReq 删除会议请求
|
||
type DeleteMeetingReq struct {
|
||
MeetingID string `json:"meetingID" binding:"required"` // 会议ID（必填）
|
||
}
|
||
|
||
// DeleteMeetingResp 删除会议响应
|
||
type DeleteMeetingResp struct {
|
||
}
|
||
|
||
// MeetingInfo 会议信息
|
||
type MeetingInfo struct {
|
||
MeetingID string `json:"meetingID"` // 会议ID
|
||
Subject string `json:"subject"` // 会议主题
|
||
CoverURL string `json:"coverURL"` // 封面URL
|
||
ScheduledTime int64 `json:"scheduledTime"` // 预约时间戳（毫秒）
|
||
Status int32 `json:"status"` // 会议状态：1-已预约，2-进行中，3-已结束，4-已取消
|
||
CreatorUserID string `json:"creatorUserID"` // 创建者用户ID
|
||
Description string `json:"description"` // 会议描述
|
||
Duration int32 `json:"duration"` // 会议时长（分钟）
|
||
EstimatedCount int32 `json:"estimatedCount"` // 会议预估人数
|
||
EnableMic bool `json:"enableMic"` // 是否开启连麦
|
||
EnableComment bool `json:"enableComment"` // 是否开启评论
|
||
AnchorUserIDs []string `json:"anchorUserIDs"` // 主播用户ID列表（多选）
|
||
AnchorUsers []*sdkws.UserInfo `json:"anchorUsers"` // 主播用户信息列表
|
||
CreateTime int64 `json:"createTime"` // 创建时间戳（毫秒）
|
||
UpdateTime int64 `json:"updateTime"` // 更新时间戳（毫秒）
|
||
Ex string `json:"ex"` // 扩展字段
|
||
GroupID string `json:"groupID"` // 关联的群聊ID
|
||
CheckInCount int32 `json:"checkInCount"` // 签到人数统计
|
||
Password string `json:"password"` // 会议密码（6位数字）
|
||
}
|
||
|
||
// GetMeetingReq 获取会议请求（用户端）
|
||
type GetMeetingReq struct {
|
||
MeetingID string `json:"meetingID" binding:"required"` // 会议ID（必填）
|
||
}
|
||
|
||
// GetMeetingResp 获取会议响应（用户端）
|
||
type GetMeetingResp struct {
|
||
MeetingInfo *MeetingPublicInfo `json:"meetingInfo"` // 会议信息
|
||
}
|
||
|
||
// GetMeetingsPublicReq 获取会议列表请求（用户端）
|
||
type GetMeetingsPublicReq struct {
|
||
Status int32 `json:"status"` // 会议状态（选填）：1-已预约，2-进行中，3-已结束，4-已取消
|
||
Keyword string `json:"keyword"` // 搜索关键词（选填，搜索主题和描述）
|
||
StartTime int64 `json:"startTime"` // 开始时间戳（毫秒，选填）
|
||
EndTime int64 `json:"endTime"` // 结束时间戳（毫秒，选填）
|
||
Pagination Pagination `json:"pagination"` // 分页参数
|
||
}
|
||
|
||
// GetMeetingsPublicResp 获取会议列表响应（用户端）
|
||
type GetMeetingsPublicResp struct {
|
||
Total int64 `json:"total"` // 总数
|
||
Meetings []*MeetingPublicInfo `json:"meetings"` // 会议列表
|
||
}
|
||
|
||
// MeetingPublicInfo 会议公开信息（用户端，过滤了管理字段）
|
||
type MeetingPublicInfo struct {
|
||
MeetingID string `json:"meetingID"` // 会议ID
|
||
Subject string `json:"subject"` // 会议主题
|
||
CoverURL string `json:"coverURL"` // 封面URL
|
||
ScheduledTime int64 `json:"scheduledTime"` // 预约时间戳（毫秒）
|
||
Status int32 `json:"status"` // 会议状态：1-已预约，2-进行中，3-已结束，4-已取消
|
||
Description string `json:"description"` // 会议描述
|
||
Duration int32 `json:"duration"` // 会议时长（分钟）
|
||
EstimatedCount int32 `json:"estimatedCount"` // 会议预估人数
|
||
EnableMic bool `json:"enableMic"` // 是否开启连麦
|
||
EnableComment bool `json:"enableComment"` // 是否开启评论
|
||
AnchorUsers []*sdkws.UserInfo `json:"anchorUsers"` // 主播用户信息列表
|
||
GroupID string `json:"groupID"` // 关联的群聊ID
|
||
CheckInCount int32 `json:"checkInCount"` // 签到人数统计
|
||
Password string `json:"password"` // 会议密码（6位数字）
|
||
}
|
||
|
||
// CheckInMeetingReq 会议签到请求
|
||
type CheckInMeetingReq struct {
|
||
MeetingID string `json:"meetingID" binding:"required"` // 会议ID（必填）
|
||
}
|
||
|
||
// CheckInMeetingResp 会议签到响应
|
||
type CheckInMeetingResp struct {
|
||
CheckInID string `json:"checkInID"` // 签到ID
|
||
CheckInTime int64 `json:"checkInTime"` // 签到时间戳（毫秒）
|
||
}
|
||
|
||
// GetMeetingCheckInsReq 获取会议签到列表请求
|
||
type GetMeetingCheckInsReq struct {
|
||
MeetingID string `json:"meetingID" binding:"required"` // 会议ID（必填）
|
||
Pagination Pagination `json:"pagination"` // 分页参数
|
||
}
|
||
|
||
// GetMeetingCheckInsResp 获取会议签到列表响应
|
||
type GetMeetingCheckInsResp struct {
|
||
Total int64 `json:"total"` // 总数
|
||
CheckIns []*MeetingCheckInInfo `json:"checkIns"` // 签到列表
|
||
}
|
||
|
||
// MeetingCheckInInfo 会议签到信息
|
||
type MeetingCheckInInfo struct {
|
||
CheckInID string `json:"checkInID"` // 签到ID
|
||
MeetingID string `json:"meetingID"` // 会议ID
|
||
UserID string `json:"userID"` // 用户ID
|
||
CheckInTime int64 `json:"checkInTime"` // 签到时间戳（毫秒）
|
||
UserInfo *sdkws.UserInfo `json:"userInfo"` // 用户信息
|
||
}
|
||
|
||
// GetMeetingCheckInStatsReq 获取会议签到统计请求
|
||
type GetMeetingCheckInStatsReq struct {
|
||
MeetingID string `json:"meetingID" binding:"required"` // 会议ID（必填）
|
||
}
|
||
|
||
// GetMeetingCheckInStatsResp 获取会议签到统计响应
|
||
type GetMeetingCheckInStatsResp struct {
|
||
MeetingID string `json:"meetingID"` // 会议ID
|
||
CheckInCount int64 `json:"checkInCount"` // 签到人数
|
||
}
|
||
|
||
// CheckUserCheckInReq 检查用户是否已签到请求
|
||
type CheckUserCheckInReq struct {
|
||
MeetingID string `json:"meetingID" binding:"required"` // 会议ID（必填）
|
||
}
|
||
|
||
// CheckUserCheckInResp 检查用户是否已签到响应
|
||
type CheckUserCheckInResp struct {
|
||
IsCheckedIn bool `json:"isCheckedIn"` // 是否已签到
|
||
CheckInInfo *MeetingCheckInInfo `json:"checkInInfo,omitempty"` // 签到信息（如果已签到）
|
||
}
|