频道成员管理

频道成员管理提供了完整的群组成员管理功能，包括成员信息获取、成员状态监听、权限管理等核心能力。

获取频道成员

获取频道内所有成员

// 获取频道内所有成员
List<WKChannelMember> members = WKIM.shared.channelMemberManager.getMembers(channelId: channelId);

获取频道内指定用户的成员信息

// 获取频道内指定用户的成员信息
WKChannelMember? member = WKIM.shared.channelMemberManager.getMember(channelId: channelId, uid: uid);

完整成员获取示例

class ChannelMemberManager {
  
  // 获取所有成员
  static List<WKChannelMember> getAllMembers(String channelId) {
    try {
      final members = WKIM.shared.channelMemberManager.getMembers(channelId: channelId);
      print('获取到 ${members.length} 个成员');
      return members;
    } catch (error) {
      print('获取成员列表失败: $error');
      return [];
    }
  }
  
  // 获取指定成员信息
  static WKChannelMember? getMemberInfo(String channelId, String uid) {
    try {
      final member = WKIM.shared.channelMemberManager.getMember(channelId: channelId, uid: uid);
      if (member != null) {
        print('获取成员信息成功: ${member.memberName}');
      }
      return member;
    } catch (error) {
      print('获取成员信息失败: $error');
      return null;
    }
  }
  
  // 按角色筛选成员
  static List<WKChannelMember> getMembersByRole(String channelId, int role) {
    final allMembers = getAllMembers(channelId);
    return allMembers.where((member) => member.role == role).toList();
  }
  
  // 获取管理员列表
  static List<WKChannelMember> getAdminMembers(String channelId) {
    return getMembersByRole(channelId, 1); // 假设1为管理员角色
  }
  
  // 获取普通成员列表
  static List<WKChannelMember> getNormalMembers(String channelId) {
    return getMembersByRole(channelId, 0); // 假设0为普通成员角色
  }
  
  // 搜索成员
  static List<WKChannelMember> searchMembers(String channelId, String keyword) {
    if (keyword.trim().isEmpty) {
      return [];
    }
    
    final allMembers = getAllMembers(channelId);
    return allMembers.where((member) {
      final name = member.memberName.toLowerCase();
      final remark = member.memberRemark.toLowerCase();
      final uid = member.memberUID.toLowerCase();
      final searchKey = keyword.toLowerCase();
      
      return name.contains(searchKey) || 
             remark.contains(searchKey) || 
             uid.contains(searchKey);
    }).toList();
  }
  
  // 获取在线成员（需要结合频道信息）
  static List<WKChannelMember> getOnlineMembers(String channelId) {
    final allMembers = getAllMembers(channelId);
    // 这里需要结合频道管理器获取在线状态
    return allMembers.where((member) {
      final channel = WKIM.shared.channelManager.getChannel(member.memberUID, WKChannelType.personal);
      return channel?.online == 1;
    }).toList();
  }
  
  // 获取成员显示名称
  static String getMemberDisplayName(WKChannelMember member) {
    if (member.memberRemark.isNotEmpty) {
      return member.memberRemark;
    }
    if (member.memberName.isNotEmpty) {
      return member.memberName;
    }
    return member.memberUID;
  }
  
  // 检查成员是否为管理员
  static bool isAdmin(WKChannelMember member) {
    return member.role == 1; // 假设1为管理员角色
  }
  
  // 检查成员是否被禁言
  static bool isMuted(WKChannelMember member) {
    if (member.forbiddenExpirationTime == 0) {
      return false;
    }
    final now = DateTime.now().millisecondsSinceEpoch ~/ 1000;
    return member.forbiddenExpirationTime > now;
  }
  
  // 检查成员是否在黑名单
  static bool isBlacklisted(WKChannelMember member) {
    return member.status == 2; // 2表示黑名单状态
  }
}

事件监听

刷新频道成员监听

// 刷新频道成员
WKIM.shared.channelMemberManager.addOnRefreshMemberListener('key', (WKChannelMember member, bool isEnd) {
    // todo 刷新会话列表
});

// 移除刷新频道成员监听
WKIM.shared.channelMemberManager.removeRefreshMemberListener('key');

