Custom Participant List

Customize the CometChat Calls SDK v5 participant list on iOS with participant views, actions, status, and layout.

Build a custom participant list UI that displays real-time participant information with full control over layout and interactions. This guide demonstrates how to hide the default participant list and create your own using participant events and actions.

Overview

The SDK provides participant data through events, allowing you to build custom UIs for:

• Participant roster with search and filtering
• Custom participant cards with role badges or metadata
• Moderation dashboards with quick access to controls
• Attendance tracking and engagement monitoring

Prerequisites

• CometChat Calls SDK installed and initialized
• Active call session (see Join Session)
• Basic understanding of UITableView or UICollectionView

---

Step 1: Hide Default Participant List

Configure session settings to hide the default participant list button:

Swift

let sessionSettings = CometChatCalls.sessionSettingsBuilder
    .hideParticipantListButton(true)
    .build()

Objective-C

SessionSettings *sessionSettings = [[[CometChatCalls sessionSettingsBuilder]
    hideParticipantListButton:YES]
    build];

---

Step 2: Create Participant List Layout

Create a custom view controller for displaying participants:

Swift

class ParticipantListViewController: UIViewController {
    
    private let tableView = UITableView()
    private let searchBar = UISearchBar()
    private var participants: [Participant] = []
    private var filteredParticipants: [Participant] = []
    /// Per-participant state the app maintains itself, keyed by `Participant.uid`, because
    /// `Participant` carries no such flags. Starts empty — anything that happened before this
    /// client joined is not recoverable.
    fileprivate var statuses: [String: ParticipantStatus] = [:]
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupUI()
        setupParticipantListener()
    }
    
    private func setupUI() {
        title = "Participants"
        view.backgroundColor = .systemBackground
        
        // Setup search bar
        searchBar.placeholder = "Search participants..."
        searchBar.delegate = self
        searchBar.translatesAutoresizingMaskIntoConstraints = false
        view.addSubview(searchBar)
        
        // Setup table view
        tableView.delegate = self
        tableView.dataSource = self
        tableView.register(ParticipantCell.self, forCellReuseIdentifier: "ParticipantCell")
        tableView.translatesAutoresizingMaskIntoConstraints = false
        view.addSubview(tableView)
        
        // Layout constraints
        NSLayoutConstraint.activate([
            searchBar.topAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
            searchBar.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            searchBar.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            
            tableView.topAnchor.constraint(equalTo: searchBar.bottomAnchor),
            tableView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            tableView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            tableView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
        ])
        
        // Add close button
        navigationItem.rightBarButtonItem = UIBarButtonItem(
            barButtonSystemItem: .close,
            target: self,
            action: #selector(dismissView)
        )
    }
    
    @objc private func dismissView() {
        dismiss(animated: true)
    }
}

Objective-C

@interface ParticipantListViewController () <UITableViewDelegate, UITableViewDataSource, UISearchBarDelegate>
@property (nonatomic, strong) UITableView *tableView;
@property (nonatomic, strong) UISearchBar *searchBar;
@property (nonatomic, strong) NSArray<Participant *> *participants;
@property (nonatomic, strong) NSArray<Participant *> *filteredParticipants;
/// Per-participant state the app maintains itself, keyed by uid — `Participant` carries no
/// such flags. Starts empty; state from before this client joined is not recoverable.
@property (nonatomic, strong) NSMutableDictionary<NSString *, ParticipantStatus *> *statuses;
@end

@implementation ParticipantListViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    self.statuses = [NSMutableDictionary dictionary];
    [self setupUI];
    [self setupParticipantListener];
}

