即时通讯

  • 即时通讯 > API 文档 > IM Web 文档 > types

    types

    最近更新时间: 2022-05-24 16:45:57

    types

    “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 描述信息
    email 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 描述信息
    email 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
    以上内容是否对您有帮助?
  • Qvm free helper
    Close