SDK 公开面与文档覆盖

本页回答一个具体问题:这个平台导出的每个公开方法、事件、枚举与数据类型,在文档中心的哪一页被说明?页面由 SDK 制品公开面(api-surface 快照)与 IDL 绑定声明生成,逐项给出签名与文档位置;差异(多余/缺失的方法)如实标注,不做静默补齐。

口径

契约(IDL 语义操作)是语义权威:方法名、参数、返回、错误码、示例都以功能页为准。

制品快照用于确认该平台是否真的导出了该方法;快照与实现不一致时,页面标注差异而不是猜测。

本页只做索引与核对,不重复功能页的参数表与示例。

来源与口径​

项内容
制品公开面已读取该平台的 api-surface 快照(104 个公开方法)
契约语义IDL 1.0.0 的 103 个语义操作 + 16 个事件
绑定签名来自 IDL 绑定声明的方法签名(各平台语言风格)
口径说明制品公开面快照包含 103 个公开方法(102 个 IDL 语义操作 + isChatroomJoined)。

覆盖摘要​

类别数量文档承载位置
IDL 语义操作103功能页(每操作:说明 + 参数表 + 返回值 + 错误码 + 示例)
绑定便捷方法1本页「绑定便捷方法」小节
事件16本页事件表 + 连接监听
枚举 / 常量6API 参考「枚举」各页
数据类型58API 参考「类」各页 + 方法参数/返回值表

公开方法索引​

下表逐项列出本平台导出的公开方法(IDL 语义操作在前,绑定便捷方法在后),并给出承载页面。功能页内的每个操作都有独立的参数表、返回值、错误码与可运行示例。