key为监听的唯一标识，可以为任意字符串，添加监听和移出监听时需要传入相同的key

完整事件监听管理

class ChannelMemberListener {
  static final Map<String, Function> _refreshListeners = {};
  static StreamController<ChannelMemberUpdateEvent>? _updateController;
  
  // 获取成员更新流
  static Stream<ChannelMemberUpdateEvent> get memberUpdateStream {
    _updateController ??= StreamController<ChannelMemberUpdateEvent>.broadcast();
    return _updateController!.stream;
  }
  
  // 添加成员刷新监听
  static void addRefreshMemberListener(String key, Function(WKChannelMember, bool) callback) {
    _refreshListeners[key] = callback;
    
    WKIM.shared.channelMemberManager.addOnRefreshMemberListener(key, (WKChannelMember member, bool isEnd) {
      // 调用回调
      callback(member, isEnd);
      
      // 发送到流
      _updateController?.add(ChannelMemberUpdateEvent(
        member: member,
        isEnd: isEnd,
        timestamp: DateTime.now(),
      ));
      
      print('频道成员更新: ${member.memberUID}, isEnd: $isEnd');
    });
  }
  
  // 移除成员刷新监听
  static void removeRefreshMemberListener(String key) {
    _refreshListeners.remove(key);
    WKIM.shared.channelMemberManager.removeRefreshMemberListener(key);
  }
  
  // 移除所有监听
  static void removeAllListeners() {
    for (final key in _refreshListeners.keys) {
      WKIM.shared.channelMemberManager.removeRefreshMemberListener(key);
    }
    _refreshListeners.clear();
  }
  
  // 为特定频道添加监听
  static void addChannelMemberListener(String channelId, Function(WKChannelMember, bool) callback) {
    final key = 'channel_$channelId';
    
    addRefreshMemberListener(key, (WKChannelMember member, bool isEnd) {
      if (member.channelID == channelId) {
        callback(member, isEnd);
      }
    });
  }
  
  // 移除特定频道的监听
  static void removeChannelMemberListener(String channelId) {
    final key = 'channel_$channelId';
    removeRefreshMemberListener(key);
  }
  
  // 销毁
  static void dispose() {
    removeAllListeners();
    _updateController?.close();
    _updateController = null;
  }
}

// 频道成员更新事件
class ChannelMemberUpdateEvent {
  final WKChannelMember member;
  final bool isEnd;
  final DateTime timestamp;
  
  ChannelMemberUpdateEvent({
    required this.member,
    required this.isEnd,
    required this.timestamp,
  });
  
  @override
  String toString() {
    return 'ChannelMemberUpdateEvent{memberUID: ${member.memberUID}, isEnd: $isEnd, timestamp: $timestamp}';
  }
}

数据结构说明

WKChannelMember 频道成员对象

class WKChannelMember {
  String channelID = "";           // 频道ID
  int channelType = 0;             // 频道类型
  String memberUID = "";           // 成员ID
  String memberName = "";          // 成员名称
  String memberRemark = "";        // 成员备注
  String memberAvatar = "";        // 成员头像
  int role = 0;                    // 成员角色
  int status = 0;                  // 成员状态（1：正常，2：黑名单）
  int isDeleted = 0;               // 是否删除
  String createdAt = "";           // 创建时间
  String updatedAt = "";           // 修改时间
  int version = 0;                 // 版本
  int robot = 0;                   // 机器人（0：否，1：是）
  dynamic extraMap;                // 扩展字段
  String remark = "";              // 用户备注
  String memberInviteUID = "";     // 邀请者UID
  int forbiddenExpirationTime = 0; // 被禁言到期时间
  String memberAvatarCacheKey = "";// 成员头像缓存key
}

字段说明

字段	类型	说明
`channelID`	String	频道ID
`channelType`	int	频道类型
`memberUID`	String	成员ID
`memberName`	String	成员名称
`memberRemark`	String	成员备注
`memberAvatar`	String	成员头像URL
`role`	int	成员角色（0=普通成员，1=管理员，2=群主）
`status`	int	成员状态（1=正常，2=黑名单）
`isDeleted`	int	是否删除（0=否，1=是）
`version`	int	版本号
`robot`	int	是否机器人（0=否，1=是）
`forbiddenExpirationTime`	int	禁言到期时间戳