- (void)setupUI {
    self.title = @"Participants";
    self.view.backgroundColor = [UIColor systemBackgroundColor];
    
    // Setup search bar
    self.searchBar = [[UISearchBar alloc] init];
    self.searchBar.placeholder = @"Search participants...";
    self.searchBar.delegate = self;
    self.searchBar.translatesAutoresizingMaskIntoConstraints = NO;
    [self.view addSubview:self.searchBar];
    
    // Setup table view
    self.tableView = [[UITableView alloc] init];
    self.tableView.delegate = self;
    self.tableView.dataSource = self;
    [self.tableView registerClass:[ParticipantCell class] forCellReuseIdentifier:@"ParticipantCell"];
    self.tableView.translatesAutoresizingMaskIntoConstraints = NO;
    [self.view addSubview:self.tableView];
    
    // Layout constraints
    [NSLayoutConstraint activateConstraints:@[
        [self.searchBar.topAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.topAnchor],
        [self.searchBar.leadingAnchor constraintEqualToAnchor:self.view.leadingAnchor],
        [self.searchBar.trailingAnchor constraintEqualToAnchor:self.view.trailingAnchor],
        
        [self.tableView.topAnchor constraintEqualToAnchor:self.searchBar.bottomAnchor],
        [self.tableView.leadingAnchor constraintEqualToAnchor:self.view.leadingAnchor],
        [self.tableView.trailingAnchor constraintEqualToAnchor:self.view.trailingAnchor],
        [self.tableView.bottomAnchor constraintEqualToAnchor:self.view.bottomAnchor]
    ]];
    
    // Add close button
    self.navigationItem.rightBarButtonItem = [[UIBarButtonItem alloc]
        initWithBarButtonSystemItem:UIBarButtonSystemItemClose
        target:self
        action:@selector(dismissView)];
}

- (void)dismissView {
    [self dismissViewControllerAnimated:YES completion:nil];
}

@end

---

Step 3: Create Participant Cell

Build a custom table view cell to display participant information.

Participant carries only identity and timing fields — uid, name, avatar, mid, state, isJoined, joinedAt, leftAt, deviceID and the total*Minutes counters. It has no mute / video / screen-share / hand-raise / pin flags, and the SDK exposes no getter for them. Accumulate that state in your own app from the participant events, as below. Because those events fire only on change, a client that joins mid-call cannot recover state that was already in effect.

Swift

/// Per-participant state the app maintains itself, keyed by `Participant.uid`.
struct ParticipantStatus {
    var isAudioMuted = false
    var isVideoPaused = false
    var isPresenting  = false
    var isHandRaised  = false
    var isPinned      = false
}

class ParticipantCell: UITableViewCell {
    
    private let avatarImageView = UIImageView()
    private let nameLabel = UILabel()
    private let statusLabel = UILabel()
    private let muteButton = UIButton(type: .system)
    private let pinButton = UIButton(type: .system)
    
    var participant: Participant?
    var onMuteAction: ((Participant) -> Void)?
    var onPinAction: ((Participant) -> Void)?
    
