public abstract class GroupInfo extends GroupBasicInfo
GroupBasicInfo.Type
Constructor and Description |
---|
GroupInfo() |
Modifier and Type | Method and Description |
---|---|
abstract void |
addGroupKeeper(java.util.List<UserInfo> userInfos,
BasicCallback callback)
添加群管理员,管理员可以移除、禁言普通群成员,并且在公开群组里可以直接添加群成员和审核入群审批
GroupApprovalEvent .
群主可以添加、取消管理员并且移除或禁言管理员 |
abstract void |
changeGroupAdmin(java.lang.String username,
java.lang.String appKey,
BasicCallback callback)
移交群主,将群主移交給指定群内成员,移交群主后原群主成为普通群成员.
移交群主成功后群内所有成员会收到群主变更事件,SDK收到事件会以类型为 EventNotificationContent.EventNotificationType.group_owner_changed
的消息事件方式上报 |
abstract void |
getAvatarBitmap(GetAvatarBitmapCallback callback)
从本地获取群组头像的缩略图bitmap,如果本地存在头像缩略图文件,直接返回;若不存在,会异步从服务器拉取。
下载完成后 会将头像保存至本地并返回。当群组未设置头像,或者下载失败时回调返回Null。
所有的缩略头像bitmap在sdk内都会缓存, 并且会有清理机制,所以上层不需要对缩略头像bitmap做缓存。 |
abstract java.io.File |
getAvatarFile()
从本地获取群头像缩略图文件,头像缩略图会在调用
JMessageClient.getGroupInfo(long, GetGroupInfoCallback)
时自动下载。当此群未设置头像,或者自动下载失败时此接口返回Null。 |
abstract void |
getBigAvatarBitmap(GetAvatarBitmapCallback callback)
从本地获取群组头像的原图bitmap,如果本地存在头像原图文件,直接返回;若不存在,会异步从服务器拉取。
下载完成后 会将头像保存至本地并返回。当群组未设置头像,或者下载失败时回调返回Null。
注意:在调用 updateAvatar(File, String, BasicCallback) 上传头像时,若
上传的头像未经压缩处理,调此接口则有可能出现OOM |
abstract java.io.File |
getBigAvatarFile()
从本地获取群组头像原图文件,当群组未设置头像,或者本地不存在头像原图文件时此接口返回Null。
|
abstract java.util.List<UserInfo> |
getGroupKeepers()
获取群管理员列表, 返回群内管理员的成员信息列表,管理员角色描述详见官方文档群组管理员
|
abstract UserInfo |
getGroupMemberInfo(java.lang.String username)
Deprecated.
deprecated in jmessage 1.3.0 use
getGroupMemberInfo(String, String) instead. |
abstract UserInfo |
getGroupMemberInfo(java.lang.String username,
java.lang.String appKey)
根据appKey跨应用获取单个群成员UserInfo
|
abstract java.util.List<UserInfo> |
getGroupMembers()
获取群成员userinfo列表。
|
abstract java.lang.String |
getGroupOwner()
获取群主的username
|
abstract java.util.List<UserInfo> |
getGroupSilenceMembers()
获取群成员禁言列表,返回群内被禁言的成员信息列表
|
abstract int |
getNoDisturb()
群组是否在免打扰名单中
|
abstract java.lang.String |
getOwnerAppkey()
获取群主所属appkey
|
abstract int |
isGroupBlocked()
群组是否在被屏蔽的名单中
|
abstract boolean |
isKeepSilence(java.lang.String username,
java.lang.String appKey)
判断用户在该群内是否被禁言,若被禁言返回true,否则返回false
|
abstract void |
removeGroupKeeper(java.util.List<UserInfo> userInfos,
BasicCallback callback)
取消群管理员,管理员角色描述详见官方文档群组管理员
|
abstract void |
setBlockGroupMessage(int blocked,
BasicCallback callback)
设置屏蔽群消息,设置后将不会再收到此群的消息
|
abstract void |
setGroupMemSilence(java.lang.String username,
java.lang.String appKey,
boolean keepSilence,
BasicCallback callback)
群成员禁言状态设置,禁言后用户可正常接收消息,但无法向被禁言的群组中发送消息
解禁后可正常发送消息,禁言状态设置成功后群内所有成员将会收到群禁言通知事件
sdk收到群禁言通知事件后会以类型为
ContentType.eventNotification
的消息事件方式上报 |
abstract void |
setNoDisturb(int noDisturb,
BasicCallback callback)
将此群组设置为免打扰。设置之后收到此群消息时将不会在通知栏展示通知
|
abstract void |
updateAvatar(java.io.File avatar,
java.lang.String format,
BasicCallback callback)
更新群组头像,建议用户在上传头像前先对头像先进行压缩,否则在调用
getBigAvatarBitmap(GetAvatarBitmapCallback)
接口拿头像的原图时,有可能会抛出OOM异常。 |
abstract void |
updateDescription(java.lang.String groupDesc,
BasicCallback callback)
修改群组描述,新的描述不允许为空
|
abstract void |
updateName(java.lang.String groupName,
BasicCallback callback)
修改群组名称,新的群名称不允许为空
|
getAvatar, getGroupDescription, getGroupFlag, getGroupID, getGroupLevel, getGroupName, getGroupType, getMaxMemberCount
public abstract int getNoDisturb()
public abstract java.lang.String getGroupOwner()
public abstract java.lang.String getOwnerAppkey()
public abstract java.util.List<UserInfo> getGroupMembers()
@Deprecated public abstract UserInfo getGroupMemberInfo(java.lang.String username)
getGroupMemberInfo(String, String)
instead.getGroupMemberInfo(String, String)
username
- 指定群成员的usernamepublic abstract UserInfo getGroupMemberInfo(java.lang.String username, java.lang.String appKey)
username
- 指定群成员的usernameappKey
- 群成员所属的appKeypublic abstract void setNoDisturb(int noDisturb, BasicCallback callback)
noDisturb
- 1 -- 免打扰,其他 -- 非免打扰callback
- 回调接口public abstract void setBlockGroupMessage(int blocked, BasicCallback callback)
blocked
- 1 -- 设置屏蔽; 其他(int) -- 取消屏蔽callback
- 回调接口public abstract int isGroupBlocked()
public abstract java.io.File getAvatarFile()
JMessageClient.getGroupInfo(long, GetGroupInfoCallback)
时自动下载。当此群未设置头像,或者自动下载失败时此接口返回Null。public abstract void getAvatarBitmap(GetAvatarBitmapCallback callback)
public abstract java.io.File getBigAvatarFile()
public abstract void getBigAvatarBitmap(GetAvatarBitmapCallback callback)
updateAvatar(File, String, BasicCallback)
上传头像时,若
上传的头像未经压缩处理,调此接口则有可能出现OOMpublic abstract void updateAvatar(java.io.File avatar, java.lang.String format, BasicCallback callback)
getBigAvatarBitmap(GetAvatarBitmapCallback)
接口拿头像的原图时,有可能会抛出OOM异常。
此接口可以指定头像文件在后台存储时的扩展名,如果填空或者不填,则后台存储文件时将没有扩展名。
avatar
- 头像文件format
- 文件扩展名,注意名称中不要包括"."callback
- 回调对象public abstract void updateName(java.lang.String groupName, BasicCallback callback)
groupName
- 群名称callback
- 回调接口public abstract void updateDescription(java.lang.String groupDesc, BasicCallback callback)
groupDesc
- 群组描述callback
- 回调接口public abstract void setGroupMemSilence(java.lang.String username, java.lang.String appKey, boolean keepSilence, BasicCallback callback)
ContentType.eventNotification
的消息事件方式上报username
- 待设置群成员的usernameappKey
- 待设置群成员的appKey,传入空则默认使用本应用appKeykeepSilence
- //true 设置禁言, false 取消禁言callback
- public abstract java.util.List<UserInfo> getGroupSilenceMembers()
public abstract boolean isKeepSilence(java.lang.String username, java.lang.String appKey)
username
- 待判断用户的用户名appKey
- 待判断用户的appKey,若传入空则默认使用本应用appKeypublic abstract void addGroupKeeper(java.util.List<UserInfo> userInfos, BasicCallback callback)
GroupApprovalEvent
.
群主可以添加、取消管理员并且移除或禁言管理员userInfos
- 群成员UserInfo列表callback
- 回调public abstract void removeGroupKeeper(java.util.List<UserInfo> userInfos, BasicCallback callback)
userInfos
- 群成员UserInfo列表callback
- 回调public abstract java.util.List<UserInfo> getGroupKeepers()
public abstract void changeGroupAdmin(java.lang.String username, java.lang.String appKey, BasicCallback callback)
EventNotificationContent.EventNotificationType.group_owner_changed
的消息事件方式上报username
- 待移交者用户名appKey
- 待移交者appKey, 若传入空则默认使用本应用appKey