成员角色说明

角色值	说明
`0`	普通成员
`1`	管理员
`2`	群主

成员状态说明

状态值	说明
`1`	正常
`2`	黑名单

成员列表组件

class ChannelMemberListWidget extends StatefulWidget {
  final String channelId;
  
  const ChannelMemberListWidget({Key? key, required this.channelId}) : super(key: key);
  
  @override
  _ChannelMemberListWidgetState createState() => _ChannelMemberListWidgetState();
}

class _ChannelMemberListWidgetState extends State<ChannelMemberListWidget> {
  List<WKChannelMember> _members = [];
  List<WKChannelMember> _filteredMembers = [];
  bool _loading = true;
  String _searchKeyword = '';
  StreamSubscription<ChannelMemberUpdateEvent>? _subscription;
  
  @override
  void initState() {
    super.initState();
    _loadMembers();
    _setupListener();
  }
  
  @override
  void dispose() {
    _subscription?.cancel();
    ChannelMemberListener.removeChannelMemberListener(widget.channelId);
    super.dispose();
  }
  
  void _loadMembers() {
    setState(() {
      _loading = true;
    });
    
    final members = ChannelMemberManager.getAllMembers(widget.channelId);
    
    setState(() {
      _members = members;
      _filteredMembers = members;
      _loading = false;
    });
  }
  
  void _setupListener() {
    // 添加成员更新监听
    ChannelMemberListener.addChannelMemberListener(widget.channelId, (member, isEnd) {
      if (isEnd) {
        _loadMembers();
      }
    });
    
    // 监听成员更新流
    _subscription = ChannelMemberListener.memberUpdateStream.listen((event) {
      if (event.member.channelID == widget.channelId && event.isEnd) {
        _loadMembers();
      }
    });
  }
  
  void _searchMembers(String keyword) {
    setState(() {
      _searchKeyword = keyword;
      if (keyword.isEmpty) {
        _filteredMembers = _members;
      } else {
        _filteredMembers = ChannelMemberManager.searchMembers(widget.channelId, keyword);
      }
    });
  }
  
  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        // 搜索框
        Padding(
          padding: EdgeInsets.all(16),
          child: TextField(
            decoration: InputDecoration(
              hintText: '搜索成员',
              prefixIcon: Icon(Icons.search),
              border: OutlineInputBorder(
                borderRadius: BorderRadius.circular(8),
              ),
            ),
            onChanged: _searchMembers,
          ),
        ),
        