方法本平台签名 / 形态文档位置
initconstructor(options) / init(options)建立连接
connectconnect(token)建立连接
disconnectdisconnect()建立连接
getConnectionStatusgetConnectionStatus()建立连接
getCurrentUserIdgetCurrentUserId()连接监听
addEventListeneraddEventListener(event, handler)连接监听
removeEventListenerremoveEventListener(event, handler)连接监听
sendMessagesendMessage(conversationType, targetId, content, options?)发送消息
sendTextMessagesendTextMessage(conversationType, targetId, text, options?)发送消息
sendImageMessagesendImageMessage(conversationType, targetId, content, options?)发送消息
sendFileMessagesendFileMessage(conversationType, targetId, content, options?)发送消息
sendVoiceMessagesendVoiceMessage(conversationType, targetId, content, options?)发送消息
sendLocationMessagesendLocationMessage(conversationType, targetId, content, options?)发送消息
sendTypingStatussendTypingStatus(conversationType, targetId, typing)输入状态
recallMessagerecallMessage(messageId)消息管理
sendReadReceiptsendReadReceipt(conversationType, targetId, messageIds)已读回执
getMessageReadCountgetMessageReadCount(messageId)已读回执
getMessageReadUsersgetMessageReadUsers(messageId, options?)已读回执
getMessageReadDetailgetMessageReadDetail(messageId, options?)API 参考索引
searchMessagessearchMessages({keyword, limit?})消息管理
getConversationListgetConversationList()会话列表
getConversationgetConversation(conversationType, targetId)会话列表
getHistoryMessagesgetHistoryMessages(conversationType, targetId, options?)历史消息
clearUnreadCountclearUnreadCount(conversationType, targetId)未读数
setConversationToTopsetConversationToTop(conversationType, targetId, isTop)置顶与免打扰
saveTextMessageDraftsaveTextMessageDraft(conversationType, targetId, draft)草稿
getTextMessageDraftgetTextMessageDraft(conversationType, targetId)草稿
clearTextMessageDraftclearTextMessageDraft(conversationType, targetId)草稿
setConversationNotificationLevelsetConversationNotificationLevel(conversationType, targetId, level)置顶与免打扰
getUserProfilegetUserProfile(userId)用户资料
updateMyUserProfileupdateMyUserProfile({name?, avatarUrl?})用户资料
getOnlineStatusgetOnlineStatus(userId)在线状态
getOnlineStatusBatchgetOnlineStatusBatch(userIds)在线状态
searchUserssearchUsers(keyword, options?)好友列表
sendFriendRequestsendFriendRequest(toUserId, message?)好友请求
getFriendRequestsgetFriendRequests(options?)好友请求
acceptFriendRequestacceptFriendRequest(requestId)好友请求
rejectFriendRequestrejectFriendRequest(requestId)好友请求
getFriendsgetFriends()好友列表
deleteFrienddeleteFriend(friendId)好友列表
setFriendRemarksetFriendRemark(friendId, remark)好友列表
getBlacklistgetBlacklist()黑名单
addToBlacklistaddToBlacklist(userId)黑名单
removeFromBlacklistremoveFromBlacklist(userId)黑名单
createGroupcreateGroup({groupId?, name, owner?, members?, groupType?})创建群组
getGroupsInfogetGroupsInfo(groupIds)创建群组
getGroupMembersgetGroupMembers(groupId)群成员
addGroupMembersaddGroupMembers(groupId, userIds)群成员
removeGroupMembersremoveGroupMembers(groupId, userIds)群成员
quitGroupquitGroup(groupId)群成员
updateGroupNameupdateGroupName(groupId, name)群管理
updateGroupNoticeupdateGroupNotice(groupId, notice)群管理
transferGroupOwnertransferGroupOwner(groupId, newOwner)群管理
addGroupAdminaddGroupAdmin(groupId, userId)群管理
removeGroupAdminremoveGroupAdmin(groupId, userId)群管理
muteGroupMembermuteGroupMember(groupId, userId, mutedUntil)群管理
createChatroomcreateChatroom({chatroomId?, name, owner?})加入与退出
joinChatroomjoinChatroom(chatroomId)加入与退出
leaveChatroomleaveChatroom(chatroomId)加入与退出
getChatroomInfogetChatroomInfo(chatroomId)聊天室信息
getChatroomMembersgetChatroomMembers(chatroomId, options?)聊天室信息
getSystemMessagesgetSystemMessages(options?)系统通知
uploadFileuploadFile(data, name, mime?)文件上传
updateMessageExpansionupdateMessageExpansion(messageId, expansion)消息进阶
removeMessageExpansionremoveMessageExpansion(messageId, keys)消息进阶
addMessageReactionaddMessageReaction(params)消息进阶
removeMessageReactionremoveMessageReaction(params)消息进阶
batchGetMessageReactionSummariesbatchGetMessageReactionSummaries(params)消息进阶
getMessageReactionsgetMessageReactions(params)消息进阶
getMessageReactionUsersgetMessageReactionUsers(params)消息进阶
createConversationTagcreateConversationTag(tagName, options)会话标签与分组
updateConversationTagupdateConversationTag(tagId, tagName)会话标签与分组
deleteConversationTagdeleteConversationTag(tagId)会话标签与分组
getConversationTagsgetConversationTags()会话标签与分组
addConversationsToTagaddConversationsToTag(tagId, conversations)会话标签与分组
removeConversationsFromTagremoveConversationsFromTag(tagId, conversations)会话标签与分组
getConversationsFromTagByPagegetConversationsFromTagByPage(tagId, options)会话标签与分组
getTagsFromConversationgetTagsFromConversation(conversationType, targetId)会话标签与分组
getUnreadCountByTaggetUnreadCountByTag(tagId)会话标签与分组
setConversationToTopInTagsetConversationToTopInTag(tagId, conversationType, targetId, top)会话标签与分组
deleteConversationdeleteConversation(conversationType, targetId)会话删除与类型免打扰
getConversationTypeNotificationgetConversationTypeNotification(conversationType)会话删除与类型免打扰
setConversationTypeNotificationsetConversationTypeNotification(conversationType, level)会话删除与类型免打扰
startStreamMessagestartStreamMessage(params)消息进阶
appendStreamMessageappendStreamMessage(streamId, delta, options?)消息进阶
completeStreamMessagecompleteStreamMessage(streamId)消息进阶
getStreamMessagegetStreamMessage(streamId)消息进阶
getMessageExpansiongetMessageExpansion(messageId: string): Promise<RcResult<MessageExpansion>>消息进阶
combineMessagescombineMessages(messages: Message[], options?: CombineMessagesOptions): Promise<RcResult<CombineContent>>消息进阶
subscribePresencesubscribePresence(userIds: string[]): Promise<RcResult<{subscribed: string[]}>>在线状态订阅与推送令牌
unsubscribePresenceunsubscribePresence(userIds: string[]): Promise<RcResult<{subscribed: string[]}>>在线状态订阅与推送令牌
getPresenceSubscriptionsgetPresenceSubscriptions(): Promise<RcResult<{userId: string, subscribed: string[]}>>在线状态订阅与推送令牌
registerPushTokenregisterPushToken(options: RegisterPushTokenOptions): Promise<RcResult<PushToken>>在线状态订阅与推送令牌
unregisterPushTokenunregisterPushToken(tokenId: string): Promise<RcResult<UnregisterPushTokenResult>>在线状态订阅与推送令牌
getPushTokensgetPushTokens(): Promise<RcResult<PushTokenListResult>>在线状态订阅与推送令牌
createSupergroupChannelcreateSupergroupChannel(params: CreateSupergroupChannelParams): Promise<RcResult<SupergroupChannel>>超级群频道与用户组
listSupergroupChannelslistSupergroupChannels(groupId: string): Promise<RcResult<SupergroupChannelListResult>>超级群频道与用户组
joinSupergroupChanneljoinSupergroupChannel(channelId: string, options?: SupergroupChannelOptions): Promise<RcResult<JoinSupergroupChannelResult>>超级群频道与用户组
leaveSupergroupChannelleaveSupergroupChannel(channelId: string, options?: SupergroupChannelOptions): Promise<RcResult<LeaveSupergroupChannelResult>>超级群频道与用户组
bindUserGroupToChannelbindUserGroupToChannel(channelId: string, userGroupId: string, options?: SupergroupChannelOptions): Promise<RcResult<BindUserGroupToChannelResult>>超级群频道与用户组
createUserGroupcreateUserGroup(params: CreateUserGroupParams): Promise<RcResult<UserGroup>>超级群频道与用户组
listUserGroupslistUserGroups(groupId: string): Promise<RcResult<UserGroupListResult>>超级群频道与用户组
getUserGroupsByUsergetUserGroupsByUser(userId: string, options?: SupergroupChannelOptions): Promise<RcResult<UserGroupListResult>>超级群频道与用户组
isChatroomJoined绑定便捷方法本地判断当前用户是否已加入指定聊天室(内存态,不发起网络请求)。

