types
- types
- “flooNotice” (res)
- “flooError” (res)
- “loginFail” (desc)
- “loginSuccess” (res)
- “onGroupListUpdate” (meta)
- “onGroupMemberChanged” (groupId)
- “onGroupMessage” (meta)
- “onInputStatusMessage” (res)
- “onMentionMessage” (meta)
- “onMessageCanceled” (res)
- “onMessageDeleted” (res)
- “onMessageRecalled” (res)
- “onMessageStatusChanged” (res)
- “onReceiveHistoryMsg” (res)
- “onRosterInfoUpdate” (res)
- “onRosterListUpdate” (meta)
- “onRosterMessage” (meta)
- “onSendingMessageStatusChanged” (res)
- “onUnreadChange” (cid)
- “recentlistUpdate”
- “onGroupCreated” (meta)
- “onGroupDestoryed” (meta)
- “onGroupJoined” (meta)
- “onGroupApplyAccepted” (meta)
- “onGroupApplyDeclined” (meta)
- “onGroupBaned” (meta)
- “onGroupUnbaned” (meta)
- ~RosterItem
- ~UserSettings
- ~UserProfile
- ~Meta
- ~RosterApplication
- ~GroupInfoAndSettings
- ~BriefGroupInfoAndSettings
- ~GroupMember
- ~GroupMemberBanned
- ~GroupUserRelationResponse
- ~GroupAnnouncement
- ~GroupInfoRequest
- ~GroupBannedMemberRequest
- ~GroupBlockedListItem
- ~GroupInvitation
- ~GroupApplication
- ~GroupSharedFile
- ~GroupSharedFileResponse
- ~GroupBanAllResponse
- ~FileUpload
- ~FileUploadResult
- ~fileUploadProgress
- ~ConversationItem
- ~UserProfile
- ~UserSettings
- ~Event
- ~EventCallback
“flooNotice” (res)
Floo通知
Kind: event emitted by types
Param | Type | Description |
---|---|---|
res | object |
结果 |
res.category | string |
类别 |
res.desc | string |
描述 |
Example
{category: 'loginMessage',desc: 'socket connecting...'} // 开始建连接
{category: 'loginMessage',desc: 'socket connect success...'} // 连接成功
{category: 'loginMessage',desc: 'logining socket service...'} // 开始登录
{category: 'loginMessage',desc: 'login socket failure ......'} // 登录失败
{category: 'loginMessage',desc: 'login socket success.....'} // 登录成功
{category: 'loginMessage', desc: 'getting token...' } //获取token
{category: 'loginMessage',desc: 'token sucecc, getting roster lists..'} // 获取token成功,开始获取好友列表
{category: 'loginMessage',desc: 'get roster list failure:' + ex.message} // 获取好友列表失败
{category: 'action', desc: 'relogin' } // 需要自动登录
{category: 'action', desc: 'relogin_manually' } // 需要手动登录
{category: 'conversation_deleted',desc: { id, source:'user_operation' }} // 会话被删除。ID:会话ID, source: 来源
{category: 'userNotice', desc:'PASSWORD_CHANGED'} // 用户密码改变
{category: 'userNotice', desc:'FROZEN'} // 用户账户被封禁
{category: 'userNotice', desc:'REMOVED'} // 用户被删除
{category: 'userNotice', desc:'KICK_BY_SAME_DEVICE'} // 当前设备被相同设备踢下线
{category: 'userNotice', desc:'KICKED_BY_OTHER_DEVICE'} // 当前设备被其它设备踢下线
{category: 'userNotice', desc:'INFO_UPDATED'} // 用户信息改变:profile或setting
{category: 'userNotice', desc:'DEVICE_LOGIN'} // 用户其它设备上线
{category: 'userNotice', desc:'DEVICE_LOGOUT'} // 用户其它设备下线
{category: 'userNotice', desc:'DEVICE_ADDED'} // 新设备通知
{category: 'userNotice', desc:'DEVICE_REMOVED'} // 设备被移除的通知
{category: 'userNotice', desc:'CLUSTER_CHANGED'} // 用户所在集群改变 需要重新登录
“flooError” (res)
Floo错误
Kind: event emitted by types
Param | Type | Description |
---|---|---|
res | object |
|
res.category | string |
类别 |
res.desc | string |
描述 |
Example
{category: 'USER_BANNED', desc:'用户被禁言'}
{category: 'USER_FROZEN', desc:'用户被冻结,请联系App管理员。'}
{category: 'APP_FROZEN', desc:'APP 被冻结,请登陆蓝莺IM控制台查看详情。'}
{category: 'LICENSE', desc:'无效 LICENSE,请确认服务已按时付费。'}
{category: 'LICENSE', desc:'超出 LICENSE 用户数限制,请购买更高规格服务。'}
{category: 'DNS_FAILED', desc: dnsServer } // DNS错误: 无法访问
“loginFail” (desc)
登录失败
Kind: event emitted by types
Param | Type | Description |
---|---|---|
desc | string |
失败原因 |
“loginSuccess” (res)
登录成功
Kind: event emitted by types
Param | Type | Description |
---|---|---|
res | object |
空对象 |
“onGroupListUpdate” (meta)
群列表更新
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
undefined |
“onGroupMemberChanged” (groupId)
群成员列表更新
Kind: event emitted by types
Param | Type | Description |
---|---|---|
groupId | number |
群ID |
“onGroupMessage” (meta)
收到群消息
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
消息内容 |
“onInputStatusMessage” (res)
对方正在输入
Kind: event emitted by types
Param | Type | Description |
---|---|---|
res | object |
|
res.ext | string |
扩展字段 |
res.from | string |
发送者用户ID |
res.to | string |
接收者用户ID |
“onMentionMessage” (meta)
收到群组@消息
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
消息内容 |
“onMessageCanceled” (res)
消息被取消已读
Kind: event emitted by types
Param | Type | Description |
---|---|---|
res | object |
|
res.uid | string |
会话ID |
res.mid | string |
消息ID |
“onMessageDeleted” (res)
消息被删除
Kind: event emitted by types
Param | Type | Description |
---|---|---|
res | object |
|
res.uid | string |
会话ID |
res.mid | string |
消息ID |
“onMessageRecalled” (res)
消息被撤回
Kind: event emitted by types
Param | Type | Description |
---|---|---|
res | object |
|
res.uid | string |
会话ID |
res.mid | string |
消息ID |
“onMessageStatusChanged” (res)
消息状态变更:撤回/删除/已读
Kind: event emitted by types
Param | Type | Description |
---|---|---|
res | object |
|
res.uid | string |
会话ID |
res.mid | string |
消息ID |
“onReceiveHistoryMsg” (res)
收到历史消息
Kind: event emitted by types
Param | Type | Description |
---|---|---|
res | object |
|
res.next | number |
下次取历史消息的key |
“onRosterInfoUpdate” (res)
好友信息变更
Kind: event emitted by types
Param | Type | Description |
---|---|---|
res | object |
|
res.rosterIds | Array.<number> |
好友的用户ID列表 |
“onRosterListUpdate” (meta)
好友列表变更
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
好友通知的消息内容 |
“onRosterMessage” (meta)
收到单聊消息
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
消息内容 |
“onSendingMessageStatusChanged” (res)
消息发送状态变更
Kind: event emitted by types
Param | Type | Description | ||
---|---|---|---|---|
res | object |
|||
res.status: | number |
发送状态,取值为sending | failed | sent |
res.mid: | number |
客户端生成的client_mid |
“onUnreadChange” (cid)
未读数改变
Kind: event emitted by types
Param | Type | Description |
---|---|---|
cid | number |
会话ID |
“recentlistUpdate”
最近会话更新
Kind: event emitted by types
“onGroupCreated” (meta)
群组创建通知
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
群通知的消息内容 |
“onGroupDestoryed” (meta)
群组解散通知
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
群通知的消息内容 |
“onGroupJoined” (meta)
成员入群通知
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
群通知的消息内容 |
“onGroupApplyAccepted” (meta)
群申请被通过
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
群通知的消息内容 |
“onGroupApplyDeclined” (meta)
群申请被拒绝
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
群通知的消息内容 |
“onGroupBaned” (meta)
被群禁言
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
群通知的消息内容 |
“onGroupUnbaned” (meta)
被群取消禁言
Kind: event emitted by types
Param | Type | Description |
---|---|---|
meta | Meta |
群通知的消息内容 |
types~RosterItem : object
好友信息
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
alias | string |
别名 |
auth_mode | number |
验证方式, 0 - 无需验证,任何人可以加为好友, 1 - 需要同意方可加为好友, 2 - 需要回答问题正确方可加为好友, 3 - 拒绝所有加好友申请,int32 |
auth_question | string |
验证问题 |
avatar | string |
头像 |
description | string |
描述信息 |
ext | string |
扩展信息 |
mute_notification | boolean |
是否接收消息提醒 |
nick_name | string |
昵称或名称 |
public_info | string |
公开信息,好友和陌生人可见 |
relation | number |
关系: 0 - 好友,1 - 被删除,2 - 陌生人, int32 |
user_id | number |
好友用户ID,int64 |
username | string |
用户名 |
types~UserSettings : object
用户设置信息
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
auth_answer | string |
验证问题答案 |
auth_mode | number |
验证方式, 0 - 无需验证,任何人可以加为好友, 1 - 需要同意方可加为好友, 2 - 需要回答问题正确方可加为好友, 3 - 拒绝所有加好友申请,int32 |
auth_question | string |
验证问题 |
auto_download | boolean |
是否自动下载 |
group_confirm | boolean |
邀请入群时是否需要用户确认: true - 需要用户同意才可加入, false - 自动同意邀请 |
id | number |
用户ID, int64 |
no_push | boolean |
是否关闭推送消息 |
no_push_detail | boolean |
是否推送详情 |
no_push_end_hour | number |
推送免打扰结束时间,int32 |
no_push_start_hour | number |
推送免打扰开始时间,int32 |
no_sounds | boolean |
收到消息时是否静音 |
push_nick_name | string |
推送昵称 |
push_token | string |
推送token |
silence_end_time | number |
推送不提醒结束时间,int32 |
silence_start_time | number |
推送不提醒开始时间,int32 |
user_id | number |
用户ID,int64 |
vibratory | boolean |
收到消息时否振动 |
types~UserProfile : object
用户信息
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
avatar | string |
头像 url |
description | string |
描述信息 |
string |
邮箱 | |
mobile | string |
手机号码 |
nick_name | string |
昵称 |
private_info | string |
私有信息,仅自己可见 |
public_info | string |
公开信息,好友和陌生人可见 |
user_id | number |
用户ID,int64 |
username | string |
用户名 |
types~Meta : object
消息体
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
id | string |
消息ID |
from | string |
发送者 |
to | string |
接收者 |
content | string |
消息内容 |
type | string |
消息类型: text - 文本, image - 图片, audio - 语音, video - 视频,file - 文件, location - 位置, command - 命令, forward - 转发 |
ext | string |
object |
config | string |
object |
attach | string |
object |
status | number |
消息状态: 0 - 未读, 1 - 已投递, 2 - 已读 |
timestamp | string |
消息发送时间戳(毫秒) |
toType | string |
接收者类型: roster - 好友, group - 群组 |
types~RosterApplication : object
加好友申请列表项
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
expired_time | number |
过期时间,int64 |
reason | string |
申请描述 |
status | number |
状态: 0 - 等待确认, 1 - 接受, 2 - 拒绝。 int32 |
user_id | number |
发起加好友申请的用户ID,int64 |
types~GroupInfoAndSettings : object
群信息
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
apply_approval | number |
入群申请审批设置, 0:同意所有申请 1:需要管理员确认 2:拒绝所有申请 |
avatar | string |
群头像 |
ban_expire_time | number |
全员禁言过期时间(秒),禁言期间只允许管理员发消息, 为0或小于当前时间表示不禁言, -1表示永久禁言 |
created_at | number |
创建时间 |
description | string |
群描述 |
ext | string |
群扩展信息 |
group_id | number |
群id,int64 |
history_visible | boolean |
新成员可见历史聊天记录设置 |
member_invite | boolean |
群成员邀请设置: false - 不允许邀请, true - 允许邀请(默认) |
member_modify | boolean |
群成员修改群信息设置: false - 群成员不能修改群信息(默认), true - 群成员可以修改群信息 |
msg_mute_mode | number |
群消息屏蔽模式: 0 - 表示不屏蔽, 1 - 表示屏蔽本地消息通知, 2 - 表示屏蔽消息,不接收消息 |
msg_push_mode | number |
群消息推送模式:0 - 接收所有推送,1 - 不接受推送,2 - 接收管理员和@消息推送, 3 - 只接收管理员消息推送, 4 - 只接收@消息推送 |
name | string |
群名称 |
owner_id | number |
群主id,int64 |
read_ack | boolean |
群消息已读功能设置 |
status | number |
群状态, 0:正常, 1:已解散 |
type | number |
群类型: 1表示公开群,0表示私有群, 2表示聊天室 |
updated_at | number |
更新时间,int64 |
count | number |
群成员数 |
capacity | number |
群容量 |
types~BriefGroupInfoAndSettings : object
群简要信息及用户设置
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
apply_approval | number |
入群申请审批设置, 0:同意所有申请 1:需要管理员确认 2:拒绝所有申请 |
avatar | string |
群头像 |
capacity | number |
群容量 |
count | number |
群成员数 |
group_id | number |
群id,int64 |
msg_mute_mode | number |
群消息屏蔽模式: 0 - 表示不屏蔽, 1 - 表示屏蔽本地消息通知, 2 - 表示屏蔽消息,不接收消息 |
msg_push_mode | number |
群消息推送模式:0 - 接收所有推送,1 - 不接受推送,2 - 接收管理员和@消息推送, 3 - 只接收管理员消息推送, 4 - 只接收@消息推送 |
name | string |
群名称 |
owner | number |
群主id,int64 |
status | number |
群状态, 0:正常, 1:已解散,int32 |
type | number |
群类型: 1表示公开群,0表示私有群, 2表示聊天室。int32 |
types~GroupMember : object
群成员格式
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
display_name | string |
成员群名片 |
join_time | number |
成员入群时间,int64 |
user_id | number |
用户id,int64 |
avatar | string |
头像地址 |
types~GroupMemberBanned : object
禁言成员
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
display_name | string |
成员群名片 |
join_time | number |
成员入群时间,int64 |
user_id | number |
用户id,int64 |
avatar | string |
头像地址 |
expired_time | number |
禁言过期时间 |
types~GroupUserRelationResponse : object
群用户请求结果
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
reason | string |
原因 |
result | string |
结果 |
user_id | number |
用户ID,int64 |
types~GroupAnnouncement : object
群公告内容
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
author | number |
公告发布者,int64 |
content | string |
公告内容 |
created_at | number |
公告发布时间,int64 |
group_id | number |
群id,int64 |
id | number |
公告id,int64 |
title | string |
公告标题 |
types~GroupInfoRequest : object
创建群
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
avatar | string |
群头像 |
description | string |
群描述 |
name | string |
群名称 |
type | number |
群类型 1表示公开群,0表示私有群, 2表示聊天室,int32 |
user_list | Array.<number> |
邀请入群的用户id列表 |
types~GroupBannedMemberRequest : object
禁言请求
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
duration | number |
禁言时长,单位为分钟,int64 |
group_id | number |
群id,int64 |
user_list | Array.<number> |
用户id列表 |
types~GroupBlockedListItem : object
群组黑名单
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
user_id | number |
用户id,int64 |
group_id | number |
群id,int64 |
create_at | string |
创建时间 |
types~GroupInvitation : object
群组邀请信息
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
group_id | number |
群ID |
inviter_id | number |
邀请者ID |
invitee_id | number |
被邀请者ID |
reason | string |
原因 |
status | number |
状态: 0 - 待处理,1 - 用户同意,2 - 用户拒绝 |
expire_time | number |
过期时间 |
create_at | string |
创建时间 |
types~GroupApplication : object
群申请信息
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
group_id | number |
群ID |
applicant_id | number |
申请者ID |
reason | string |
原因 |
expire_time | number |
过期时间 |
status | number |
状态: 0 - 待处理,1 - 同意,2 - 拒绝 |
types~GroupSharedFile : object
群共享文件返回格式
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
created_at | number |
int64 |
file_id | number |
共享文件id,int64 |
group_id | number |
群id,int64 |
name | string |
共享文件名称 |
size | number |
共享文件大小,int64 |
type | string |
共享文件类型 |
updated_at | number |
int64 |
uploader | number |
共享文件上传者,int64 |
url | string |
共享文件url |
types~GroupSharedFileResponse : object
删除群共享文件结果
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
file_id | number |
文件ID |
reason | string |
原因 |
result | string |
结果 |
types~GroupBanAllResponse : object
全员禁言结果
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
ban_expire_time | number |
全员禁言过期时间,int64 |
types~FileUpload : object
文件上传信息
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
download_url | string |
下载地址 |
oss_body_param | object.<string, string> |
额外参数 |
upload_url | string |
上传地址 |
types~FileUploadResult : object
文件上传结果
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
url | string |
下载地址 |
types~fileUploadProgress : function
文件上传进度回调
Kind: inner typedef of types
Param | Type | Description |
---|---|---|
res | object |
进度 |
res.loaded | number |
已下载字节数 |
res.total | number |
总字节数 |
types~ConversationItem : object
会话信息
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
id | number |
会话ID |
content | string |
消息内容 |
timestamp | string |
消息发送时间戳(毫秒) |
type | string |
会话类型: roster - 单聊, group - 群聊 |
types~UserProfile : object
用户信息
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
avatar | string |
头像 url |
description | string |
描述信息 |
string |
邮箱 | |
mobile | string |
手机号码 |
nick_name | string |
昵称 |
private_info | string |
私有信息,仅自己可见 |
public_info | string |
公开信息,好友和陌生人可见 |
user_id | number |
用户ID,int64 |
username | string |
用户名 |
types~UserSettings : object
用户设置信息
Kind: inner typedef of types
Properties
Name | Type | Description |
---|---|---|
auth_answer | string |
验证问题答案 |
auth_mode | number |
验证方式, 0 - 无需验证,任何人可以加为好友, 1 - 需要同意方可加为好友, 2 - 需要回答问题正确方可加为好友, 3 - 拒绝所有加好友申请,int32 |
auth_question | string |
验证问题 |
auto_download | boolean |
是否自动下载 |
group_confirm | boolean |
邀请入群时是否需要用户确认: true - 需要用户同意才可加入, false - 自动同意邀请 |
id | number |
设置ID |
no_push | boolean |
是否关闭推送消息 |
no_push_detail | boolean |
是否推送详情 |
no_push_end_hour | number |
推送免打扰结束时间,int32 |
no_push_start_hour | number |
推送免打扰开始时间,int32 |
no_sounds | boolean |
收到消息时是否静音 |
push_nick_name | string |
推送昵称 |
push_token | string |
推送token |
silence_end_time | number |
推送不提醒结束时间,int32 |
silence_start_time | number |
推送不提醒开始时间,int32 |
user_id | number |
用户ID,int64 |
vibratory | boolean |
收到消息时否振动 |
types~Event : string
监听事件名称
Kind: inner typedef of types
types~EventCallback : function
监听事件回调
Kind: inner typedef of types
Param | Type | Description |
---|---|---|
res | flooNotice |
flooError |