    override init(style: UITableViewCell.CellStyle, reuseIdentifier: String?) {
        super.init(style: style, reuseIdentifier: reuseIdentifier)
        setupUI()
    }
    
    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    private func setupUI() {
        // Avatar
        avatarImageView.layer.cornerRadius = 20
        avatarImageView.clipsToBounds = true
        avatarImageView.backgroundColor = .systemGray4
        avatarImageView.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(avatarImageView)
        
        // Name label
        nameLabel.font = .systemFont(ofSize: 16, weight: .semibold)
        nameLabel.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(nameLabel)
        
        // Status label
        statusLabel.font = .systemFont(ofSize: 12)
        statusLabel.textColor = .secondaryLabel
        statusLabel.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(statusLabel)
        
        // Action buttons
        muteButton.setImage(UIImage(systemName: "mic.slash"), for: .normal)
        muteButton.addTarget(self, action: #selector(muteButtonTapped), for: .touchUpInside)
        muteButton.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(muteButton)
        
        pinButton.setImage(UIImage(systemName: "pin"), for: .normal)
        pinButton.addTarget(self, action: #selector(pinButtonTapped), for: .touchUpInside)
        pinButton.translatesAutoresizingMaskIntoConstraints = false
        contentView.addSubview(pinButton)
        
        // Layout
        NSLayoutConstraint.activate([
            avatarImageView.leadingAnchor.constraint(equalTo: contentView.leadingAnchor, constant: 16),
            avatarImageView.centerYAnchor.constraint(equalTo: contentView.centerYAnchor),
            avatarImageView.widthAnchor.constraint(equalToConstant: 40),
            avatarImageView.heightAnchor.constraint(equalToConstant: 40),
            
            nameLabel.leadingAnchor.constraint(equalTo: avatarImageView.trailingAnchor, constant: 12),
            nameLabel.topAnchor.constraint(equalTo: contentView.topAnchor, constant: 12),
            
            statusLabel.leadingAnchor.constraint(equalTo: nameLabel.leadingAnchor),
            statusLabel.topAnchor.constraint(equalTo: nameLabel.bottomAnchor, constant: 4),
            statusLabel.bottomAnchor.constraint(equalTo: contentView.bottomAnchor, constant: -12),
            
            pinButton.trailingAnchor.constraint(equalTo: contentView.trailingAnchor, constant: -16),
            pinButton.centerYAnchor.constraint(equalTo: contentView.centerYAnchor),
            pinButton.widthAnchor.constraint(equalToConstant: 32),
            
            muteButton.trailingAnchor.constraint(equalTo: pinButton.leadingAnchor, constant: -8),
            muteButton.centerYAnchor.constraint(equalTo: contentView.centerYAnchor),
            muteButton.widthAnchor.constraint(equalToConstant: 32)
        ])
    }
    
    func configure(with participant: Participant, status: ParticipantStatus) {
        self.participant = participant
        nameLabel.text = participant.name

        // Build status text from the app's own state, not from `participant`.
        var statusParts: [String] = []
        if status.isAudioMuted  { statusParts.append("🔇 Muted") }
        if status.isVideoPaused { statusParts.append("📹 Video Off") }
        if status.isPresenting  { statusParts.append("🖥️ Presenting") }
        if status.isHandRaised  { statusParts.append("✋ Hand Raised") }
        if status.isPinned      { statusParts.append("📌 Pinned") }

        statusLabel.text = statusParts.isEmpty ? "Active" : statusParts.joined(separator: " • ")

        // Update button states
        muteButton.alpha = status.isAudioMuted ? 0.5 : 1.0
        pinButton.tintColor = status.isPinned ? .systemBlue : .systemGray
    }
    
    @objc private func muteButtonTapped() {
        guard let participant = participant else { return }
        onMuteAction?(participant)
    }
    
    @objc private func pinButtonTapped() {
        guard let participant = participant else { return }
        onPinAction?(participant)
    }
}

Objective-C

/// Per-participant state the app maintains itself, keyed by `Participant.uid`.
@interface ParticipantStatus : NSObject
@property (nonatomic, assign) BOOL isAudioMuted;
@property (nonatomic, assign) BOOL isVideoPaused;
@property (nonatomic, assign) BOOL isPresenting;
@property (nonatomic, assign) BOOL isHandRaised;
@property (nonatomic, assign) BOOL isPinned;
@end

@implementation ParticipantStatus
@end

@interface ParticipantCell : UITableViewCell
@property (nonatomic, strong) Participant *participant;
@property (nonatomic, copy) void (^onMuteAction)(Participant *);
@property (nonatomic, copy) void (^onPinAction)(Participant *);
- (void)configureWithParticipant:(Participant *)participant status:(ParticipantStatus *)status;
@end

@implementation ParticipantCell {
    UIImageView *_avatarImageView;
    UILabel *_nameLabel;
    UILabel *_statusLabel;
    UIButton *_muteButton;
    UIButton *_pinButton;
}

- (instancetype)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(NSString *)reuseIdentifier {
    self = [super initWithStyle:style reuseIdentifier:reuseIdentifier];
    if (self) {
        [self setupUI];
    }
    return self;
}

- (void)setupUI {
    // Avatar
    _avatarImageView = [[UIImageView alloc] init];
    _avatarImageView.layer.cornerRadius = 20;
    _avatarImageView.clipsToBounds = YES;
    _avatarImageView.backgroundColor = [UIColor systemGray4Color];
    _avatarImageView.translatesAutoresizingMaskIntoConstraints = NO;
    [self.contentView addSubview:_avatarImageView];
    
    // Name label
    _nameLabel = [[UILabel alloc] init];
    _nameLabel.font = [UIFont systemFontOfSize:16 weight:UIFontWeightSemibold];
    _nameLabel.translatesAutoresizingMaskIntoConstraints = NO;
    [self.contentView addSubview:_nameLabel];
    
    // Status label
    _statusLabel = [[UILabel alloc] init];
    _statusLabel.font = [UIFont systemFontOfSize:12];
    _statusLabel.textColor = [UIColor secondaryLabelColor];
    _statusLabel.translatesAutoresizingMaskIntoConstraints = NO;
    [self.contentView addSubview:_statusLabel];
    
    // Action buttons
    _muteButton = [UIButton buttonWithType:UIButtonTypeSystem];
    [_muteButton setImage:[UIImage systemImageNamed:@"mic.slash"] forState:UIControlStateNormal];
    [_muteButton addTarget:self action:@selector(muteButtonTapped) forControlEvents:UIControlEventTouchUpInside];
    _muteButton.translatesAutoresizingMaskIntoConstraints = NO;
    [self.contentView addSubview:_muteButton];
    
    _pinButton = [UIButton buttonWithType:UIButtonTypeSystem];
    [_pinButton setImage:[UIImage systemImageNamed:@"pin"] forState:UIControlStateNormal];
    [_pinButton addTarget:self action:@selector(pinButtonTapped) forControlEvents:UIControlEventTouchUpInside];
    _pinButton.translatesAutoresizingMaskIntoConstraints = NO;
    [self.contentView addSubview:_pinButton];
    
    // Layout constraints
    [NSLayoutConstraint activateConstraints:@[
        [_avatarImageView.leadingAnchor constraintEqualToAnchor:self.contentView.leadingAnchor constant:16],
        [_avatarImageView.centerYAnchor constraintEqualToAnchor:self.contentView.centerYAnchor],
        [_avatarImageView.widthAnchor constraintEqualToConstant:40],
        [_avatarImageView.heightAnchor constraintEqualToConstant:40],
        
        [_nameLabel.leadingAnchor constraintEqualToAnchor:_avatarImageView.trailingAnchor constant:12],
        [_nameLabel.topAnchor constraintEqualToAnchor:self.contentView.topAnchor constant:12],
        
        [_statusLabel.leadingAnchor constraintEqualToAnchor:_nameLabel.leadingAnchor],
        [_statusLabel.topAnchor constraintEqualToAnchor:_nameLabel.bottomAnchor constant:4],
        [_statusLabel.bottomAnchor constraintEqualToAnchor:self.contentView.bottomAnchor constant:-12],
        
        [_pinButton.trailingAnchor constraintEqualToAnchor:self.contentView.trailingAnchor constant:-16],
        [_pinButton.centerYAnchor constraintEqualToAnchor:self.contentView.centerYAnchor],
        [_pinButton.widthAnchor constraintEqualToConstant:32],
        
        [_muteButton.trailingAnchor constraintEqualToAnchor:_pinButton.leadingAnchor constant:-8],
        [_muteButton.centerYAnchor constraintEqualToAnchor:self.contentView.centerYAnchor],
        [_muteButton.widthAnchor constraintEqualToConstant:32]
    ]];
}

- (void)configureWithParticipant:(Participant *)participant status:(ParticipantStatus *)status {
    self.participant = participant;
    _nameLabel.text = participant.name;

    // Build status text from the app's own state, not from `participant`.
    NSMutableArray *statusParts = [NSMutableArray array];
    if (status.isAudioMuted)  [statusParts addObject:@"🔇 Muted"];
    if (status.isVideoPaused) [statusParts addObject:@"📹 Video Off"];
    if (status.isPresenting)  [statusParts addObject:@"🖥️ Presenting"];
    if (status.isHandRaised)  [statusParts addObject:@"✋ Hand Raised"];
    if (status.isPinned)      [statusParts addObject:@"📌 Pinned"];

    _statusLabel.text = statusParts.count == 0 ? @"Active" : [statusParts componentsJoinedByString:@" • "];

    // Update button states
    _muteButton.alpha = status.isAudioMuted ? 0.5 : 1.0;
    _pinButton.tintColor = status.isPinned ? [UIColor systemBlueColor] : [UIColor systemGrayColor];
}

- (void)muteButtonTapped {
    if (self.onMuteAction && self.participant) {
        self.onMuteAction(self.participant);
    }
}

- (void)pinButtonTapped {
    if (self.onPinAction && self.participant) {
        self.onPinAction(self.participant);
    }
}

@end

---

Step 4: Implement Participant Events

Listen for participant updates and handle actions:

Swift

extension ParticipantListViewController: ParticipantEventListener {
    
    private func setupParticipantListener() {
        CallSession.shared.addParticipantEventListener(self)
    }
    
    deinit {
        CallSession.shared.removeParticipantEventListener(self)
    }
    
    func onParticipantListChanged(participants: [Participant]) {
        DispatchQueue.main.async {
            self.participants = participants
            self.filteredParticipants = participants
            self.title = "Participants (\(participants.count))"
            self.tableView.reloadData()
        }
    }
    
    func onParticipantJoined(participant: Participant) {
        print("\(participant.name ?? "") joined")
    }

    func onParticipantLeft(participant: Participant) {
        guard let uid = participant.uid else { return }
        DispatchQueue.main.async {
            self.statuses.removeValue(forKey: uid)   // don't leak state for someone who left
            self.tableView.reloadData()
        }
    }

    // `onParticipantListChanged` carries no flags, so every status below comes from these
    // transition events. Each one mutates the app's own `statuses` map and redraws.
    func onParticipantAudioMuted(participant: Participant)      { update(participant) { $0.isAudioMuted = true } }
    func onParticipantAudioUnmuted(participant: Participant)    { update(participant) { $0.isAudioMuted = false } }
    func onParticipantVideoPaused(participant: Participant)     { update(participant) { $0.isVideoPaused = true } }
    func onParticipantVideoResumed(participant: Participant)    { update(participant) { $0.isVideoPaused = false } }
    func onParticipantHandRaised(participant: Participant)      { update(participant) { $0.isHandRaised = true } }
    func onParticipantHandLowered(participant: Participant)     { update(participant) { $0.isHandRaised = false } }
    func onParticipantStartedScreenShare(participant: Participant) { update(participant) { $0.isPresenting = true } }
    func onParticipantStoppedScreenShare(participant: Participant) { update(participant) { $0.isPresenting = false } }

    private func update(_ participant: Participant, _ change: @escaping (inout ParticipantStatus) -> Void) {
        guard let uid = participant.uid else { return }
        DispatchQueue.main.async {
            var status = self.statuses[uid] ?? ParticipantStatus()
            change(&status)
            self.statuses[uid] = status
            self.tableView.reloadData()
        }
    }
}

Objective-C

@interface ParticipantListViewController () <ParticipantEventListener>
@end

- (void)setupParticipantListener {
    [[CallSession shared] addParticipantEventListener:self];
}

- (void)dealloc {
    [[CallSession shared] removeParticipantEventListener:self];
}

- (void)onParticipantListChangedWithParticipants:(NSArray<Participant *> *)participants {
    dispatch_async(dispatch_get_main_queue(), ^{
        self.participants = participants;
        self.filteredParticipants = participants;
        self.title = [NSString stringWithFormat:@"Participants (%lu)", (unsigned long)participants.count];
        [self.tableView reloadData];
    });
}

- (void)onParticipantJoinedWithParticipant:(Participant *)participant {
    NSLog(@"%@ joined", participant.name);
}

- (void)onParticipantLeftWithParticipant:(Participant *)participant {
    if (!participant.uid) { return; }
    dispatch_async(dispatch_get_main_queue(), ^{
        [self.statuses removeObjectForKey:participant.uid];   // don't leak state
        [self.tableView reloadData];
    });
}

// `onParticipantListChanged` carries no flags, so every status below comes from these
// transition events. self.statuses is an NSMutableDictionary<NSString *, ParticipantStatus *>.
- (void)updateParticipant:(Participant *)participant change:(void (^)(ParticipantStatus *))change {
    NSString *uid = participant.uid;
    if (!uid) { return; }
    dispatch_async(dispatch_get_main_queue(), ^{
        ParticipantStatus *status = self.statuses[uid] ?: [ParticipantStatus new];
        change(status);
        self.statuses[uid] = status;
        [self.tableView reloadData];
    });
}

- (void)onParticipantAudioMutedWithParticipant:(Participant *)p {
    [self updateParticipant:p change:^(ParticipantStatus *s) { s.isAudioMuted = YES; }];
}
- (void)onParticipantAudioUnmutedWithParticipant:(Participant *)p {
    [self updateParticipant:p change:^(ParticipantStatus *s) { s.isAudioMuted = NO; }];
}
- (void)onParticipantVideoPausedWithParticipant:(Participant *)p {
    [self updateParticipant:p change:^(ParticipantStatus *s) { s.isVideoPaused = YES; }];
}
- (void)onParticipantVideoResumedWithParticipant:(Participant *)p {
    [self updateParticipant:p change:^(ParticipantStatus *s) { s.isVideoPaused = NO; }];
}
- (void)onParticipantHandRaisedWithParticipant:(Participant *)p {
    [self updateParticipant:p change:^(ParticipantStatus *s) { s.isHandRaised = YES; }];
}
- (void)onParticipantHandLoweredWithParticipant:(Participant *)p {
    [self updateParticipant:p change:^(ParticipantStatus *s) { s.isHandRaised = NO; }];
}
- (void)onParticipantStartedScreenShareWithParticipant:(Participant *)p {
    [self updateParticipant:p change:^(ParticipantStatus *s) { s.isPresenting = YES; }];
}
- (void)onParticipantStoppedScreenShareWithParticipant:(Participant *)p {
    [self updateParticipant:p change:^(ParticipantStatus *s) { s.isPresenting = NO; }];
}

---

Step 5: Implement Table View Data Source

Swift

extension ParticipantListViewController: UITableViewDelegate, UITableViewDataSource {
    
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return filteredParticipants.count
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "ParticipantCell", for: indexPath) as! ParticipantCell
        let participant = filteredParticipants[indexPath.row]
        
        let status = participant.uid.flatMap { statuses[$0] } ?? ParticipantStatus()
        cell.configure(with: participant, status: status)

        cell.onMuteAction = { participant in
            guard let uid = participant.uid else { return }
            CallSession.shared.muteParticipant(participantId: uid)
        }

        cell.onPinAction = { [weak self] participant in
            guard let self, let uid = participant.uid else { return }
            if self.statuses[uid]?.isPinned == true {
                CallSession.shared.unpinParticipant()
                self.statuses[uid]?.isPinned = false
            } else {
                // Only one participant can be pinned at a time — `unpinParticipant()` takes no id.
                for key in Array(self.statuses.keys) { self.statuses[key]?.isPinned = false }
                CallSession.shared.pinParticipant(participantId: uid, type: "pin")
                self.statuses[uid, default: ParticipantStatus()].isPinned = true
            }
            self.tableView.reloadData()
        }
        
        return cell
    }
}

