Message API

介绍

Message模块主要包装了Carrier消息功能,我们在开发过程中预置了Carrier离线接口,待Carrier离线消息SDK提供后,进行补充,其中借鉴了Hyper的消息封装代码。(message模块api目前只支持Android)

目录

1. 是否链接上节点

  • 方法名称 isConnected

返回参数

参数 类型 描述 必须 说明
isConnected boolean true、false

2. 启动节点

  • 方法名称 run

清除carrier

  • 方法名称 cleanup

3. 关闭节点

  • 方法名称 kill

4. 发送文件

  • 方法名称 sendFile
参数 类型 描述 必须 说明
file file

返回参数

参数 类型 描述 必须 说明
fileId string

5. 停止正在传送的文件

  • 方法名称 stopFile
参数 类型 描述 必须 说明
fileId string

6. 获取地址

  • getAddress

返回参数

参数 类型 描述 必须 说明
address string

7. 获取用户id

  • 方法名称 getUserId

返回参数:

参数 类型 描述 必须 说明
userId string 用户id

8. 验证地址有效性

  • 方法名称 isValidAddress
参数 类型 描述 必须 说明
address string

返回参数:

参数 类型 描述 必须 说明
isValidAddress boolean 是否有效 true、false

9. 验证用户id有效性

  • 方法名称 isValidUserId
参数 类型 描述 必须 说明
userId string 用户id

返回参数:

参数 类型 描述 必须 说明
isValidUserId boolean 是否有效 true、false

10. 添加好友

  • 方法名称 addFriend
参数 类型 描述 必须 说明
address string 好友地址
nickname string 昵称
message string 验证消息

同意好友请求

  • 方法名称 acceptFriend
参数 类型 描述 必须 说明
userId string 用户id
nickname string 昵称

解除好友关系

  • removeFriend
参数 类型 描述 必须 说明
userId string 用户id

11. 设置profile

  • setSelfInfo
参数 类型 描述 必须 说明
UserInfo object 用户信息
class UserInfo{
        String userId;
        String name;
        String description;
        boolean hasAvatar;
       String gender;
       String phone;
       String email;
       String region;
}

12. 发送消息

  • sendFriendMessage
参数 类型 描述 必须 说明
userId string 用户id
message string 验证消息

13. 我的profile

  • getSelfInfo

返回参数

参数 类型 描述 必须 说明
UserInfo object 用户信息

获取好友信息

  • getFriend
参数 类型 描述 必须 说明
userId string 用户id

返回参数

参数 类型 描述 必须 说明
FriendInfo object 参考 结构: FriendInfo
class FriendInfo{
        String userId;
        String name;
        String description;
        boolean hasAvatar;
       String gender;
       String phone;
       String email;
       String region;
       ConnectionStatus status  ; // 0: Connected ||  1:Disconnected

}


好友列表

  • getFriends

返回参数

参数 类型 描述 必须 说明
List object 参考 结构: FriendInfo

group

13. 创建一个群组

  • createRoom
参数 类型 描述 必须 说明
title string 群昵称

返回参数

参数 类型 描述 必须 说明
groupId string

好友邀请

  • inviteToRoom
参数 类型 描述 必须 说明
groupId string 群id
friendId string 好友id

返回参数

参数 类型 描述 必须 说明
result boolean 结果

加入群组

  • joinRoom
参数 类型 描述 必须 说明
cookieText string 组的cookie信息
friendId string 用户id

返回参数

参数 类型 描述 必须 说明
result boolean 结果

关闭群组

  • closeRoom
参数 类型 描述 必须 说明
groupId string 群id

返回参数

参数 类型 描述 必须 说明
result boolean 结果

删除群组

  • joinRoom
参数 类型 描述 必须 说明
groupId string 群id

返回参数

参数 类型 描述 必须 说明
result boolean 结果

设置群组昵称

  • setRoomTitle
参数 类型 描述 必须 说明
groupId string 群id
title string 群昵称

返回参数

参数 类型 描述 必须 说明
result boolean 结果

14. 发送群消息

  • sendRoomMessage
参数 类型 描述 必须 说明
groupId string 群id
message string 群消息

返回参数

参数 类型 描述 必须 说明
result boolean 结果

群好友信息

  • getPeerList
参数 类型 描述 必须 说明
groupId string 群id

返回参数

参数 类型 描述 必须 说明
peerInfo object 结果