        // 成员列表
        Expanded(
          child: _loading
            ? Center(child: CircularProgressIndicator())
            : _filteredMembers.isEmpty
              ? Center(
                  child: Column(
                    mainAxisAlignment: MainAxisAlignment.center,
                    children: [
                      Icon(Icons.people_outline, size: 64, color: Colors.grey),
                      SizedBox(height: 16),
                      Text('暂无成员', style: TextStyle(color: Colors.grey)),
                    ],
                  ),
                )
              : ListView.builder(
                  itemCount: _filteredMembers.length,
                  itemBuilder: (context, index) {
                    final member = _filteredMembers[index];
                    return _buildMemberItem(member);
                  },
                ),
        ),
      ],
    );
  }
  
  Widget _buildMemberItem(WKChannelMember member) {
    return ListTile(
      leading: CircleAvatar(
        backgroundImage: member.memberAvatar.isNotEmpty 
          ? NetworkImage(member.memberAvatar)
          : null,
        child: member.memberAvatar.isEmpty 
          ? Text(member.memberUID.substring(0, 1).toUpperCase())
          : null,
      ),
      title: Text(
        ChannelMemberManager.getMemberDisplayName(member),
        style: TextStyle(fontWeight: FontWeight.w500),
      ),
      subtitle: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          Text('ID: ${member.memberUID}'),
          if (ChannelMemberManager.isMuted(member))
            Text('已禁言', style: TextStyle(color: Colors.red, fontSize: 12)),
        ],
      ),
      trailing: Row(
        mainAxisSize: MainAxisSize.min,
        children: [
          if (ChannelMemberManager.isAdmin(member))
            Container(
              padding: EdgeInsets.symmetric(horizontal: 6, vertical: 2),
              decoration: BoxDecoration(
                color: Colors.orange,
                borderRadius: BorderRadius.circular(4),
              ),
              child: Text(
                '管理员',
                style: TextStyle(color: Colors.white, fontSize: 10),
              ),
            ),
          if (member.robot == 1)
            Container(
              margin: EdgeInsets.only(left: 4),
              padding: EdgeInsets.symmetric(horizontal: 6, vertical: 2),
              decoration: BoxDecoration(
                color: Colors.blue,
                borderRadius: BorderRadius.circular(4),
              ),
              child: Text(
                '机器人',
                style: TextStyle(color: Colors.white, fontSize: 10),
              ),
            ),
        ],
      ),
      onTap: () {
        _showMemberDetails(member);
      },
    );
  }
  
  void _showMemberDetails(WKChannelMember member) {
    showDialog(
      context: context,
      builder: (context) => AlertDialog(
        title: Text('成员详情'),
        content: Column(
          mainAxisSize: MainAxisSize.min,
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text('姓名: ${member.memberName}'),
            Text('ID: ${member.memberUID}'),
            Text('角色: ${_getRoleText(member.role)}'),
            Text('状态: ${_getStatusText(member.status)}'),
            if (member.memberRemark.isNotEmpty)
              Text('备注: ${member.memberRemark}'),
            if (ChannelMemberManager.isMuted(member))
              Text('禁言到期: ${_formatTime(member.forbiddenExpirationTime)}'),
          ],
        ),
        actions: [
          TextButton(
            onPressed: () => Navigator.of(context).pop(),
            child: Text('关闭'),
          ),
        ],
      ),
    );
  }
  
  String _getRoleText(int role) {
    switch (role) {
      case 0: return '普通成员';
      case 1: return '管理员';
      case 2: return '群主';
      default: return '未知';
    }
  }
  
  String _getStatusText(int status) {
    switch (status) {
      case 1: return '正常';
      case 2: return '黑名单';
      default: return '未知';
    }
  }
  
  String _formatTime(int timestamp) {
    if (timestamp == 0) return '永久';
    final date = DateTime.fromMillisecondsSinceEpoch(timestamp * 1000);
    return '${date.year}-${date.month.toString().padLeft(2, '0')}-${date.day.toString().padLeft(2, '0')} ${date.hour.toString().padLeft(2, '0')}:${date.minute.toString().padLeft(2, '0')}';
  }
}

下一步

命令管理

学习命令消息处理和监听

提醒管理

了解@提醒和自定义提醒功能

频道管理

回到频道管理功能

高级功能

探索自定义消息和扩展特性

WuKongEasySDK

WuKongIMSDK

频道成员管理

获取频道成员

获取频道内所有成员

获取频道内指定用户的成员信息

完整成员获取示例

事件监听

刷新频道成员监听

完整事件监听管理

数据结构说明

WKChannelMember 频道成员对象

字段说明

成员角色说明

成员状态说明

Flutter Widget 集成示例

成员列表组件

下一步

命令管理

提醒管理

频道管理

高级功能

WuKongEasySDK

WuKongIMSDK

​获取频道成员

​获取频道内所有成员

​获取频道内指定用户的成员信息

​完整成员获取示例

​事件监听

​刷新频道成员监听

​完整事件监听管理

​数据结构说明

​WKChannelMember 频道成员对象

​字段说明

​成员角色说明

​成员状态说明

​Flutter Widget 集成示例

​成员列表组件

​下一步

命令管理

提醒管理

频道管理

高级功能

获取频道成员

获取频道内所有成员

获取频道内指定用户的成员信息

完整成员获取示例

事件监听

刷新频道成员监听

完整事件监听管理

数据结构说明

WKChannelMember 频道成员对象

字段说明

成员角色说明

成员状态说明

Flutter Widget 集成示例

成员列表组件

下一步