extension ParticipantListViewController: UISearchBarDelegate {
    
    func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) {
        if searchText.isEmpty {
            filteredParticipants = participants
        } else {
            filteredParticipants = participants.filter {
                ($0.name ?? "").localizedCaseInsensitiveContains(searchText)
            }
        }
        tableView.reloadData()
    }
}

Objective-C

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    return self.filteredParticipants.count;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    ParticipantCell *cell = [tableView dequeueReusableCellWithIdentifier:@"ParticipantCell" forIndexPath:indexPath];
    Participant *participant = self.filteredParticipants[indexPath.row];
    
    ParticipantStatus *status = participant.uid ? self.statuses[participant.uid] : nil;
    [cell configureWithParticipant:participant status:(status ?: [ParticipantStatus new])];

    __weak typeof(self) weakSelf = self;
    cell.onMuteAction = ^(Participant *p) {
        if (!p.uid) { return; }
        [[CallSession shared] muteParticipantWithParticipantId:p.uid];
    };

    cell.onPinAction = ^(Participant *p) {
        __strong typeof(weakSelf) self = weakSelf;
        if (!self || !p.uid) { return; }
        if (self.statuses[p.uid].isPinned) {
            [[CallSession shared] unpinParticipant];
            self.statuses[p.uid].isPinned = NO;
        } else {
            // Only one participant can be pinned at a time — unpinParticipant takes no id.
            for (NSString *key in self.statuses) { self.statuses[key].isPinned = NO; }
            [[CallSession shared] pinParticipantWithParticipantId:p.uid type:@"pin"];
            ParticipantStatus *s = self.statuses[p.uid] ?: [ParticipantStatus new];
            s.isPinned = YES;
            self.statuses[p.uid] = s;
        }
        [self.tableView reloadData];
    };
    
    return cell;
}