事件索引​

事件名在所有 GA 平台一致(Web 为小写下划线常量值,原生平台为枚举成员)。事件订阅方式见连接监听页;载荷字段来自 IDL 事件定义。

事件载荷本平台导出文档位置
CONNECTING{attempt:int}是API 参考 · 事件载荷
CONNECTED{userId:string, sessionId?:string}是API 参考 · 事件载荷
DISCONNECT{code:int, reason:string}是API 参考 · 事件载荷
SUSPEND{code:int, reason:string}是API 参考 · 事件载荷
MESSAGES{messages:Message[]}是API 参考 · 事件载荷
CONVERSATION{conversation:Conversation}是API 参考 · 事件载荷
MESSAGE_RECALLED{message:Message}是API 参考 · 事件载荷
READ_RECEIPTReadReceipt是API 参考 · 事件载荷
TYPING{conversationType:ConversationType,targetId:string,userId:string,typing:bool,timestamp:int64}是API 参考 · 事件载荷
MESSAGE_REACTION_CHANGED{messageId:string,conversationType:ConversationType,targetId:string,reactionId:string,operation:added|removed|cleared,userId:string,reactionTime:int64,totalCount:uint32,users:string[]?}是API 参考 · 事件载荷
MESSAGE_EXPANSION_CHANGED{messageId:string,conversationType:ConversationType,targetId:string,updated:Record<string,string>?,removed:string[]?,timestamp:int64}是API 参考 · 事件载荷
STREAM_MESSAGE_CHANGED{streamId:string,messageId:string,conversationType:ConversationType,targetId:string,senderId:string,delta:string,seq:uint32,text:string,status:streaming|ended,complete:bool,timestamp:int64}否API 参考 · 事件载荷
PRESENCE_CHANGED{userId:string,online:bool,lastSeenAt:int64,timestamp:int64,reason:connect|disconnect|kick|deactivate}是API 参考 · 事件载荷
FRIEND_EVENT{kind:FriendEventKind,request?:FriendRequest,fromUserId?:string,toUserId?:string,timestamp:int64}是API 参考 · 事件载荷
CHATROOM_EVENT{chatroomId:string,kind:ChatroomEventKind,userId?:string,onlineCount?:uint32,chatroom?:Chatroom,timestamp:int64}是API 参考 · 事件载荷
KICKED{code:int,reason:string}是API 参考 · 事件载荷

枚举与常量索引​

枚举取值在 API 参考的「枚举」页逐项列出(名称、取值、语义),错误码另有状态码页。

常量 / 枚举取值数文档位置
Events17枚举 · event-type
RCConnectionStatus4枚举 · connection-status
ConversationType5枚举 · conversation-type
MessageDirection2枚举 · direction
ErrorCode47枚举 · error-code
SYSTEM_TARGET_ID—状态码与错误处理

数据类型索引​

公开数据类型分两类:有独立页面的核心结构(消息、会话、群组、内容联合体等),以及只作为参数/返回结构出现的选项与结果对象(字段在对应方法的参数表与返回值中说明)。

随方法说明的类型​

ChannelType、CombineContent、Config、Content、ConversationRef、ConversationTag、ConversationTagConversation、Conversations、Count、Counts、CurrentUserReacted、GroupId、Groups、IMClient、Id、Ids、Inactive、Indexed、Info、JoinPolicy、Joined、MaxChars、Member、Members、MentionedInfo、MessageReadDetailItem、More、Ms、MsgId、Names、Policy、PushToken、Quote、ReactionSummary、Seq、StreamMessage、SupergroupChannel、Time、Token、Total、Type、Until、Url、UserGroup、Version

如何反馈差异​

  • 方法语义与签名:以 功能列表 与各功能页为准;
  • 错误码与重试:见 状态码;
  • 若发现“制品导出但文档未说明”或“文档说明但制品未导出”,请提交到文档反馈渠道,会按版本更新日志同步。