Group Member Management

chat.getGroupMemberList(options);

// Pull all administrators of the group
let promise = chat.getGroupMemberList({
  groupID: 'group1',
  role: TencentCloudChat.TYPES.GRP_MBR_ROLE_ADMIN,
  count: 15,
  offset: 0
});
promise.then(function(imResponse) {
  console.log(imResponse.data.memberList);
}).catch(function(imError) {
  console.warn('getGroupMemberList error:', imError);
});

// Pull the muting end timestamp of group members.
let promise = tim.getGroupMemberList({
   groupID: 'group1',
   count: 30,
   offset:0,
 }); // Pull 30 group members starting from 0
promise.then(function(imResponse) {
  console.log(imResponse.data.memberList); // Group member list
  for (let groupMember of imResponse.data.memberList) {
    if (groupMember.muteUntil * 1000  > Date.now()) {
      console.log(`${groupMember.userID} muted`);
    } else {
      console.log(`${groupMember.userID} not muted`);
    }
  }
}).catch(function(imError) {
    console.warn('getGroupMemberProfile error:', imError);
});

// The Premium edition supports retrieving the list of online members in the AVChatRoom
let promise = chat.getGroupMemberList({
   groupID: 'group1',
   filter: 1000,
   offset:0, // Default is to start pulling from 0
 });
promise.then(function(imResponse) {
  console.log(imResponse.data.memberList); // Group member list
}).catch(function(imError) {
  console.warn('getGroupMemberList error:', imError);
});

// filter the list of online members in the AVChatRoom
let promise = chat.getGroupMemberList({ groupID: 'group1', filter: 1000, offset: 0 });
promise.then(function(imResponse) {
  console.log(imResponse.data.memberList);
}).catch(function(imError) {
  console.warn('getGroupMemberList error:', imError);
});

chat.setGroupMemberMuteTime(options);

let promise = chat.setGroupMemberMuteTime({
  groupID: 'group1',
  userID: 'user1',
  muteTime: 600 // Mute for 10 minutes; set to 0 to unmute
});
promise.then(function(imResponse) {
  console.log(imResponse.data.group); // New group profile
  console.log(imResponse.data.member); // New member profile
}).catch(function(imError) {
  console.warn('setGroupMemberMuteTime error:', imError); // Error information
});

// Set the period for muting a group member in the topic
let promise = chat.setGroupMemberMuteTime({
  groupID: 'topicID',
  userID: 'user1',
  muteTime: 600 // Mute for 10 minutes; set to 0 to unmute
});
promise.then(function(imResponse) {
  console.log(imResponse.data.group); // New group profile
  console.log(imResponse.data.member); // New member profile
}).catch(function(imError) {
  console.warn('setGroupMemberMuteTime error:', imError); // Error information
});

// Global Mute
let promise = chat.updateGroupProfile({
  groupID: 'group1',
  muteAllMembers: true, // true: mute all; false: unmute all
});
promise.then(function(imResponse) {
  console.log(imResponse.data.group) // Detailed group profile after modification
}).catch(function(imError) {
  console.warn('updateGroupProfile error:', imError); // Error information
});

chat.addGroupMember(options);

let promise = chat.addGroupMember({groupID: 'group1', userIDList: ['user1','user2','user3']});
promise.then(function(imResponse) {
  console.log(imResponse.data.successUserIDList);
  console.log(imResponse.data.failureUserIDList);
  console.log(imResponse.data.existedUserIDList);
  // A user userX is allowed to join up to N groups. 
  // If userX has already joined N groups, attempting to add userX as a group member again will result in userX being unable to join the group normally.
  // SDK places userX's information into the overLimitUserIDList for processing by the access side.
  console.log(imResponse.data.overLimitUserIDList);
  console.log(imResponse.data.group);
}).catch(function(imError) {
  console.warn('addGroupMember error:', imError);
});

chat.deleteGroupMember(options);

// Removing group members from non-live groups
let promise = chat.deleteGroupMember({
   groupID: 'group1',
   userIDList:['user1'],
   reason: 'You violated the rules, I am kicking you out!',
 });
promise.then(function(imResponse) {
  console.log(imResponse.data.group); // Group profile after group member removal
  console.log(imResponse.data.userIDList); // List of userID of the removed group member
}).catch(function(imError) {
  console.warn('deleteGroupMember error:', imError); // Error information
});

// Removing group members from AVChatRoom
let promise = chat.deleteGroupMember({
   groupID: 'group1',
   userIDList:['user1'],
   reason: "You violated the rules, I'm kicking you out!",
   duration: 60,
 });
promise.then(function(imResponse) {
  console.log(imResponse.data.group); // Group profile after group member removal
  console.log(imResponse.data.userIDList); // List of userID of the removed group member
}).catch(function(imError) {
  console.warn('deleteGroupMember error:', imError); // Error information
});

chat.setGroupMemberRole(options);

let promise = chat.setGroupMemberRole({
  groupID: 'group1',
  userID: 'user1',
  role: TencentCloudChat.TYPES.GRP_MBR_ROLE_ADMIN // Set user: user1 as an admin in group ID: group1
});
promise.then(function(imResponse) {
  console.log(imResponse.data.group); // New group profile
  console.log(imResponse.data.member); // New member profile
}).catch(function(imError) {
  console.warn('setGroupMemberRole error:', imError); // Error information
});

chat.getGroupOnlineMemberCount(groupID);

// Querying the Number of Online Users in an AVChatRoom
let promise = chat.getGroupOnlineMemberCount('group1');
promise.then(function(imResponse) {
  console.log(imResponse.data.memberCount);
}).catch(function(imError) {
  console.warn('getGroupOnlineMemberCount error:', imError); // Error information
});