- (void)searchBar:(UISearchBar *)searchBar textDidChange:(NSString *)searchText {
    if (searchText.length == 0) {
        self.filteredParticipants = self.participants;
    } else {
        NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name CONTAINS[cd] %@", searchText];
        self.filteredParticipants = [self.participants filteredArrayUsingPredicate:predicate];
    }
    [self.tableView reloadData];
}

---

Step 6: Present Participant List

Show the participant list from your call view controller:

Swift

class CallViewController: UIViewController {
    
    private let participantListButton = UIButton(type: .system)
    
    private func setupParticipantListButton() {
        participantListButton.setImage(UIImage(systemName: "person.3"), for: .normal)
        participantListButton.addTarget(self, action: #selector(showParticipantList), for: .touchUpInside)
        // Add to your view hierarchy
    }
    
    @objc private func showParticipantList() {
        let participantListVC = ParticipantListViewController()
        let navController = UINavigationController(rootViewController: participantListVC)
        navController.modalPresentationStyle = .pageSheet
        
        if let sheet = navController.sheetPresentationController {
            sheet.detents = [.medium(), .large()]
            sheet.prefersGrabberVisible = true
        }
        
        present(navController, animated: true)
    }
}

Objective-C

- (void)setupParticipantListButton {
    self.participantListButton = [UIButton buttonWithType:UIButtonTypeSystem];
    [self.participantListButton setImage:[UIImage systemImageNamed:@"person.3"] forState:UIControlStateNormal];
    [self.participantListButton addTarget:self action:@selector(showParticipantList) forControlEvents:UIControlEventTouchUpInside];
    // Add to your view hierarchy
}

- (void)showParticipantList {
    ParticipantListViewController *participantListVC = [[ParticipantListViewController alloc] init];
    UINavigationController *navController = [[UINavigationController alloc] initWithRootViewController:participantListVC];
    navController.modalPresentationStyle = UIModalPresentationPageSheet;
    
    UISheetPresentationController *sheet = navController.sheetPresentationController;
    if (sheet) {
        sheet.detents = @[UISheetPresentationControllerDetent.mediumDetent, UISheetPresentationControllerDetent.largeDetent];
        sheet.prefersGrabberVisible = YES;
    }
    
    [self presentViewController:navController animated:YES completion:nil];
}

---

Related Documentation

• Participant Management - Participant actions and events
• Events - All available event listeners
• Actions - Available call actions